dspmqerr (display mq error log)

Displays the IBM® MQ error log files.

Purpose

You can use the dspmqerr command to view or list the IBM MQ error log files.

You can view a list of the files available, then repeat the command specifying a file name to view a specific file. If you specify neither the list argument nor a file name, you can view the default file of the specified type.

The command is based on the UNIX less command. The less command provides controls for navigating the contents of a file, and you can use these controls when viewing system error logs.

Syntax

Parameters

-f: Specifies that the file type to return is FDC.
-s: Specifies that the file type to return is system-wide error log.
-m QMgrName: Specifies that the file type to return is the log or logs for the specified queue manager
-w: Specifies that the file type to return is an IBM MQ Console log.
-l: Lists the files available.
filename: Specifies the particular file to view.

Usage notes

This command must be run from the IBM MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.

Examples

The following commands all display the system error log:
```
dspmqerr
dspmqerr -s
dspmqerr MQSystem.log
```
The following command lists all the error logs on the appliance (but not FDC files):
```
dspmqerr -l
```
The following command lists all the FDC files:
```
dspmqerr -f -l
```
The following command lists all the IBM MQ Console files:
```
dspmqerr -w -l
```
The following command lists all the log files for the queue manager QM1:
```
dspmqerr -m QM1 -l
```
The following command lists the first log file in the log file directory for the queue manager QM1:
```
dspmqerr -m QM1
```
The following command lists the log file for the queue manager QM1 named AMQERR02.LOG:
```
dspmqerr -m QM1 AMQERR02.LOG
```
The following command displays the FDC file named AMQ12345.FDC:
```
dspmqerr -f AMQ12345.FDC
```
The following command displays the IBM MQ Console file named messages.log:
```
dspmqerr -w messages.log
```