檔案傳送要求訊息格式

檔案傳送是由到達代理程式指令佇列的 XML 訊息所起始，通常是因為使用者發出檔案傳送指令或使用「 IBM® WebSphere® MQ 探險家」外掛程式。 The transfer request XML must conform to the FileTransfer.xsd schema and have the <request> element as the root element. FileTransfer.xsd 綱目文件位於 MQ_INSTALLATION_PATH/mqft/samples/schema 目錄中。 FileTransfer.xsd 綱目會匯入 fteutils.xsd，它位於相同的目錄中。

檔案傳送訊息可具有下列三個根元素之一：

<request> - 用於新的檔案傳送要求、受管理的呼叫要求或刪除擱置中的排定傳送
<cancel> - 用於取消正在進行的檔案傳送
<transferSpecifications> - for specifying multiple transfer file groups, used by the fteCreateTransfer command

For information about specifying multiple transfer groups by using the <transferSpecifications> element, see 使用傳送定義檔.

綱目

下列綱目說明哪些元素在傳送要求 XML 訊息中是有效的。

<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema">

<xsd:include schemaLocation="fteutils.xsd"/>

    <!--
        Defines the request of a managed transfer and version number
        <request version="1.00" ...
            <managedTransfer>
                ...
            </managedTransfer>
        </request>
     -->
    <xsd:element name="request">
        <xsd:complexType>
            <xsd:choice>
                <xsd:element name="managedTransfer" type="managedTransferType"/>
                <xsd:element name="deleteScheduledTransfer" type="deleteScheduledTransferType" />
                <xsd:element name="managedCall" type="managedCallType"/>
            </xsd:choice>
            <xsd:attribute name="version" type="versionType" use="required" />
        </xsd:complexType>
    </xsd:element>

    <!--
        Defines the cancel request of a managed transfer and version number
        <cancel version="1.00"
                  xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
                  xsi:noNamespaceSchemaLocation="FileTransfer.xsd">
            <originator>
                <hostName>myMachine</hostName>
                <userID>myUserId</userID>
            </originator>     - Delete a scheduled transfer.
            
            <transfer>
               Transfer ID to Cancel
            </transfer>
        </cancel>
     -->
    <xsd:element name="cancel">
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element name="originator" type="hostUserIDType" maxOccurs="1" minOccurs="1" />
                <xsd:choice> 
                    <xsd:element name="transfer" type="IDType" maxOccurs="1" minOccurs="1" />
                    <xsd:element name="call"     type="IDType" maxOccurs="1" minOccurs="1" />
                </xsd:choice>
                <xsd:element name="reply"      type="replyType"      maxOccurs="1" minOccurs="0" />
            </xsd:sequence>
            <xsd:attribute name="version" type="versionType" use="required" />
        </xsd:complexType>
    </xsd:element>

    <!--
        Defines the transfer definition element structure.
        <transferSpecifications>
            <item ...
            <item ...
        </transferSpecifications>
     -->
    <xsd:element name="transferSpecifications">
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element name="item" type="itemType" minOccurs="1" maxOccurs="unbounded" />
            </xsd:sequence>
        </xsd:complexType>
    </xsd:element>

    <!--
        Define a managed transfer of an instigator and request
        <managedTransfer>

            <originator>
                ...
            </originator>

            <schedule>
                <submit timebase="source"|"UTC">2008-12-07T16:07"</submit>
                <repeat>
                    <frequency interval="hours">2</frequency>
                    <expireTime>2008-12-0816:07</expireTime>
                </repeat>
            </schedule>

            <sourceAgent agent="here" QMgr="near" />
            <destinationAgent agent="there" QMgr="far" />

            <trigger>
            ...
            </trigger>

            <transferSet>
                ...
            </transferSet>
        </managedTransfer>
     -->

     <xsd:complexType name="managedTransferType">
         <xsd:sequence>
            <xsd:element name="originator"       type="origTransferRequestType"  maxOccurs="1" minOccurs="1"/>
            <xsd:element name="schedule"         type="scheduleType"     maxOccurs="1" minOccurs="0"/>
            <xsd:element name="sourceAgent"      type="agentType"        maxOccurs="1" minOccurs="1"/>
            <xsd:element name="destinationAgent" type="agentClientType"  maxOccurs="1" minOccurs="1" />
            <xsd:element name="trigger"          type="triggerType"      maxOccurs="1" minOccurs="0" />
            <xsd:element name="reply"            type="replyType"        maxOccurs="1" minOccurs="0" />
            <xsd:element name="transferSet"      type="transferSetType"  maxOccurs="1" minOccurs="1" />
            <xsd:element name="job"              type="jobType"          maxOccurs="1" minOccurs="0"/>
        </xsd:sequence>
    </xsd:complexType>

    <!--
         This is a modified form of origRequestType which is used on a managed transfer request.
         The hostName and userID are mandatory attributes in this case.
     -->
    <xsd:complexType name="origTransferRequestType">
        <xsd:sequence>
            <xsd:element name="hostName" type="xsd:string" minOccurs="1" maxOccurs="1"/>
            <xsd:element name="userID" type="xsd:string" minOccurs="1" maxOccurs="1"/>
            <xsd:element name="mqmdUserID" type="xsd:string" minOccurs="0" maxOccurs="1"/>
            <xsd:element name="webBrowser" type="xsd:string" minOccurs="0" maxOccurs="1"/>
            <xsd:element name="webUserID" type="xsd:string" minOccurs="0" maxOccurs="1"/>
        </xsd:sequence>
    </xsd:complexType>

    <!--
        Defines the transferset of source and destination agent and one or more files
        <transferset priority="1">
            <metaDataSet>
                <metaData key="keyname">keyvalue</metaData>
                <metaData key="keyname">keyvalue</metaData>
            </metaDataSet>

            <item>
                ...
            </item>
        </transferset>
     -->
    <xsd:complexType name="transferSetType">
        <xsd:sequence>
            <xsd:element name="metaDataSet"         type="metaDataSetType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="preSourceCall"       type="commandActionType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="postSourceCall"      type="commandActionType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="preDestinationCall"  type="commandActionType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="postDestinationCall" type="commandActionType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="item" type="itemType" maxOccurs="unbounded" minOccurs="0" />
        </xsd:sequence>
        <xsd:attribute name="priority" type="priorityType" use="optional" />
    </xsd:complexType>


    <!--
        Define a file pair with source and destination
        <item mode=[binary|text]>
            <source recursive="false" disposition="leave">
                <file>filename</file>
            </source>

            <destination type="file" exist="error">
                <file>filename</file>
            </destination>

        </item>
    -->
    <xsd:complexType name="itemType">
        <xsd:sequence>
            <xsd:element name="source"      type="fileSourceType"       maxOccurs="1" minOccurs="1" />
            <xsd:element name="destination" type="fileDestinationType"  maxOccurs="1" minOccurs="1" />
        </xsd:sequence>
        <xsd:attribute name="mode" type="modeType" use="required" />
        <xsd:attribute name="checksumMethod" type="checkSumMethod" use="required" />
    </xsd:complexType>

    <!--
        Defines the request to delete scheduled file transfer.
        <deleteScheduledTransfer>
            <originator>
                <delete>
                    <hostName>myMachine</hostName>
                    <userID>myUserId</userID>
                </delete>
            </originator>
            <ID>56</ID>
        </deleteScheduledTransfer>
     -->
    <xsd:complexType name ="deleteScheduledTransferType">
        <xsd:sequence>
            <xsd:element name="originator" type="origDeleteType" maxOccurs="1" minOccurs="1" />
            <xsd:element name="ID"         type="idType"         maxOccurs="1" minOccurs="1" />
            <xsd:element name="reply"      type="replyType"      maxOccurs="1" minOccurs="0" />
        </xsd:sequence>
    </xsd:complexType>


    <xsd:complexType name="managedCallType">
        <xsd:sequence>
            <xsd:element name="originator"  type="origRequestType"  maxOccurs="1" minOccurs="1"/>
            <xsd:element name="agent"       type="agentType"        maxOccurs="1" minOccurs="1"/>
            <xsd:element name="reply"       type="replyType"        maxOccurs="1" minOccurs="0" />
            <xsd:element name="transferSet" type="callTransferSetType"  maxOccurs="1" minOccurs="1" />
            <xsd:element name="job"         type="jobType"          maxOccurs="1" minOccurs="0"/>
        </xsd:sequence>
    </xsd:complexType>

    <xsd:complexType name="callTransferSetType">
        <xsd:sequence>
            <xsd:element name="metaDataSet" type="metaDataSetType" maxOccurs="1" minOccurs="0" />
            <xsd:element name="call" type="commandActionType" maxOccurs="1" minOccurs="1" />
        </xsd:sequence>
        <xsd:attribute name="priority" type="priorityType" use="optional" />
    </xsd:complexType>
</xsd:schema>

瞭解傳送要求訊息

下列清單中說明在傳送要求訊息中使用的元素及屬性：

元素說明

<request>

群組元素，包含指定檔案傳送要求需要的所有元素。

屬性	說明
version	指定此元素的版本，由 WebSphere MQ Managed File Transfer提供。

<managedTransfer>

群組元素，包含單一檔案傳送或單一檔案傳送群組需要的所有元素。

<deleteScheduledTransfer>

群組元素，包含用來取消排程傳送的發送端及 ID 資訊。

<managedCall>

群組元素，包含程式或執行檔的單一受管理呼叫需要的所有元素。

<ID>

唯一 ID，指定要從擱置的排定傳送清單中刪除的傳送要求。

<originator>

群組元素，包含指定要求發送端的元素。

<hostName>

來源檔案所在系統的主機名稱。

<userID>

發出檔案傳送的使用者 ID。

<mqmdUserID>

選用項目。在訊息描述子 (MQMD) 中提供的 IBM WebSphere MQ 使用者 ID。

<schedule>

群組元素，說明檔案傳送的排定時間、重複行為及下次發生時間。

<submit>

指定排定傳送應該開始的日期和時間。

屬性	說明
timebase	指定要使用的時區。此屬性可具有下列其中一個值： source - 使用來源代理程式的時區 admin - 使用發出此指令的管理者的時區 UTC - 使用世界標準時間 (UTC)
時區	根據 timebase 值的時區說明

<repeat>

群組元素，包含排定傳送多久重複一次、排定傳送重複的次數及排定傳送何時停止重複的相關詳細資料。

<frequency>

在重複傳送之前必須經歷的時段。

屬性	說明
區間	間隔單位，必須是下列其中一個值：分鐘時日週月年

<expireTime>

選用元素，指定排定傳送停止重複的日期和時間。此元素與 <expireCount> 元素互斥。

<expireCount>

選用元素，指定排定檔案傳送在停止之前發生的次數。此元素與 <expireTime> 元素互斥。

<sourceAgent>

指定來源檔案所在系統上的代理程式名稱。

屬性	說明
代理程式 (agent)	指定代理程式的名稱。
QMgr	代理程式佇列管理程式的名稱。

<destinationAgent>

指定系統上要做為檔案傳送目的地的代理程式名稱。

屬性	說明
代理程式 (agent)	指定代理程式的名稱。
QMgr	代理程式佇列管理程式的名稱。
hostName	代理程式佇列管理程式的主機名稱或 IP 位址。
portNumber	用於與目的地代理程式佇列管理程式進行用戶端連線的埠號。
channel	用來連接至目的地代理程式佇列管理程式的通道名稱。

<trigger>

選用元素，指定要進行檔案傳送時必須具備的條件。

屬性	說明
log	指出是否記載觸發失敗的旗標。有效值如下所示： yes - 會針對失敗的觸發傳送建立日誌項目 no - 不會針對失敗的觸發傳送建立日誌項目

<fileExist>

指定以逗點區隔的檔案名稱清單，這些檔案名稱位於與來源代理程式相同的系統上。如果此名稱清單中的檔案滿足觸發的條件，就會進行傳送。此元素與 <fileSize> 元素互斥。

屬性	說明
comparison	指出如何根據名稱清單評估來源檔案名稱。有效值如下所示： = 名稱清單中至少有一個檔案名稱必須符合 != 名稱清單中至少有一個檔案不存在
value	指出比較類型： exist：檔案必須存在

<fileSize>

指定以逗點區隔的檔案名稱清單，這些檔案名稱位於與來源代理程式相同的系統上。如果此名稱清單中的檔案滿足觸發的條件，就會進行傳送。此元素與 <fileExist> 元素互斥。

屬性	說明
comparison	指出如何根據名稱清單評估來源檔案名稱。有效值如下所示： >= 名稱清單中有一個檔案名稱存在，且檔案大小最少為 value 屬性指定的大小
value	指定為整數值的檔案大小，其單位指定為下列其中一項： B - 位元組 KB - 千位元組 MB - 百萬位元組 GB - 十億位元組（單位值不區分大小寫）

<reply>

指定對同步檔案傳送產生的暫時回覆佇列名稱（在指令行上使用 -w 參數指定）。佇列名稱是由 command.properties 配置檔中的索引鍵 dynamicQueuePrefix 或預設值 WMQFTE.* 所定義。 (如果未指定的話)。

屬性	說明
QMGR	產生暫時動態佇列以接收回覆的指令佇列管理程式的名稱。
persistent	寫入回覆佇列的訊息是否具有持續性。有效值如下所示： true - 訊息具有持續性 false - 訊息不具有持續性 qdef - 訊息的持續性由回覆佇列的內容定義預設值是 false。

<transferSet>

指定您想要一起執行的檔案傳送群組，或您想要一起執行的受管理呼叫群組。在傳輸期間，<transferSet> 是包含 <item> 元素的群組元素。

屬性	說明
priority	傳送的優先順序層次。優先順序是範圍 0-9 中的值，其中 0 是最低優先順序。預設優先順序層次是 0，依預設，傳送時會使用來源代理程式的優先順序層次。

<metaDataSet>

選用群組元素，包含一個以上 meta 資料項目。

<metaData>

指定使用者定義的 meta 資料，其傳送至代理程式呼叫的結束點。此元素包含字串形式的 meta 資料值。

屬性	說明
key	字串形式的 meta 資料名稱

<call>

群組元素，包含指定要呼叫的程式或執行檔的 <command> 元素。

<command>

指定要呼叫的程式或執行檔。此指令必須位於代理程式指令路徑中。如需相關資訊，請參閱表 2。此元素可以包含選用的 <argument> 元素。

屬性	說明
名	指令的名稱。
successRC	此指令傳回的成功回覆碼。預設值是 0。
retryCount	指令失敗時重試指令的次數。
retryWait	指令重試之間要等待的時間（以秒為單位）。
類型	要呼叫的程式類型。有效值是 antscript、jcl 或 executable。

<argument>

指定要傳遞至指令的引數。

<item>

群組元素，包含指定來源及目的地檔案名稱和位置的元素。

屬性	說明
mode	指定傳送模式為二進位或文字模式。
checksumMethod	指定產生訊息摘要以建立數位簽章的雜湊演算法類型。有效值是 MD5 或 none。

<source>

群組元素，指定來源系統上的檔案以及傳送完成之後是否移除這些檔案

屬性	說明
recursive	指定當 <source> 元素是目錄或包含萬用字元時，在子目錄中遞迴地傳送檔案。
disposition	指定當 <source> 已順利傳送至其目的地時，對 <source> 元素採取的動作。有效值如下所示： leave - 來源檔案維持不變。 delete - 順利傳送來源檔案之後，即從來源系統中刪除來源檔案。

<file>

指定傳送來源，可以是檔案或目錄名稱。以與作業系統一致的格式使用完整路徑，例如 C:/from/here.txt。請不要使用檔案 URI。

屬性	說明
別名 (alias)	指定來源檔案的別名。此別名是來源檔案的名稱，不包括針對傳送所指定的任何目錄路徑。
EOL	指定文字傳送的行尾標記。有效值為： LF - 僅限換行字元 CRLF - 換行 (carriage return/line feed) 字元序列
encoding	文字檔傳送的來源檔案編碼。
delimiterType	指定包括在目的地檔案中的個別訊息資料之後的定界字元類型。有效值如下所示： binary - 十六進位定界字元只有在已啟用 7.0.4.1 版功能時，才可使用此屬性。
delimiterPosition	指定將記錄導向的來源檔案記錄寫入一般檔案時，要插入定界字元的位置。有效值如下所示： prefix - 將定界字元插入到目的地檔案中，每一個來源記錄導向檔案記錄的資料之前。 postfix - 將定界字元插入到目的地檔案中，每一個來源記錄導向檔案記錄的資料之後。
includeDelimiterInFile	指定是否在記錄導向的來源檔案記錄之間併入定界字元。

<queue>

與 <source> 元素一起使用時，指定要從中傳送的佇列名稱，該佇列必須位於來源代理程式佇列管理程式上。請使用 QUEUE 格式。請不要併入佇列管理程式名稱，該佇列必須在來源代理程式佇列管理程式上。如果您在 <destination> 元素內使用 <queue> 元素，就不能在 <source> 元素內使用它。

屬性	說明
useGroups	指定是否只從來源佇列傳送第一個完整訊息群組。有效值如下所示： true - 只傳送第一個完整訊息群組 false - 傳送來源佇列上的所有訊息
groupId	指定要從來源佇列讀取的訊息群組。只有在 useGroups 屬性的值為 true 時，此屬性才有效。
delimiterType	指定包括在目的地檔案中的個別訊息資料之後的定界字元類型。有效值如下所示： text-文字或 Java 文字定界字元 binary - 十六進位定界字元
delimiter	指定包括在目的地檔案中的個別訊息資料之間的定界字元。
delimiterPosition	指定將定界字元併入在目的地檔案中的個別訊息資料之前或之後。有效值如下所示： prefix - 將定界字元併入在資料之前 postfix - 將定界字元併入在資料之後
encoding	指定來源佇列編碼。
waitTime	指定來源代理程式等待下列情況的時間（以秒為單位）：訊息出現在來源佇列上（如果該佇列是空的或已變成空的）一個完整群組出現在來源佇列上（如果 useGroups 屬性已設為 true）如需設定 waitTime 值的相關資訊，請參閱指定訊息轉為檔案傳送等待時間的指引。

<destination>

指定目的地及行為的群組元素（如果檔案已存在於目的地代理程式上）。

您只能指定 <file> 和 <queue> 其中之一作為目的地的子元素。

屬性	說明
類型	目的地的類型。有效值如下所示： file - 指定檔案作為目的地 directory - 指定目錄作為目的地 queue-指定 IBM WebSphere MQ 佇列作為目的地 filespace- 指定檔案空間作為目的地僅當 <destination> 元素具有 <file>的子元素時，選項檔案及目錄才有效。只有在 <destination> 元素具有 <queue>的子元素時，選項佇列才有效。只有在 <destination> 元素具有 <filespace>的子元素時，選項檔案空間才有效。
exist	指定如果目的地系統上存在目的地檔案時要採取的動作。有效值如下所示： error - 報告錯誤，且不傳送檔案。 overwrite - 改寫現有目的地檔案。如果 <destination> 元素具有 <queue> 或 <filespace>的子元素，則此屬性無效。

屬性

說明

類型

目的地的類型。有效值如下所示：

file - 指定檔案作為目的地
directory - 指定目錄作為目的地
queue-指定 IBM WebSphere MQ 佇列作為目的地
filespace- 指定檔案空間作為目的地

僅當 <destination> 元素具有 <file>的子元素時，選項檔案及目錄才有效。

只有在 <destination> 元素具有 <queue>的子元素時，選項佇列才有效。

只有在 <destination> 元素具有 <filespace>的子元素時，選項檔案空間才有效。

exist

指定如果目的地系統上存在目的地檔案時要採取的動作。有效值如下所示：

error - 報告錯誤，且不傳送檔案。
overwrite - 改寫現有目的地檔案。

如果 <destination> 元素具有 <queue> 或 <filespace>的子元素，則此屬性無效。

<file>

指定傳送目的地，可以是檔案或目錄名稱。請使用完整路徑，其格式與作業系統一致，例如 C:/from/here.txt。請不要使用檔案 URI。

屬性	說明
別名 (alias)	指定目的地檔案的別名。此別名是來源檔案的名稱，不包括針對傳送所指定的任何目錄路徑。
encoding	文字檔傳送的目的地檔案編碼。
EOL	指定文字傳送的行尾標記。有效值為： LF - 僅限換行字元 CRLF - 換行 (carriage return/line feed) 字元序列

<queue>

與 <destination> 元素一起使用時，指定要傳至其中的佇列名稱，其可位於連接至目的地代理程式佇列管理程式的任何佇列管理程式上。請使用 QUEUE@QM 格式，其中 QUEUE 是放置訊息的佇列名稱，QM 是佇列所在的佇列管理程式。如果您在 <source> 元素內使用 <queue> 元素，就不能在 <destination> 元素內使用它。

屬性	說明
delimiter	將檔案分割成多個訊息的定界字元。
delimiterType	指定定界字元的類型。有效值如下所示： text-Java 正規表示式 binary - 十六進位位元組序列 size - 位元組、千位元組或百萬位元組的數目。例如，1 B、1 K 或 1 M。
delimiterPosition	指定預期是在併入個別訊息中的資料之前還是之後會有定界字元。有效選項如下所示： prefix - 預期定界字元在資料之前 postfix - 預期定界字元在資料之後
includeDelimiterInMessage	此布林值指定是否在訊息結尾併入用來將檔案分割成多個訊息的定界字元。
encoding	指定目的地佇列編碼。
persistent	指定訊息是否具有持續性。有效值如下所示： true - 訊息具有持續性 false - 訊息不具有持續性 qdef - 訊息的持續性值由目的地佇列的設定定義
setMqProps	這是一個布林值，指定是否在檔案中的第一則訊息上設定 IBM WebSphere MQ 訊息內容，以及在發生錯誤時寫入佇列的任何訊息。
unrecognisedCodePage	指定如果目的地佇列管理程式無法辨識資料字碼頁，則文字模式傳送是失敗，還是執行轉換。有效值如下所示： fail - 傳送報告失敗 binary-資料轉換為目的地字碼頁，且說明資料格式的 IBM WebSphere MQ 訊息標頭設為 MQFMT_NONE。預設行為是 fail。

<filespace>

群組元素，指定要傳送至其中的檔案空間名稱。

<name>

與 <filespace> 元素一起使用時，此元素的值指定檔案空間的名稱。

<attributes>

Optional group element that contains one or more <attribute> elements to specify distribution attribute information if you are transferring files to a IBM 4690 store controller.

<attribute>

指定檔案配送屬性的選用元素。請指定符號值或數值。

表 1. WebSphere MQ Managed File Transfer 中檔案配送屬性的有效值
符號值	數值	說明
DIST(LOCAL)	DIST(1)	本端檔案
DIST(MIRRORED,UPDATE)	DIST(2)	鏡映檔案，更新時配送
DIST(MIRRORED, CLOSE)	DIST(3)	鏡映檔案，關閉時配送
DIST(COMPOUND,UPDATE)	DIST(4)	複合檔案，更新時配送
DIST(COMPOUND,CLOSE	DIST(5)	複合檔案，關閉時配送

如需 IBM 4690上 WebSphere MQ Managed File Transfer 的配送屬性相關資訊，請參閱檔案配送屬性。

<preSourceCall>

群組元素，指定在傳送開始之前，要在傳送來源呼叫的指令。

<postSourceCall>

群組元素，指定在傳送完成之後，要在傳送來源呼叫的指令。

<preDestinationCall>

群組元素，指定在傳送開始之前，要在傳送目的地呼叫的指令。

<postDestinationCall>

群組元素，指定在傳送完成之後，要在傳送目的地呼叫的指令。

<command>

與 <preSourceCall>、<postSourceCall>、<preDestinationCall> 或 <postDestinationCall> 元素一起使用時，此元素指定要呼叫的指令。此指令必須位於代理程式指令路徑中。如需相關資訊，請參閱表 2。

屬性	說明
名	要執行的指令名稱。
successRC	指令順利執行時所預期的回覆碼。

<argument>

與 <command> 元素一起使用時，此元素指定要傳入指令中的引數。 <command> 元素內可以有任何數量的 <argument> 元素。

<job>

Optional group element containing job information for the entire transfer specification. <job> is a user-defined job name identifier that is added to the log message when the transfer has started. This <job> element is the same as the <job> element that appears in the transfer log message, which is described in the following topic: 檔案傳送日誌訊息格式.

<name>

與 <job> 元素一起使用時，此元素的值指定工作的名稱。

<transferSpecifications>

群組元素，包含用於多個傳送群組的 <item> 元素。如需如何使用此元素的進一步詳細資料，請參閱使用傳送定義檔。

<cancel>

群組元素，包含取消進行中的檔案傳送需要的所有元素。

屬性	說明
version	指定此元素的版本，由 WebSphere MQ Managed File Transfer提供。

<transfer>

與 <cancel> 元素一起使用時，此元素的值指定要取消的傳送要求 ID。

<job>

包含工作資訊的群組元素。

<jobName>

指定邏輯工作 ID。

檔案傳送取消訊息格式

檔案傳送要求會傳回 48 個字元的 ID，以識別特定代理程式的傳送。這個 ID 可用來取消傳送。

瞭解傳送取消訊息

以下說明在傳送取消訊息中使用的元素及屬性：

<cancel>

群組元素，包含取消進行中的檔案傳送需要的所有元素。

屬性	說明
version	指定此元素的版本，由 WebSphere MQ Managed File Transfer提供。

<originator>

群組元素，包含指定要求發送端的元素。

<hostName>

來源檔案所在系統的主機名稱。

<userID>

發出檔案傳送的使用者 ID。

<mqmdUserID>

選用項目。在訊息描述子 (MQMD) 中提供的 IBM WebSphere MQ 使用者 ID。

<transfer>

與 <cancel> 元素一起使用時，此元素的值指定要取消的傳送要求 ID。

<job>

選用項目。包含工作資訊的群組元素。

<jobName>

指定邏輯工作 ID。

範例

針對下列每一個要求，提供了符合此綱目的 XML 訊息的範例：