dmpmqlog
Display and format a portion of the WebSphere MQ system log.
Purpose
Use the dmpmqlog command to dump a formatted version of the WebSphere® MQ system log to standard out.
The log to be dumped must have been created on the same type of operating system as that being used to issue the command.
Syntax
Optional parameters
- Dump start point
- Use one of the following parameters to specify the log sequence
number (LSN) at which the dump should start. If you omit this, dumping
starts by default from the LSN of the first record in the active portion
of the log.
-b
- Start dumping from the base LSN. The base LSN identifies the start of the log extent that contains the start of the active portion of the log.
-s
StartLSN
- Start dumping from the specified LSN. The LSN is specified in
the format
nnnn:nnnn:nnnn:nnnn
.If you are using a circular log, the LSN value must be equal to or greater than the base LSN value of the log.
-n
ExtentNumber
- Start dumping from the specified extent number. The extent number
must be in the range 0 - 9999999.
This parameter is valid only for queue managers using linear logging.
-e
EndLSN
- End dumping at the specified LSN. The LSN is specified in the
format
nnnn:nnnn:nnnn:nnnn
. -f
LogFilePath
- The absolute (rather than relative) directory path name to the
log files. The specified directory must contain the log header file
(
amqhlctl.lfh
) and a subdirectory calledactive
. The active subdirectory must contain the log files. By default, log files are assumed to be in the directories specified in the WebSphere MQ configuration information. If you use this option, queue names associated with queue identifiers are shown in the dump only if you use the -m option to name a queue manager name that has the object catalog file in its directory path.On a system that supports long file names this file is called qmqmobjcat and, to map the queue identifiers to queue names, it must be the file used when the log files were created. For example, for a queue manager named qm1, the object catalog file is located in the directory
..\qmgrs\qm1\qmanager\
. To achieve this mapping, you might need to create a temporary queue manager, for example named tmpq, replace its object catalog with the one associated with the specific log files, and then start dmpmqlog, specifying-m tmpq
and-f
with the absolute directory path name to the log files. -m
QMgrName
- The name of the queue manager. If you omit this parameter, the
name of the default queue manager is used. Note: Do not dump the log while the queue manager is running, and do not start the queue manager while dmpmqlog is running.