fteRAS (收集 MFT 故障诊断信息)

fteRAS 命令收集运行该命令的系统上 Managed File Transfer 配置和日志实体的故障排除信息（ MustGather 数据）。

用途

如果需要收集故障诊断信息以帮助在 Managed File Transfer 代理程序，数据库记录器或其他命令报告问题或无法正常工作时找到解决方案，请使用 fteRAS 命令来运行可靠性，可用性和可维护性信息 (RAS) 收集工具。
注意： 在收集高可用 Managed File Transfer 代理的故障排除信息时，应在托管该代理实例的所有机器上运行 fteRAS 命令。
警告: 如果在服务器上配置了大量 Managed File Transfer 代理程序，那么 fteRAS 命令可能需要很长时间才能完成。 如果发生这种情况，您可以选择将 Managed File Transfer 代理程序的日志和配置目录的内容压缩到 zip 文件中。

运行 fteRAS 命令时，用于放置所生成的归档 (.zip) 文件的输出目录可以是缺省位置或您选择的目录。

运行 fteRAS 命令时显示的进度信息

从 IBM® MQ 9.3.0开始， fteRAS 命令到控制台的输出已增强，以便您可以通过显示以下信息来查看该命令在运行时的进度:
  • 每个步骤的开始时间和结束时间，格式为 yyyy-MM-dd HH:mm:ss，其中时区是本地时区
  • 在步骤 FTEConfigLogsCollector 中从配置，日志，安装和 bin 目录复制到临时文件夹的文件总数
  • 要压缩的数据的大小
  • 压缩字节数的计数器
  • 压缩总百分比的计数器

从 IBM MQ 9.3.0开始， fteRAS 命令的输出还包含预订信息。 此信息显示为代理程序和资源监视器接收的消息数。 和预定的传输。 它还显示保存到文件系统的资源监视器定义数。

以下示例显示了从命令运行的样本:

C:\Users\Administrator>fteRAS
5724-H72 Copyright IBM Corp.  2008, 2026.  ALL RIGHTS RESERVED
BFGCL0819I: Collector FTEDirectoryListingCollector started at 2022-01-03 15:37:44 India Standard Time.
BFGCL0820I: Collector FTEDirectoryListingCollector completed at 2022-01-03 15:38:38 India Standard Time.

BFGCL0819I: Collector FTEListAgentsCollector started at 2022-01-03 15:38:38 India Standard Time.
BFGMQ1046I: Fetching messages from subscription to topic string 'Agents/#'. Number of messages received: '9'
BFGCL0820I: Collector FTEListAgentsCollector completed at 2022-01-03 15:38:49 India Standard Time.

BFGCL0819I: Collector FTEDisplayVersionCollector started at 2022-01-03 15:38:49 India Standard Time.
BFGCL0820I: Collector FTEDisplayVersionCollector completed at 2022-01-03 15:38:50 India Standard Time.

BFGCL0819I: Collector FTEListMonitorsCollector started at 2022-01-03 15:38:50 India Standard Time.
BFGMQ1046I: Fetching messages from subscription to topic string 'monitors/#'. Number of messages received: '6'
BFGCL0827I: 6 of 6 resource monitor definitions saved to file system.
BFGCL0820I: Collector FTEListMonitorsCollector completed at 2022-01-03 15:39:19 India Standard Time.

BFGCL0819I: Collector FTEListScheduledTransfersCollector started at 2022-01-03 15:39:19 India Standard Time.
BFGMQ1046I: Fetching messages from subscription to topic string 'Scheduler/#'. Number of messages received: '9'
BFGCL0820I: Collector FTEListScheduledTransfersCollector completed at 2022-01-03 15:39:20 India Standard Time.

BFGCL0819I: Collector FTETopicSubscriptionCollector started at 2022-01-03 15:39:20 India Standard Time.
BFGCL0820I: Collector FTETopicSubscriptionCollector completed at 2022-01-03 15:41:11 India Standard Time.

BFGCL0819I: Collector FTEConfigLogsCollector started at 2022-01-03 15:41:11 India Standard Time.
BFGCL0822I: Copying 8041 file(s) from 'config' directory to a temporary directory.
BFGCL0822I: Copying 8785 file(s) from 'logs' directory to a temporary directory.
BFGCL0821I: Copying file(s) from 'bin' directory to a temporary directory.
BFGCL0822I: Copying 1 file(s) from 'installations' directory to a temporary directory.
BFGCL0820I: Collector FTEConfigLogsCollector completed at 2022-01-03 15:42:21 India Standard Time.

BFGCL0606I: fteRAS command is compressing the output.
BFGCL0823I: Total size of data to compress '1394633' bytes.
BFGCL0824I: Compressed '1394633' bytes. Compression '100%' completed.
BFGCL0604I: fteRAS command completed successfully.  Output is stored in C:\ProgramData\IBM\MQ\mqft\logs\fteRAS.zip.\fteRAS.zip.

语法

fteRAS

读取语法图跳过可视语法图 fteRAS -p configuration_options-lpds_库名称
安全性
读取语法图跳过可视语法图-mquseriduser_id-nolpw-mqpassword密码-nolpw
读取语法图跳过可视语法图-agentsagentNameList输出目录

参数

--p 配置选项

可选。 指定用于收集故障排除信息的配置选项集。 使用这组配置选项作为 -p 参数的值。 按照惯例， -p 参数的值是相关协调队列管理器的名称。 如果不提供 -p 参数，系统将使用一组默认配置选项。 有关默认配置选项集的更多信息，请参阅 MFT installation.properties 文件。

[z/OS]-l pds_库名称
可选。 仅适用于 z/OS®。 指定 PDS 库的名称，此库包含用于对特定代理或记录器调用 MQMFT 命令的 JCL 脚本。 从命令 PDS 库的 BFGZRAS JCL 脚本运行命令时，将始终设置此选项，这样会在输出目录中捕获 PDS 库的所有成员。
注: BFGZRAS 在运行 BFGCUSTM 作业时创建 BFGRAS 成员。
-mquserid 用户ID
可选。 指定要向命令队列管理器进行认证的用户标识。
-mqpassword 密码
可选。 指定通过协调队列管理器进行认证时所使用的密码。
指定 -mqpassword 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid，但未指定 -mqpassword，那么系统将提示您提供关联的密码，不会显示该密码。

从 IBM MQ 9.3开始，该命令缺省为使用 MQCSP 认证，并将要认证的用户标识和密码发送到 MQCSP 结构中的队列管理器。

-nolpw
可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器，请指定此参数。
指定 -nolpw 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid 和 -nolpw，但未指定 -mqpassword，那么系统会提示您提供关联的密码，不会显示该密码。
注: 如果指定 -nolpw 选项，并且密码长度超过 12 个字符，那么命令将失败并返回错误消息 BFGCL0829E。
[MQ 9.4.0 2024 年 6 月]-代理人
可选。 指定将为其收集数据的代理程序的名称。 如果不指定 -agents 参数， fteRAS 命令将连接到默认协调队列管理器，并收集本地系统上所有代理的数据。
代理程序名称必须用引号括起，并且必须以逗号分隔的代理程序名称列表形式提供多个代理程序名称。 例如：
fteRAS -agents "AGENT_LIN,AGENT_LIN3"
代理程序名称可以包含星号通配符 (*) ，其中 * 与零个或多个字符匹配。 星号是 fteRAS 支持的唯一通配符类型。 例如：
fteRAS -agents "AGENT_*"
fteRAS -agents "A*,G*"
如果在验证期间， fteRAS 在系统上找不到名称与提供的代理程序名称或具有通配符的代理程序名称模式相匹配的代理程序，那么它将失败并返回消息 BFGCL0835E。
注意： 在不同机器上设置高可用性 (HA) 配置时，如果有一对配置相同的代理实例，则必须在两个系统上都使用 fteRAS 命令。 有关 Managed File Transfer 中 HA 代理的更多信息，请参阅托管文件传输中的高可用代理。
输出目录
可选。 要在收集 RAS 数据时使用的目录，以及在成功收集数据后存储输出文件 (例如 fteRAS.zip) 的位置。 如果此目录不存在，那么将创建此目录。 缺省位置为 mqft logs 目录。
-或-h
可选。 显示命令语法。

示例

[AIX][Linux]在 AIX® and Linux® 上，要将输出文件 fteRAS.zip 保存在 /var/mqm/errors 目录中，请运行 fteRAS ，如下例所示：
fteRAS /var/mqm/errors
以下消息确认已成功完成该命令：
BFGCL0604I: fteRAS command completed successfully. Output is stored in /var/mqm/errors/fteRAS.zip
[Windows]在 Windows 上，要将输出文件 fteRAS.zip 保存在新安装 IBM MQ 的默认错误目录中，请按下例运行 fteRAS ：
fteRAS "C:\ProgramData\IBM\MQ\errors"
以下消息确认已成功完成该命令：
BFGCL0604I: fteRAS command completed successfully. Output is stored in C:\ProgramData\IBM\MQ\errors\fteRAS.zip
注: 对于 IBM MQ 8.0 或更高版本，如果这不是该产品版本的新安装，那么错误目录在系统上的位置可能不同。 有关更多信息，请参阅 Windows上的程序和数据目录位置。
[IBM i]在 IBM i 上，要将输出文件复制到 /QIBM/UserData/mqm/errors ，请从 Qshell 运行 fteRAS 命令，如下例所示：
/QIBM/ProdData/mqm/bin/fteRAS /QIBM/UserData/mqm/errors
以下消息确认已成功完成该命令：
BFGCL0604I: fteRAS command completed successfully. Output is stored in /QIBM/UserData/mqm/errors/fteRAS.zip

返回码

表 1. 返回代码标识符和描述
返回码 描述
0 命令成功完成
1 命令未成功执行