Connect:Direct 节点属性文件格式

Connect:Direct® 网桥代理配置目录中的 ConnectDirectNodeProperties.xml 文件指定有关文件传输中涉及的远程 Connect:Direct 节点的信息。

ConnectDirectNodeProperties.xml 文件必须符合 ConnectDirectNodeProperties.xsd 模式。 ConnectDirectNodeProperties.xsd 模式文档位于 MFT 安装的 MQ_INSTALLATION_PATH/mqft/samples/schema 目录中。 模板 ConnectDirectNodeProperties.xml 文件由 fteCreateCDAgent 命令在代理配置目录中创建。

文件 ConnectDirectNodeProperties.xml 由代理定期重载，对该文件的任何有效更改都将影响该代理的行为。 缺省重新装入时间间隔为 30 秒。 该时间间隔可以通过指定 agent.properties 文件中的代理属性 xmlConfigReloadInterval 进行更改。

模式

以下模式描述在 ConnectDirectNodeProperties.xml 文件中有效的元素。

<?xml version="1.0" encoding="UTF-8"?>

<schema targetNamespace="http://wmqfte.ibm.com/ConnectDirectNodeProperties"
  elementFormDefault="qualified"
  xmlns="https://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="credentialsFile" type="tns:credentialsFileName" minOccurs="0" maxOccurs="1" />
      <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>

了解 ConnectDirectNodeProperties.xml 文件

下表中描述了 ConnectDirectNodeProperties.xml 文件中使用的元素和属性。
nodeProperties
XML 文档的根元素。
credentialsFile
存储敏感信息的凭证文件的路径。 对于 IBM® WebSphere® MQ 7.5 或更高版本，此属性的值可以包含环境变量。 有关更多信息，请参阅 MFT 属性中的环境变量
节点
指定一个或多个 Connect:Direct 节点。
属性 描述
名称 一种模式，用于标识使用节点元素指定的定义的 Connect:Direct 节点的名称。 模式匹配不区分大小写。
pattern 指定用于 name 属性值的模式类型。 pattern 属性的有效值为:
  • wildcard - 使用通配符
  • regex - 使用 Java 正则表达式
有关 MFT使用的正则表达式类型的信息，请参阅 MFT 使用的正则表达式。
类型 指定与 name 属性给定的模式匹配的一个或多个 Connect:Direct 节点的操作系统类型。 type 属性的有效值为:
  • Windows - 节点在 Windows 上运行
  • UNIX - 节点在 AIX® 或 Linux®
  • [z/OS]z/OS， zos， os/390或 os390 -节点在 z/OS® 上运行
该属性的值不区分大小写。

示例

在此示例中， Connect:Direct 凭证文件名指定为 ConnectDirectCredentials.xml。 示例代码指定以下平台连接：
  • 名称以 cdnodew 开头的所有 Connect:Direct 节点都在 Windows 平台上运行。
  • 名称以 cdnodeu 开头的所有 Connect:Direct 节点都在 AIX and Linux 平台上运行。
  • 名称以 cdnodez 开头的所有 Connect:Direct 节点都在 z/OS 平台上运行。
  • 所有其他 Connect:Direct 节点都在 AIX and Linux 平台上运行。
Connect:Direct 网桥代理将搜索从文件开头到结尾的匹配项，并使用它找到的第一个匹配项。
<?xml version="1.0" encoding="UTF-8"?> 	
<tns:nodeProperties xmlns:tns="http://wmqfte.ibm.com/ConnectDirectNodeProperties"
                    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
                    xsi:schemaLocation="http://wmqfte.ibm.com/ConnectDirectNodeProperties 
                                                             ConnectDirectNodeProperties.xsd"> 		

    <tns:credentialsFile path="ConnectDirectCredentials.xml" />
    <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>