com.ibm.broker.config.proxy

Class MQConfigManagerConnectionParameters

  • java.lang.Object
    • com.ibm.broker.config.proxy.MQConfigManagerConnectionParameters
  • All Implemented Interfaces:
    ConfigManagerConnectionParameters

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

    @Deprecated
    public class MQConfigManagerConnectionParameters
    extends java.lang.Object
    implements ConfigManagerConnectionParameters

    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 allows user-written IBM Integration API (CMP) applications to specify a set of connection parameters that can be used to connect to MQ-based brokers.

    This class is included for compatibility with older applications. 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 f51619.1 2008-07-17 HDMPL v7 Release: Deprecated class

    • Constructor Summary

      Constructors 
      Constructor and Description
      MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr)
      Deprecated. 
      Takes the parameters required to connect to a WebSphere MQ-based broker.
      MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname)
      Deprecated. 
      Takes the parameters required to connect to a WebSphere MQ-based broker.
      MQConfigManagerConnectionParameters(java.lang.String ip, int port, java.lang.String qmgr, java.lang.String mqseClassname, java.net.URL mqseURL)
      Deprecated. 
      Takes the parameters required to connect to a WebSphere MQ-based broker.
      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)
      Deprecated. 
      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)
      Deprecated. 
      Takes the parameters required to connect to an WebSphere MQ-based broker.
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method and Description
      void disableDomainAwareness()
      Deprecated. 
      As of WebSphere Message Broker V7, Configuration Manager ACLs are no longer used, and so this method is no longer required.
      static void disableMQJavaClientTracing()
      Deprecated. 
      Disables WebSphere MQ Java Client tracing
      static void enableMQJavaClientTracing(java.lang.String filename)
      Deprecated. 
      Sends level 5 WebSphere MQ Java Client tracing to the specified file.
      static java.lang.String generateUniqueDeployID()
      Deprecated. 
      This method should not be invoked by user applications.
      java.lang.String getDeployID()
      Deprecated. 
      This method should not be used.
      com.ibm.broker.config.proxy.CommsMessageSerializer getProtocol()
      Deprecated. 
      This method is required by the IBM Integration API (CMP) and should not be called by user applications.
      com.ibm.broker.config.proxy.Receiver getReceiver()
      Deprecated. 
      This method is required by the IBM Integration API (CMP) and should not be called by user applications.
      com.ibm.broker.config.proxy.Sender getSender()
      Deprecated. 
      This method is required by the IBM Integration API (CMP) and should not be called by user applications.
      java.lang.String getSessionIDString()
      Deprecated. 
      Returns a String representation of the session Id for this connection to the broker.
      static java.lang.String[] getSupportedSSLCipherSuites()
      Deprecated. 
      Minimum set of supported SSL Cipher Suites
      java.lang.String getUserID()
      Deprecated. 
      Returns the userid and machine name string that will be used to authorize this application with the broker.
      void setAdvancedConnectionParameters(java.lang.String channelName, java.lang.String requestQueueName, java.lang.String responseQueueName, int maxRetries, int retryWaitMillis, java.lang.String deployID, byte[] sessionID)
      Deprecated. 
      Sets the 'advanced' options for a connection to MQ.
      java.lang.String toString()
      Deprecated. 
      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

      • MQConfigManagerConnectionParameters

        public MQConfigManagerConnectionParameters(java.lang.String ip,
                                                   int port,
                                                   java.lang.String qmgr)
        Deprecated. 
        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 ConfigManagerProxy.getInstance().
        Parameters:
        ip - IP Address of the target server
        port - Port of the target server
        qmgr - WebSphere MQ queue manager which the broker is using
      • MQConfigManagerConnectionParameters

        public MQConfigManagerConnectionParameters(java.lang.String ip,
                                                   int port,
                                                   java.lang.String qmgr,
                                                   java.lang.String mqseClassname)
        Deprecated. 
        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 ConfigManagerProxy.getInstance().
        Parameters:
        ip - IP Address of the target server
        port - Port of the target server
        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.
      • MQConfigManagerConnectionParameters

        public MQConfigManagerConnectionParameters(java.lang.String ip,
                                                   int port,
                                                   java.lang.String qmgr,
                                                   java.lang.String mqseClassname,
                                                   java.net.URL mqseURL)
        Deprecated. 
        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 ConfigManagerProxy.getInstance().
        Parameters:
        ip - IP Address of the target server
        port - Port of the target server
        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.
      • MQConfigManagerConnectionParameters

        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)
        Deprecated. 
        Takes the parameters required to connect to an 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 ConfigManagerProxy.getInstance().
        Parameters:
        ip - IP Address of the target server
        port - Port of the target server
        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 separated list of LDAP servers hosting CRLs
      • MQConfigManagerConnectionParameters

        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.util.Collection<java.security.cert.CertStore> sslCRLLdapCollection)
        Deprecated. 
        Constructor. 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 ConfigManagerProxy.getInstance().
        Parameters:
        ip - IP Address of the target server
        port - Port of the target server
        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

      • setAdvancedConnectionParameters

        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)
        Deprecated. 
        Sets the 'advanced' options for a connection to MQ. User-written IBM Integration API (CMP) applications should never need to use this method.
        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 messages should be resent after consecutive failures. If this is set to -1, the existing value will be used.
        retryWaitMillis - The time (in milliseconds) to wait between retries. If this is set to -1, the existing value will be used.
        deployID - This parameter is not 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.
      • getProtocol

        public com.ibm.broker.config.proxy.CommsMessageSerializer getProtocol()
        Deprecated. 
        This method is required by the IBM Integration API (CMP) and should not be called by user applications. Returns an instance of the wire protocol associated with this connection.
        Specified by:
        getProtocol in interface ConfigManagerConnectionParameters
        Returns:
        CommsMessageSerializer an object capable of turning Comms Messages into byte streams.
      • toString

        public java.lang.String toString()
        Deprecated. 
        For diagnostic information, this method displays the current connection parameters.
        Overrides:
        toString in class java.lang.Object
      • getDeployID

        public java.lang.String getDeployID()
        Deprecated. This method should not be used.
        Functionally equivalent to getUserID().
        Specified by:
        getDeployID in interface ConfigManagerConnectionParameters
        Returns:
        String
      • disableDomainAwareness

        public void disableDomainAwareness()
        Deprecated. As of WebSphere Message Broker V7, Configuration Manager ACLs are no longer used, and so this method is no longer required.
        This method does nothing.
      • getUserID

        public java.lang.String getUserID()
        Deprecated. 
        Returns the userid and machine name string that will be used to authorize this application with the broker.
        Specified by:
        getUserID in interface ConfigManagerConnectionParameters
        Returns:
        String userId and machine, in the form "user@machine"
      • enableMQJavaClientTracing

        public static final void enableMQJavaClientTracing(java.lang.String filename)
        Deprecated. 
        Sends level 5 WebSphere MQ Java Client tracing to the specified file.
        Parameters:
        filename - of the trace file
      • disableMQJavaClientTracing

        public static final void disableMQJavaClientTracing()
        Deprecated. 
        Disables WebSphere MQ Java Client tracing
      • getSessionIDString

        public java.lang.String getSessionIDString()
        Deprecated. 
        Returns a String representation of the session Id for this connection to the broker.
        Returns:
        String representation of the session Id.
      • generateUniqueDeployID

        public static java.lang.String generateUniqueDeployID()
        Deprecated. This method should not be invoked by user applications.
        The effects of calling this method are undefined.
        Returns:
        String
      • getSupportedSSLCipherSuites

        public static final java.lang.String[] getSupportedSSLCipherSuites()
        Deprecated. 
        Minimum set of supported SSL Cipher Suites
        Returns:
        String[] Supported SSL Cipher Suites