WebSphere MQ for iSeries configuration

Start the TCP channel listener using the command STRMQMLSR.

Start any sender channel using the command STRMQMCHL CHLNAME(channel_name).

Use the WRKMQMQ command to display the WebSphere MQ configuration menu.

Note:
AMQ* errors are placed in the log relating to the job that found the error. Use the WRKACTJOB command to display the list of jobs. Under the subsystem name QSYSWRK, locate the job and enter 5 against it to work with that job. WebSphere MQ logs are prefixed 'AMQ'.

Basic configuration

  1. First you need to create a queue manager. To do this, type CRTMQM and press Enter. 


    +--------------------------------------------------------------------------------+
|                      Create Message Queue Manager (CRTMQM)                     |
|                                                                                |
| Type choices, press Enter.                                                     |
|                                                                                |
| Message Queue Manager name . . .                                               |
|                                                                                |
| Text 'description' . . . . . . .   *BLANK                                      |
|                                                                                |
| Trigger interval . . . . . . . .   999999999     0-999999999                   |
| Undelivered message queue  . . .   *NONE                                       |
|                                                                                |
| Default transmission queue . . .   *NONE                                       |
|                                                                                |
| Maximum handle limit . . . . . .   256           1-999999999                   |
| Maximum uncommitted messages . .   1000          1-10000                       |
| Default Queue manager  . . . . .   *NO           *YES, *NO                     |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                         Bottom |
| F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    |
| F24=More keys                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+
  2. In the Message Queue Manager name field, type AS400. In the Undelivered message queue field, type DEAD.LETTER.QUEUE.
  3. Press Enter.
  4. Now start the queue manager by entering STRMQM MQMNAME(AS400).
  5. Create the undelivered message queue using the following parameters. (For details and an example refer to Defining a queue.) 
      Local Queue
       Queue name :   DEAD.LETTER.QUEUE
       Queue type :   *LCL

Channel configuration

This section details the configuration to be performed on the OS/400 queue manager to implement the channel described in Figure 32.

Examples are given for connecting WebSphere MQ for iSeries and MQSeries for OS/2 Warp. If you wish connect to another WebSphere MQ product, use the appropriate values from the table in place of those for OS/2.

Notes:

  1. The words in bold are user-specified and reflect the names of WebSphere MQ objects used throughout these examples. If you change the names used here, ensure that you also change the other references made to these objects throughout this book. All others are keywords and should be entered as shown.

  2. The WebSphere MQ channel ping command (PNGMQMCHL) runs interactively, whereas starting a channel causes a batch job to be submitted. If a channel ping completes successfully but the channel will not start, this indicates that the network and WebSphere MQ definitions are probably correct, but that the OS/400 environment for the batch job is not. For example, make sure that QSYS2 is included in the system portion of the library list and not just your personal library list.

For details and examples of how to create the objects listed refer to Defining a queue and Defining a channel.


Table 49. Configuration worksheet for WebSphere MQ for iSeries

ID Parameter Name Reference Example Used User Value
Definition for local node
(A) Queue Manager Name
AS400
(B) Local queue name
AS400.LOCALQ
Connection to MQSeries for OS/2 Warp

The values in this section of the table must match those used in Table 16, as indicated.

(C) Remote queue manager name (A) OS2
(D) Remote queue name
OS2.REMOTEQ
(E) Queue name at remote system (B) OS2.LOCALQ
(F) Transmission queue name
OS2
(G) Sender (SNA) channel name
AS400.OS2.SNA
(H) Sender (TCP) channel name
AS400.OS2.TCP
(I) Receiver (SNA) channel name (G) OS2.AS400.SNA
(J) Receiver (TCP) channel name (H) OS2.AS400.TCP
Connection to WebSphere MQ for Windows

The values in this section of the table must match those used in Table 18, as indicated.

(C) Remote queue manager name (A) WINNT
(D) Remote queue name
WINNT.REMOTEQ
(E) Queue name at remote system (B) WINNT.LOCALQ
(F) Transmission queue name
WINNT
(G) Sender (SNA) channel name
AS400.WINNT.SNA
(H) Sender (TCP/IP) channel name
AS400.WINNT.TCP
(I) Receiver (SNA) channel name (G) WINNT.AS400.SNA
(J) Receiver (TCP/IP) channel name (H) WINNT.AS400.TCP
Connection to WebSphere MQ for AIX

The values in this section of the table must match those used in Table 22, as indicated.

(C) Remote queue manager name
AIX
(D) Remote queue name
AIX.REMOTEQ
(E) Queue name at remote system (B) AIX.LOCALQ
(F) Transmission queue name
AIX
(G) Sender (SNA) channel name
AS400.AIX.SNA
(H) Sender (TCP/IP) channel name
AS400.AIX.TCP
(I) Receiver (SNA) channel name (G) AIX.AS400.SNA
(J) Receiver (TCP) channel name (H) AIX.AS400.TCP
Connection to MQSeries for Compaq Tru64 UNIX

The values in this section of the table must match those used in Table 23, as indicated.

(C) Remote queue manager name
DECUX
(D) Remote queue name
DECUX.REMOTEQ
(E) Queue name at remote system (B) DECUX.LOCALQ
(F) Transmission queue name
DECUX
(H) Sender (TCP) channel name
DECUX.AS400.TCP
(J) Receiver (TCP) channel name (H) AS400.DECUX.TCP
Connection to WebSphere MQ for HP-UX

The values in this section of the table must match those used in Table 25, as indicated.

(C) Remote queue manager name
HPUX
(D) Remote queue name
HPUX.REMOTEQ
(E) Queue name at remote system (B) HPUX.LOCALQ
(F) Transmission queue name
HPUX
(G) Sender (SNA) channel name
AS400.HPUX.SNA
(H) Sender (TCP) channel name
AS400.HPUX.TCP
(I) Receiver (SNA) channel name (G) HPUX.AS400.SNA
(J) Receiver (TCP) channel name (H) HPUX.AS400.TCP
Connection to MQSeries for AT&T GIS UNIX

The values in this section of the table must match those used in Table 27, as indicated.

(C) Remote queue manager name
GIS
(D) Remote queue name
GIS.REMOTEQ
(E) Queue name at remote system (B) GIS.LOCALQ
(F) Transmission queue name
GIS
(G) Sender (SNA) channel name
AS400.GIS.SNA
(H) Sender (TCP) channel name
AS400.GIS.TCP
(I) Receiver (SNA) channel name (G) GIS.AS400.SNA
(J) Receiver (TCP/IP) channel name (H) GIS.AS400.TCP
Connection to WebSphere MQ for Solaris

The values in this section of the table must match those used in Table 30, as indicated.

(C) Remote queue manager name
SOLARIS
(D) Remote queue name
SOLARIS.REMOTEQ
(E) Queue name at remote system (B) SOLARIS.LOCALQ
(F) Transmission queue name
SOLARIS
(G) Sender (SNA) channel name
AS400.SOLARIS.SNA
(H) Sender (TCP/IP) channel name
AS400.SOLARIS.TCP
(I) Receiver (SNA) channel name (G) SOLARIS.AS400.SNA
(J) Receiver (TCP/IP) channel name (H) SOLARIS.AS400.TCP
Connection to WebSphere MQ for z/OS without CICS

The values in this section of the table must match those used in Table 34, as indicated.

(C) Remote queue manager name
MVS
(D) Remote queue name
MVS.REMOTEQ
(E) Queue name at remote system (B) MVS.LOCALQ
(F) Transmission queue name
MVS
(G) Sender (SNA) channel name
AS400.MVS.SNA
(H) Sender (TCP) channel name
AS400.MVS.TCP
(I) Receiver (SNA) channel name (G) MVS.AS400.SNA
(J) Receiver (TCP) channel name (H) MVS.AS400.TCP
Connection to MQSeries for VSE/ESA

The values in this section of the table must match those used in Table 51, as indicated.

(C) Remote queue manager name
VSE
(D) Remote queue name
VSE.REMOTEQ
(E) Queue name at remote system (B) VSE.LOCALQ
(F) Transmission queue name
VSE
(G) Sender channel name
AS400.VSE.SNA
(I) Receiver channel name (G) VSE.AS400.SNA


WebSphere MQ for iSeries sender-channel definitions using SNA

     Local Queue
              Queue name :   OS2                             (F)
              Queue type :   *LCL
                   Usage :   *TMQ
 
     Remote Queue
              Queue name :   OS2.REMOTEQ                     (D)
              Queue type :   *RMT
            Remote queue :   OS2.LOCALQ                      (E)
    Remote Queue Manager :   OS2                             (C)
      Transmission queue :   OS2                             (F)
 
     Sender Channel
            Channel Name :   AS400.OS2.SNA                   (G)
            Channel Type :   *SDR
          Transport type :   *LU62
         Connection name :   OS2CPIC                         (14)
      Transmission queue :   OS2                             (F)

WebSphere MQ for iSeries receiver-channel definitions using SNA

     Local Queue
              Queue name :   AS400.LOCALQ                    (B)
              Queue type :   *LCL
 
     Receiver Channel
            Channel Name :   OS2.AS400.SNA                   (I)
            Channel Type :   *RCVR
          Transport type :   *LU62

WebSphere MQ for iSeries sender-channel definitions using TCP

     Local Queue
              Queue name :   OS2                             (F)
              Queue type :   *LCL
                   Usage :   *TMQ
 
     Remote Queue
              Queue name :   OS2.REMOTEQ                     (D)
              Queue type :   *RMT
            Remote queue :   OS2.LOCALQ                      (E)
    Remote Queue Manager :   OS2                             (C)
      Transmission queue :   OS2                             (F)
 
     Sender Channel
            Channel Name :   AS400.OS2.TCP                   (H)
            Channel Type :   *SDR
          Transport type :   *TCP
         Connection name :   os2.tcpip.hostname
      Transmission queue :   OS2                             (F)

WebSphere MQ for iSeries receiver-channel definitions using TCP

     Local Queue
              Queue name :   AS400.LOCALQ                    (B)
              Queue type :   *LCL
 
     Receiver Channel
            Channel Name :   OS2.AS400.TCP                   (J)
            Channel Type :   *RCVR
          Transport type :   *TCP

Defining a queue


Type CRTMQMQ on the command line. 


+--------------------------------------------------------------------------------+
|                          Create MQM Queue (CRTMQMQ)                            |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Queue name . . . . . . . . . . .                                                |
|                                                                                |
|Queue type . . . . . . . . . . .                 *ALS, *LCL, *RMT               |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                        Bottom  |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|Parameter QNAME required.                                                       |
|                                                                                |
+--------------------------------------------------------------------------------+

Fill in the two fields of this panel and press Enter. This causes another panel to appear, with entry fields for the other parameters you have. Defaults can be taken for all other queue attributes.

Defining a channel

Type CRTMQMCHL on the command line. 


+--------------------------------------------------------------------------------+
|                        Create MQM Channel (CRTMQMCHL)                          |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Channel name . . . . . . . . . .                                                |
|Channel type . . . . . . . . . .                 *RCVR, *SDR, *SVR, *RQSTR      |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                        Bottom  |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|Parameter CHLNAME required.                                                     |
|                                                                                |
+--------------------------------------------------------------------------------+

Fill in the two fields of this panel and press Enter. Another panel is displayed on which you can specify the values for the other parameters given earlier. Defaults can be taken for all other channel attributes.


© IBM Corporation 2002. All Rights Reserved