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