文件传输状态消息格式
将消息发布到协调队列管理器中以指示传输集中每个文件的传输状态。 每次由代理处理文件传输的请求时,都会将事务消息发布到协调队列管理器中(在其 SYSTEM.FTE/Transfers/agent_name /transfer ID 主题中),它符合 TransferStatus.xsd XML 模式。 TransferStatus.xsd 文件位于 WMQMFT 安装的 MQ_INSTALLATION_PATH/mqft/samples/schema 目录中。
模式
以下模式描述了在传输状态 XML 消息中哪些元素有效。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<xsd:include schemaLocation="fteutils.xsd"/>
<xsd:element name="transaction">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="sourceAgent" type="agentType"
maxOccurs="1" minOccurs="1"/>
<xsd:element name="destinationAgent" type="agentType"
maxOccurs="1" minOccurs="1"/>
<xsd:element name="transferSet" type="transferSetType"
maxOccurs="1" minOccurs="1"/>
</xsd:sequence>
<xsd:attribute name="version" type="versionType" use="required"/>
<xsd:attribute name="ID" type="IDType" use="required"/>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="transferSetType">
<xsd:sequence>
<xsd:element name="stats" type="statsType"
maxOccurs="1" minOccurs="1" />
<xsd:element name="current" type="currentType"
maxOccurs="1" minOccurs="0" />
</xsd:sequence>
<xsd:attribute name="time" type="xsd:dateTime" use="required" />
</xsd:complexType>
<xsd:complexType name="currentType">
<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="transferred" type="xsd:nonNegativeInteger" use="required" />
<xsd:attribute name="size" type="xsd:nonNegativeInteger" use="required" />
</xsd:complexType>
<xsd:complexType name="statsType">
<xsd:attribute name="bytes" type="xsd:nonNegativeInteger" use="required" />
<xsd:attribute name="seconds" type="xsd:decimal" use="required" />
<xsd:attribute name="currentItem" type="xsd:nonNegativeInteger" use="required" />
<xsd:attribute name="totalItems" type="xsd:nonNegativeInteger" use="required" />
</xsd:complexType>
</xsd:schema>了解传输状态消息
下表描述了传输状态消息中使用的元素和属性:- <transaction>
- 包含用于文件传输的所有元素的组元素。
属性 描述 版本 指定 Managed File Transfer提供的此元素的版本。 标识 文件传输的唯一标识。 - <sourceAgent>
- 指定源文件所在系统上的代理的名称。
属性 描述 客服 代理的名称。 QMgr 代理队列管理器的名称。 - <destinationAgent>
- 指定您要向其传输文件的系统上代理的名称。
属性 描述 客服 代理的名称。 QMgr 代理队列管理器的名称。 - <transferset>
- 指定正一起执行的一组文件传输。 传输中的所有文件都必须开始于相同的源代理,结束于相同的目标代理。
属性 描述 时间 指定日期和时间(采用日期时间格式)。 - <stats>
- 必需。 定义关于在给定秒数内传输的度量值,包括迄今为止复制的字节数。 同时还在 <transferSet> 中提供当前项号与总项数。
属性 描述 字节 迄今为止复制的字节数。 秒 传输这些字节所花费的秒数。 currentItem 正传输的当前项的索引。 totalItems 正传输的总项数。 - <current>
- 可选元素。 包含指定目前正在进行的文件传输的元素的组元素。 <current> 元素指示迄今为止已为当前项传输的数据字节数以及预期的字节总数。
- <source>
- 包含指定源文件名的元素的组元素。
- <file>
- 指定要传输的文件的源路径。 该路径是为传输指定的路径。 该路径可能与作为传输日志一部分输出的路径不同,后者是路径的绝对形式。
- <destination>
- 包含指定目标文件名或规范的元素的组元素。
- <file>
- 指定要传输的文件的目标路径。 该路径是为传输指定的路径。 该路径可能与作为传输日志一部分输出的路径不同,后者是路径的绝对形式。
属性 描述 别名 指定目标文件的别名。 该别名是源文件的名称,不包括针对传输指定的任何目录路径。 filespace 指定将目标文件写入的文件空间的名称。 - <queue>
- 与 <destination> 元素一起使用时,指定要传输到的队列的名称。 该名称格式为 QUEUE 或 QUEUE@QUEUE_MANAGER。