[IBM i]

CPYMQMNL (Copy MQ Namelist)

Where allowed to run
All environments (*ALL)
Threadsafe
Yes

The Copy MQ Namelist (CPYMQMNL) command copies an MQ namelist.

Parameters

Table 1. Command parameters
Keyword Description Choices Notes
FROMNL From Namelist Character value Required, Key, Positional 1
TONL To Namelist Character value Required, Key, Positional 2
MQMNAME Message Queue Manager name Character value, *DFT Optional, Key, Positional 3
REPLACE Replace *NO, *YES Optional, Positional 4
TEXT Text 'description' Character value, *BLANK, *SAME Optional, Positional 5
NAMES List of Names Values (up to 256 repetitions): Character value, *BLANKS, *SAME, *NONE Optional, Positional 6

From Namelist (FROMNL)

Specifies the name of the existing namelist, to provide values for the attributes not specified in this command.

from-namelist
Specify the name of the source namelist.

To Namelist (TONL)

The name of the new namelist to be created. The name can contain a maximum of 48 characters.

If a namelist with this name already exists, REPLACE(*YES) must be specified.

to-namelist
Specify the name of the MQ namelist being created.

Message Queue Manager name (MQMNAME)

Specifies the name of the message queue manager.

The possible values are:

*DFT
The default queue manager is used.
message-queue-manager-name
Specify the name of the queue manager.

Replace (REPLACE)

Specifies whether the new namelist should replace an existing namelist with the same name.

*NO
Do not replace the existing namelist. The command fails if the named namelist already exists.
*YES
Replace the existing namelist. If there is no namelist with the same name, a new namelist is created.

Text 'description' (TEXT)

Specifies text that briefly describes the namelist.

Note: The field length is 64 bytes and the maximum number of characters is reduced if the system is using a double byte character set (DBCS).

*SAME
The attribute is unchanged.
description
Specify no more than 64 characters enclosed in apostrophes.

List of Names (NAMES)

List of names. This is the list of names to be created. The names can be of any type, but must conform to the rules for naming MQ objects.

*SAME
The attribute is unchanged.
namelist
The list to create. An empty list is valid.