Copy MQ Process (CPYMQMPRC)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Copy MQ Process (CPYMQMPRC) command creates an MQ process definition of the same type and, for attributes not specified in the command, with the same attribute values as an existing process definition.
Parameters
Keyword | Description | Choices | Notes |
---|---|---|---|
FROMPRC | From process | Character value | Required, Key, Positional 1 |
TOPRC | To process | Character value | Required, Key, Positional 2 |
MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Key, Positional 3 |
REPLACE | Replace | *NO, *YES | Optional, Positional 4 |
TEXT | Text 'description' | Character value, *BLANK, *SAME | Optional, Positional 5 |
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 6 |
APPID | Application identifier | Character value, *SAME | Optional, Positional 7 |
USRDATA | User data | Character value, *SAME, *NONE | Optional, Positional 8 |
ENVDATA | Environment data | Character value, *SAME, *NONE | Optional, Positional 9 |
From process (FROMPRC)
>Specifies the name of the existing process definition to provide values for the attributes not specified in this command.
The possible values are:
- from-process-name
- Specify the name of the source MQ process.
To process (TOPRC)
>The name of the new process definition to be created. The name can contain a maximum of 48 characters.
If a process definition with this name already exists, REPLACE(*YES) must be specified.
The possible values are:
- to-process-name
- Specify the name of the MQ process being created.
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)
>Specifies whether the new process definition should replace an existing process definition with the same name.
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:
- *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