mqrc (display return code and AMQ message information)

Display information about return codes and AMQ messages.

Purpose

We can use the mqrc command to display information about symbols, return codes, and AMQ messages. We can specify a range of return codes or AMQ messages, as well as specifying specific return codes or AMQ messages.

Numeric arguments are interpreted as decimal if they start with a digit 1 - 9, or hex if prefixed with 0x.

Syntax

Notes:

¹ If there is a problem with a message within a range, an indication is displayed before the message text. ? is displayed if there are no matching return codes for the message. ! is displayed if the message severity is different to the return code severity.

Parameters

returnCode

The return code to display

AMQmessage

The AMQ message to display

symbol

The symbol to display

-a

Try all severities to find message text

-b

Display messages without extended information

-f first

First number in a range

-l last

Last number in a range

-m AMQmessage

The AMQ message to list

-M

Display AMQ messages in a range

-r returnCode

The return code to display

-R

Display all return codes. If used with the -f and -l parameters, -R displays the return codes within a range.

-s symbol

The symbol to display

-

If a - is given as a trailing parameter, it indicates that further input will come from stdin.

-d language

Display the message in the specified language, for example, Fr_FR.

-i format

Determine the message to display from a message in the specified format, which must be one of the following:

text: The textual format of the QMErrorLog service, including the Insert attributes.
json: JSON format diagnostic messages, specified in UTF-8.

-o format

Display the message in the specified format, which must be one of the following:

mqrc: The format used by mqrc in previous versions of the product.
text: The textual format of the QMErrorLog service.
json: The JSON format, described in JSON format diagnostic messages.

-p

Display the message explanation only. For example:

mqrc -p AMQ8118

displays

The queue manager insert_5 does not exist.

-u

Display the user response only. For example:

mqrc -u AMQ8118

displays

Either create the queue manager (crtmqm command) or correct the queue manager name used in the command 
and then try the command again.

-x

Display extended message information, including the message severity. For example, the following message has an error (E) severity of 30:

mqrc -x AMQ8118
536903960  0x20008118  E  30  urcMS_MQCONN_FAILED
536903960  0x20008118  E  30  zrc_CSPRC_Q_MGR_DOES_NOT_EXIST


MESSAGE:
IBM MQ queue manager does not exist.

EXPLANATION:
The queue manager <insert three> does not exist.

ACTION:
Either create the queue manager (crtmqm command) or correct the queue manager name used in the command 
and then try the command again.

Examples

This command displays AMQ message 5005:
```
mqrc AMQ5005
```
This command displays return codes in the range 2505 - 2530:
```
mqrc -R -f 2505 -l 2530
```
Running the following command, where AMQERR01.json contains JSON formatted messages in any language, converts all messages into US English in the original textual QMErrorLog format:
```
cat AMQERR01.json | mqrc -d En_US -i json -o text -
```
Alternatively, you could take AMQERR01.LOG and convert it to JSON:
```
cat AMQERR01.LOG | mqrc -i text -o json -
```
Running the following command, where AMQERR01.LOG contains text formatted messages in any language, converts messages into US English:
```
cat AMQERR01.LOG | mqrc -d En_US -i text -o text -
```