Home

 

Client channel definition table

On platforms other than z/OS, the client-connection channel definition described previously is stored in the client channel definition table associated with the queue manager running on the server. The file containing the table is called AMQCLCHL.TAB and is a binary file that cannot be edited directly. We can use the DEFINE CHANNEL command to add a client connection channel to the table, and the ALTER CHANNEL command to alter the attributes of a channel that already has an entry in the table.

Do not delete AMQCLCHL.TAB. It contains default channel definitions that are required when you define a channel. If you suspect that this has been deleted, for example you get error messages when you try to define a new channel, check to see that the file exists.

If you install WebSphere MQ in the default location, AMQCLCHL.TAB is located in the following directory on a server machine:

• On i5/OS, in the Integrated File System (IFS):

  /QIBM/UserData/mqm/qmgrs/QUEUEMANAGERNAME/&ipcc

• On UNIX systems:

  /mqmtop/qmgrs/QUEUEMANAGERNAME/@ipcc

  Note that the name of the directory referred to by QUEUEMANAGERNAME is case sensitive on UNIX systems.

• On Windows, the location of this file defaults to:

  C:\\IBM\WebSphere MQ\qmgrs\QUEUEMANAGERNAME\@ipcc

On z/OS, client-connection channel definitions are stored with WebSphere MQ objects in page set zero. They are not stored in a file that can be accessed from a client machine, nor can they be copied directly to a client machine. Instead, use the MAKECLNT parameter of the COMMAND function of the WebSphere MQ utility program, CSQUTIL, to generate a file that contains a client channel definition table. We can then download this file to a client machine using a file transfer program. For details, see the WebSphere MQ for z/OS System Administration Guide.

Here is some sample JCL for making a client channel definition file:

//CLIENT    EXEC  PGM=CSQUTIL,PARM='QM2'
//STEPLIB   DD   DISP=SHR,DSN=thlqual.SCSQANLE
//          DD   DISP=SHR,DSN=thlqual.SCSQAUTH
//OUTCLNT   DD   DISP=OLD,DSN=MY.CLIENTS
//SYSPRINT  DD SYSOUT=*
//SYSIN     DD *
COMMAND DDNAME(CMDCHL) MAKECLNT(OUTCLNT) CCSID(437)
/*
//CMDCHL    DD *
DISPLAY CHANNEL(*) ALL TYPE(CLNTCONN)
DISPLAY AUTHINFO (*) ALL
/*

where

thlqual is a high level qualifier for the WebSphere MQ library data sets. The data set for the client channel definition file, identified by the DD name

OUTCLNT in the sample JCL, must have the format:

RECFM=U, LRECL=6144, BLKSIZE=6144

If you use FTP to copy the file, remember to type

bin to set binary mode; do not use the default ASCII mode.

 

Home