Accessing client-connection channel definitions

Make the client channel definition table (CCDT) available to client applications by copying or sharing it, then specify its location and name on the client computer.

Before you begin

You have defined the client-connection channels you need.

On z/OS®, you have created a CCDT. On other platforms, the CCDT is automatically created and updated.

About this task

For a client application to use the client channel definition table (CCDT), you must make the CCDT available to it and specify its location and name

Procedure

  1. Make the CCDT available to the client applications in one of three ways:
    1. Optional: Copy the CCDT to the client computer.
    2. Optional: Copy the CCDT to a location shared by more than one client.
    3. Optional: Leave the CCDT on the server but make it shareable by the client.
    Whichever location you choose for the CCDT, the location must be secure to prevent unauthorized changes to the channels.
  2. On the client, specify the location and name of the file containing the CCDT in one of three ways:
    1. Optional: Use the CHANNELS stanza of the client configuration file. For more information, see CHANNELS stanza of the client configuration file.
    2. Optional: Use the environment variables MQCHLLIB and MQCHLTAB.
      For example, you can set the environment variables by typing:
      • On HP Integrity NonStop Server, and UNIX and Linux® systems: 
        
export MQCHLLIB= MQ_INSTALLATION_PATH/qmgrs/ QUEUEMANAGERNAME /@ipcc
export MQCHLTAB=AMQCLCHL.TAB
      • [IBMi]On IBM® i: 
        
ADDENVVAR ENVVAR(MQCHLLIB) VALUE('/QIBM/UserData/mqm/qmgrs/QUEUEMANAGERNAME/@ipcc')
ADDENVVAR ENVVAR(MQCHLTAB) VALUE(AMQCLCHL.TAB)

      where MQ_INSTALLATION_PATH represents the high-level directory in which IBM MQ is installed.

    3. Optional: On Windows only, use the setmqscp control command to publish the client-connection channel definitions in Active Directory
    If the MQSERVER environment variable is set, an IBM MQ client uses the client-connection channel definition specified by MQSERVER in preference to any definitions in the client channel definition table.