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
Parent topic: CL commands reference for IBM i