com.ibm.mq
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 WebSphere MQ processes. UseMQQueueManager.accessProcess()
to create an MQProcess object.
-
-
Field Summary
-
Fields inherited from class com.ibm.mq.MQManagedObject
alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions
-
-
Constructor Summary
Constructors Constructor and Description MQProcess(MQQueueManager qMgr, java.lang.String processName, int openOptions)
Establishes access to a WebSphere MQ process on the specified queue manager in order to inquire about the process attributes.MQProcess(MQQueueManager qMgr, java.lang.String processName, int openOptionsP, java.lang.String queueManagerName, java.lang.String alternateUserId)
Establishes access to a WebSphere MQ process on the specified queue manager in order to inquire about the process attributes.
-
Method Summary
Methods Modifier and Type Method and Description void
close()
Closes the process.java.lang.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.java.lang.String
getEnvironmentData()
Gets information on the environment of the application which is to be started.java.lang.String
getUserData()
Gets information pertaining to the application to be started.-
Methods inherited from class com.ibm.mq.MQManagedObject
getAlternateUserId, getAttributeString, getCloseOptions, getConnectionReference, getDescription, getName, getOpenOptions, getResolvedObjectString, getResolvedQName, getResolvedType, inquire, inquire, isOpen, set, setAttributeString, setCloseOptions
-
-
-
-
Constructor Detail
-
MQProcess
public MQProcess(MQQueueManager qMgr, java.lang.String processName, int openOptions) throws MQException
Establishes access to a WebSphere 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: 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, java.lang.String processName, int openOptionsP, java.lang.String queueManagerName, java.lang.String alternateUserId) throws MQException
Establishes access to a WebSphere 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: 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
- ifCMQC.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 Detail
-
close
public void close() throws MQException
Closes the process.- Overrides:
close
in classMQManagedObject
- Throws:
MQException
- if the WebSphere MQ call fails.
-
getApplicationId
public java.lang.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 underlyinginquire()
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:
- Throws:
MQException
- if the underlyinginquire()
call fails.- See Also:
CMQC.MQIA_APPL_TYPE
-
getEnvironmentData
public java.lang.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 java.lang.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
-
-