Establishing a session using SNAP-IX

The following information guides you through the tasks you must perform to create the SNA infrastructure that WebSphere MQ requires. This example creates the definitions for a partner node and LU on OS/2.

Use sna start followed by xsnaadmin to type the SNAP-IX configuration panels. You need root authority to use xsnaadmin.

SNAP-IX configuration

SNAP-IX configuration involves the following steps:

  1. Defining a local node
  2. Adding a Token Ring Port
  3. Defining a local LU

The SNAP-IX main menu, from which you start, is shown here:



The SNAP-IX main menu. It contains the menu items and options that you need to select to establish the session. The menus at the top of the screen are: Selection, Services, Diagnostics, and Windows. The main window contains three elements that you can select as part of the configuration: Connectivity and dependent LUs, Independent Local LUs, and Remote Systems. The instructions and panels following this figure guide you through the configuration process.


Defining a local node

  1. From the SNAP-IX main menu, click the Services pull-down. The Services pull-down appears::



    The services pull-down from the SNAP-IX main menu. The services pull-down lists the following options: Configure node parameters, Connectivity, 3270, 5250, RJE, LUA, APPC, TN server, PU concentration, and HPR. The instructions that follow guide you through the next step of the process.

  2. Click Configure node parameters. The following panel is displayed:



    The node-parameters configuration panel. The instructions that follow guide you through the next step of the process.

  3. Complete the Control point name with the values Network name ((4)) and Control point name ((2)).
  4. Type the Control point name ((2)) in the Control point alias field.
  5. Type the Node ID ((3)).
  6. Click End node.
  7. Click OK.

A default independent local LU is defined.

Adding a Token Ring Port

  1. From the main SNAP-IX menu, click Connectivity and dependent LUs.
  2. Click Add. The following panel is displayed:



    Adding connectivity and dependent LU items. The instructions that follow guide you through the next step of the process.

  3. Click Token Ring Card and click OK. The following panel is displayed:



    Adding a token-ring port. The instructions that follow guide you through the next step of the process.

  4. Type the SNA port name ((9)).
  5. Type a Description and click OK to take the default values.

Defining a local LU

  1. From the main SNAP-IX menu, click Independent local LUs.
  2. Click Add. The following panel is displayed:



    Adding independent local LUs. You use this panel to specify the LU name, LU alias, and a description. The instructions that follow guide you through the next step of the process.

  3. Type the LU name ((5)) and click OK.

APPC configuration

APPC configuration involves the following steps:

  1. Defining a remote node
  2. Defining a partner LU
  3. Defining a link station
  4. Defining a mode
  5. Adding CPI-C information
  6. Adding a TP definition

Defining a remote node

  1. From the main SNAP-IX menu, click Remote systems.
  2. Click Add. The following panel is displayed:



    Adding a remote system. The panel contains the following options: Define remote node, Define partner LU, Define wildcard partner LU name, and Define partner LU alias.

  3. Select the Define remote node check box and click OK. The following panel is displayed:



    The remote-node definition panel. The instructions that follow explain how to use this panel.

  4. Type the Node's SNA network name ((13)) and a Description.
  5. Click OK.
  6. A default partner LU with the same name is generated and a message is displayed.
  7. Click OK.

Defining a partner LU

  1. From the main SNAP-IX menu, click Remote systems and click the remote node.
  2. Click Add. The following panel is displayed:



    Defining a partner LU. The instructions that follow explain how to use this panel.

  3. Select theDefine partner LU on node node name check box.
  4. Click OK. The following panel is displayed:



    The partner LU definition panel. The instructions that follow explain how to use this panel.

  5. Type the partner LU name ((15)) and click OK.

Defining a link station

  1. From the main SNAP-IX menu, click Connectivity and dependent LUs.
  2. Click the MQPORT port.
  3. Click Add. The following panel is displayed:



    Adding a link station. The instructions that follow explain how to use this panel.

  4. Select the Add link station to port MQPORT check box.
  5. Click OK. The following panel is displayed:



    The Token-ring link station definition panel. The instructions that follow explain how to use this panel.

  6. Type the Name of the link station ((12)).
  7. Set the value of Activation to "On demand".
  8. Select the Independent only check box.
  9. Click Remote node and select the value of the remote node ((14)).
  10. Click OK.
  11. Set the value of Remote node type to "End or LEN node".
  12. Type the value for MAC address ((19)) and click Advanced. The following panel is displayed:



    The advanced page of the Token-ring link station definition panel. The instructions that follow explain how to use this panel.

  13. Select the Request CP-CP sessions. check box
  14. Select the Reactivate link station after failure. check box
  15. Click OK to exit the Advanced panel.
  16. Click OK again.

Defining a mode

  1. From the SNAP-IX main menu, click the Services pull-down: The following panel is displayed:



    The services pull-down from the SNAP-IX main menu. The services pull-down lists the following options: Configure node parameters, Connectivity, 3270, 5250, RJE, LUA, APPC, TN server, PU concentration, and HPR. The instructions that follow guide you through the next step of the process.

  2. Click APPC. The following panel is displayed:



    The APPC selection from the Services pull-down. The instructions that follow guide you through the next step in the process.

  3. Click Modes. The following panel is displayed:



    Displaying modes from the APPC selection of the Services pull-down. The instructions that follow guide you through the next step in the process.

  4. Click Add. The following panel is displayed:



    Adding a mode. The instructions that follow guide you through the next step in the process.

  5. Type the Name to be given to the mode ((17)).
  6. Set the values of Initial session limit to 8, Min con. winner sessions to 4, and Auto-activated sessions to 0.
  7. Click OK.
  8. Click Done.

Adding CPI-C information

  1. From the SNAP-IX main menu, click the Services pull-down:



    The Services pull-down from the SNAP-IX main menu. The instructions that follow guide you through the next step in the process.

  2. Click APPC. The following panel is displayed:



    The APPC selection from the Services pull-down. The instructions that follow guide you through the next step in the process.

  3. Click CPI-C. The following panel is displayed:



    Displaying the CPI-C destination names. The instructions that follow guide you through the next step in the process.

  4. Click Add. The following panel is displayed:



    Adding a CPI-C destination. The instructions that follow guide you through the next step in the process.

  5. Type the Name ((18)). Select the Application TP check box and type the value ((16)). Select the Use PLU alias check box and type the name ((15)). Type the Mode name ((17)).
  6. Click OK.

Adding a TP definition using SNAP-IX Release 6

To add a TP definition:

  1. Click the Services pull-down and click APPC as for CPI-C information.
  2. Click Transaction Programs. The following panel is displayed:



    Adding a TP definition (1). The instructions that follow guide you through the next step in the process.

  3. Click Add. The following panel is displayed:



    Adding a TP definition (2). The instructions that follow guide you through the next step in the process.

  4. Type TP name ((7)) in the Application TP field.
  5. Clear the Queue incoming Allocates check box.
  6. Type Full path to executable ((10)).
  7. Type -m Local queue manager ((11)) in the Arguments field.
  8. Type mqm in the User ID and Group ID fields.
  9. Type environment variables APPCLLU=local LU ((5)) and APPCTPN=Invokable TP ((7)) separated by the pipe character in the Environment field.
  10. Click OK to save your definition.

SNAP-IX operation

The SNAP-IX control daemon is started with the sna start command. Depending on the options selected at installation, it may already be running.

The xsnaadmin utility controls SNAP-IX resources.

Logging and tracing are controlled from here. Log and trace files can be found in the /var/opt/sna directory. The logging files sna.aud and sna.err can be read using a standard editor such as vi.

In order to read the trace files sna1.trc and sna2.trc you must first format them by running the command snatrcfmt -f sna1.trc -o sna1. This produces a sna1.dmp file that can be read using a normal editor.

It is possible to edit the configuration file, but this is not a recommended method of configuring SNAP-IX.

The APPCLLU environment variables must be set before starting a sender channel from the Solaris system. The command can be either entered interactively or added to the logon profile. Depending on the level of BOURNE shell or KORN shell program being used, the command will be: 

export APPCLLU=SOLARXLU    (5)   newer level

or 

APPCLLU=SOLARXLU           (5)   older level
export

What next?

The connection is now established. You are ready to complete the configuration. Go to WebSphere MQ for Solaris configuration.


© IBM Corporation 2002. All Rights Reserved