The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
MQSeries-1.30
River stage one • 1 direct dependent • 1 total dependent
1 ++
/ mqchl2ini

NAME

mqchl2ini - Convert an MQSeries client channel table file to a text stanza format

SYNOPSIS

mqchl2ini inputfile outputfile

DESCRIPTION

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.

EXAMPLES

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)

SEE ALSO

mqini2chl(8), MQSeries::Config::ChannelTable(3)