MQProcess
public class MQProcess
extends MQManagedObject
java.lang.Object
|
+----com.ibm.mq.MQManagedObject
|
+----com.ibm.mq.MQProcess
MQProcess provides inquire operations for WebSphere MQ processes.
Use MQQueueManager.accessProcess() to create an MQProcess object.
Constructors
MQProcess
public MQProcess(MQQueueManager qMgr, String processName, int openOptions,
String queueManagerName,
String alternateUserId) throws MQException;
Establishes access to a WebSphere MQ process on the specified queue manager
in to inquire about the process attributes. It has been made public to permit
subclassing.
- Parameters
-
- qMgr - the queue manager which is running the process.
- processName - the name of process to open.
- openOptions - options which 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:
- MQC.MQOO_ALTERNATE_USER_AUTHORITY
- MQC.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 MQC.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.
- Exceptions
-
- MQException - if the open fails.
Methods
close
public void close() throws MQException;
Closes the process.
- Exceptions
-
- MQException - if the WebSphere 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
-
- Exceptions
-
- MQException - if you call this method after you have closed the process,
to indicate that the process is no longer accessible or if the underlying
inquire() call fails.
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:
- MQC.MQAT_AIX
- MQC.MQAT_CICS
- MQC.MQAT_IMS
- MQC.MQAT_MVS
- MQC.MQAT_OS400
- MQC.MQAT_UNIX
- MQC.MQAT_WINDOWS
- MQC.MQAT_JAVA
- MQC.MQAT_USER_FIRST
- MQC.MQAT_USER_LAST
- Exceptions
-
- MQException - if underlying inquire call
fails.
getEnvironmentData
public String getEnvironmentData() throws MQException;
Gets information on the environment of the application that is to be started.
- Returns
-
- the information as a String.
- Exceptions
-
- MQException - if an internal error occurs.
getUserData
public String getUserData() throws MQException;
Gets information pertaining to the application to be started.
- Returns
-
- the information as a String.
- Exceptions
-
- MQException - if an internal error occurs.