Connecting to an integration node by creating a .broker file

View the schema and an example of a .broker file, which contains connection settings for a specific integration node.

Use a .broker file to define connection details for a specific integration node, including host, port, and optionally password and SSL security credentials. You can then share this stored connection information between different users and commands, so that this information does not have to be typed manually each time. For example, you might specify a .broker file so that multiple users can connect to a remote integration node that has SSL enabled on its web administration port.

You can create a .broker file in a text editor by using the XML schema that is provided in this topic. You can reference the .broker file in the IBM® Integration Toolkit, in commands, and in the IBM Integration API.

The following mqsi* commands can reference a .broker file, by using the -n parameter:
  • mqsiattachpolicy
  • mqsicacheadmin
  • mqsichangepolicy
  • mqsichangeresourcestats
  • mqsicreatepolicy
  • mqsicreateexecutiongroup
  • mqsideleteexecutiongroup
  • mqsideletepolicy
  • mqsideploy
  • mqsidetachpolicy
  • mqsilist
  • mqsireloadsecurity
  • mqsireportpolicy
  • mqsireportresourcestats
  • mqsistartmsgflow
  • mqsistopmsgflow
  • mqsiwebuseradmin
A sample .broker file is as follows:
<?xml version="1.0" encoding="utf-8"?>
<IntegrationNodeConnectionParameters Version="10.0.0" host="localhost" listenerPort="4414" integrationNodeName="IBNODE" userName="user"  password="password" useSsl="true" sslTrustStorePassword="password" sslTrustStorePath="c:\keystore\my_keystore.jks" xmlns="http://www.ibm.com/xmlns/prod/websphere/iib/8/IntegrationNodeConnectionParameters" />

This example enables an SSL connection to an integration node named IBNODE that is running on host 'localhost'. IBNODE uses port 4414 for its HTTPS web administration connections.

The .broker file is based on the following XML schema:

<?xml version="1.0" encoding="UTF-8"?><xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.ibm.com/xmlns/prod/websphere/iib/8/IntegrationNodeConnectionParameters">
    <xsd:element name="IntegrationNodeConnectionParameters">
    	<xsd:complexType>
    		<xsd:attribute name="Version" use="required">
    			<xsd:simpleType>
    				<xsd:restriction base="xsd:string">
    					<xsd:pattern value="\d\d[0-9\.]*"></xsd:pattern>
    				</xsd:restriction>
    			</xsd:simpleType>
    		</xsd:attribute>
    		<xsd:attribute name="host" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="listenerPort" type="xsd:int"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="integrationNodeName" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="userName" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
                 <xsd:attribute name="password" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="useSsl" type="xsd:boolean"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="sslTrustStorePassword" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
    		<xsd:attribute name="sslTrustStorePath" type="xsd:string"
    			use="optional">
    		</xsd:attribute>
    	</xsd:complexType>
    </xsd:element>
</xsd:schema>