fteChangeDefaultConfigurationOptions (change the default configuration options)

Use the fteChangeDefaultConfigurationOptions command to change the default configuration options that you want IBM® MQ Managed File Transfer to use. The value of the configuration options defines the group of properties files that IBM MQ Managed File Transfer uses.

Important: On distributed systems, only users who are IBM 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 an IBM MQ administrator, you will receive the error message BFGCL0502E: You are not authorized to perform the requested operation. and the command will not run.

On z/OS® systems, the user must satisfy (at least) one of these conditions in order to run the migrate command:

Be a member of the mqm group (if the mqm group is defined on the system).
Be a member of the group named in the BFG_GROUP_NAME environment variable (if one is named).
Have no value set in the BFG_GROUP_NAME environment variable when the command is run.

Purpose

Your default Managed File Transfer configuration options are established the first time you use the fteSetupCoordination command to configure a queue manager as the coordination queue manager. During the installation of the MFT product, the mqft directory is created under <MQ_DATA_PATH> if it does not already exist. Additionally, configuration, installations, and logs directories are created under the mqft directory, if they do not already exist.

By using the fteChangeDefaultConfigurationOptions command you can change the default coordination queue manager that is defined in the installation.properties file. If you change this coordination queue manager, IBM MQ Managed File Transfer uses the configuration options given by the structured set of directories and property files contained it the directory you used as input for configuration_options by default. This directory name is the same as the coordination queue manager used by agents under this configuration.

See Configuration options on distributed platforms for more information about the installation.properties file.

Syntax

fteChangeDefaultConfigurationOptions

Parameters

configuration_options: Required. This parameter specifies the default configuration options that you want to change to. Use the name of a non-default coordination queue manager as the input for this parameter.
-? or -h: Optional. Displays command syntax.

Example

In this example, the default configuration options are changed to QM_COORD2:


fteChangeDefaultConfigurationOptions QM_COORD2

Return codes

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