fteSetupCoordination （为协调队列管理器设置属性文件和目录）

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

重要说明：
[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环境变量中没有设置任何值。

用途

使用 fteSetupCoordination 命令可创建以下 Managed File Transfer 对象:
  • 协调队列管理器目录
  • 数据目录 mqft (如果不存在)
  • installation.properties 文件
  • coordination.properties 文件
此命令还为您提供以下 MQSC 命令，您必须针对协调队列管理器运行这些命令才能配置 Managed File Transfer。 MQSC 命令创建主题、主题字符串、SYSTEM.FTE 队列和缺省的数据库记录器队列。 这些命令还会更新名称列表，并将协调队列管理器的 PSMODE 属性设置为 ENABLED。
[z/OS]如果协调队列管理器位于 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]如果您使用的是 z/OS ，您可以使用 fteSetupCoordination 命令模板PDSE库数据集生成的脚本，从JCL发出 Managed File Transfer 命令和其他命令。 有关更多信息，请参阅 创建 MFT 代理程序或记录器命令数据集。

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)
必需。 协调队列管理器的名称。 此队列管理器必须是 IBM 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 认证详细信息添加到指定的 Managed File Transfer 凭证文件中。 当已启用 IBM MQ 连接认证时，请使用此命令。 如果要更新现有的详细信息，则必须使用 -f 强制参数。

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

-default
可选。 将缺省配置选项更新为与该命令中指定的协调队列管理器关联的选项。
  • 如果指定此参数，现有队列管理器将成为默认协调队列管理器。 所有 Managed File Transfer 命令都使用它，无需使用 fteSetupCommands 命令的 -p 参数设置配置选项。
  • 如果不指定此参数，队列管理器仍会被配置，但对于每条需要协调队列管理器的 Managed File Transfer 命令，都必须使用 fteSetupCommands 命令的 -p 参数来指定配置选项。
更多信息，请参阅 -p configuration_options。
-或-h
可选。 显示命令语法。

示例

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

返回码

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