CRTMQMPRC (Create MQ Process)

The Create MQ Process (CRTMQMPRC) command creates a new IBM® MQ process definition, specifying those attributes that are different from the default.

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

Parameters

Table 1. Command parameters
Keyword	Description	Choices	Notes
PRCNAME	Process name	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, SYSDFTPRC	Optional, Positional 4
APPTYPE	Application type	`Integer`, DEF, CICS, UNIX, OS400, WINDOWS, WINDOWS_NT,	Optional, Positional 5
APPID	Application identifier	`Character value`, *SYSDFTPRC	Optional, Positional 6
USRDATA	User data	`Character value`, SYSDFTPRC, NONE	Optional, Positional 7
ENVDATA	Environment data	`Character value`, SYSDFTPRC, NONE	Optional, Positional 8

Process name (PRCNAME)

The name of the new MQ process definition to be created.

The possible values are:

process-name: Specify the name of the new MQ process definition. The name can contain up to 48 characters.

Message Queue Manager name (MQMNAME)

Specifies the name of the queue manager.

The possible values are:

*DFT: Use the default queue manager.
queue-manager-name: The name of a message queue manager.

Replace (REPLACE)

If a process definition with the same name already exists, this specifies whether it is replaced.

The possible values are:

*NO: This definition does not replace any existing process definition with the same name. The command fails if the named process definition already exists.
*YES: Replace the existing process definition. If there is no definition with the same name, a new definition is created.

Text 'description' (TEXT)

Specifies text that briefly describes the process definition.

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

The possible values are:

*SYSDFTPRC: The value of this attribute is taken from the system default process.
*BLANK: The text is set to a blank string.
description: Specify the new descriptive information.

Application type (APPTYPE)

The type of application started.

The possible values are:

*CICS: Represents a CICS®/400 application.
*DEF: Specifying DEF causes the default application type for the platform at which the command is interpreted to be stored in the process definition. This default cannot be changed by the installation. If the platform supports clients, the default is interpreted as the default application type of the server.
integer: User-defined application type in the range 65536 through 999999999.
*OS400: Represents an IBM i application.
*SYSDFTPRC: The value for this attribute is taken from the system default process.
*UNIX: Represents a UNIX or Linux® application.
user-value: User-defined application type in the range 65536 through 999999999.
The values within this range are not tested, and any other value is accepted.
*WINDOWS: Represents a Windows application.
*WINDOWS_NT: Represents a Windows NT application.

Application identifier (APPID)

Application identifier. This is the name of the application to be started, on the platform for which the command is processing. It is typically a program name and library name.

The possible values are:

*SYSDFTPRC: The value for this attribute is taken from the system default process.
application-id: The maximum length is 256 characters.

User data (USRDATA)

A character string that contains user information pertaining to the application, as defined by APPID, to start.

The possible values are:

*SYSDFTPRC: The value for this attribute is taken from the system default process.
*NONE: The user data is blank.
user-data: Specify up to 128 characters of user data.

Environment data (ENVDATA)

A character string that contains environment information pertaining to the application, as defined by APPID, to start.

The possible values are:

*SYSDFTPRC: The value for this attribute is taken from the system default process.
*NONE: The environment data is blank.
environment-data: The maximum length is 128 characters.