Initiated end (Receiver)

Use the CRTMQMCHL command to define the receiving end of the message channel link with transport type *LU62. Leave the CONNECTION NAME field blank and ensure that the corresponding details match the sending end of the channel. (See Creating a channel for details of how to do this.)

To enable the initiating end to start the receiving channel, add a routing entry to a subsystem at the initiated end. The subsystem must be the one that allocates the APPC device used in the LU 6.2 sessions and, therefore, it must have a valid communications entry for that device. The routing entry calls the program that starts the receiving end of the message channel.

Use the i5/OS commands (for example, ADDRTGE) to define the end of the link that is initiated by a communication session.

The initiated end panel is shown in Figure Figure 73.

Figure 73. LU 6.2 communication setup panel - initiated end
                           Add Routing Entry (ADDRTGE)
 
 Type choices, press Enter.
 
 Subsystem description  . . . . .   QCMN          Name
   Library  . . . . . . . . . . .     *LIBL       Name, *LIBL, *CURLIB
 Routing entry sequence number  .   1             1-9999
 Comparison data:
   Compare value  . . . . . . . .   MQSERIES
 
   Starting position  . . . . . .   37            1-80
 Program to call  . . . . . . . .   AMQCRC6B      Name, *RTGDTA
   Library  . . . . . . . . . . .   QMAS400       Name, *LIBL, *CURLIB
 Class  . . . . . . . . . . . . .   *SBSD         Name, *SBSD
   Library  . . . . . . . . . . .   *LIBL         Name, *LIBL, *CURLIB
 Maximum active routing steps . .   *NOMAX        0-1000, *NOMAX
 Storage pool identifier  . . . .   1             1-10
 
 
 
                                                                         Bottom
 F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display
 F24=More keys
 

Subsystem description
The name of your subsystem where this definition resides. Use the i5/OS WRKSBSD command to view and update the appropriate subsystem description for the routing entry.
Routing entry sequence number
A unique number in your subsystem to identify this communication definition. You can use values in the range 1 to 9999.
Comparison data: Compare value
A text string to compare with that received when the session is started by a Transaction program parameter, as shown in Figure 72. The character string is derived from the Transaction program field of the sender CSI.
Comparison data: Starting position
The character position in the string where the comparison is to start.
Note:
The starting position field is the character position in the string for comparison, and this is always 37.
Program to call
The name of the program that runs the inbound message program to be called to start the session.

The program, AMQCRC6A, is called for the default queue manager. This is a program supplied with WebSphere MQ for iSeries that sets up the environment and then calls AMQCRS6A.

For additional queue managers:

An example of this is shown in Figure Figure 74:

Figure 74. LU 6.2 communication setup panel - initiated end
                       Display Routing Entries
                                                             System:   MY400
 Subsystem description:   QCMN           Status:   ACTIVE
 
 Type options, press Enter.
   5=Display details
 
                                                                 Start
 Opt    Seq Nbr    Program       Library       Compare Value      Pos
           10      *RTGDTA                     'QZSCSRVR'         37
           20      *RTGDTA                     'QZRCSRVR'         37
           30      *RTGDTA                     'QZHQTRG'          37
           50      *RTGDTA                     'QVPPRINT'         37
           60      *RTGDTA                     'QNPSERVR'         37
           70      *RTGDTA                     'QNMAPINGD'        37
           80      QNMAREXECD    QSYS          'AREXECD'          37
           90      AMQCRC6A      QMQMBW        'MQSERIES'         37
          100      *RTGDTA                     'QTFDWNLD'         37
          150      *RTGDTA                     'QMFRCVR'          37
 
 
 
 F3=Exit   F9=Display all detailed descriptions   F12=Cancel
 

In Figure Figure 74 sequence number 90 represents the default queue manager and provides compatibility with configurations from previous releases (that is, V3R2, V3R6, V3R7, and V4R2) of WebSphere MQ for iSeries. These releases allow one queue manager only. Sequence numbers 92 and 94 represent two additional queue managers called ALPHA and BETA that are created with libraries QMALPHA and QMBETA.

Note:
You can have more than one routing entry for each queue manager by using different routing data. This gives the option of different job priorities depending on the classes used.
Class
The name and library of the class used for the steps started through this routing entry. The class defines the attributes of the routing step's running environment and specifies the job priority. An appropriate class entry must be specified. Use, for example, the WRKCLS command to display existing classes or to create a new class. Further information on managing work requests from remote LU 6.2 systems is available in the AS/400(R) Programming: Work Management Guide.

Note on Work Management

The AMQCRS6A job will not be able to take advantage of the normal i5/OS work management features that are documented in the WebSphere MQ for iSeries V6 System Administration Guide book because it is not started in the same way as other WebSphere MQ jobs. To change the run-time properties of the LU62 receiver jobs, you can do one of the following:

See the AS/400 Programming: Work Management Guide for more information about configuring Communication Jobs.