fteSetupCoordination (set up coordination details)

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

Purpose

Use the fteSetupCoordination command to create the following WebSphere MQ File Transfer Edition objects:
  • Coordination queue manager directory
  • Data directory (if this does not exist)
  • wmqfte.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 File Transfer Edition. 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)
DEFINE QLOCAL(SYSTEM.FTE.DATABASELOGGER.REJECT) +
 DESCR('Messages rejected by the FTE database logger.') +
 DEFPRTY(0) +
 DEFSOPT(SHARED) +
 GET(ENABLED) +
 MAXDEPTH(999999999) +
 MAXMSGL(4194304) +
 MSGDLVSQ(PRIORITY) +
 PUT(ENABLED) +
 RETINTVL(999999999) +
 SHARE +
 NOTRIGGER +
 USAGE(NORMAL) +
 REPLACE
DEFINE QLOCAL(SYSTEM.FTE.DATABASELOGGER.COMMAND) +
 DESCR('Command messages to control the FTE database logger.') +
 DEFPRTY(0) +
 DEFSOPT(SHARED) +
 GET(ENABLED) +
 MAXDEPTH(999999999) +
 MAXMSGL(4194304) +
 MSGDLVSQ(PRIORITY) +
 PUT(ENABLED) +
 RETINTVL(5000) +
 SHARE +
 NOTRIGGER +
 USAGE(NORMAL) +
 REPLACE

For more information about properties files, see Configuration options.

If you are using z/OS®, you can issue the fteSetupCoordination command and other commands from JCL. See Using WebSphere MQ File Transfer Edition commands from JCL for more information.

Syntax

Syntax diagram format

           

Read syntax diagramSkip visual syntax diagram
fteSetupCoordination

>>-fteSetupCoordination----------------------------------------->

>-- -coordinationQMgr--(coordination_qmgr_name)----------------->

>--+--------------------------------------------------+--------->
   '- -coordinationQMgrHost--(coordination_qmgr_host)-'   

>--+--------------------------------------------------+--------->
   '- -coordinationQMgrPort--(coordination_qmgr_port)-'   

>--+--------------------------------------------------------+--->
   '- -coordinationQMgrChannel--(coordination_qmgr_channel)-'   

>--+-----+--+-----------+--------------------------------------><
   '- -f-'  '- -default-'   

Parameters

-coordinationQMgr (coordination_qmgr_name)
Required. The name of the coordination queue manager. This queue manager must be a 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.

Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/setup_coord_cmd.htm