fteSetupCommands(创建 command.properties 文件)

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

重要信息: 在分布式系统上,只有作为 IBM MQ 管理员 (以及 mqm 组的成员) 的用户才能运行此命令。 如果尝试以非 IBM MQ 管理员用户身份运行此命令,那么您将收到错误消息BFGCL0502E: You are not authorized to perform the requested operation.并且不会运行该命令。
z/OS® 系统上,用户必须满足 (至少) 下列其中一个条件才能运行迁移命令:
  • 是 mqm 组的成员(如果在系统上定义了 mqm 组)。
  • [V8.0.0.6 2017 年 1 月]是 BFG_GROUP_NAME 环境变量中指定的组(如果指定了一个组)的成员。
  • [V8.0.0.6 2017 年 1 月]在运行命令时,在 BFG_GROUP_NAME 环境变量中未设置任何值。

用途

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

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

Syntax

fteSetupCommands

Read syntax diagramSkip visual syntax diagramfteSetupCommands -connectionQMgr  connection_qmgr_name-connectionQMgrHost connection_qmgr_host-connectionQMgrPort connection_qmgr_port-connectionQMgrChannel connection_qmgr_channel-credentialsFilefilePath-useridusername-p configuration_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 认证详细信息添加到指定的 IBM MQ Managed File Transfer 凭证文件。 如果已启用 IBM MQ 连接认证,请使用此命令。 如果要更新现有的详细信息,则必须使用 -f 强制参数。

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

-? or -h
可选。 显示命令语法。

示例

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

返回码

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