The command.properties file

The command.properties file specifies the command queue manager to connect to when you issue commands and the information that WebSphere® MQ Managed File Transfer requires to contact that queue manager.

The command.properties file is created by the installer or by the fteSetupCommands command. You can use the fteSetupCommands command with the -f flag to change the basic command queue manager properties in this file. To change or add advanced command queue manager properties you must edit the file in a text editor.

Some WebSphere MQ Managed File Transfer commands connect to the agent queue manager or coordination queue manager instead of the command queue manager. For information about which commands connect to which queue manager, see Which WebSphere MQ Managed File Transfer command connects to which queue manager.

The command.properties file is located in your MQ_DATA_PATH/mqft/config/coordination_qmgr_name directory.

The command.properties file contains the following values:

Table 1. Basic command queue manager properties
Property name	Description	Default value
connectionQMgr	The name of the queue manager used to connect to the IBM® WebSphere MQ network.	No default
connectionQMgrHost	The host name or IP address of the connection queue manager.	No default
connectionQMgrPort	The port number used to connect to the connection queue manager in client mode.	1414
connectionQMgrChannel	The SVRCONN channel name used to connect to the connection queue manager.	SYSTEM.DEF.SVRCONN

If you do not specify a value for the connectionQMgrHost property, bindings mode is used by default.

If you specify a value for the connectionQMgrHost property but do not specify values for the connectionQMgrPort and connectionQMgrChannel properties, a port number of 1414 and a channel of SYSTEM.DEF.SVRCONN are used by default.

Table 2. Advanced command queue manager properties
Property name	Description	Default value
Code page properties:
connectionCcsid	The code page the commands connect to the command queue manager with. If you specify a value for connectionCcsid you must also specify a value for connectionCcsidName.	1208
connectionCcsidName	The Java representation of the connectionCcsid. If you specify a value for connectionCcsidName you must also specify a value for connectionCcsid.	UTF8
Multi-instance queue manager properties:
connectionQMgrStandby	The host name and the port number used for client connections, in IBM WebSphere MQ CONNAME format, for the standby instance of a multi-instance command queue manager defined by the connectionQMgr property. For example, `host_name(port_number)`	No default
Security properties:
userIdForClientConnect	The user ID that gets flowed through the client connections to IBM WebSphere MQ. If `java` is specified the user name reported by the JVM is flowed as part of the IBM WebSphere MQ connection request. The value of this property can be None or java.	None
Queue properties:
dynamicQueuePrefix	For commands that require a response from the agent, this property defines the IBM WebSphere MQ prefix to use for generating the temporary reply queue name. The format of the dynamicQueuePrefix property follows the format of the DynamicQName field of the IBM WebSphere MQ MQOD structure. For more information, see Creating dynamic queues. You can also define this property in the coordination.properties file if you want to use a specific IBM WebSphere MQ prefix for temporary queues that are generated by WMQFTE.	WMQFTE.*
modelQueueName	For commands that require a response from the agent, this property defines the IBM WebSphere MQ model queue to use for generating the temporary reply queue. You can also define this property in the coordination.properties file if you want to use a specific IBM WebSphere MQ model queue for temporary queues that are generated by WMQFTE. For more information, see The coordination.properties file.	SYSTEM.DEFAULT.MODEL.QUEUE
Connection properties:
javaLibraryPath	When connecting to a queue manager in bindings mode WebSphere MQ Managed File Transfer must have access to the IBM WebSphere MQ Java bindings libraries. By default WebSphere MQ Managed File Transfer looks for the bindings libraries in the default location defined by IBM WebSphere MQ. If the bindings libraries are in a different location use this property to specify the location of the bindings libraries.	/opt/mqm/java/lib
failCleanAgentWithNoArguments	By default, the value of this property is true, which means that the fteCleanAgent command fails to run if only the agent name parameter is specified. Setting the property to false means that, if only the agent name parameter is set, the behavior of the fteCleanAgent command is equivalent to specifying the -all parameter.	true

The following text is an example of the contents of a command.properties file.

connectionQMgr=PLUTO
connectionQMgrHost=kuiper.example.com
connectionQMgrPort=1930
connectionQMgrChannel=SYSTEM.DEF.SVRCONN

PLUTO is the name of an IBM WebSphere MQ queue manager that is located on the system kuiper.example.com. The queue manager PLUTO is the queue manager that the WebSphere MQ Managed File Transfer commands connect to.