fteSetupCoordination (set up coordination details)

The fteSetupCoordination command creates properties files and the coordination queue manager directory for WebSphere® MQ Managed File Transfer.

Important: Only users who are WebSphere MQ administrators (and members of the mqm group) can run this command. If you try to run this command as a user who is not a WebSphere MQ administrator, you will receive an error message and the command will not run.

Purpose

Use the fteSetupCoordination command to create the following WebSphere MQ Managed File Transfer objects:

Coordination queue manager directory
Data directory mqft (if this does not exist)
installation.properties file
coordination.properties file

This command also provides you with the following MQSC commands that you must run against your coordination queue manager to configure WebSphere MQ Managed File Transfer. The MQSC commands create a topic, a topic string, the SYSTEM.FTE queue, and the default database logger queues. These commands also update a namelist and set the PSMODE attribute of the coordination queue manager to ENABLED.

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)

For more information about properties files, see Configuration options.

Syntax

fteSetupCoordination

Parameters

-coordinationQMgr (coordination_qmgr_name )

Required. The name of the coordination queue manager. This queue manager must be an IBM® WebSphere MQ Version 7.0 or later queue manager.

-coordinationQMgrHost (coordination_qmgr_host)

Optional. The host name or IP address of the coordination queue manager.

If you do not specify the -coordinationQMgrHost parameter, a bindings mode connection is assumed.

If you specify a value for the -coordinationQMgrHost parameter but do not specify values for the -coordinationQMgrPort and -coordinationQMgrChannel parameters, a port number of 1414 and a channel of SYSTEM.DEF.SVRCONN are used by default.

-coordinationQMgrPort (coordination_qmgr_port)

Optional. The port number used for client connections to the coordination queue manager. If you specify the -coordinationQMgrPort parameter, you must also specify the -coordinationQMgrHost parameter.

-coordinationQMgrChannel (coordination_qmgr_channel)

Optional. The channel name used to connect to the coordination queue manager. If you specify the -coordinationQMgrChannel parameter, you must also specify the -coordinationQMgrHost parameter.

-f

Optional. Forces an overwrite of the existing coordination queue manager configuration with the details specified in this command.

-default

Optional. Updates the default configuration options to the options associated with the coordination queue manager specified in this command.

-? or -h

Optional. Displays command syntax.

Example

In this example, the required objects are set up for a coordination queue manager called QM_SATURN, which is connected to in client mode:

fteSetupCoordination -coordinationQMgr QM_SATURN
-coordinationQMgrHost myhost.ibm.com -coordinationQMgrPort 1415
-coordinationQMgrChannel SYSTEM.DEF.SVRCONN

Return codes

0: Command completed successfully.
1: Command ended unsuccessfully.