MQProcess.NET class

Use MQProcess to query the attributes of an IBM MQ process. Create an MQProcess object using a constructor, or an MQQueueManager AccessProcess method.

Class

System.Object
        |
        └─ IBM.WMQ.MQBase
                |
                └─ IBM.WMQ.MQBaseObject
                        |
                        └─ IBM.WMQ.MQManagedObject
                                |
                                └─ IBM.WMQ.MQProcess

• Properties
• Constructors

Properties

Test for MQException being thrown when getting properties.

public string ApplicationId {get;}

Gets the character string that identifies the application to be started. ApplicationId is used by a trigger monitor application. ApplicationId is sent to the initiation queue as part of the trigger message.

The default value is null.

public int ApplicationType {get;}

Identifies the type of the process to be started by a trigger monitor application. Standard types are defined, but others can be used:

• MQAT_AIX
• MQAT_CICS®
• MQAT_IMS
• MQAT_MVS
• MQAT_NATIVE
• MQAT_OS400
• MQAT_UNIX
• MQAT_WINDOWS
• MQAT_JAVA
• MQAT_USER_FIRST
• MQAT_USER_LAST

The default value is MQAT_NATIVE.

public string EnvironmentData {get;}

Gets information about the environment of the application that is to be started.

The default value is null.

public string UserData {get;}

Gets information the user has provided about the application to be started.

The default value is null.

Constructors

public MQProcess(MQQueueManager queueManager, string processName, int openOptions);

public MQProcess(MQQueueManager qMgr, string processName, int openOptions, string queueManagerName, string alternateUserId);

Throws MQException.

Access an IBM MQ process on queue manager qMgr to inquire on process attributes.

qMgr

Queue manager to access.

processName

The name of the process to open.

openOptions

Options that control the opening of the process. The valid options that can be added, or combined using a bitwise OR, are:

• MQC.MQOO_FAIL_IF_QUIESCING
• MQC.MQOO_INQUIRE
• MQC.MQOO_SET
• MQC.MQOO_ALTERNATE_USER_AUTHORITY

queueManagerName

The name of the queue manager on which the process is defined. We can leave a blank or null queue manager name if the queue manager is the same as the one the process is accessing.

alternateUserId

If MQC.MQOO_ALTERNATE_USER_AUTHORITY is specified in the openOptions parameter, alternateUserId specifies the alternative user ID used to check the authorization for the action. If MQOO_ALTERNATE_USER_AUTHORITY is not specified, alternateUserId can be blank or null.

Default user authority is used for connection to the queue manager if MQC.MQOO_ALTERNATE_USER_AUTHORITY is not specified.

public MQProcess MQQueueManager.AccessProcess(string processName, int openOptions);

public MQProcess MQQueueManager.AccessProcess(string processName, int openOptions, string queueManagerName, string alternateUserId);

Throws MQException.

Access an IBM MQ process on this queue manager to inquire on process attributes.

processName

The name of the process to open.

openOptions

Options that control the opening of the process. The valid options that can be added, or combined using a bitwise OR, are:

• MQC.MQOO_FAIL_IF_QUIESCING
• MQC.MQOO_INQUIRE
• MQC.MQOO_SET
• MQC.MQOO_ALTERNATE_USER_AUTHORITY

queueManagerName

The name of the queue manager on which the process is defined. We can leave a blank or null queue manager name if the queue manager is the same as the one the process is accessing.

alternateUserId

If MQC.MQOO_ALTERNATE_USER_AUTHORITY is specified in the openOptions parameter, alternateUserId specifies the alternative user ID used to check the authorization for the action. If MQOO_ALTERNATE_USER_AUTHORITY is not specified, alternateUserId can be blank or null.

Default user authority is used for connection to the queue manager if MQC.MQOO_ALTERNATE_USER_AUTHORITY is not specified.