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:


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