|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.broker.config.proxy.MQConfigManagerConnectionParameters
public class MQConfigManagerConnectionParameters
Allows user-written Configuration Manager Proxy applications to specify a set of connection parameters that can be used to connect to MQ-based Configuration Managers.
Applications should create an instance of this class if they require the hostname, port, queue manager and (optionally) security exit information in order to connect to a Configuration Manager. In order to attempt a connection, the instance must then be passed to the ConfigManagerProxy.getInstance() method. For example:
ConfigManagerProxy.getInstance( new MQConfigManagerConnectionParameters( "mymachine.domain.com", 1414, "MYQM"));Note that once the getInstance() method has been called, modifying the MQConfigManagerConnectionParameters object will have no effect on existing connections.
class
com.ibm.broker.config.proxy.MQConfigManagerConnectionParameters
implements
com.ibm.broker.config.proxy.ConfigManagerConnectionParameters
|
|
Responsibilities | Represents a set of connection parameters to a WebSphere MQ based Configuration Manager. |
Collaborators | com.ibm.mq.* |
Change Activity: --------- ----------- ------------- ------------------------------------ Reason: Date: Originator: Comments: --------- ----------- ------------- ------------------------------------ f25103.1 2004-03-15 HDMPL v6 Release f44739.7 2007-07-30 HDMPL v6.1 Release: Methods now return genericized types where relevant
Constructor Summary | |
---|---|
MQConfigManagerConnectionParameters(java.lang.String ip,
int port,
java.lang.String qmgr)
Takes the parameters required to connect to an MQSeries-based Config Manager. |
|
MQConfigManagerConnectionParameters(java.lang.String ip,
int port,
java.lang.String qmgr,
java.lang.String mqseClassname)
Takes the parameters required to connect to an MQSeries-based Config Manager. |
|
MQConfigManagerConnectionParameters(java.lang.String ip,
int port,
java.lang.String qmgr,
java.lang.String mqseClassname,
java.net.URL mqseURL)
Takes the parameters required to connect to an MQSeries-based Config Manager. |
|
MQConfigManagerConnectionParameters(java.lang.String ip,
int port,
java.lang.String qmgr,
java.lang.String mqseClassname,
java.net.URL mqseURL,
java.lang.String sslCipherSuite,
java.lang.String sslPeerName,
java.lang.String sslKeyStore,
java.lang.String sslTrustStore,
java.util.Collection<java.security.cert.CertStore> sslCRLLdapCollection)
Constructor. |
|
MQConfigManagerConnectionParameters(java.lang.String ip,
int port,
java.lang.String qmgr,
java.lang.String mqseClassname,
java.net.URL mqseURL,
java.lang.String sslCipherSuite,
java.lang.String sslPeerName,
java.lang.String sslKeyStore,
java.lang.String sslTrustStore,
java.lang.String sslCRLLdapList)
Constructor. |
Method Summary | |
---|---|
void |
disableDomainAwareness()
Prevents Windows domain awareness support from initializing for this instance. |
static void |
disableMQJavaClientTracing()
Disables WebSphere MQ Java Client tracing |
static void |
enableMQJavaClientTracing(java.lang.String filename)
Sends level 5 WebSphere MQ Java Client tracing to the specified file. |
static java.lang.String |
generateUniqueDeployID()
Generates a deploy ID and returns it. |
java.lang.String |
getDeployID()
Returns the string used to uniquely map each deployment request back to this ConfigManagerProxy connection. |
com.ibm.broker.config.common.CommsMessageSerializer |
getProtocol()
This method is required by the Configuration Manager Proxy and should not be called by user applications. |
com.ibm.broker.config.proxy.Receiver |
getReceiver()
This method is required by the Configuration Manager Proxy and should not be called by user applications. |
com.ibm.broker.config.proxy.Sender |
getSender()
This method is required by the Configuration Manager Proxy and should not be called by user applications. |
java.lang.String |
getSessionIDString()
Returns a String representation of the session Id for this connection to the Configuration Manager. |
static java.lang.String[] |
getSupportedSSLCipherSuites()
Minimum set of supported SSL Cipher Suites |
java.lang.String |
getUserID()
Crosses the JNI to return the correctly formatted MQSeries userId & domain. |
void |
setAdvancedConnectionParameters(java.lang.String channelName,
java.lang.String requestQueueName,
java.lang.String responseQueueName,
int maxRetries,
int retryWaitMillis,
java.lang.String deployID,
byte[] sessionID)
Sets the 'advanced' options for a connection to MQ. |
java.lang.String |
toString()
For diagnostic information, this method displays the current connection parameters. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr)
ip
- IP Address of the target serverport
- Port of the target serverqmgr
- MQSeries Queue Manager which the Configuration Manager is usingpublic MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname)
ip
- IP Address of the target serverport
- Port of the target serverqmgr
- MQSeries Queue Manager which the Configuration Manager is usingmqseClassname
- Name of the Security Exit to use with this connection.
The Security Exit will be loaded using the standard class loader.public MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname, java.net.URL mqseURL)
ip
- IP Address of the target serverport
- Port of the target serverqmgr
- MQSeries Queue Manager which the Configuration Manager is usingmqseClassname
- Name of the Security Exit to use with this connection.
If running inside an Eclipse environment, callers should also use the mqseURL
parameter.mqseURL
- URL that describes where the MQ Security Exit can be loaded.
If null, the standard class loader will be used to locate and instantiate
the security exit class.public MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname, java.net.URL mqseURL, java.lang.String sslCipherSuite, java.lang.String sslPeerName, java.lang.String sslKeyStore, java.lang.String sslTrustStore, java.lang.String sslCRLLdapList)
ip
- - IP Address of the target serverport
- - Port of the target serverqmgr
- - MQSeries Queue Manager which the Configuration Manager is usingmqseClassname
- - Name of the Security Exit to use with this connection.
If running inside an Eclipse environment, callers should also use the mqseURL
parameter.mqseURL
- URL that describes where the MQ Security Exit can be loaded.
If null, the standard class loader will be used to locate and instantiate
the security exit class.sslCipherSuite
- SSL CipherSuite to be usedsslPeerName
- SSL Peername to be usedsslKeyStore
- SSL KeyStore to be usedsslTrustStore
- SSL TrustStore to be usedsslCRLLdapList
- A comma seperated list of LDAP servers hosting CRLspublic MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname, java.net.URL mqseURL, java.lang.String sslCipherSuite, java.lang.String sslPeerName, java.lang.String sslKeyStore, java.lang.String sslTrustStore, java.util.Collection<java.security.cert.CertStore> sslCRLLdapCollection)
ip
- - IP Address of the target serverport
- - Port of the target serverqmgr
- - MQSeries Queue Manager which the Configuration Manager is usingmqseClassname
- - Name of the Security Exit to use with this connection.
If running inside an Eclipse environment, callers should also use the mqseURL
parameter.mqseURL
- URL that describes where the MQ Security Exit can be loaded.
If null, the standard class loader will be used to locate and instantiate
the security exit class.sslCipherSuite
- SSL CipherSuite to be usedsslPeerName
- SSL Peername to be usedsslKeyStore
- SSL KeyStore to be usedsslTrustStore
- SSL TrustStore to be usedsslCRLLdapCollection
- A collection of CertStore objects represting LDAP servers hosting CRLsMethod Detail |
---|
public void setAdvancedConnectionParameters(java.lang.String channelName, java.lang.String requestQueueName, java.lang.String responseQueueName, int maxRetries, int retryWaitMillis, java.lang.String deployID, byte[] sessionID)
channelName
- The name of the MQSeries Server Connection channel
to use. If this is set to null, the existing value will be used.requestQueueName
- The name of the MQSeries queue to
which messages will be put. If this is set to null, the existing value
will be used.responseQueueName
- The name of the MQSeries queue from
which messages will be got. If this is set to null, the existing value
will be used.maxRetries
- The number of times the MQSender should retry after
consecutive failures. If this is set to -1, the existing value will
be used.retryWaitMillis
- The time (in milliseconds) the MQSender should
wait inbetween retries. If this is set to -1, the existing value will
be used.deployID
- The String used to map deployment requests uniquely
back to this connection. If this is set to null the existing value
will be used.sessionID
- A byte array containing an identifier that uniquely
identifies this connection to the Configuration Manager. This will be used as
a correlId, and so should be no longer than 24 bytes. If this is set
to null, the existing value will be used.public com.ibm.broker.config.proxy.Sender getSender() throws ConfigManagerProxyLoggedException
getSender
in interface ConfigManagerConnectionParameters
ConfigManagerProxyLoggedException
- if the security exit
could not be instantiatedpublic com.ibm.broker.config.proxy.Receiver getReceiver() throws ConfigManagerProxyLoggedException
getReceiver
in interface ConfigManagerConnectionParameters
ConfigManagerProxyLoggedException
- if the security exit
could not be instantiatedpublic com.ibm.broker.config.common.CommsMessageSerializer getProtocol()
getProtocol
in interface ConfigManagerConnectionParameters
public java.lang.String toString()
toString
in class java.lang.Object
public java.lang.String getDeployID()
getDeployID
in interface ConfigManagerConnectionParameters
public void disableDomainAwareness()
public java.lang.String getUserID()
getUserID
in interface ConfigManagerConnectionParameters
public static final void enableMQJavaClientTracing(java.lang.String filename)
filename
- of the trace filepublic static final void disableMQJavaClientTracing()
public java.lang.String getSessionIDString()
public static java.lang.String generateUniqueDeployID()
public static final java.lang.String[] getSupportedSSLCipherSuites()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |