dmpmqlog (dump MQ formatted log)

Display and format a portion of the IBM MQ system log.


Purpose

Use the dmpmqlog command to dump a formatted version of the IBM 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

dmpmqlog   -b   -s StartLSN  -n ExtentNumber  -e EndLSN  -f LogFilePath  -m QMgrName


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 called active. The active subdirectory must contain the log files. By default, log files are assumed to be in the directories specified in the IBM MQ configuration information. If we use this option, queue names associated with queue identifiers are shown in the dump only if we 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.