Change MQ Process (CHGMQMPRC)
- 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, *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 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.
The possible values are:
- *SAME
- The attribute is unchanged.
- *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.
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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i