Configuring MQSeries for VSE/ESA involves the following tasks:
Examples are given for connecting MQSeries for VSE/ESA and MQSeries for OS/2 Warp. If you wish connect to another WebSphere MQ platform use the appropriate set of values from the table in place of those for OS/2.
Refer to the sections Defining a local queue and Defining a remote queue for details of how to create queue definitions, and Defining a SNA LU 6.2 sender channel and Defining a SNA LU6.2 receiver channel for details of how to create channels.
Table 51. Configuration worksheet for MQSeries for VSE/ESA
ID | Parameter Name | Reference | Example Used | User Value |
---|---|---|---|---|
Definition for local node | ||||
(A) | Queue Manager Name |
| VSE |
|
(B) | Local queue name |
| VSE.LOCALQ |
|
Connection to MQSeries for OS/2 Warp
The values in this section of the table must match those used in the worksheet table for OS/2, 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 channel name |
| VSE.OS2.SNA |
|
(I) | Receiver channel name | (G) | OS2.VSE.SNA |
|
Connection to WebSphere MQ for Windows
The values in this section of the table must match those used in the worksheet table for Windows NT, 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 channel name |
| VSE.WINNT.SNA |
|
(I) | Receiver channel name | (G) | WINNT.VSE.SNA |
|
Connection to WebSphere MQ for AIX
The values in this section of the table must match those used in the worksheet table for AIX, 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 channel name |
| VSE.AIX.SNA |
|
(I) | Receiver channel name | (G) | AIX.VSE.SNA |
|
Connection to MQSeries for Compaq Tru64 UNIX
The values in this section of the table must match those used in the worksheet table for UNIX, 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.VSE.TCP |
|
(I) | Receiver channel name | (J) | VSE.DECUX.TCP |
|
Connection to WebSphere MQ for HP-UX
The values in this section of the table must match those used in the worksheet table for HP-UX, 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 channel name |
| VSE.HPUX.SNA |
|
(I) | Receiver channel name | (G) | HPUX.VSE.SNA |
|
Connection to MQSeries for AT&T GIS UNIX
The values in this section of the table must match those used in the worksheet table for GIS UNIX, 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 channel name |
| VSE.GIS.SNA |
|
(I) | Receiver channel name | (G) | GIS.VSE.SNA |
|
Connection to WebSphere MQ for Solaris
The values in this section of the table must match those used in the worksheet table for Solaris, 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 channel name |
| VSE.SOLARIS.SNA |
|
(I) | Receiver channel name | (G) | SOLARIS.VSE.SNA |
|
Connection to WebSphere MQ for iSeries
The values in this section of the table must match those used in the worksheet table for iSeries, as indicated. | ||||
(C) | Remote queue manager name |
| AS400 |
|
(D) | Remote queue name |
| AS400.REMOTEQ |
|
(E) | Queue name at remote system | (B) | AS400.LOCALQ |
|
(F) | Transmission queue name |
| AS400 |
|
(G) | Sender channel name |
| VSE.AS400.SNA |
|
(I) | Receiver channel name | (G) | AS400.VSE.SNA |
|
Connection to WebSphere MQ for z/OS without CICS
The values in this section of the table must match those used in the worksheet table for z/OS, 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 channel name |
| VSE.MVS.SNA |
|
(I) | Receiver channel name | (G) | MVS.VSE.SNA |
|
For TCP, the sender channel name (G) and the receiver channel name (I), in the preceding table, can be VSE.sys.tcp and sys.VSE.TCP respectively.
In both cases sys represents the remote system name, for example, OS2. Therefore, in this case, (G) becomes VSE.OS2.TCP and (I) becomes OS2.VSE.TCP.
Local Queue Object Type : L Object Name : OS2 (F) Usage Mode: T (Transmission) Remote Queue Object Type : R Object Name : OS2.REMOTEQ (D) Remote QUEUE Name : OS2.LOCALQ (E) Remote QM Name : OS2 (C) Transmission Name : OS2 (F) Sender Channel Channel name : VSE.OS2.SNA (G) Channel type : S (Sender) Transmission queue name : OS2 (F) Remote Task ID : MQTP Connection name : OS2 (6)
Local Queue Object type : QLOCAL Object Name : VSE.LOCALQ (B) Usage Mode : N (Normal) Receiver Channel Channel name : OS2.VSE.SNA (I) Channel type : R (Receiver)
+--------------------------------------------------------------------------------+
|08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
|19:50:25 *** Master Terminal Main Menu *** VSE1 |
|MQMMTP A004 |
| SYSTEM IS ACTIVE |
| |
| 1. Configuration |
| |
| 2. Operations |
| |
| 3. Monitoring |
| |
| 4. Browse Queue Records |
| |
| |
| Option: |
| |
| |
| |
| |
| |
| |
|Function completed - please enter a new request. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| CLEAR/PF3 = Exit ENTER=Select |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:52:21 *** Configuration Main Menu *** VSE1 |
| MQMMCFG A004 |
| SYSTEM IS ACTIVE |
| |
| Maintenance Options : |
| 1. Global System Definition |
| 2. Queue Definitions |
| 3. Channel Definitions |
| |
| |
| Display Options : |
| 4. Global System Definition |
| 5. Queue Definitions |
| 6. Channel Definitions |
| |
| |
| Option: |
| |
| |
| |
| Please enter one of the options listed. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| ENTER = Process PF2 = Main Menu PF3 = Quit |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:55:12 Queue Main Options VSE1 |
| MQMMQUE A004 |
| SYSTEM IS ACTIVE |
| |
| Default Q Manager : VSEP |
| |
| Object Type: L L=Local Q, R=Remote Q, AQ=Alias Queue, |
| AM=Alias Manager, |
| AR=Alias Reply Q |
| |
| Object Name: VSE.LOCALQ |
| |
| |
| |
| |
| |
| |
| |
| |
| ENTER NEEDED INFORMATION. |
| |
| PF2=Main Config PF3 = Quit PF4/ENTER = Read PF5 = Add PF6 = Update |
| PF9 = List PF11= Reorg. PF12= Delete |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:56:10 Queue Definition Record VSE1 |
| MQMMQUE QM - VSEP A004 |
| |
| LOCAL QUEUE DEFINITION |
| |
| Object Name. . . . . . . . : VSE.LOCALQ |
| Description line 1 . . . . : |
| Description line 2 . . . . : |
| |
| Put Enabled . . . . . . . : Y Y=Yes, N=No |
| Get Enabled . . . . . . . : Y Y=Yes, N=No |
| |
| Default Inbound status . . : A Outbound .. : A A=Active,I=Inactive |
| |
| Dual Update Queue . . . . .: |
| |
| |
| Automatic Reorganize (Y/N) : N |
| |
| Record being added - Press ADD key again. |
| |
| PF2=Main Config PF3 = Quit PF4/ENTER = Read PF5 = Add PF6 = Update |
| PF9 = List PF10= Queue PF11= Reorg. PF12= Delete |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:57:26 Queue Extended Definition VSE1 |
| MQMMQUE QM - VSEP A004 |
| Object Name. . . . . . . . : VSE.LOCALQ |
| Physical Queue Information |
| Usage Mode . . . . . . . . : N N=Normal, T=Transmission |
| Share Mode . . . . . . . . : Y Y=Yes, N=No |
| Physical File Name . . . . : ** FILE NOT DEFINED |
| Maximum Values |
| Maximum Q Depth. . . . . . : 01000000 Global Lock Entries . : 00001000 |
| Maximum Message Length . . : 01000000 Local Lock Entries. . : 00001000 |
| Maximum Concurrent Accesses: 00000100 Checkpoint Threshold : 1000 |
| |
| Trigger Information |
| Trigger Enable . . . . . . : N Y=yes, N=No |
| Trigger Type . . . . . . : F=First, E=Every |
| Maximum Trigger Starts . . : 0001 |
| Allow Restart of Trigger : N Y=Yes, N=No |
| Trans ID : Term ID: |
| Program ID : Channel Name: |
| |
| ***** File not found ***** |
| PF2=Main Config PF3 = Quit PF4/ENTER = Read PF5 = Add PF6 = Update |
| PF9 = List PF10= Queue PF11= Reorg. PF12= Delete |
+--------------------------------------------------------------------------------+
For a normal queue specify a Usage Mode of N.
+--------------------------------------------------------------------------------+
|08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
|19:50:25 *** Master Terminal Main Menu *** VSE1 |
|MQMMTP A004 |
| SYSTEM IS ACTIVE |
| |
| 1. Configuration |
| |
| 2. Operations |
| |
| 3. Monitoring |
| |
| 4. Browse Queue Records |
| |
| |
| Option: |
| |
| |
| |
| |
| |
| |
|Function completed - please enter a new request. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| CLEAR/PF3 = Exit ENTER=Select |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:52:21 *** Configuration Main Menu *** VSE1 |
| MQMMCFG A004 |
| SYSTEM IS ACTIVE |
| |
| Maintenance Options : |
| 1. Global System Definition |
| 2. Queue Definitions |
| 3. Channel Definitions |
| |
| |
| Display Options : |
| 4. Global System Definition |
| 5. Queue Definitions |
| 6. Channel Definitions |
| |
| |
| Option: |
| |
| |
| |
| Please enter one of the options listed. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| ENTER = Process PF2 = Main Menu PF3 = Quit |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:59:30 Queue Main Options VSE1 |
| MQMMQUE A004 |
| SYSTEM IS ACTIVE |
| |
| Default Q Manager : VSEP |
| |
| Object Type: R L=Local Q, R=Remote Q, AQ=Alias Queue, |
| AM=Alias Manager, |
| AR=Alias Reply Q |
| |
| Object Name: OS2.REMOTEQ |
| |
| |
| |
| |
| |
| |
| |
| |
| ENTER NEEDED INFORMATION. |
| |
| PF2=Main Config PF3 = Quit PF4/ENTER = Read PF5 = Add PF6 = Update |
| PF9 = List PF11= Reorg. PF12= Delete |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 20:00:25 Queue Definition Record VSE1 |
| MQMMQUE QM - VSEP A004 |
| |
| REMOTE QUEUE DEFINITION |
| |
| Object Name. . . . . . . . : OS2.REMOTEQ |
| Description line 1 . . . . : |
| Description line 2 . . . . : |
| |
| Put Enabled . . . . . . . : Y Y=Yes, N=No |
| Get Enabled . . . . . . . : Y Y=Yes, N=No |
| |
| |
| |
| Remote Queue Name . . . . .: OS2.LOCALQ |
| Remote QM Name. . . . . . .: OS2 |
| Transmission Q Name . . . .: OS2 |
| |
| |
| Record being added - Press ADD key again. |
| |
| PF2=Main Config PF3 = Quit PF4/ENTER = Read PF5 = Add PF6 = Update |
| PF9 = List PF10= Queue PF11= Reorg. PF12= Delete |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
|19:50:25 *** Master Terminal Main Menu *** VSE1 |
|MQMMTP A004 |
| SYSTEM IS ACTIVE |
| |
| 1. Configuration |
| |
| 2. Operations |
| |
| 3. Monitoring |
| |
| 4. Browse Queue Records |
| |
| |
| Option: |
| |
| |
| |
| |
| |
| |
|Function completed - please enter a new request. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| CLEAR/PF3 = Exit ENTER=Select |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:52:21 *** Configuration Main Menu *** VSE1 |
| MQMMCFG A004 |
| SYSTEM IS ACTIVE |
| |
| Maintenance Options : |
| 1. Global System Definition |
| 2. Queue Definitions |
| 3. Channel Definitions |
| |
| |
| Display Options : |
| 4. Global System Definition |
| 5. Queue Definitions |
| 6. Channel Definitions |
| |
| |
| Option: |
| |
| |
| |
| Please enter one of the options listed. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| ENTER = Process PF2 = Main Menu PF3 = Quit |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|10/08/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZR02 |
|14:05:20 Channel Record DISPLAY SYSA |
|MQMMCHN Last Check Point Last Update 19981006 SFCA |
|MSN 00000000 Time 11:28:28 Interv 000000 Create Date 19980616 |
|Name : RB01.DC01.SDRC.5006 |
|Protocol : L (L/T) Port : 0000 Type : R (S/R/C) |
|Partner : MA02 |
| |
| Allocation Retries Get Retries |
| Number of Retries: 00000000 Number of Retries : 00000000 |
| Delay Time - fast: 00000000 Delay Time : 00000005 |
| Delay Time - slow: 00000000 |
| |
| Max Messages per Batch : 000001 Max Transmission Size : 03200 |
| Message Sequence Wrap : 999999 Max Message Size : 0010240 |
| |
| Mess Seq Req(Y/N): Y Convers Cap (Y/N): Y Split Msg(Y/N): N |
| |
| Transmission Queue Name : |
| TP Name: |
| Checkpoint Values: Frequency: 0000 Time Span: 0000 |
| Enable(Y/N) Y Dead Letter Store(Y/N) Y |
|Channel record displayed. |
|PF2 =Menu PF3 =Quit PF4 =Read PF5 =Add PF6=Update PF9 =List PF12 =Delete |
+--------------------------------------------------------------------------------+
All other parameters can be entered as shown.
Note that the default value for sequence number wrap is 999999, whereas for Version 2 products, this value defaults to 999999999.
+--------------------------------------------------------------------------------+
|08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
|19:50:25 *** Master Terminal Main Menu *** VSE1 |
|MQMMTP A004 |
| SYSTEM IS ACTIVE |
| |
| 1. Configuration |
| |
| 2. Operations |
| |
| 3. Monitoring |
| |
| 4. Browse Queue Records |
| |
| |
| Option: |
| |
| |
| |
| |
| |
| |
|Function completed - please enter a new request. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| CLEAR/PF3 = Exit ENTER=Select |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| 08/18/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 19:52:21 *** Configuration Main Menu *** VSE1 |
| MQMMCFG A004 |
| SYSTEM IS ACTIVE |
| |
| Maintenance Options : |
| 1. Global System Definition |
| 2. Queue Definitions |
| 3. Channel Definitions |
| |
| |
| Display Options : |
| 4. Global System Definition |
| 5. Queue Definitions |
| 6. Channel Definitions |
| |
| |
| Option: |
| |
| |
| |
| Please enter one of the options listed. |
| 5686-A06 (C) Copyright IBM Corp. 1999 All Rights Reserved. |
| ENTER = Process PF2 = Main Menu PF3 = Quit |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|08/19/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
|07:29:03 Channel Record DISPLAY MCHN |
|MQMMCHN Last Check Point Last Update 19980805 A004 |
|MSN 00000149 Time 17:52:32 Interv 000000 Create Date 19980528 |
|Name : OS2.VSE.SNA |
|Protocol : L (L/T) Port : 0000 Type : R (S/R/C) |
|Partner : |
| |
| Allocation Retries Get Retries |
| Number of Retries: 00000000 Number of Retries : 00000000 |
| Delay Time - fast: 00000000 Delay Time : 00000000 |
| Delay Time - slow: 00000000 |
| |
| Max Messages per Batch : 000001 Max Transmission Size : 032000 |
| Message Sequence Wrap : 999999 Max Message Size : 008192 |
| |
| Mess Seq Req(Y/N): Y Convers Cap (Y/N): Y Split Msg(Y/N): N |
| |
| Transmission Queue Name : |
| TP Name: |
| Checkpoint Values: Frequency: 0000 Time Span: 0000 |
| Enable(Y/N) Y Dead Letter Store(Y/N) Y |
|Channel record displayed. |
|PF2 =Menu PF3 =Quit PF4 =Read PF5 =Add PF6=Update PF9 =List PF12 =Delete |
+--------------------------------------------------------------------------------+
All other parameters can be entered as shown.
To define a TCP/IP sender channel, carry out the following procedure:
Figure 119. Channel configuration panel
+-------------------------------------------------------------------------------------+
| 07/16/1998 IBM MQSeries for VSE/ESA Version 2.1.0 IYBPZS01 |
| 08:03:53 Channel Record DISPLAY MCHN |
| MQMMCHN Last Check Point Last Update 00000000 A005 |
| MSN 00000002 Time 07:10:22 Interv 000000 Create Date 19980528 |
| Name : SD01_TCP_VSEP |
| Protocol : T (L/T) Port : 1414 Type : S (S/R/C) |
| Partner : |
| |
| Allocation Retries Get Retries |
| Number of Retries: 00000000 Number of Retries : 00000000 |
| Delay Time - fast: 00000000 Delay Time : 00000000 |
| Delay Time - slow: 00000000 |
| |
| Max Messages per Batch : 000001 Max Transmission Size : 032000 |
| Message Sequence Wrap : 999999 Max Message Size : 008192 |
| |
| Mess Seq Req(Y/N): Y Convers Cap (Y/N): Y Split Mssg(Y/N): N |
| |
| Transmission Queue Name : |
| TP Name: |
| Checkpoint Values: Frequency: 0000 Time Span: 0000 |
| Enable(Y/N) Y Dead Letter Store(Y/N) N |
| Channel record displayed. |
| PF2 =Menu PF3 =Quit PF4 =Read PF5 =Add PF6=Update PF9 =List PF12 =Delete |
+-------------------------------------------------------------------------------------+
Notes:
To define a TCP receiver channel, carry out the following procedure:
Notes: