client channel definition table, creating a client channel definition file, WebSphere MQ utility program (CSQUTIL)" />
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/@ipccNote 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=6144If you use FTP to copy the file, remember to type
bin to set binary mode; do not use the default ASCII mode.
Home