Creating a channel

To create a new channel:

1. Use F6 from the Work with MQM Channels panel (the second panel that displays channel details).

   Alternatively, use the CRTMQMCHL command from the command line.

   Either way, this displays the Create Channel panel. Type:

   • The name of the channel in the field provided
   • The channel type for this end of the link
2. Press Enter.

Note:

You are strongly recommended to name all the channels in your network uniquely. As shown in Table 1, including the source and target queue manager names in the channel name is a good way to do this.

Your entries are validated and errors are reported immediately. Correct any errors and continue.

You are presented with the appropriate channel settings panel for the type of channel you have chosen. Fill in the fields with the information you have gathered previously. Press Enter to create the channel.

You are provided with help in deciding on the content of the various fields in the descriptions of the channel definition panels in the help panels, and in Chapter 6, Channel attributes.

Figure 98. Create channel (1)

+--------------------------------------------------------------------------------+
|                        Create MQM Channel (CRTMQMCHL)                          |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Channel name . . . . . . . . . . > CHANNAME________________                     |
|Channel type . . . . . . . . . . > *SDR__        *RCVR, *SDR, *SVR, *RQSTR...   |
|Message Queue Manager name         *DFT__________________________________       |
|_____                                                                           |
|Replace  . . . . . . . . . . . .   *NO_          *NO, *YES                      |
|Transport type . . . . . . . . .   *TCP____      *LU62, *TCP, *SYSDFTCHL        |
|Text 'description' . . . . . . . > 'Example Channel Definition'_______________  |
|___________________________________                                             |
|Connection name  . . . . . . . .   *SYSDFTCHL_________________________________  |
|______________________________________________________________________________  |
|______________________________________________________________________________  |
|______________________________________________________________________________  |
|______________________________________________________________________________  |
|______________________________________________________________________________  |
|__________________________________________________                              |
|                                                                       More...  |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|                                                                                |
+--------------------------------------------------------------------------------+

Figure 99. Create channel (2)

+--------------------------------------------------------------------------------+
|                         Create MQM Channel (CRTMQMCHL)                         |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Transmission queue . . . . . . .   'TRANSMISSION_QUEUE_NAME'__________________  |
|__________________                                                              |
|Message channel agent  . . . . .   *NONE______   Name, *SYSDFTCHL, *NONE        |
|  Library  . . . . . . . . . . .    __________   Name                           |
|Message channel agent user ID  .   *SYSDFTCHL__  Character value...             |
|Coded Character Set Identifier     *SYSDFTCHL__  0-9999, *SYSDFTCHL             |
|Batch size . . . . . . . . . . .   50_________   1-9999, *SYSDFTCHL             |
|Disconnect interval  . . . . . .   6000_______   1-999999, *SYSDFTCHL           |
|Short retry interval . . . . . .   60_________   0-999999999, *SYSDFTCHL        |
|Short retry count  . . . . . . .   10_________   0-999999999, *SYSDFTCHL        |
|Long retry interval  . . . . . .   1200_______   0-999999999, *SYSDFTCHL        |
|Long retry count . . . . . . . .   999999999__   0-999999999, *SYSDFTCHL        |
|Security exit  . . . . . . . . .   *NONE_____    Name, *SYSDFTCHL, *NONE        |
|  Library  . . . . . . . . . . .    __________   Name                           |
|Security exit user data  . . . .   *SYSDFTCHL______________________             |
|                                                                                |
|                                                                       More...  |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|                                                                                |
+--------------------------------------------------------------------------------+

Figure 100. Create channel (3)

+--------------------------------------------------------------------------------+
|                        Create MQM Channel (CRTMQMCHL)                          |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Send exit  . . . . . . . . . . .   *NONE______   Name, *SYSDFTCHL, *NONE        |
|  Library  . . . . . . . . . . .    ___________  Name                           |
|               + for more values     __________                                 |
|Send exit user data  . . . . . .   ________________________________             |
|               + for more values   ________________________________             |
|Receive exit . . . . . . . . . .   *NONE_____    Name, *SYSDFTCHL, *NONE        |
|  Library  . . . . . . . . . . .    __________   Name                           |
|               + for more values   __________                                   |
|                                    __________                                  |
|Receive exit user data . . . . .   ________________________________             |
|               + for more values   ________________________________             |
|Message exit . . . . . . . . . .   *NONE_____    Name, *SYSDFTCHL, *NONE        |
|  Library  . . . . . . . . . . .    __________   Name                           |
|               + for more values   __________                                   |
|                                    __________                                  |
|                                                                       More...  |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|                                                                                |
+--------------------------------------------------------------------------------+

Figure 101. Create channel (4)

+--------------------------------------------------------------------------------+
|                        Create MQM Channel (CRTMQMCHL)                          |
|                                                                                |
|Type choices, press Enter.                                                      |
|                                                                                |
|Message exit user data . . . . .   ________________________________             |
|               + for more values   _____________________________                |
|Convert message  . . . . . . . .   *SYSDFTCHL_   *YES, *NO, *SYSDFTCHL          |
|Sequence number wrap . . . . . .   999999999__   100-999999999, *SYSDFTCHL      |
|Maximum message length . . . . .   4194304____   0-4194304, *SYSDFTCHL          |
|Heartbeat interval . . . . . . .   300________   0-999999999, *SYSDFTCHL        |
|Non Persistent Message Speed . .   *FAST_____    *FAST, *NORMAL, *SYSDFTCHL     |
|Password . . . . . . . . . . . .   *SYSDFTCHL_   Character value, *BLANK...     |
|Task User Profile  . . . . . . .   *SYSDFTCHL_   Character value, *BLANK...     |
|Transaction Program Name . . . .   *SYSDFTCHL                                   |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                       Bottom   |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
|F24=More keys                                                                   |
|                                                                                |
+--------------------------------------------------------------------------------+