mqchl2ini - Convert an MQSeries client channel table file to a text stanza format
mqchl2ini inputfile outputfile
mqchl2ini will read an MQSeries client channel table file, of version 4 (MQSeries 5.0), 6 (MQSeries 5.1 and later) or 7 (MQSeries 5.3 and later), and convert it to a text file written with a stanza format similar to the various "*.ini" files used with MQSeries (eg. mqs.ini, qm.ini, etc).
This file is intended to bootstrap the process of using the partner utility, mqini2chl, to maintain channel table files without using a queue manager. In other words, this utility will typically be run once, against an existing chanenl table file, then the relationship reversed. The text file will be use as the master source, and the channel table derived from it.
The output format is kept as compact as possible. The first entry written into the text file will always be SYSTEM.DEF.CLNTCONN, which should always be found in any channel table file. Keys will be omitted if the values are strings, and empty.
For each additional CLNTCONN definition found in the channel table file, another stanza is written, with the primary key being the ChannelName, and the stanza consisting of all of the keys which differ from the SYSTEM.DEF.CLNTCONN definition. Thus, if a security exit, for example, is defined for the SYSTEM.DEF.CLNTCONN, then any CLNTCONN definition which has the same SecurityExit defined will not have the key defined in its stanza.
The following sample output shows how the authors channel table file gets converted to text:
# # Written by mqchl2ini on Thu Mar 22 15:04:17 2001 # SYSTEM.DEF.CLNTCONN: TransportType=TCP MaxMsgLength=4194304 SNP1: ChannelDesc=Client Connection to SNP1 QMgrName=SNP1 SecurityExit=/ms/dist/mq/exits/libkrb5exit.so(exitFunc) SecurityUserData=2, unix ConnectionName=snsmq1(16672) SAT98: ChannelDesc=Client Connection to SAT98 QMgrName=SAT98 SecurityExit=/ms/dist/mq/exits/libkrb5exit.so(exitFunc) SecurityUserData=0, unix ConnectionName=sasmq4(25025)