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
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
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.