dmpmqcfg (dump queue manager configuration)

Dump the configuration of a queue manager.

Purpose

You can use the dmpmqcfg command to dump the configuration of a queue manager.

Syntax

Parameters

-c string

Specifies that a client mode connection is used to connect to the queue manager.

string can take one of the following values:

default: Specifies that the default client connection process is used.
"DEFINE CHANNEL(chlname) CHLTYPE(CLNTCONN) CONNAME('connname')": Specifies that the specific client channel specified by chlname is used to connect to the queue manager at connname.; connname specifies the location of the queue manager in the following format host(portnumber)

If -c is omitted, the command connects to the queue manager by using server bindings. If that connection fails, client bindings are used.

-x filter

Specifies that the procedure is filtered.

filter can be one of the following values:

object
authority records
channel authentication
subscriptions
all

The default value is all.

-a

Specifies that object definitions show all attributes.

The default is to return only attributes that differ from the defaults for the object type.

-s SeqNumber

Specifies that the channel sequence number for sender, server, and cluster sender channel types is reset to the value specified.

SeqNumber must be in the range 1 - 999999999.

-z

Specifies that the command runs in silent mode.

All warnings, such as those that appear when attributes from a queue manager of a higher command level are inquired, are suppressed.

-n objectNames

Specifies that the definitions produced by object or profile name are filtered.

The object or profile name can contain a single asterisk. The * option can be placed only at the end of the entered filter string.

-t objectType

Specifies a single type of object to export.

objectType can be one of the following values:

all: All object types.
authinfo: An authentication information object.
channel: A channel (including MQTT channel type).
comminfo: A communications information object.
listener: A listener.
namelist: A namelist.
process: A process.
queue: A queue.
qmgr: A queue manager.
service: A service.
topic: A topic.

The default value is all.

-o outputType

Specifies the type of output for the command.

outputType can be one of the following values:

mqsc: Multi-line MQSC that can be used as direct input to runmqsc
1line: MQSC with all attributes on a single line for line diffing
setmqaut: setmqaut statements; valid only when -x authrec is specified
grtmqaut: Generates IBM i syntax for granting access to the objects.

The default value is mqsc.

-u userID

If a userID is specified, a password is requested.

-q

Specifies the name of the reply-to queue used when configuration information is retrieved.

-r

Specifies the name of the remote queue manager/transmit queue when queued mode is used.

If this parameter is omitted, the configuration for the directly connected queue manager (specified with the -m parameter) is dumped.

-m

Specifies the name of the queue manager to connect to.

The default value is the default queue manager.

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.
If any object is not at the default value, the -a option must be used if the dumped configuration is used to restore the configuration.
The dmpmqcfg command dumps only subscriptions of type MQSUBTYPE_ADMIN, that is, only subscriptions that are created by using the MQSC command DEFINE SUB or its PCF equivalent. The output from dmpmqcfg is a runmqsc command to enable the administration subscription to be re-created. Subscriptions that are created by applications by using the MQSUB MQI call of type MQSUBTYPE_API are not part of the queue manager configuration, even if durable, and so are not dumped by dmpmqcfg.
The user must have MQZAO_OUTPUT (+put) authority to access the command input queue (SYSTEM.ADMIN.COMMAND.QUEUE) and MQZAO_DISPLAY (+dsp) authority to access the default model queue (SYSTEM.DEFAULT.MODEL.QUEUE), to be able to create a temporary dynamic queue if the default reply queue is used. The user must also have MQZAO_CONNECT (+connect) and MQZAO_INQUIRE (+inq) authority for the queue manager, and MQZAO_DISPLAY (+dsp) authority for every object that is requested.
For more information about this command in IBM MQ, see dmpmqcfg in the IBM MQ documentation.

Examples

The following command dumps the queue manager configuration for a queue manager QM1:
```
dmpmqcfg -m QM1
```