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
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®
Example
In this example, the file specifies
that all Connect:Direct nodes
that have a name that begins with
cdnodewrun on a Windows platform, all Connect:Direct nodes that have a name that begins with
cdnodeurun on a UNIX platform, and that all Connect:Direct nodes that have a name that begins with
cdnodezrun 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>