com.ibm.broker.config.proxy

Class MQBrokerConnectionParameters

  • All Implemented Interfaces:
    BrokerConnectionParameters

    Deprecated. 
    As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters

    @Deprecated
    public class MQBrokerConnectionParameters
    extends IntegrationNodeConnectionParameters
    implements BrokerConnectionParameters

    This class has been deprecated. As of IBM Integration Bus V10, MQ Broker Connections are no longer used and applications should use the IntegrationNodeConnectionParameters class to connect directly with brokers.

    For example:

         BrokerProxy b = BrokerProxy.getInstance(
             new IntegrationNodeConnectionParameters("localhost", 4414)); 
     

    To connect to a broker defined on the local machine, it is recommended that you use BrokerProxy.getLocalInstance instead.

    This class provides the connection parameters to a remote broker by directly specifying its WebSphere MQ-based connection parameters.

    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. In order to attempt a connection, the instance must then be passed to the BrokerProxy.getInstance method. For example:

         BrokerProxy.getInstance(
             new MQBrokerConnectionParameters(
                 "mymachine.domain.com", 1414, "MYQM"));
     
    Note that once the getInstance() method has been called, modifying the MQBrokerConnectionParameters object will have no effect on existing connections.

    class com.ibm.broker.config.proxy.MQBrokerConnectionParameters implements com.ibm.broker.config.proxy.BrokerConnectionParameters

    Responsibilities Represents a set of connection parameters to a WebSphere MQ based Message Broker.
    Collaborators com.ibm.mq.*
    
     Change Activity:
     --------- ----------- ------------- ------------------------------------
     Reason:   Date:       Originator:   Comments:
     --------- ----------- ------------- ------------------------------------
     f51619.1  2008-07-16  HDMPL         v7 Release
    
     
    • Constructor Detail

      • MQBrokerConnectionParameters

        @Deprecated
        public MQBrokerConnectionParameters(java.lang.String ip,
                                                        int port,
                                                        java.lang.String qmgr)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters Please note that previously the port value was port of the MQ Listener. MQ is no longer used for Java CMP applications to connect to the integration node. The port value should now be the Web admin port of the target integration node.
        Takes the parameters required to connect to a WebSphere-MQ based broker. Upon returning from this method, the supplied data will not have been validated and a connection to a broker will not have been established. All this work takes place during the call to BrokerProxy.getInstance().
        Parameters:
        ip - IP Address of the target integration node
        port - Web admin port of the target integration node.
        qmgr - WebSphere MQ Queue Manager which the broker is using
      • MQBrokerConnectionParameters

        @Deprecated
        public MQBrokerConnectionParameters(java.lang.String ip,
                                                        int port,
                                                        java.lang.String qmgr,
                                                        java.lang.String mqseClassname)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters Please note that previously the port value was port of the MQ Listener. MQ is no longer used for Java CMP applications to connect to the integration node. The port value should now be the Web admin port of the target integration node.
        Takes the parameters required to connect to a WebSphere-MQ based broker. Upon returning from this method, the supplied data will not have been validated and a connection to a broker will not have been established. All this work takes place during the call to BrokerProxy.getInstance().
        Parameters:
        ip - IP Address of the target integration node
        port - Web admin port of the target integration node.
        qmgr - WebSphere MQ Queue Manager which the broker is using
        mqseClassname - Name of the Security Exit to use with this connection. The Security Exit will be loaded using the standard class loader.
      • MQBrokerConnectionParameters

        @Deprecated
        public MQBrokerConnectionParameters(java.lang.String ip,
                                                        int port,
                                                        java.lang.String qmgr,
                                                        java.lang.String mqseClassname,
                                                        java.net.URL mqseURL)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters Please note that previously the port value was port of the MQ Listener. MQ is no longer used for Java CMP applications to connect to the integration node. The port value should now be the Web admin port of the target integration node.
        Takes the parameters required to connect to a WebSphere-MQ based broker. Upon returning from this method, the supplied data will not have been validated and a connection to a broker will not have been established. All this work takes place during the call to BrokerProxy.getInstance().
        Parameters:
        ip - IP Address of the target integration node
        port - Web admin port of the target integration node.
        qmgr - WebSphere MQ Queue Manager which the broker is using
        mqseClassname - 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.
      • MQBrokerConnectionParameters

        @Deprecated
        public MQBrokerConnectionParameters(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)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters Please note that previously the port value was port of the MQ Listener. MQ is no longer used for Java CMP applications to connect to the integration node. The port value should now be the Web admin port of the target integration node.
        Takes the parameters required to connect to a WebSphere-MQ based broker. Upon returning from this method, the supplied data will not have been validated and a connection to a broker will not have been established. All this work takes place during the call to BrokerProxy.getInstance().
        Parameters:
        ip - IP Address of the target integration node
        port - Web admin port of the target integration node.
        qmgr - WebSphere MQ Queue Manager which the broker is using
        mqseClassname - - 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 used
        sslPeerName - SSL Peername to be used
        sslKeyStore - SSL KeyStore to be used
        sslTrustStore - SSL TrustStore to be used
        sslCRLLdapList - A comma seperated list of LDAP servers hosting CRLs
      • MQBrokerConnectionParameters

        @Deprecated
        public MQBrokerConnectionParameters(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)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters Please note that previously the port value was port of the MQ Listener. MQ is no longer used for Java CMP applications to connect to the integration node. The port value should now be the Web admin port of the target integration node.
        Takes the parameters required to connect to a WebSphere-MQ based broker. Upon returning from this method, the supplied data will not have been validated and a connection to a broker will not have been established. All this work takes place during the call to BrokerProxy.getInstance().
        Parameters:
        ip - IP Address of the target integration node
        port - Web admin port of the target integration node.
        qmgr - WebSphere MQ Queue Manager which the broker is using
        mqseClassname - 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 used
        sslPeerName - SSL Peername to be used
        sslKeyStore - SSL KeyStore to be used
        sslTrustStore - SSL TrustStore to be used
        sslCRLLdapCollection - A collection of CertStore objects representing LDAP servers hosting CRLs
    • Method Detail

      • setSSLKeyStorePassword

        @Deprecated
        public void setSSLKeyStorePassword(java.lang.String password)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Sets the SSL key store password for the current connection. If this parameter is required, it must be supplied before BrokerProxy.getInstance() is invoked.
        Parameters:
        password - Password for the key store
      • setSSLTrustStorePassword

        @Deprecated
        public void setSSLTrustStorePassword(java.lang.String password)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Sets the SSL trust store password for the current connection. If this parameter is required, it must be supplied before BrokerProxy.getInstance() is invoked.
        Parameters:
        password - Password for the trust store
      • setSSLFIPSEnabled

        @Deprecated
        public static void setSSLFIPSEnabled(boolean sslUseFIPS)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Enables the use of FIPS compliant ciphers for all future SSL connections in this JVM. If this parameter is required, it must be supplied before BrokerProxy.getInstance() is called; any changes to this value will only be applied to the JVM the next time BrokerProxy.getInstance() is called.
        Parameters:
        sslUseFIPS - Only if this is true, FIPS compliance will be enabled on all future connections to SSL queue managers within this JVM.
      • setAdvancedConnectionParameters

        @Deprecated
        public void setAdvancedConnectionParameters(java.lang.String channelName,
                                                                java.lang.String requestQueueName,
                                                                java.lang.String responseQueueName,
                                                                int maxRetries,
                                                                int retryWaitMillis,
                                                                byte[] sessionID)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Sets advanced options for a connection to the integration node.
        Parameters:
        channelName - The name of the WebSphere MQ Server Connection channel to use. If this is set to null, the existing value will be used.
        requestQueueName - This parameter is currently ignored.
        responseQueueName - This parameter is currently ignored.
        maxRetries - The number of times the IBM Integration API (CMP) should retry sending messages after consecutive failures. If this is set to -1, the existing value will be used.
        retryWaitMillis - The time (in milliseconds) the IBM Integration API (CMP) should wait inbetween retries. If this is set to -1, the existing value will be used.
        sessionID - A byte array containing an identifier that uniquely identifies this connection to the broker. 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.
      • enableMQJavaClientTracing

        @Deprecated
        public static final void enableMQJavaClientTracing(java.lang.String filename)
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Starts level 5 WebSphere MQ Java Client tracing. Note that the filename parameter is ignored as of WebSphere MQ V7.0.1.
        Parameters:
        filename - of the trace file
      • disableMQJavaClientTracing

        @Deprecated
        public static final void disableMQJavaClientTracing()
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Disables WebSphere MQ Java Client tracing
      • getSupportedSSLCipherSuites

        @Deprecated
        public static final java.lang.String[] getSupportedSSLCipherSuites()
        Deprecated. As of IBM Integration Bus v10, replaced by IntegrationNodeConnectionParameters
        Minimum set of supported SSL Cipher Suites
        Returns:
        String[] Supported SSL Cipher Suites