Add Queue Manager Journal (ADDMQMJRN)

Where allowed to run

All environments (*ALL)

Threadsafe

Yes

The Add Queue Manager Journals command (ADDMQMJRN) adds a journal to a queue manager. This command can be used, for example, to configure remote journal replication for a backup or multi-instance queue manager.

Parameters

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager associated with the journal.

queue-manager-name

Specify the name of the queue manager. The name can contain up to 48 characters. The maximum number of characters is reduced if the system is using a double byte character set (DBCS).

Queue Manager Journal (JRN)

Specifies the journal name to create.

The possible values are:

*DFT

The journal name is chosen by the system. If a local journal already exists for the queue manager on this system - the existing local journal name is used, otherwise a unique name is generated of the format AMQxJRN where x is a character in the range 'A - Z'.

journal-name

Specify the name of the journal. The name can contain up to 10 characters. Journal receiver names will be derived from this journal name by truncating at the 4th character (or at the last character if the journal name is shorter than 4 characters) and appending zeroes. If the local queue manager library already contains a local journal, its name must match that supplied. Only one local journal can exist in a queue manager library. DLTMQM will not remove journal artifacts from a queue manager library unless they are prefixed with "AMQ".

Remote Relational Database (RMTJRNRDB)

Specifies the name of the relational database directory entry that contains the remote location name of the target system. Use the WRKRDBDIRE command to locate and existing entry or configure a new relational database directory entry for the target system.

relational-database-directory-entry

Specify the name of the relational database directory entry. The name can contain up to 18 characters.

Remote Journal Status (RMTJRNSTS)

Specifies whether the remote journal is ready to receive journal entries from the queue managers local journal.

The possible values are:

*ACTIVE

The remote journal is ready to receive journal entries from the local queue manager journal. Replication of journal entries starts with the oldest local journal receiver required to perform a full media recovery and queue manager restart. If these recovery points do not exist, replication starts with the currently attached local journal receiver.

*INACTIVE

The remote journal is not ready to receive journal entries from the local queue manager journal.

Remote Journal Delivery (RMTJRNDLV)

Specifies whether the journal entries are replicated synchronously or asynchronously when the remote journal is activated. Note that this parameter is ignored when RMTJRNSTS(*INACTIVE) is specified.

The possible values are:

*SYNC

The remote journal is replicated synchronously with the local queue manager journal.

*ASYNC

The remote journal is replicated asynchronously with the local queue manager journal.

Remote Journal Sync. Timeout (RMTJRNTIMO)

Specifies the maximum amount of time in seconds to wait for a response from the remote system when using synchronous replication with remote journaling. If a response is not received from the remote system within the timeout period, the remote journal environment will automatically be deactivated. Note that this parameter is ignored when RMTJRNDLV(*ASYNC) or RMTJRNSTS(*INACTIVE) are specified.

The possible values are:

*DFT

The system uses the default value of 60 seconds to wait for a response from the remote system.

1-3600

Specify the maximum number of seconds to wait for a response from the remote system. Note that this option is only available on IBM i V6R1M0 and later operating systems.

Examples

None

Error messages

Unknown