Web addressable access to the client channel definition table
From IBM® MQ 9.0, the product provides the ability to locate a client channel definition table (CCDT) through a URL, either by programming using MQCNO, using environment variables, or using mqclient.ini file stanzas.
IBM MQ supports retrieving a CCDT from a file, ftp, or http URL.
The environment variable MQCCDTURL allows you to provide a file, ftp, or http URL as a single value from which a client channel definition table can be obtained.
You can also use MQCHLLIB (or that specified by ChannelDefinitionDirectory under the CHANNELS stanza of the client configuration file) to locate a CCDT file, either through file, ftp, or http URL, in addition to the existing local file system directory, that is, /var/mqm).
Note that an MQCHLLIB value is a directory stem and works in combination with MQCHLTAB to derive the fully qualified URL.
- Authenticated connections
-
export MQCHLLIB=ftp://myuser:password@myhost.sample.com/var/mqm/qmgrs/QMGR/@ipcc export MQCHLLIB=http://myuser:password@myhost.sample.com/var/mqm/qmgrs/QMGR/@ipcc
- Unauthenticated connections
-
export MQCHLLIB=ftp://myhost.sample.com/var/mqm/qmgrs/QMGR/@ipcc export MQCHLLIB=http://myhost.sample.com/var/mqm/qmgrs/QMGR/@ipcc export MQCHLLIB=file:///var/mqm/qmgrs/QMGR/@ipcc
- MQCD provided by ClientConnOffset and ClientConnPtr in MQCNO.
- URL provided by CCDTUrlOffset and CCDTUrlPtr in MQCNO.
- MQSERVER environment variable.
- If an mqclient.ini file is defined and contains a ServerConnectionParms then the channel that it defines is used. For more information, see IBM MQ MQI client configuration file, mqclient.ini and CHANNELS stanza of the client configuration file.
- MQCCDTURL environment variable.
- MQCHLLIB and MQCHLTAB environment variable.
- ChannelDefinitionDirectory in the CHANNELS stanza of the client configuration file.
Attempting to open a CCDT file for write access, for example when using the runmqsc DEFINE CHANNEL command from a client, returns an error message indicating that the file could not be opened for write access.
It is, however, possible to read channel and authentication information definitions using runmqsc.