MQ Batch Toolkit

Chapter 2 Configuring the Property files

Configuring the Property files

MQ Batch Toolkit contains 2 property files: .MQBT.properties and log4j.properties

.MQBT.properties

The .MQBT.properties file contains global parameters for MQ Batch Toolkit. The .MQBT.properties file can also support parameters for specific MQ Batch Toolkit functions (i.e. QList). If a function specific section if included in the .MQBT.properties then those parameter values will be used rather than the global parameters.

Note: A user can override either the global or function specific values by specifying parameters on the command prompt.

Sample .MQBT.properties file

[Defaults]
CommProfileDirectory=c:\CommProfileDB.properties
License=0000AAAA0000AAAA
[QList]
CommProfileDirectory=d:\test\CommProfileDB.properties

Global Parameters:

MQ Batch Toolkit currently supports 3 global parameters: CommProfileDirectory and License.

CommProfileDirectory

This parameter contains the full path and filename of a Queue Manager Access Profile file. i.e. c:\test\CommProfileDB.properties

License

This parameter contains the license key for a registered user of MQ Batch Toolkit.

QueuePrefix

This parameter is used when create temporary dynamic queue on a z/OS queue manager. The default value is 'CSQ'.

log4j.properties

The log4j.properties file contains parameters related to MQ Batch Toolkit's use og Log4J. The default install of MQ Batch Toolkit cantains a log4j.properties file that write a full log record to the log\mqbt.log file plus a partial log record is written to the console (screen / terminal).

Sample log4j.properties file

#
# Use two appenders to write to a file and the console
#
log4j.rootCategory=DEBUG, LF, stdout
#
# Use one appender to write to a file only
#
##log4j.rootCategory=DEBUG, LF
#
# File appender
#
log4j.appender.LF=org.apache.log4j.RollingFileAppender
log4j.appender.LF.File=log/mqbt.log
log4j.appender.LF.MaxFileSize=1000KB
log4j.appender.LF.MaxBackupIndex=9
log4j.appender.LF.layout=org.apache.log4j.PatternLayout
log4j.appender.LF.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p - %m%n
#
# stdout
#
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern%d{yyyy-MM-dd HH:mm:ss} %-5p - %m%n

If the user does not want the logging information to be displayed on the console then update the log4j.rootCategory parameter to be as follows:

log4j.rootCategory=DEBUG, LF

All Log4J output (regardless of the stdout setting) is written to the MQ Batch Toolkit log file. The location and the name of the log file is controlled by the log4j.appender.LF.File property field. The default value for log4j.appender.LF.File is log/mqbt.log

On Windows, this means that if the user installed MQ Batch Toolkit in the default directory of
C:\Capitalware\MQBT
then the absolute path to the log file would be
C:\Capitalware\MQBT\log\mqbt.log