com.ibm.mq
Class MQQueueManager

java.lang.Object
  |
  +--com.ibm.mq.MQManagedObject
        |
        +--com.ibm.mq.MQQueueManager

public class MQQueueManager
extends MQManagedObject

The MQQueueManager class provides a connection to a WebSphere MQ queue manager.

An MQQueueManager object (and any queues or processes accessed through it) can be shared between multiple threads, but be aware that access to the WebSphere MQ queue manager itself is synchronized, so that only one thread can communicate with it at any one time. A call to MQQueue.get() specifying MQC.MQGMO_WAIT (for example) will therefore block any other threads attempting to make WebSphere MQ calls using the same MQQueueManager until the get completes.


Nested Class Summary
static class MQQueueManager.MQExitWrapper
           
 
Field Summary
 boolean isConnected
          Deprecated. Use the isConnected method instead.
 
Fields inherited from class com.ibm.mq.MQManagedObject
alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions
 
Constructor Summary
MQQueueManager(java.lang.String queueManagerName)
          Creates a connection to the named queue manager.
MQQueueManager(java.lang.String queueManagerName, javax.resource.spi.ConnectionManager connectionManager)
          Creates a connection to the named queue manager specifying a connection manager.
MQQueueManager(java.lang.String queueManagerName, java.util.Hashtable properties)
          Creates a connection to the named queue manager using a Hashtable.
MQQueueManager(java.lang.String queueManagerName, java.util.Hashtable properties, javax.resource.spi.ConnectionManager connectionManager)
          Creates a connection to the named queue manager using given Hashtable and connection manager.
MQQueueManager(java.lang.String queueManagerName, java.util.Hashtable properties, com.ibm.mq.MQConnectionManager connectionManager)
          Creates a connection to a queue manager which overrides the settings in MQEnvironment class with those in the given Hashtable.
MQQueueManager(java.lang.String queueManagerName, java.util.Hashtable properties, java.net.URL url)
          Creates a connection to the named queue manager using a channel definition table.
MQQueueManager(java.lang.String queueManagerName, int options)
          Creates a connection to the named queue manager specifying binding options.
MQQueueManager(java.lang.String queueManagerName, int options, javax.resource.spi.ConnectionManager connectionManager)
          Creates a connection to the named queue manager specifying bindings options and a connection manager.
MQQueueManager(java.lang.String queueManagerName, int options, com.ibm.mq.MQConnectionManager connectionManager)
          Creates a connection to a queue manager allowing binding options to be specified.
MQQueueManager(java.lang.String queueManagerName, com.ibm.mq.MQConnectionManager connectionManager)
          Creates a connection to a named queue manager using a connection manager.
MQQueueManager(java.lang.String queueManagerName, java.net.URL url)
          Creates a connection to the named queue manager using a channel definition table.
MQQueueManager(java.lang.String queueManagerName, java.net.URL url, javax.resource.spi.ConnectionManager connectionManager)
          Creates a connection to the named queue manager using a client channel definition table.
MQQueueManager(java.lang.String queueManagerName, java.net.URL url, com.ibm.mq.MQConnectionManager connectionManager)
          Creates a connection to the named queue manager using a client channel definition table.
 
Method Summary
 MQDistributionList accessDistributionList(MQDistributionListItem[] items, int options)
          Creates a distribution list using the default alternative user ID.
 MQDistributionList accessDistributionList(MQDistributionListItem[] items, int options, java.lang.String id)
          Creates a distribution list.
 MQProcess accessProcess(java.lang.String processName, int openOptions)
          Accesses a WebSphere MQ process on this queue manager using default queue manager name and alternative user ID values.
 MQProcess accessProcess(java.lang.String processName, int openOptions, java.lang.String queueManagerName, java.lang.String alternateUserId)
          Establishes access to a WebSphere MQ process on this queue manager in order to inquire about the process attributes.
 MQQueue accessQueue(java.lang.String queueName, int openOptions)
          Establishes access to an WebSphere MQ queue on this queue manager using default queue manager name and alternative user ID values.
 MQQueue accessQueue(java.lang.String queueName, int openOptions, java.lang.String queueManagerName, java.lang.String dynamicQueueName, java.lang.String alternateUserId)
          Establishes access to a WebSphere MQ queue on this queue manager in order to get or browse messages, put messages, inquire about the attributes of the queue, or set the attributes of the queue.
 void backout()
          Indicates to the queue manager that all the message gets and puts that have occurred since the last syncpoint are to be backed out.
 void begin()
          Begins a new unit of work.
 void commit()
          Indicates to the queue manager that the application has reached a syncpoint.
 void disconnect()
          Ends the connection to the queue manager.
 java.net.URL getCCDTURL()
          Returns the URL of the channel definition file, or null if it does not exist.
 int getCharacterSet()
          Gets the CCSID (Coded Character Set Identifier) of the queue manager's codeset.
 java.lang.String getCommandInputQueueName()
          Gets the name of the command input queue defined on the queue manager.
 int getCommandLevel()
          Indicates the level of system control commands supported by the queue manager.
 boolean getDistributionListCapable()
          Indicates whether the queue manager supports distribution lists.
 java.sql.Connection getJDBCConnection(javax.sql.XADataSource xads)
          Returns a Connection object for use with the JTA-JDBC support.
 java.sql.Connection getJDBCConnection(javax.sql.XADataSource xads, java.lang.String userid, java.lang.String password)
          Registers a database for coordination.
 int getMaximumMessageLength()
          Gets the maximum length of a message that the queue manager can handle.
 int getMaximumPriority()
          Gets the maximum message priority supported by the queue manager.
static java.util.Hashtable getProperties(java.lang.Object key, MQChannelHeader header, java.net.URL url)
          Reads properties concerning a channel in the channel definition table.
 int getSyncpointAvailability()
          Indicates whether the queue manager supports units of work and syncpointing with the MQQueue.get() and MQQueue.put() methods.
 boolean isConnected()
          Indicates whether this object is currently connected to a WebSphere MQ queue manager.
 void put(java.lang.String qName, MQMessage msg)
          Puts a single message on to a (possibly unopened) queue.
 void put(java.lang.String qName, MQMessage msg, MQPutMessageOptions pmo)
          Puts a single message on to a (possibly unopened) queue.
 void put(java.lang.String qName, java.lang.String qmName, MQMessage msg)
          Puts a single message on to a (possibly unopened) queue.
 void put(java.lang.String qName, java.lang.String qmName, MQMessage msg, MQPutMessageOptions pmo)
          Puts a single message on to a (possibly unopened) queue.
 void put(java.lang.String qName, java.lang.String qmName, MQMessage msg, MQPutMessageOptions pmo, java.lang.String altUserId)
          Puts a single message onto a (possibly unopened) queue.
 
Methods inherited from class com.ibm.mq.MQManagedObject
close, getAttributeString, getDescription, inquire, isOpen, set, setAttributeString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

isConnected

public boolean isConnected
Deprecated. Use the isConnected method instead.

Indicates whether this MQQueueManager object is currently connected to a WebSphere MQ queue manager. Use the disconnect() method to disconnect from a queue manager.

Constructor Detail

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName)
               throws MQException
Creates a connection to the named queue manager.

The host name, channel name and port to use during the connection request are specified in the MQEnvironment class. This must be done before calling this constructor.

The following example shows a connection to a queue manager "MYQM", running on a system with host name "fred.mq.com".


   MQEnvironment.hostname = "fred.mq.com";  // host to connect to
   MQEnvironment.port     = -1  ;           // port to connect to.  If not set, this
                                            // defaults to 1414 for WebSphereMQ Client connections.
   MQEnvironment.channel  = "channel.name"; // the CASE-SENSITIVE name of the SVRCONN channel
                                            // on the queue manager
   MQQueueManager qMgr    = new MQQueueManager("MYQM");
 

If the queue manager name is null or blank, then a connection is made to the default queue manager.

Parameters:
queueManagerName - the name of the queue manager to which to connect.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      int options)
               throws MQException
Creates a connection to the named queue manager specifying binding options.

Parameters:
queueManagerName - the name of the queue manager.
options - binding options. Possible values are:
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.util.Hashtable properties)
               throws MQException
Creates a connection to the named queue manager using a Hashtable. The Hashtable overrides the specification held in MQEnvironment.

Parameters:
queueManagerName - the name of the queue manager.
properties - connection properties.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      com.ibm.mq.MQConnectionManager connectionManager)
               throws MQException
Creates a connection to a named queue manager using a connection manager.

Parameters:
queueManagerName - the name of the queue manager.
connectionManager - the connection manager that will handle this connection.
Throws:
MQException - if there are connection problems.
See Also:
MQSimpleConnectionManager

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      int options,
                      com.ibm.mq.MQConnectionManager connectionManager)
               throws MQException
Creates a connection to a queue manager allowing binding options to be specified. It also allows a connection manager to be specified.

Parameters:
queueManagerName - the name of the queue manager.
options - binding options. Possible values are:
connectionManager - the connection manager that will handle this connection.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.util.Hashtable properties,
                      com.ibm.mq.MQConnectionManager connectionManager)
               throws MQException
Creates a connection to a queue manager which overrides the settings in MQEnvironment class with those in the given Hashtable.

Parameters:
queueManagerName - the name of the queue manager.
properties - connection properties.
connectionManager - the connection manager that will handle this connection.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      javax.resource.spi.ConnectionManager connectionManager)
               throws MQException
Creates a connection to the named queue manager specifying a connection manager.

Parameters:
queueManagerName - the name of the queue manager.
connectionManager - the connection manager which will handle this connection.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      int options,
                      javax.resource.spi.ConnectionManager connectionManager)
               throws MQException
Creates a connection to the named queue manager specifying bindings options and a connection manager.

Parameters:
queueManagerName - the name of the queue manager.
options - binding options. Possible values are:
connectionManager - the Connection manager that handles this connection
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.util.Hashtable properties,
                      javax.resource.spi.ConnectionManager connectionManager)
               throws MQException
Creates a connection to the named queue manager using given Hashtable and connection manager. The given properties override those held in MQEnvironment.

Parameters:
queueManagerName - the name of the queue manager.
properties - connection properties.
connectionManager - the ConnectionManager which handles this connection.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.net.URL url)
               throws MQException
Creates a connection to the named queue manager using a channel definition table. Using a client channel definition table enables alternative channel definitions to be defined. The constructor selects a set of definitions from the table and these are used instead of any settings held in MQEnvironment class when opening a channel.

Parameters:
queueManagerName - the queue manager that is used when selecting a channel definition. This can be in of the following forms:
url - the URL which specifies the channel definition file to be used in connecting to the queue manager.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.util.Hashtable properties,
                      java.net.URL url)
               throws MQException
Creates a connection to the named queue manager using a channel definition table. Using a client channel definition table enables alternative channel definitions to be defined. The constructor selects a set of definitions from the table and these are used instead of any settings held in MQEnvironment class when opening a channel. Properties other than those defined by the client channel definition table may be supplied with this constructor.

Parameters:
queueManagerName - the queue manager that is used when selecting a channel definition. This can be in of the following forms:
properties - A hashtable of properties to be used to establish the connection with those defined in the client channel definition that is actually used. Any properties that are not valid for this type of connection will be be ignored.
url - the URL which specifies the channel definition file to be used in connecting to the queue manager.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.net.URL url,
                      javax.resource.spi.ConnectionManager connectionManager)
               throws MQException
Creates a connection to the named queue manager using a client channel definition table. Using a client channel definition table enables alternative channel definitions to be defined. The constructor selects a set of definitions from the table and these are used instead of any settings held in MQEnvironment class when opening a channel. The queue manager name parameter can be in one of the following forms:

Parameters:
queueManagerName - the queue manager that is used when selecting a channel definition. This can be in of the following forms:
url - the URL which specifies the channel definition table to be used in connecting to the queue manager.
connectionManager - the connection manager.
Throws:
MQException - if there are connection problems.

MQQueueManager

public MQQueueManager(java.lang.String queueManagerName,
                      java.net.URL url,
                      com.ibm.mq.MQConnectionManager connectionManager)
               throws MQException
Creates a connection to the named queue manager using a client channel definition table. Using a client channel definition table enables alternative channel definitions to be defined. The constructor selects a set of definitions from the table and these are used instead of any settings held in MQEnvironment class when opening a channel.

Parameters:
queueManagerName - the queue manager that is used when selecting a channel definition. This can be in of the following forms:
url - the URL which specifies the channel definition file to be used in connecting to the queue manager.
connectionManager - the connection manager.
Throws:
MQException - if there are connection problems.
Method Detail

getJDBCConnection

public java.sql.Connection getJDBCConnection(javax.sql.XADataSource xads)
                                      throws MQException,
                                             java.sql.SQLException,
                                             java.lang.Exception
Returns a Connection object for use with the JTA-JDBC support.

Parameters:
xads - A database-specific implementation of the XADataSource interface that defines the details of the database to connect to. See the documentation for your database to determine how to create an appropriate XADataSource object to pass into this method.
Returns:
a connection for use with the JTA-JDBC support.
Throws:
MQException - if there is a WebSphere MQ failure.
java.sql.SQLException - if there are problems getting the Connection object.
java.lang.Exception - thrown to avoid problems with the JVM verifier if you are not using the JTA functionality. The actual exception thrown is javax.transaction.xa.XAException, which requires the jta.jar file to be added to the CLASSPATH for programs that did not previously require it.

getJDBCConnection

public java.sql.Connection getJDBCConnection(javax.sql.XADataSource xads,
                                             java.lang.String userid,
                                             java.lang.String password)
                                      throws MQException,
                                             java.sql.SQLException,
                                             java.lang.Exception
Registers a database for coordination. Used to create a JDBC Connection which is coordinated by the queue manager after a call to begin().

Parameters:
xads - database-specific implementation of the XADataSource interface that defines the details of the database. See the documentation for your database to determine how to create an appropriate XADataSource object to pass into this method.
userid - the user ID for connecting to the database.
password - the password for connecting to the database.
Returns:
connection for use with the JTA-JDBC support.
Throws:
MQException - if there is a WebSphere MQ failure.
java.sql.SQLException - if there are problems getting the Connection object.
java.lang.Exception - thrown to avoid problems with the JVM verifier if you are not using the JTA functionality. The actual exception thrown is javax.transaction.xa.XAException, which requires the jta.jar file to be added to the CLASSPATH for programs that did not previously require it.

isConnected

public boolean isConnected()
Indicates whether this object is currently connected to a WebSphere MQ queue manager. Use disconnect() to disconnect from a queue manager.

Returns:
true if connected.

getCharacterSet

public int getCharacterSet()
                    throws MQException
Gets the CCSID (Coded Character Set Identifier) of the queue manager's codeset. This defines the character set used by the queue manager for all character string fields in the application programming interface.

Returns:
the CCSID.
Throws:
MQException - if you call this method after disconnecting from the queue manager, indicating that the connection is no longer valid.

getMaximumMessageLength

public int getMaximumMessageLength()
                            throws MQException
Gets the maximum length of a message that the queue manager can handle. No queue can be defined with a maximum message length greater than this.

Returns:
The maximum message length in bytes.
Throws:
MQException - if you call this method after disconnecting from the queue manager, indicating that the connection is no longer valid.

getCommandLevel

public int getCommandLevel()
                    throws MQException
Indicates the level of system control commands supported by the queue manager. The set of system control commands corresponding to a particular command level varies according to the platform on which the queue manager is running. See the WebSphere MQ Application Programming Reference.

Returns:
values between MQC.MQCMDL_LEVEL_1 and MQC.MQCMDL_LEVEL_600.
Throws:
MQException - if you call this method after disconnecting from the queue manager to indicate that the connection is no longer valid.

getCommandInputQueueName

public java.lang.String getCommandInputQueueName()
                                          throws MQException
Gets the name of the command input queue defined on the queue manager. This is a queue to which applications can send commands, if authorized to do so.

Returns:
the name of the command input queue.
Throws:
MQException - if you call this method after disconnecting from the queue manager, indicating that the connection is no longer valid.

getMaximumPriority

public int getMaximumPriority()
                       throws MQException
Gets the maximum message priority supported by the queue manager. Priorities range from 0 (lowest) to this value.

Returns:
the maximum message priority.
Throws:
MQException - if you call this method after disconnecting from the queue manager, indicating that the connection is no longer valid.

getSyncpointAvailability

public int getSyncpointAvailability()
                             throws MQException
Indicates whether the queue manager supports units of work and syncpointing with the MQQueue.get() and MQQueue.put() methods.

Returns:
MQC.MQSP_AVAILABLE if syncpointing is available, or MQC.MQSP_NOT_AVAILABLE if not.
Throws:
MQException - if you call this method after disconnecting from the queue manager to indicate that the connection is no longer valid.

getDistributionListCapable

public boolean getDistributionListCapable()
Indicates whether the queue manager supports distribution lists.

Returns:
true if distribution lists are supported.

getProperties

public static java.util.Hashtable getProperties(java.lang.Object key,
                                                MQChannelHeader header,
                                                java.net.URL url)
                                         throws java.io.IOException,
                                                MQException
Reads properties concerning a channel in the channel definition table.

Parameters:
key - the name of the channel.
header - helps to find the channel information in the table.
url - the URL of the channel definition table.
Returns:
the relevant properties in a Hashtable.
Throws:
java.io.IOException - if there are connection problems.
MQException - if there are WebSphere MQ problems.

disconnect

public void disconnect()
                throws MQException
Ends the connection to the queue manager. All open queues and processes accessed through this queue manager are closed and become unusable. The only way to reconnect is to create a new MQQueueManager object.

Throws:
MQException - if the MQ disconnect call fails.

commit

public void commit()
            throws MQException
Indicates to the queue manager that the application has reached a syncpoint. All the message gets and puts that have occurred since the last syncpoint are to be made permanent. Messages sent as part of a unit of work (with the MQC.MQPMO_SYNCPOINT flag set in MQPutMessageOptions.options) are made available to other applications. Messages retrieved as part of a unit of work (with the MQC.MQGMO_SYNCPOINT flag set in MQGetMessageOptions.options) are deleted.

Throws:
MQException - if the call fails.
See Also:
backout()

backout

public void backout()
             throws MQException
Indicates to the queue manager that all the message gets and puts that have occurred since the last syncpoint are to be backed out. Messages sent as part of a unit of work (with the MQC.MQPMO_SYNCPOINT flag set in the options field of MQPutMessageOptions) are deleted. Messages retrieved as part of a unit of work (with the MQC.MQGMO_SYNCPOINT flag set in MQGetMessageOptions.options) are reinstated on the queue.

Throws:
MQException - if the call fails.
See Also:
commit()

begin

public void begin()
           throws MQException
Begins a new unit of work. This method is only supported by WebSphere MQ in a bindings connection. It signals to the queue manager that a new unit of work is to begin.

Throws:
MQException - if the call fails

put

public void put(java.lang.String qName,
                java.lang.String qmName,
                MQMessage msg,
                MQPutMessageOptions pmo,
                java.lang.String altUserId)
         throws MQException
Puts a single message onto a (possibly unopened) queue. If a send exit has been specified, it processes the message before it is sent. See the description of MQPUT1 in WebSphere MQ Application Programming Reference for more information.

Parameters:
qName - the name of the queue to which the message is put.
qmName - the name of the queue manager which holds the queue.
msg - the message to be sent.
pmo - the put message options to use.
altUserId - alternative user ID to use when putting the message.
Throws:
MQException - if the WebSphere MQ put call fails.

put

public void put(java.lang.String qName,
                java.lang.String qmName,
                MQMessage msg,
                MQPutMessageOptions pmo)
         throws MQException
Puts a single message on to a (possibly unopened) queue. If a send exit has been specified it processes the message before it is sent.

Parameters:
qName - the name of the queue to which the message is put.
qmName - the name of the queue manager that holds the queue.
msg - the message to be sent.
pmo - the put message options to use.
Throws:
MQException - if the WebSphere MQ put call fails.

put

public void put(java.lang.String qName,
                java.lang.String qmName,
                MQMessage msg)
         throws MQException
Puts a single message on to a (possibly unopened) queue. If a send exit has been specified it processes the message before it is sent.

Parameters:
qName - the name of the queue to which the message is put.
qmName - the name of the queue manager which holds the queue.
msg - the message to be sent.
Throws:
MQException - if the WebSphere MQ put call fails.

put

public void put(java.lang.String qName,
                MQMessage msg,
                MQPutMessageOptions pmo)
         throws MQException
Puts a single message on to a (possibly unopened) queue. If a send exit has been specified it processes the message before it is sent.

Parameters:
qName - the name of the queue to which the message is put.
msg - the message to be sent.
pmo - the put message options to use.
Throws:
MQException - if the WebSphere MQ put call fails.

put

public void put(java.lang.String qName,
                MQMessage msg)
         throws MQException
Puts a single message on to a (possibly unopened) queue. If a send exit has been specified it processes the message before it is sent.

Parameters:
qName - the name of the queue to which the message is put.
msg - the message to be sent.
Throws:
MQException - if the WebSphere MQ put call fails.

accessQueue

public MQQueue accessQueue(java.lang.String queueName,
                           int openOptions,
                           java.lang.String queueManagerName,
                           java.lang.String dynamicQueueName,
                           java.lang.String alternateUserId)
                    throws MQException
Establishes access to a WebSphere MQ queue on this queue manager in order to get or browse messages, put messages, inquire about the attributes of the queue, or set the attributes of the queue.

If the queue named is a model queue, then a dynamic local queue is created. The name of the created queue is held in the name field of the returned MQQueue object.

Parameters:
queueName - name of queue to open.
openOptions - options which control the opening of the queue. As inquire and set options are automatically added to the options provided, there is no need to specify these explicitly. The valid options are: If more than one option is required the values can be combined using either the '+' or '|' operator. See WebSphere MQ Application Programming Reference for a complete description of these options.
queueManagerName - name of the queue manager on which the queue is defined. A name which is blank, or which is null, denotes the queue manager to which this object is connected.
dynamicQueueName - name of the dynamic queue to be created. This parameter is ignored unless queueName specifies the name of a model queue. If it does, this parameter specifies the name of the dynamic queue to be created. A blank or null name is not valid if queueName specifies the name of a model queue. If the last non-blank character in the name is an asterisk (*), the queue manager replaces it with a string of characters which guarantees that the name generated for the queue is unique at the local queue mananager. Asterisk is only valid in positions 1 to 33 of the dynamicQueueName parameter.
alternateUserId - if MQC.MQOO_ALTERNATE_USER_AUTHORITY is specified in the openOptions parameter this parameter specifies the alternate user ID to be used to check the authorization for the open. If MQC.MQOO_ALTERNATE_USER_AUTHORITY is not specified, this parameter can be left blank (or null).
Returns:
the MQQueue that has been successfully opened.
Throws:
MQException - if the open fails.
See Also:
accessProcess(java.lang.String, int, java.lang.String, java.lang.String)

accessQueue

public MQQueue accessQueue(java.lang.String queueName,
                           int openOptions)
                    throws MQException
Establishes access to an WebSphere MQ queue on this queue manager using default queue manager name and alternative user ID values.

Parameters:
queueName - the name of the queue to open.
openOptions - options which control the opening of the queue. See accessQueue(String, int, String, String, String) for more information.
Returns:
an MQQueue that has been successfully opened.
Throws:
MQException - if the open fails.

accessProcess

public MQProcess accessProcess(java.lang.String processName,
                               int openOptions,
                               java.lang.String queueManagerName,
                               java.lang.String alternateUserId)
                        throws MQException
Establishes access to a WebSphere MQ process on this queue manager in order to inquire about the process attributes.

Parameters:
processName - name of the 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: If more than one option is required the values can be combined using either the '+' or '|' operator.
queueManagerName - name of the queue manager on which the process is defined. A name which is entirely blank or null denotes the queue manager to which this object is connected.
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.
Returns:
an MQProcess that has been successfully opened.
Throws:
MQException - if the open fails.
See Also:
accessQueue(String, int, String, String, String)

accessProcess

public MQProcess accessProcess(java.lang.String processName,
                               int openOptions)
                        throws MQException
Accesses a WebSphere MQ process on this queue manager using default queue manager name and alternative user ID values.

Parameters:
processName - name of process to open.
openOptions - see openOptions for details.
Returns:
an MQProcess that has been successfully opened.
Throws:
MQException - if the open fails.
See Also:
accessProcess(String,int,String,String)

accessDistributionList

public MQDistributionList accessDistributionList(MQDistributionListItem[] items,
                                                 int options,
                                                 java.lang.String id)
                                          throws MQException
Creates a distribution list.

Parameters:
items - the elements of the distribution list.
options - the open options for the distribution list.
id - the alternative user ID.
Returns:
the distribution list.
Throws:
MQException - if there is a problem opening the distribution list.

accessDistributionList

public MQDistributionList accessDistributionList(MQDistributionListItem[] items,
                                                 int options)
                                          throws MQException
Creates a distribution list using the default alternative user ID.

Parameters:
items - the elements of the distribution list.
options - the open options for the distribution list.
Returns:
the distribution list.
Throws:
MQException - if there is a problem opening the distribution list.

getCCDTURL

public java.net.URL getCCDTURL()
Returns the URL of the channel definition file, or null if it does not exist. Java URLs support various protocols, which normally include file, HTTP, FTP and LDAP. The URL class has several constructors, one of which is: URL(String spec).

Returns:
The URL of the channel definition file.

(c) Copyright IBM Corp. 2005. All Rights Reserved.