Create MQ Namelist (CRTMQMNL)

    Where allowed to run
    All environments (*ALL)

    Threadsafe
    Yes

The Create MQ Namelist (CRTMQMNL) command creates a new MQ namelist. A namelist is an MQ object that contains a list of other MQ objects. Typically, namelists are used by applications, for example trigger monitors, where they are used to identify a group of queues. A namelist is maintained independently of applications, therefore we can update it without stopping any of the applications that use it.


Parameters

Keyword Description Choices Notes
NAMELIST Namelist Character value Required, Key, Positional 1
MQMNAME Message Queue Manager name Character value, *DFT Optional, Key, Positional 2
REPLACE Replace *NO, *YES Optional, Positional 3
TEXT Text 'description' Character value, *BLANK, *SYSDFTNL Optional, Positional 4
NAMES List of Names Values (up to 256 repetitions): Character value, *BLANKS, *SYSDFTNL, *NONE Optional, Positional 5


Namelist (NAMELIST)

The name of the namelist to be created.

    namelist
    Specify the name of the namelist. The maximum length of the string is 48 bytes.


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).

    *SYSDFTNL
    The value of the attribute is taken from the system default namelist.

    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.

    *SYSDFTNL
    The value of the attribute is taken from the system default namelist.

    namelist
    The list to create. An empty list is valid.


Examples

None


Error messages

Unknown