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® and 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>