This is the name of the application to be started, on the platform for which the command is executing, and might typically be a program name and library name.
The maximum length of the string is MQ_PROCESS_APPL_ID_LENGTH.
Valid application types are:
integer: System-defined application type in the range zero through 65 535 or a user-defined application type in the range 65 536 through 999 999 999 (not checked).
Only application types (other than user-defined types) that are supported on the platform at which the command is executed should be used:
Specifies how the command is executed when the queue manager is a member of a queue-sharing group. You can specify one of the following:
The maximum length is MQ_QSG_NAME_LENGTH.
A character string that contains environment information pertaining to the application to be started.
The maximum length of the string is MQ_PROCESS_ENV_DATA_LENGTH.
A plain-text comment that provides descriptive information about the process definition. It must contain only displayable characters.
The maximum length of the string is MQ_PROCESS_DESC_LENGTH.
If characters are used that are not in the coded character set identifier (CCSID) for the queue manager on which the command is executing, they might be translated incorrectly.
Specifies the disposition of the object to which you are applying the command (that is, where it is defined and how it behaves). The value can be:
QSGDisposition | Change | Copy, Create |
---|---|---|
MQQSGD_COPY | The object definition resides on the page set of the queue manager that executes the command. The object was defined using a command that had the parameter MQQSGD_COPY. Any object residing in the shared repository, or any object defined using a command that had the parameters MQQSGD_Q_MGR, is not affected by this command. | The object is defined on the page set of the queue manager that executes the command using the MQQSGD_GROUP object of the same name as the ToProcessName object (for Copy) or ProcessName object (for Create). |
MQQSGD_GROUP | The object definition resides in the shared repository. The object
was defined using a command that had the parameter MQQSGD_GROUP. Any object
residing on the page set of the queue manager that executes the command (except
a local copy of the object) is not affected by this command.
If the command is successful, the following MQSC command is generated and sent to all active queue managers in the queue-sharing group to attempt to refresh local copies on page set zero: DEFINE PROCESS(process-name) REPLACE QSGDISP(COPY) The Change for the group object takes effect regardless of whether the generated command with QSGDISP(COPY) fails. |
The object definition resides in the shared repository.
This is allowed only if the queue manager is in a queue-sharing group.
If the definition is successful, the following MQSC command is generated and sent to all active queue managers in the queue-sharing group to attempt to make or refresh local copies on page set zero: DEFINE PROCESS(process-name) REPLACE QSGDISP(COPY) The Copy or Create for the group object takes effect regardless of whether the generated command with QSGDISP(COPY) fails. |
MQQSGD_PRIVATE | The object resides on the page set of the queue manager
that executes the command, and was defined with MQQSGD_Q_MGR or MQQSGD_COPY.
Any object residing in the shared repository is unaffected. |
Not permitted. |
MQQSGD_Q_MGR | The object definition resides on the page set of the queue
manager that executes the command. The object was defined using a command
that had the parameter MQQSGD_Q_MGR. Any object residing in the shared repository,
or any local copy of such an object, is not affected by this command.
This is the default value. |
The object is defined on the page set of the queue manager
that executes the command.
This is the default value. |
If a process definition with the same name as ToProcessName already exists, this specifies whether it is to be replaced.
The value can be:
A character string that contains user information pertaining to the application (defined by ApplId) that is to be started.
The maximum length of the string is MQ_PROCESS_USER_DATA_LENGTH.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzac0470 |