MFT agent.properties 文件

为了恢复目的而采用检查点的间隔（以完整数据帧为单位）。 这是高级属性，对于大多数 Managed File Transfer 配置，不需要修改其值。

如果存在导致传输进入恢复状态的问题，那么传输只可以恢复到检查点边界。 因此，该值越大（具有较大的 agentChunkSize、agentWindowSize 和 agentFrameSize 值），代理恢复传输所需的时间就越长。 对于传输很少进入恢复状态的可靠 Managed File Transfer 网络，增大此值以提高整体性能可能是有益的。

针对文件数据传输的每个传输块的大小。 因此，表示在源代理和目标代理之间传输的 IBM MQ 消息的最大大小。 这是高级属性，对于大多数 Managed File Transfer 配置，不需要修改其值。

该值是通过源代理和目标代理协商而定，使用两个值中较大一个。 如果要更改此属性的值，请在源代理和目标代理处更改该值。

agentChunkSize 是一个整数值。 例如：agentChunkSize=10240 将块大小设置为 10 KB。

传输帧的窗口数。 这是高级属性，对于大多数 Managed File Transfer 配置，不需要修改其值。

对于具有较长等待时间的网络，增加此值可以提高整体性能，因为这会使代理同时具有更多活动消息块。

该属性的值乘以 agentWindowSize 再乘以 agentChunkSize，指示每个传输的代理内存使用量上限。 例如，针对每个传输，262144 字节块 x 10 x 5 = 12.5MB。

注：如果单个传输中传输的文件大小小于 12.5MB，那么增加该属性值对传输性能无影响。

每个窗口的块数。 这是高级属性，对于大多数 Managed File Transfer 配置，不需要修改其值。

对于具有较长等待时间的网络，增加此值可以提高整体性能。 因为这会使代理同时具有更多活动消息块，并会降低将确认消息发送回源代理的频率。

该属性值乘以agentFrameSize,乘以agentChunkSize,表示每次传输时代理内存消耗的上限，也表示目标代理命令队列中 "IBM MQ消息数据的上限。 例如，针对每个传输，262144 字节块 x 10 x 5 = 上限 12.5MB。

注：如果单个传输中传输的文件大小小于 12.5MB，那么增加该属性值对传输性能无影响。

如果为该属性指定值 0，那么代理会等待所有未完成的传输停止。 如果为该属性指定的值无效，那么将使用缺省值。

用于将消息从 Connect:Direct 网桥代理传输到目标 Connect:Direct 节点的 Connect:Direct 节点的名称。 此节点是 Connect:Direct 网桥的一部分，而不是作为传输源或目标的远程节点。 有关更多信息，请参阅 Connect:Direct 网桥。

在大多数情况下， Connect:Direct 网桥节点与 Connect:Direct 网桥代理位于同一系统上。 在这些情况下，该属性的缺省值（本地系统的 IP 地址）正确。 如果系统具有多个 IP 地址，或者 Connect:Direct 网桥节点与 Connect:Direct 网桥代理位于不同的系统上，并且它们的系统共享文件系统，请使用此属性为 Connect:Direct 网桥节点指定正确的主机名。

如果您未设置 cdNode 属性，那么会忽略该属性。

如果您未设置 cdNode 属性，那么会忽略该属性。

该属性指定了临时存储文件的目录的完整路径。 例如，如果 cdTmpDir设置为 /tmp，那么会将文件临时放置在 /tmp 目录中。

如果您未设置 cdNode 属性，那么会忽略该属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

value_of_java.io.tmpdir
/cdbridge-agentName

value_of_java.io.tmpdir
\cdbridge-agentName

缺省情况下，操作系统选择本地端口号。

• TCPIP
• SSL
• TLS

如果未将 cdNodeProtocol 属性设置为 SSL 或 TLS，那么会忽略该属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

如果未将 cdNodeProtocol 属性设置为 SSL 或 TLS，那么会忽略该属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

有关创建认证凭证文件的详细信息，请参阅 在 z/OS上配置 MQMFTCredentials.xml

请参阅 配置 MQMFTCredentials.xml ，以获取有关此文件的位置和许可权的信息。

有关创建认证凭证文件的更多详细信息，请参阅 MFT 和 IBM MQ 连接认证

如果未将 cdNodeProtocol 属性设置为 SSL 或 TLS，那么会忽略该属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

如果未将 cdNodeProtocol 属性设置为 SSL 或 TLS，那么会忽略该属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

在 z/OS

有关创建认证凭证文件的更多详细信息，请参阅 MFT 和 IBM MQ 连接认证

如果重新启动代理，那么即使触发传输的次数已超出 monitorGroupRetryLimit 的值，监视器仍会再次触发传输。 如果该行为导致触发传输的次数超出 monitorGroupRetryLimit 的值，那么代理会向其事件日志中写入一个错误。

如果对该属性指定值 -1，那么监视器会不限制次数地再次触发传输，直至不满足触发条件。

如果将此属性设置为太小的值，那么 IBM MQ 网络的性能可能会受到负面影响。

确定 Managed File Transfer Agent 是否检查是否有足够的内存可用于在接受传输之前运行传输。 源和目标代理上都会执行该检查。 如果没有足够的内存，将拒绝此传输。

在计算传输所需的内存时，将使用传输所需的最大内存。 所以，该值可能大于传输使用的实际内存。 因此，如果 enableMemoryAllocationChecking 属性设置为 true，可运行的并行传输的数量可能会下降。 仅当迂到 Managed File Transfer 因内存不足错误而失败的问题时，建议将此属性设置为 true。 可能使用大量内存的传输包括消息大小较大的“文件到消息”传输和“消息到文件”传输。

仅当受管传输请求指定详细回复信息为必需时，才会包含详细回复信息。 To specify this requirement, set the detailed attribute of the <reply> element of the managedTransfer XML request message sent to the source agent. 有关更多信息，请参阅 文件传输请求消息格式。

可以为每个传输请求生成多条回复消息。 该数目等于传输的传输日志进度消息数目加 1（其中，第一条回复消息为简单 ACK 回复）。 除 ACK 回复消息外，所有消息中都包含详细信息，但总体传输结果仅包含在最后一条详细回复消息中。

• com.ibm.wmqfte.insertRecordLineSeparator
• com.ibm.wmqfte.newRecordOnLineSeparator
• com.ibm.wmqfte.convertLineSeparators

该属性的值可以为 true 或 false。

要启用此功能，源代理和目标代理都必须应用APARIT03450，并且源代理 "agent.properties文件中的failTransferOnFirstFailure属性必须设为true。 在目标代理上将该属性设置为 true 是可选的。

如果未将 failTransferOnFirstFailure 属性设置为 true、受管文件传输包含多个文件并且其中一个文件传输失败（例如，由于目标文件已存在并且覆盖属性设置为 error），那么源代理将继续并尝试传输请求中的任何剩余文件。

代理发布其下一条进度日志消息之前传输的文件数。 使用该属性控制在传输期间将进度日志消息发布到协调队列管理器的速率。

该属性可以设置的最大值为 1000。

对于单个文件到文件或“文件到消息”传输，可以自动包含在初始传输请求消息中的最大文件大小（字节）。

您可以使用该属性提高传输速度，但如果将文件大小设置为过大的值，这可能会降低性能。 该属性的建议初始大小是 100KB，但建议彻底测试不同值，直到找到最适合系统的文件大小。

缺省情况下，代理将写入目标上的临时文件中，并在文件传输完成后，将该临时文件重命名为所需的文件名。 将该值设置为 true 会使代理对最终的目标文件进行直接写入。

在 z/OS 系统上，此行为不适用于连续数据集，但适用于 PDS 数据集成员。

该属性的用于传输的值由目标代理定义。

在 Windows 文件锁定时仅提供建议。 当此属性设置为 true 时， Managed File Transfer 将强制文件锁定。 在 Windows 上，这意味着如果另一个应用程序打开一个文件，那么不会触发监视该文件，直至文件关闭。 涉及该文件的 Managed File Transfer 传输失败。

在 UNIX 类型的平台上，跨进程实现文件锁定。 对于 UNIX 类平台，设置该属性不会有任何影响。

此属性仅适用于正常 Managed File Transfer 代理程序。 Managed File Transfer 不支持文件服务器上的文件锁定机制。 因此，该属性对于协议网桥代理无效，因为协议网桥代理在传输文件时不会锁定文件服务器上的文件。

该属性的值可以为 true 或 false。

如果您认为您可能会经常具有比 ioThreadPoolSize 值更多的并行传输，那么您通过增加该值会看到改进，以便每个传输都有它自己的文件系统输入/输出线程。

通过插入指定的字符值，将该属性设置为允许传输成功完成。 该属性值是单字符。 通常，问号 (?) 用于表示任何不可映射的字符。 例如，使用以下格式：textReplacementCharacterSequence=?，其中问号 (?) 是替换字符。 不能使用空格字符作为替换字符。

该属性的值可以为 true 或 false。

当代理程序检测到连接中断错误 (例如 MQRC 2009) 时，它会尝试连接到备用队列管理器。 代理连接到备用队列管理器后，代理将保持连接状态，直到备用队列管理器变为不可用为止。

协议网桥代理等待建立通往 FTP 服务器的数据连接或通过已经建立的连接接收来自 FTP 服务器的数据的超时时间（以毫秒为单位）。 如果将此属性值设置为 0，协议网桥代理将会无限期等待。 如果到达超时时间，则协议网桥代理将关闭通往 FTP 服务器的任何现有数据连接，并在恢复当前传输之前尝试建立新数据连接。 如果建立新数据连接的尝试失败，那么当前传输也会失败。

作为某个网桥属性传递到由 protocolBridgeServerPropertiesExitClasses 属性指定的出口类的 initialize() 方法。

指定实现了协议网桥服务器属性用户出口例程的类的逗号分隔列表。

例如：

agentLog=on

打开所有组件的日志记录

agentLog=off

关闭所有组件的日志记录

agentLog=ftp=on, sftp=on, ftps=off

打开 FTP 和 SFTP 的日志记录，并关闭 FTPS 的日志记录

此外，您还可以将monitorMaxResourcesInPoll属性与 "fteCreateMonitor命令上匹配的 "-bs参数结合使用，例如，限制每个轮询间隔只能触发一次传输。

• 代理程序 Ant 调用， filecopy或 filemove 任务
• 在传递到代理程序的 XML 消息中，使用其中一个受支持的 Managed File Transfer Agent 命令 XML 模式 (例如， managedCall 或 managedTransfer)。

有关 commandPath 属性值的有效语法的信息，请参阅 commandPath MFT property。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

您可以将 addCommandPathToSandbox 属性设置为 false 以覆盖此缺省行为，从而兼容以下发行版：

• IBM WebSphere MQ File Transfer Edition.
• IBM WebSphere MQ 7.5.0 Fix Pack 1 Managed File Transfer 组件 (或更早版本)。
• 未设置安装属性 enableFunctionalFixPack=7502 的安装上的 IBM WebSphere MQ 7.5.0 Fix Pack 2 Managed File Transfer 组件 (或更高版本)。

重要信息: 请注意，此覆盖有效地使客户机能够将任何命令传输到代理程序系统并调用该命令，因此应极为谨慎地使用此命令。

• 适用于现有代理沙箱的拒绝的目录。
• 对于已定义的任何用户沙箱，<read> 和 <write> 元素的 <exclude>元素。
• 新的代理沙箱，如果没有为代理配置一个代理沙箱或者一个或多个用户沙箱。

将该属性设置为 true 时，会启用额外检查。 如果传输请求尝试读取进行通配符文件匹配的已定义沙箱外部的位置，那么传输将失败。 如果一个传输请求中存在多个传输，并且其中一个请求因尝试读取沙箱外部的位置而失败，那么整个传输也将失败。 如果检查失败，那么会在错误消息中给出失败原因 (请参阅 通配符传输的其他检查)。

如果忽略此属性或者将其设置为 false，那么将不会对通配符传输进行额外检查。

使用特定于平台的路径分隔符分隔路径。 路径以惊叹号 (!) 字符为前缀以表示从沙箱排除路径。 当您要在包含的根路径下排除子目录时，该功能很有用。

sandboxRoot 属性在协议网桥代理上不受支持。

您不能同时指定 sandboxRoot 属性和 userSandboxes 属性。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

userSandboxes 属性在协议网桥代理上不受支持。

您不能同时指定 sandboxRoot 属性和 userSandboxes 属性。

因为代理可能在调度的传输将要运行时从其命令队列读取命令，因此在启动调度的传输之前，可能存在额外的延迟。 在此情况下，调度程序将在该命令完成后立即运行。

有关创建认证凭证文件的详细信息，请参阅 在 z/OS上配置 MQMFTCredentials.xml。

请参阅 配置 MQMFTCredentials.xml ，以获取有关此文件的位置和许可权的信息。

有关创建认证凭证文件的更多详细信息，请参阅 MFT 和 IBM MQ 连接认证

从 IBM MQ 9.0.0 Fix Pack 3 和 IBM MQ 9.0.4开始， inquire 是对所有代理权限队列的必需许可权。

在源或目标代理负载过重的情况下，可能是针对代理的缺省值太低以致无法足够快速地响应协商请求。 当源代理定义了大量资源监视器或其资源监视器正在监视包含大量文件的目录时，最有可能发生此情况。 但是，在向代理提交大量传输请求时，也可能会发生此情况。 在此类情况下，可能需要将该属性的值增加至 200,000 或更大值。

只要收到完整的数据窗口，就向发送代理发送来自接收代理的应答。 对于带宽受到限制或不可靠的网络以及大的 agentWindowSize 和 agentChunkSize 设置，缺省值可能不够长。 这可能会导致代理之间不必要的数据重新传输。 因此，增加该值可能是有益的，可能会降低由于网络速度缓慢而使传输进入恢复方式的可能性。

• ConnectDirectCredentials.xml
• ConnectDirectNodeProperties.xml
• ConnectDirectProcessDefinitions.xml
• ProtocolBridgeCredentials.xml
• ProtocolBridgeProperties.xml
• UserSandboxes.xml

BFGAG0092I The <insert_0> file will be used to
request JVM diagnostic information.

此属性的值可以包含环境变量。

请参阅 在 MFT 属性中使用环境变量 以获取更多信息。

对于 IBM MQ 9.0.0.0，缺省值为 true

如果目标代理达到 maxDestinationTransfers 属性指定的限制，那么此代理会将传输排队。

如果代理属性值 maxSourceTransfers + maxDestinationTransfers + maxQueuedTransfers 的总和 超出状态存储队列 (SYSTEM.FTE.STATE.agent name) 的 MAXDEPTH 设置值，那么不启动代理。

5 (针对 Connect:Direct 网桥代理)

设置该属性可防止您由于错误的传输请求而意外传输太多文件，例如，如果用户无意间在 UNIX 系统上指定根目录 / 的传输。

如果目标代理达到 maxSourceTransfers 属性指定的限制，那么源代理会将传输排队。

如果代理属性值 maxSourceTransfers + maxDestinationTransfers + maxQueuedTransfers 的总和 超出状态存储队列 (SYSTEM.FTE.STATE.agent name) 的 MAXDEPTH 设置值，那么不启动代理。

5 (针对 Connect:Direct 网桥代理)

排队的传输请求的处理顺序取决于其优先级及排队的时间长短。 首先，会选择旧优先级和高优先级暂挂的传输。 队列中具有低优先级但排队时间较长的传输优先于较新且具有较高优先级的传输。

如果代理属性值 maxSourceTransfers + maxDestinationTransfers + maxQueuedTransfers 的总和 超出状态存储队列 (SYSTEM.FTE.STATE.agent name) 的 MAXDEPTH 设置值，那么不启动代理。

在此类路径中的任何条目之前搜索代理程序出口目录。

面向记录的文件支持的最大记录长度（字节）。 Managed File Transfer 可以支持写入具有任何记录长度的面向记录的文件。 但是，较大的记录长度可能会导致内存不足错误，因此为了避免这些错误，缺省情况下最大记录长度限制为 64 K。 从面向记录的文件中读取时，整个记录必须适合单个传输块，因此记录长度还受到传输块大小的限制。 该属性仅用于 I/O 用户出口的面向记录文件。

指定实现了 I/O 用户出口例程的类的逗号分隔列表。 仅列出实现了 IOExit 接口的类，即不列出实现了其他 I/O 用户出口接口的类，例如，IOExitResourcePath 和 IOExitChannel。 有关更多信息，请参阅 使用 MFT 传输 I/O 用户出口。

要与远程 IBM MQ 服务器协商的文件数据传输的压缩类型的逗号分隔列表。 您可以在以下主题中找到有关这些压缩类型的信息: 消息数据压缩列表。

检查值的有效性， 然后按属性的出现顺序传递到代理客户机通道。 然后， IBM MQ 客户机将处理此客户机通道与远程服务器通道之间的协商，以在这两个通道上的压缩属性之间查找匹配的最低公共分母。 如果未发现匹配项，那么始终选择 MQCOMPRESS_NONE。

要与远程 IBM MQ 服务器协商的头数据传输的压缩类型的逗号分隔列表。 接受的值为 MQCOMPRESS_NONE 或 MQCOMPRESS_SYSTEM。 您可以在以下主题中找到有关这些压缩类型的信息: 消息头压缩列表。

检查值的有效性， 然后按属性的出现顺序传递到代理客户机通道。 然后， IBM MQ 客户机将处理此客户机通道与远程服务器通道之间的协商，以在这两个通道上的压缩属性之间查找匹配的最低公共分母。 如果未发现匹配项，那么始终选择 MQCOMPRESS_NONE。

• 使用 fteStartAgent 命令启动代理。
• 使用 fteStopAgent 命令停止代理。
• 使用 fteSetAgentTraceLevel 命令启用或禁用代理的跟踪。
• 通过运行指定了 -d 参数的 fteShowAgentDetails 命令来显示本地代理程序的详细信息。

adminGroup=MFTADMIN

使用 agent.properties 文件中的 bpxwdynAllocAdditionalOptions 属性时，不得指定某些 BPXWDYN 选项。 有关这些属性的列表，请参阅 不能用于 MFT 的 BPXWDYN 属性。

• 对于 z/OS V1R8 和更高版本，为 MOUNT

可选属性。 如果 Automatic Restart Manager (ARM) 将代理配置为重新启动，那么请将此属性设置为关联的 ARM 策略中指定的 ARM ELEMTYPE 参数值。 对于代理，请将 ELEMTYPE 设置为 SYSBFGAG。

可选属性。 如果 Automatic Restart Manager (ARM) 将代理配置为重新启动，那么请将此属性设置为关联的 ARM 策略中指定的 ARM ELEMENT 参数值。 您可以将 ELEMENT 值设置为与代理名称相对应。

如果 MQMD 格式字段设置为 MQSTR ，那么如果 MQ 网络中存在已启用数据转换的通道，那么 Managed File Transfer 命令 XML 消息可能会损坏。

例如，如果调度的传输将在凌晨 1:00 运行，那么当时钟前进时，传输将在凌晨 2:00 运行，而当时钟后退时，传输将还原为凌晨 1:00。