Establishing a session using HP SNAplus2

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 snap start followed by xsnapadmin to enter the HP SNAplus2 configuration panels. You need root authority to use xsnapadmin.

SNAplus2 configuration

SNAplus2 configuration involves the following steps:

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

The SNAplus2 main menu, from which you will start, is shown below:



The SNAplus2 main menu. Instructions on using SNAPlus2 to establish a session are given in the following text.


Defining a local node

  1. From the SNAplus2 main menu, select the Services pull-down:



    The services pull-down from the SNAplus2 main menu. Instructions for using the pull-down menu are given in the text following this figure.

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



    The node-parameters configuration panel. Instructions for using the panel are given in the text following this figure.

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

A default independent local LU is defined.

Adding a Token Ring Port

  1. From the main SNAplus2 menu, select the Connectivity and dependent LUs panel.
  2. Press Add. The following panel is displayed:



    Adding connectivity and dependent LU items. Instructions for using this panel are given in the text following this figure.

  3. Select a Token Ring Card port and press OK. The following panel is displayed:



    Adding a token-ring port. Instructions for using this panel are given in the text following this figure.

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

Defining a local LU

  1. From the main SNAplus2 menu, select the Independent local LUs panel.
  2. Press Add. The following panel is displayed:



    Adding independent local LUs. Instructions for using this panel are given in the text following this figure.

  3. Enter the LU name ((5)) and press 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 SNAplus2 menu, select the Remote systems panel.
  2. Press Add. The following panel is displayed:



    Adding a remote system. Instructions for using this panel are given in the text following this figure.

  3. Select Define remote node and press OK. The following panel is displayed:



    The remote-node definition panel. Instructions for using the panel are given in the text following this figure.

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

Defining a partner LU

  1. From the main SNAplus2 menu, select the remote node in the Remote systems panel.
  2. Press Add. The following panel is displayed:



    Defining a partner LU. Instructions for using the panel are given in the text following this figure.

  3. Select Define partner LU on node node name.
  4. Press OK. The following panel is displayed:



    The partner LU definition panel. Instructions for using the panel are given in the text following this figure.

  5. Enter the partner LU name ((15)) and press OK.

Defining a link station

  1. From the main SNAplus2 menu, select the Connectivity and dependent LUs panel.
  2. Select the MQPORT port.
  3. Press Add. The following panel is displayed:



    Adding a link station. Instructions for using the panel are given in the text following this figure.

  4. Select Add link station to port MQPORT.
  5. Press OK. The following panel is displayed:



    The Token-ring link station definition panel. Instructions for using the panel are given in the text following this figure.

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



    The advanced page of the Token-ring link station definition panel. Instructions for using the panel are given in the text following this figure.

  13. Select Reactivate link station after failure.
  14. Press OK to exit the Advanced... panel.
  15. Press OK again.

Defining a mode

  1. From the SNAplus2 main menu, select the Services pull-down: The following panel is displayed:



    The Services pull-down from the SNAplus2 main menu. Instructions for using the panel are given in the text following this figure.

  2. Select APPC. The following panel is displayed:



    The APPC selection from the Services pull-down

  3. Select Modes.... The following panel is displayed:



    Displaying modes from the APPC selection of the Services pull-down

  4. Press Add. The following panel is displayed:



    Adding a mode. Instructions for using the panel are given in the text following this figure.

  5. Enter 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. Press OK.
  8. Press Done.

Adding CPI-C information

  1. From the SNAplus2 main menu, select the Services pull-down:



    The Services pull-down from the SNAplus2 main menu. Instructions for using the panel are given in the text following this figure.

  2. Select APPC. The following panel is displayed:



    The APPC selection from the Services pull-down. Instructions for using the panel are given in the text following this figure.

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



    Displaying the CPI-C destination names. Instructions for using the panel are given in the text following this figure.

  4. Press Add. The following panel is displayed:



    Adding a CPI-C destination. Instructions for using the panel are given in the text following this figure.

  5. Enter the Name ((18)). Select Application TP and enter the value ((16)). Select Use PLU alias and enter the name ((15)). Enter the Mode name ((17)).
  6. Press OK.

Adding a TP definition using HP SNAplus2 Release 5

Invokable TP definitions are kept in the file /etc/opt/sna/sna_tps. This should be edited to add a TP definition. Add the following lines: 

  [MQSERIES]
      PATH = /users/interops/HPUX.crs6a
      TYPE = NON-QUEUED
      USERID =  mqm
      ENV = APPCLLU=HPUXLU
      ENV = APPCTPN=MQSERIES

See WebSphere MQ for HP-UX invokable TP setup for more information about TP definitions.

Adding a TP definition using HP SNAplus2 Release 6

To add a TP definition:

  1. Select Services pulldown and select APPC as for CPI-C information.
  2. Select Transaction Programs. The following panel is displayed:



    Adding a TP definition (1). Instructions for using the panel are given in the text following this figure.

  3. Select Add. The following panel is displayed:



    Adding a TP definition (2). Instructions for using the panel are given in the text following this figure.

  4. Enter TP name ((7)) in the Application TP field.
  5. Mark Incoming Allocates as non-queued.
  6. Enter Full path to executable ((10)).
  7. Enter -m Local queue manager ((11)) in the Arguments field.
  8. Enter mqm in the User ID and Group ID fields.
  9. Enter environment variables APPCLLU=local LU ((5)) and APPCTPN=Invokable TP ((7)) separated by the pipe character in the Environment field.
  10. Press OK to save your definition.

HP-UX operation

The SNAplus2 control daemon is started with the snap start command. Depending on the options selected at installation, it may already be running.

The xsnapadmin utility controls SNAplus2 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 they must first be formatted by running the command snaptrcfmt -f sna1.trc -o sna1 which produces a sna1.dmp file which can be read using a normal editor.

The configuration file itself is editable but this is not a recommended method of configuring SNAplus2.

The APPCLU environment variables must be set before starting a sender channel from the HP-UX 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=HPUXLU    (5)   newer level

or 

APPCLLU=HPUXLU           (5)   older level
export

What next?

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


© IBM Corporation 2002. All Rights Reserved