Class MQProcess

java.lang.Object

com.ibm.mq.jmqi.JmqiObject

com.ibm.mq.MQManagedObject

com.ibm.mq.MQProcess

public class MQProcess
extends MQManagedObject

MQProcess provides inquire operations for IBM MQ processes. Use MQQueueManager.accessProcess() to create an MQProcess object.

Field Summary

Fields inherited from class MQManagedObject

alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions

Fields inherited from class com.ibm.mq.jmqi.JmqiObject

COMP_JM, COMP_JN, COMP_JO

Constructor Summary

Constructors

Constructor	Description
MQProcess(MQQueueManager qMgr, String processName, int openOptions)	Establishes access to an IBM MQ process on the specified queue manager in order to inquire about the process attributes.
MQProcess(MQQueueManager qMgr, String processName, int openOptionsP, String queueManagerName, String alternateUserId)	Establishes access to an IBM MQ process on the specified queue manager in order to inquire about the process attributes.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the process.
String	getApplicationId()	Gets the character string which identifies the application to be started.
int	getApplicationType()	Identifies the nature of the process to be started in response to a trigger message.
String	getEnvironmentData()	Gets information on the environment of the application which is to be started.
String	getUserData()	Gets information pertaining to the application to be started.

Methods inherited from class MQManagedObject

getAlternateUserId, getAttributeString, getCloseOptions, getConnectionReference, getDescription, getName, getOpenOptions, getResolvedObjectString, getResolvedQName, getResolvedType, inquire, inquire, isOpen, set, setAttributeString, setCloseOptions

Methods inherited from class com.ibm.mq.jmqi.JmqiObject

getJmqiEnvironment

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MQProcess

public MQProcess(MQQueueManager qMgr,
 String processName,
 int openOptions)
          throws MQException

Establishes access to an IBM MQ process on the specified queue manager in order to inquire about the process attributes. The default user authority is used for connection to the queue manager.

Parameters:

qMgr - the queue manager that is running the process.

processName - the name of process to open.

openOptions - options that control the opening of the process. As inquire is automatically added to the options specified there is no need to specify it explicitly. Valid options are:

• CMQC.MQOO_ALTERNATE_USER_AUTHORITY
• CMQC.MQOO_FAIL_IF_QUIESCING

If more than one option is required, the values can be combined using either the '+' or '|' operator.

Throws:

MQException - if the open fails.

MQProcess

public MQProcess(MQQueueManager qMgr,
 String processName,
 int openOptionsP,
 String queueManagerName,
 String alternateUserId)
          throws MQException

Establishes access to an IBM MQ process on the specified queue manager in order to inquire about the process attributes.

Parameters:

qMgr - the queue manager that is running the process.

processName - the name of process to open.

openOptionsP - options that control the opening of the process. As inquire is automatically added to the options specified there is no need to specify it explicitly. Valid options are:

• CMQC.MQOO_ALTERNATE_USER_AUTHORITY
• CMQC.MQOO_FAIL_IF_QUIESCING

If more than one option is required, the values can be combined using either the '+' or '|' operator.

queueManagerName - the name of queue manager qMgr.

alternateUserId - if CMQC.MQOO_ALTERNATE_USER_AUTHORITY is specified in the openOptions parameter, this parameter specifies the alternative user ID to be used to check the authorization for the open. Otherwise this parameter can be blank or null.

Throws:

MQException - if the open fails.

Method Details

close

public void close()
           throws MQException

Closes the process.

Overrides:

close in class MQManagedObject

Throws:

MQException - if the IBM MQ call fails.

getApplicationId

public String getApplicationId()
                        throws MQException

Gets the character string which identifies the application to be started. This information is used by a trigger monitor application which processes messages on the initiation queue; the information is sent to the initiation queue as part of the trigger message.

Returns:

the application ID.

Throws:

MQException - if you call this method after you have closed the process, indicating that the process is no longer accessible, or if the underlying inquire() call fails.

See Also:

• CMQC.MQCA_APPL_ID

getApplicationType

public int getApplicationType()
                       throws MQException

Identifies the nature of the process to be started in response to a trigger message.

Returns:

the following standard types have already been defined but others can be used:

• CMQC.MQAT_AIX
• CMQC.MQAT_CICS
• CMQC.MQAT_IMS
• CMQC.MQAT_MVS
• CMQC.MQAT_OS400
• CMQC.MQAT_UNIX
• CMQC.MQAT_WINDOWS
• CMQC.MQAT_JAVA
• CMQC.MQAT_USER_FIRST
• CMQC.MQAT_USER_LAST

Throws:

MQException - if the underlying inquire() call fails.

See Also:

• CMQC.MQIA_APPL_TYPE

getEnvironmentData

public String getEnvironmentData()
                          throws MQException

Gets information on the environment of the application which is to be started.

Returns:

the information as a String.

Throws:

MQException - if an internal error occurs.

See Also:

• CMQC.MQCA_ENV_DATA

getUserData

public String getUserData()
                   throws MQException

Gets information pertaining to the application to be started.

Returns:

the information as a String.

Throws:

MQException - if an internal error occurs.

See Also:

• CMQC.MQCA_USER_DATA