Create MQ Process (CRTMQMPRC)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Create MQ Process (CRTMQMPRC) command creates a new MQ process definition, specifying those attributes that are different from the default.
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, *SAME, *CICS, *MVS, *IMS, *OS2, *DOS, *UNIX, *QMGR, *OS400, *WINDOWS, *CICS_VSE, *WINDOWS_NT, *VMS, *NSK, *VOS, *IMS_BRIDGE, *XCF, *CICS_BRIDGE, *NOTES_AGENT, *BROKER, *JAVA, *DQM | 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:
- *SYSDFTPRC
- The value for this attribute is taken from the system default process.
- *CICS
- Represents a CICS/400 application.
- *MVS
- Represents an MVS application.
- *IMS
- Represents an IMS application.
- *OS2
- Represents an OS/2 application.
- *DOS
- Represents a DOS application.
- *UNIX
- Represents a UNIX application.
- *QMGR
- Represents a queue manager.
- *OS400
- Represents an IBM i application.
- *WINDOWS
- Represents a Windows application.
- *CICS_VSE
- Represents a CICS/VSE application.
- *WINDOWS_NT
- Represents a Windows NT application.
- *VMS
- Represents a VMS application.
- *NSK
- Represents a Tandem/NSK application.
- *VOS
- Represents a VOS application.
- *IMS_BRIDGE
- Represents an IMS bridge application.
- *XCF
- Represents an XCF application.
- *CICS_BRIDGE
- Represents a CICS bridge application.
- *NOTES_AGENT
- Represents a Lotus Notes application.
- *BROKER
- Represents a broker application.
- *JAVA
- Represents a Java application.
- *DQM
- Represents a DQM 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.
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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i