Connect:Direct node properties file format

The ConnectDirectNodeProperties.xml file in the Connect:Direct® bridge agent configuration directory specifies information about remote Connect:Direct nodes that are involved in a file transfer.

The ConnectDirectNodeProperties.xml file must conform to the ConnectDirectNodeProperties.xsd schema. The ConnectDirectNodeProperties.xsd schema document is located in the install_directory/samples/schema directory of the WMQFTE installation. A template ConnectDirectNodeProperties.xml file is created by the fteCreateCDAgent command in the agent configuration directory.

Schema

The following schema describes which elements are valid in the ConnectDirectNodeProperties.xml file.

<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://wmqfte.ibm.com/ConnectDirectNodeProperties" 
        elementFormDefault="qualified" 	
        xmlns="http://www.w3.org/2001/XMLSchema" 
        xmlns:tns="http://wmqfte.ibm.com/ConnectDirectNodeProperties">

    <element name="nodeProperties" type="tns:nodePropertiesType"></element>  	

    <complexType name="nodePropertiesType"> 		
        <sequence> 			
            <element name="node" type="tns:nodeType" minOccurs="0" maxOccurs="unbounded"></element> 		
        </sequence> 	
    </complexType>  	

    <complexType name="nodeType"> 		
        <attribute name="name" type="string" use="required" /> 		
        <attribute name="pattern" type="tns:patternType" use="optional" /> 		
        <attribute name="type" type="string" use="required" /> 	
    </complexType>  	

    <simpleType name="patternType"> 		
        <restriction base="string"> 			
            <enumeration value="regex" /> 			
            <enumeration value="wildcard" /> 		
        </restriction> 	
    </simpleType> 

</schema>

Understanding the ConnectDirectNodeProperties.xml file

The elements and attributes used in the ConnectDirectNodeProperties.xml file are described in the following list.
nodeProperties
Root element of the XML document.
node
Specifies one or more Connect:Direct nodes.
Attribute Description
name A pattern that identifies the names of Connect:Direct nodes that use the definitions specified by the node element. Pattern matching is not case sensitive.
pattern Specifies the type of pattern that is used for the value of the name attribute. Valid values for the pattern attribute are:
  • wildcard - wildcards are used
  • regex - Java™ regular expressions are used
For information about the types of regular expressions used by WMQFTE, see Regular expressions used by WebSphere MQ File Transfer Edition.
type Specifies the operating system type of the Connect:Direct node or nodes that match the pattern given by the name attribute. Valid values for the type attribute are:
  • Windows - the node runs on Windows
  • UNIX - the node runs on UNIX or Linux
  • z/OS, zos, os/390, or os390 - the node runs on z/OS®
The value of this attribute is not case sensitive.

Example

In this example, the file specifies that all Connect:Direct nodes that have a name that begins with cdnodew run on a Windows platform, all Connect:Direct nodes that have a name that begins with cdnodeu run on a UNIX platform, and that all Connect:Direct nodes that have a name that begins with cdnodez run on z/OS. The file specifies that all other Connect:Direct nodes run on a UNIX platform. The Connect:Direct bridge agent searches for matches from the top of the file to the bottom and uses the first match that it finds.
<?xml version="1.0" encoding="UTF-8"?> 	
<tns:nodeProperties xmlns:tns="http://wmqfte.ibm.com/ConnectDirectNodeProperties"
                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                    xsi:schemaLocation="http://wmqfte.ibm.com/ConnectDirectNodeProperties 
                                                             ConnectDirectNodeProperties.xsd"> 		

    <tns:node name="cdnodew*" pattern="wildcard" type="windows" />
    <tns:node name="cdnodeu.*" pattern="regex" type="unix" />
    <tns:node name="cdnodez*" pattern="wildcard" type="zos" />
    <tns:node name="*" pattern="wildcard" type="unix" />

</tns:nodeProperties>

Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/cd_node_props_format.htm