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:


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

Parent topic: CL commands reference for IBM i