runmqras (收集 IBM MQ 故障诊断信息)

用途

runmqras 命令用于将故障诊断信息从机器收集到单个归档中。 您可以使用此命令来收集有关应用程序或 IBM MQ 故障的信息，可能用于在报告问题时提交到 IBM 。

runmqras 命令需要 或更高版本的 (JRE) 才能运行。 Java 7 Java runtime environment 如果 IBM MQ JRE 组件（在 Linux® 上）或功能（在 Windows 上）未安装，则 runmqras 会搜索系统路径以查找替代 JRE 并尝试使用。

如果找不到替代方案，则输出错误信息 AMQ8599 则输出错误信息。 在这种情况下：

1. 安装 IBM MQ JRE 组件，或安装备用 Java 7 JRE
2. 将 JRE 添加到系统路径
3. 重新运行命令

在不请求更多部分的情况下运行旨在作为常规问题诊断的起点，但是，您可以通过命令行来请求更多 部分 。

这些额外的 部分 收集更多详细信息，具体取决于所诊断问题的类型。 如果 IBM 支持人员需要非缺省部分，那么他们会告诉您。

runmqras 命令可以在任何用户标识下运行，但该命令仅收集该用户标识可以手动收集的信息。 一般情况下，在调试 IBM MQ 问题时，请在 mqm 用户 ID 下运行命令，以便命令收集队列管理器文件和命令输出。

在 IBM MQ 9.0.0 Fix Pack 3 和 IBM MQ 9.0.5 中，默认情况下 runmqras 命令会检索环境变量信息。 这适用于 Linux, Solaris, 和 AIX®。

从 IBM MQ 9.0.0 Fix Pack 3 和 IBM MQ 9.0.5 ， runmqras 命令默认检索队列管理器数据目录的列表。 这适用于多平台。

关键字和参数

除非描述声明它们是可选的，否则所有参数都是必需的。

在每种情况下， QMgrName 都是应用该命令的队列管理器的名称。

-inputfile 输入InputFileName

XML 输入文件的标准名称

-自定义输入 CustomInputFileName

其他 XML 输入文件的标准名称

-zipfileZipFileName

提供生成的归档的文件名。

runmqras 将主机名附加到归档文件的名称。 例如，如果运行以下命令:

runmqras -zipFile diagnostics.zip

生成的归档文件称为 diagnostics-hostname.zip。

缺省情况下，归档文件的名称为 runmqras-hostname.zip ，其中 hostname 是 runmqras 附加到文件名的主机名。

-outputdir 路径

将生成的输出文件放置在其中的目录。

缺省情况下，输出目录与工作目录相同。

-workdirectory 路径

用于存储在工具处理期间运行的命令的输出的目录。 如果提供了此目录，那么此目录必须不存在 (在此情况下将创建此目录) 或必须为空。

如果不提供路径，那么将使用名称以 runmqras 开头且以日期和时间为后缀的目录:

• 在 UNIX 上，该目录位于 /tmp 下。
• 在 Windows 上，该目录位于 %temp% 下。

-SectionA,SectionB

要收集更多特定信息的可选部分。 必须使用逗号作为节之间的分隔符，不带空格。 例如：

runmqras -qmlist ESBSTGAPPQMVH2 -section defs,trace,cluster -caseno TEST123

缺省情况下，将收集文档的通用部分，而可以针对指定的问题类型收集更具体的信息; 例如，部分名称 trace 将收集跟踪目录的所有内容。

可以通过提供节名称 nodefault来避免缺省集合。

IBM 支持通常为您提供要使用的部分。 可用部分的示例如下:

全部

收集所有可能的信息，包括所有跟踪文件以及针对许多不同类型问题的诊断。 您必须仅在某些情况下使用此选项，并且此选项并非用于一般用途。

缺省值

IBM MQ 日志， FDC 文件，基本配置和状态。

注: 除非使用节名称 nodefault，否则始终收集。 有关当前环境（保存在 Linux 上的 env.stdout 、 UNIX 和 IBM i 以及 Windows 上的 set.stdout 中）和当前用户限制（保存在 Linux 上的 mqconfig.stdout 和 UNIX 中）的一些信息可能会被 runmqras 命令修改。 如有必要，请在您的环境中手动运行 env、 set 或 mqconfig 命令来检查实际值。

nodefault

阻止发生缺省集合，但仍会收集其他显式请求的部分。

跟踪

收集所有跟踪文件信息以及缺省信息。

注: 不启用跟踪。

定义

收集队列管理器定义和状态信息。

集群

收集集群配置和队列信息。

数据包

收集事务和持久性信息。

内核

收集队列管理器内核信息。

记录器

收集恢复日志记录信息。

主题

收集主题树信息。

QMGR

收集所有队列管理器文件: 队列，日志和配置文件。

泄漏

从 IBM MQ 9.0.0 Fix Pack 3 和 IBM MQ 9.0.5 ，收集 IBM MQ 进程资源使用信息。

本节适用于 Linux, HP-UX, Solaris 和 AIX。

mft

从 IBM MQ 9.0.0 Fix Pack 3 和 IBM MQ 9.0.4 ，捕捉通过 fteRas 命令获取的数据。

注: -section mft 仅收集缺省协调队列管理器拓扑的信息。

mqweb

收集 mqweb 服务器的跟踪和配置数据。

更多信息，请参阅 IBM 技术说明中关于使用 IBM MQ runmqras 命令收集数据的章节名称和说明。

-qmlist QMA[,QMB]

要运行 runmqras 命令的队列管理器名称的列表。

此参数不适用于客户机产品，因为没有要从中请求直接输出的队列管理器。

通过提供以逗号分隔的列表，可以将队列管理器之间的迭代限制为特定队列管理器列表。 缺省情况下，命令迭代跨所有队列管理器。

-noqmdata

从 IBM MQ 9.0.0 Fix Pack 12开始，设置 -noqmdata 将仅捕获安装级别诊断，跳过任何特定于队列管理器的诊断。

-qmlist 参数和 -noqmdata 参数不能一起使用。 如果同时指定了这两个参数，那么将返回以下错误:

参数错误: 最多可以提供 -noqmdata 或 -qmlist 中的一个

-timeout secs

在命令停止等待完成之前提供单个命令的缺省超时。

缺省情况下，将使用超时 10 秒。 值为零表示无限期等待。

-demo

以演示方式运行，其中不处理任何命令，也不收集任何文件。

通过以演示方式运行，您可以确切地看到将处理哪些命令以及将收集哪些文件。 输出 .zip 文件包含一个 console.log 文件，该文件记录了在命令正常运行时将处理和收集的内容。

-v

扩展 console.log 文件中记录的信息量，该文件包含在输出 .zip 文件中。

-ftp ibm | 自定义

允许通过基本 FTP 将收集的归档发送到远程目标。

处理结束后，可通过基本 FTP 将生成的存档直接发送到 IBM ，或发送到您选择的网站。 如果选择 ibm 选项，将使用匿名 FTP 将存档传送到 IBM ECuRep 服务器。 此过程与使用 FTP 手动提交文件的过程相同。

注意，如果选择 ibm 选项，还必须提供 pmrno 选项，所有其他 FTP* 选项都将被忽略。

重要信息: 从 IBM MQ 9.0.0 Fix Pack 12开始， -ftp IBM 选项不再可用。 如果选择此选项，那么将生成以下消息:

FTP IBM 选项将不再起作用，因为 IBM FTP 服务器已禁用

-ftpserver 服务器

使用 FTP 定制选项时要连接到的 FTP 服务器名称。

-ftpusername 用户标识

使用 FTP 定制选项时用于登录到 FTP 服务器的用户标识。

-ftppassword 密码

使用 FTP 定制选项时用于登录 FTP 服务器的密码。

-ftpdirectory 路径

FTP 服务器上用于将生成的 .zip 文件放入其中的目录，在使用 FTP 定制选项时使用。

-pmrno 12345,678,9AB

要与文档关联的有效 IBM PMR 编号 (问题记录编号)。

使用该选项可确保输出结果以您的 PMR 编号为前缀，这样当信息发送到 IBM 时，信息就会自动与该问题记录相关联。

-卡西诺 caseNo

有效的 Salesforce 案例编号。

使用此选项可确保输出以您的案例编号为前缀，以便在将信息发送到 IBM时，该信息会自动与该案例编号相关联。

注： -caseno 等同于 -pmrno ，两者都是可选参数，但不允许同时提供。

-help

提供简单帮助。

-字幕

显示将在 xml 中替换的关键字。

返回码

非零返回码指示失败。