Copy MQ Namelist (CPYMQMNL)

    Where allowed to run
    All environments (*ALL)

    Threadsafe
    Yes

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


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.


Examples

>

None


Error messages

>

Unknown

Parent topic: CL commands reference for IBM i