fteSetupCommands:创建 "MFT command.properties文件

fteSetupCommands 命令创建 Managed File Transfer command.properties 文件。 此属性文件指定发出命令时连接到 IBM® MQ 网络的队列管理器的详细信息。

重要说明：
[UNIX、Linux、Windows]在 UNIX, Linux®, and Windows 系统上，如果您使用的是 IBM MQ 服务器安装镜像，则必须同时满足以下两个条件才能运行该命令：
  • 成为 IBM MQ 管理员。
  • 是 mqm 组的成员（如果在系统上定义了 mqm 组）。
否则，您将收到错误信息BFGCL0502E: You are not authorized to perform the requested operation。如果您使用的是 Redistributable Managed File Transfer Agent 存档，则不受此限制。
[z/OS]在 z/OS® 系统上，您必须满足以下条件中的至少一个，才能运行该命令：
  • 是 mqm 组的成员（如果在系统上定义了 mqm 组）。
  • 成为 BFG_GROUP_NAME环境变量 （如果有）中指定的组成员。
  • 运行命令时 ，BFG_GROUP_NAME环境变量中没有设置任何值。

用途

使用 fteSetupCommands 命令可在协调队列管理器配置目录中创建 command.properties 文件。 此命令使用 MQ_DATA_PATH 环境变量和 installation.properties 文件确定在何处查找 command.properties 文件。 在发出 fteSetupCommands 命令之前，请确保您已创建并配置协调队列管理器。

有关属性文件的更多信息，请参阅 MFT command.properties 文件。

Syntax

fteSetupCommands

Read syntax diagramSkip visual syntax diagramfteSetupCommands -connectionQMgr connection_qmgr_name-connectionQMgrHostconnection_qmgr_host-connectionQMgrPortconnection_qmgr_port-connectionQMgrChannelconnection_qmgr_channel-credentialsFilefilePath-useridusername-pconfiguration_options-f

参数

-connectionQMgr (connection_qmgr_name)
必需。 用于连接到 IBM MQ 网络以发出命令的队列管理器的名称。

--connectionQMgrHost(connection_qmgr_host)
可选。 连接队列管理器的主机名或 IP 地址。

如果未指定 -connectionQMgrHost 参数，那么将采用绑定方式连接。 因此，如果要使用客户机方式连接，该参数是必需的。

如果为 -connectionQMgrHost 参数指定了值，但没有为 -connectionQMgrPort 和 -connectionQMgrChannel 属性指定值，那么缺省情况下将使用端口号 1414 和通道 SYSTEM.DEF.SVRCONN。

--connectionQMgrPort(connection_qmgr_port)
可选。 用于以客户机方式连接到连接队列管理器的端口号。 如果指定 -connectionQMgrPort 参数，那么还必须指定 -connectionQMgrHost 参数。

--connectionQMgrChannel(connection_qmgr_channel)
可选。 用于连接到连接队列管理器的通道名称。 如果指定 -connectionQMgrChannel 参数，那么还必须指定 -connectionQMgrHost 参数。

-p 配置选项
可选。 该参数确定用于设置命令队列管理器的配置选项集。 使用非缺省协调队列管理器的名称作为该参数的输入。 然后，fteSetupCommands 命令会使用与该非缺省协调队列管理器关联的属性文件集。

如果未指定该参数，那么将使用基于缺省协调队列管理器的配置选项集。

-credentialsFile (filePath)
可选。 现有凭证文件或新凭证文件的完整文件路径，将向其添加 IBM MQ 认证详细信息。

此命令支持将一组 IBM MQ 认证详细信息添加到指定的 Managed File Transfer 凭证文件中。 当已启用 IBM MQ 连接认证时，请使用此命令。 如果要更新现有的详细信息，则必须使用 -f 强制参数。

-userid (username)
可选。 用于关联凭证详细信息的用户标识。 如果未指定用户标识，将向所有用户应用凭证详细信息。 此外，还必须指定 -credentialsFile 参数。
-f
可选。 强制使用该命令中指定的详细信息覆盖现有的 command.properties 文件。

-或-h
可选。 显示命令语法。

示例

fteSetupCommands -connectionQMgr QM_NEPTUNE -connectionQMgrHost 9.146.157.241
-connectionQMgrPort 1414 -connectionQMgrChannel SYSTEM.DEF.SVRCONN

返回码

0
命令成功完成。
1
命令结束但未成功。