CHGMQMPRC (Change MQ Process)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Change MQ Process (CHGMQMPRC) command changes the specified attributes of an existing MQ process definition.
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 |
TEXT | Text 'description' | Character value, *BLANK, *SAME | Optional, Positional 3 |
APPTYPE | Application type | Integer, *DEF, *CICS, *UNIX, *OS400, *WINDOWS, *WINDOWS_NT, | Optional, Positional 4 |
APPID | Application identifier | Character value, *SAME | Optional, Positional 5 |
USRDATA | User data | Character value, *SAME, *NONE | Optional, Positional 6 |
ENVDATA | Environment data | Character value, *SAME, *NONE | Optional, Positional 7 |
Process name (PRCNAME)
The name of the process definition to be changed.
The possible values are:
- process-name
- Specify the name of the process definition. The maximum length of the string is 48 bytes.
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.
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:
- *SAME
- The attribute is unchanged.
- *BLANK
- The text is set to a blank string.
- description
- Specify no more than 64 characters enclosed in apostrophes.
Application type (APPTYPE)
The type of application started.
- *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. - *CICS
- Represents a CICS®/400® application.
- *UNIX
- Represents a UNIX or Linux® application.
- *OS400
- Represents an IBM® i application.
- *WINDOWS
- Represents a Windows application.
- *WINDOWS_NT
- Represents a Windows NT application.
- integer
- User-defined application type in the range 65536 through 999999999.
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:
- *SAME
- The attribute is unchanged.
- 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:
- *SAME
- The attribute is unchanged.
- *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:
- *SAME
- The attribute is unchanged.
- *NONE
- The environment data is blank.
- environment-data
- The maximum length is 128 characters.