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 you can update it without stopping any of the applications that use it.

Parameters

Table 1. Command 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.