addmqinf (add configuration information)

Add IBM MQ configuration information on UNIX and Windows only.

Purpose

For example, use dspmqinf to display and addmqinf to copy configuration data from the system where a queue manager was created, to other systems where the same multi-instance queue manager is also to be started.

Syntax

Required parameters

-v Attribute = Value

The name and value of the stanza attributes to be placed in the stanza specified in the command.

Table 1 lists the QueueManager stanza attribute values. The queue manager stanza is the only stanza that is currently supported.

Attribute	Value	Required or optional
Name	The name of the queue manager. We must provide a different name from any other queue manager stanza on the system.	Required
Prefix	The directory path under which this queue manager data directory is stored by default. We can use Prefix to modify the location of the queue manager data directories. The value of Directory is automatically appended to this path.	Required
Directory	The name of the queue manager data directory. Sometimes the name must be provided (as in Example ), because it is different from the queue manager name. Copy the directory name from the value returned by dspmqinf. The rules for transforming queue manager names into directory names are described in Understand IBM MQ file names.	Required
DataPath	The directory path where the queue manager data files are placed. The value of Directory is not automatically appended to this path and we must provide the transformed queue manager name as part of DataPath. If the DataPath attribute is omitted on UNIX, the queue manager data directory path is defined as Prefix / Directory .	On UNIX: Optional On Windows: Required
EphemeralPrefix	Specifies the path to the directory, within which the queue manager ephemeral data is kept, such as IPC sockets. If the EphemeralPrefix attribute is omitted, the queue manager ephemeral prefix is defined as Prefix.	Optional

Optional parameters

-s StanzaType

A stanza of the type StanzaType is added to the IBM MQ configuration.

The default value of StanzaType is QueueManager.

The only supported value of StanzaType is QueueManager.

Return codes

Example

addmqinf -v DataPath=/MQHA/qmgrs/QM!NAME +
  -v Prefix=/var/mqm  +
  -v Directory=QM!NAME  +
  -v Name=QM.NAME

QueueManager: 
   Name=QM.NAME
   Prefix=/var/mqm
   Directory=QM!NAME  
   DataPath=/MQHA/qmgrs/QM!NAME

Usage notes

To use this command we must be an IBM MQ administrator and a member of the mqm group.

Related commands