fteSetupCoordination（设置协调详细信息）

fteSetupCoordination 命令为 IBM® MQ Managed File Transfer创建属性文件和协调队列管理器目录。

重要信息: 在分布式系统上，只有作为 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 环境变量中未设置任何值。

用途

使用 fteSetupCoordination 命令可创建以下 IBM MQ Managed File Transfer 对象:
  • 协调队列管理器目录
  • 数据目录 mqft (如果不存在)
  • installation.properties 文件
  • coordination.properties 文件
此命令还为您提供以下 MQSC 命令，您必须针对协调队列管理器运行这些命令以配置 IBM MQ Managed File Transfer。 MQSC 命令创建主题、主题字符串、SYSTEM.FTE 队列和缺省的数据库记录器队列。 这些命令还会更新名称列表，并将协调队列管理器的 PSMODE 属性设置为 ENABLED。
如果协调队列管理器位于 z/OS上，那么在运行这些 MQSC 命令之前，必须确保以下必需对象已存在:
  • SYSTEM.BROKER.DEFAULT.STREAM 队列
  • SYSTEM.QPUBSUB.QUEUE.NAMELIST 名称列表
  • SYSTEM.BROKER.DEFAULT.STREAM 和 SYSTEM.BROKER.ADMIN.STREAM 流
DEFINE TOPIC('SYSTEM.FTE') TOPICSTR('SYSTEM.FTE') REPLACE
ALTER TOPIC('SYSTEM.FTE') NPMSGDLV(ALLAVAIL) PMSGDLV(ALLAVAIL)
DEFINE QLOCAL(SYSTEM.FTE) LIKE(SYSTEM.BROKER.DEFAULT.STREAM) REPLACE
ALTER QLOCAL(SYSTEM.FTE) DESCR('Stream for WMQFTE Pub/Sub interface')
* Altering namelist: SYSTEM.QPUBSUB.QUEUE.NAMELIST
* Value prior to alteration:
DISPLAY NAMELIST(SYSTEM.QPUBSUB.QUEUE.NAMELIST)
ALTER NAMELIST(SYSTEM.QPUBSUB.QUEUE.NAMELIST) +
 NAMES(SYSTEM.BROKER.DEFAULT.STREAM+
 ,SYSTEM.BROKER.ADMIN.STREAM,SYSTEM.FTE)
* Altering PSMODE.  Value prior to alteration:
DISPLAY QMGR PSMODE
ALTER QMGR PSMODE(ENABLED)

有关属性文件的更多信息，请参阅 配置选项。

如果您正在使用 z/OS，那么可以使用从 IBM MQ Managed File Transfer 命令模板 PDSE 库数据集生成的脚本从 JCL 发出 fteSetupCoordination 命令和其他命令。 有关更多信息，请参阅 创建 IBM MQ Managed File Transfer 代理或记录器命令数据集。

Syntax

fteSetupCoordination

Read syntax diagramSkip visual syntax diagramfteSetupCoordination -coordinationQMgr?  coordination_qmgr_name ?-coordinationQMgrHost coordination_qmgr_host -coordinationQMgrPort coordination_qmgr_port -coordinationQMgrChannel coordination_qmgr_channel -credentialsFilefilePath-useridusername-f-default

参数

-coordinationQMgr (coordination_qmgr_name )
必需。 协调队列管理器的名称。 此队列管理器必须是 WebSphere® MQ 版本 7.0 或更高版本的队列管理器。

-coordinationQMgrHost (coordination_qmgr_host)
可选。 协调队列管理器的主机名或 IP 地址。

如果未指定 -coordinationQMgrHost 参数，那么将采用绑定方式连接。

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

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

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

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

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

-userid(username)
可选。 用于关联凭证详细信息的用户标识。 如果未指定用户标识，将向所有用户应用凭证详细信息。 此外，还必须指定 -credentialsFile 参数。
-f
可选。 强制使用该命令中指定的详细信息覆盖现有的协调队列管理器配置。

-default
可选。 将缺省配置选项更新为与该命令中指定的协调队列管理器关联的选项。

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

示例

在本示例中，为以客户机方式连接的名为 QM_SATURN 的协调队列管理器设置必需对象：
fteSetupCoordination -coordinationQMgr QM_SATURN
-coordinationQMgrHost myhost.ibm.com -coordinationQMgrPort 1415
-coordinationQMgrChannel SYSTEM.DEF.SVRCONN

返回码

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