fteChangeDefaultConfigurationOptions (change default configuration options for MFT)

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

Important:
[AIX, Linux, Windows]On AIX®, Linux®, and Windows systems, if you are using the IBM® MQ server installation image, you must satisfy both these conditions in order to run the command:
  • Be an IBM MQ administrator.
  • Be a member of the mqm group (if the mqm group is defined on the system).
Otherwise you get the error message BFGCL0502E: You are not authorized to perform the requested operation. This restriction does not apply if you are using the Redistributable Managed File Transfer Agent archive.
[z/OS]On z/OS® systems, you must satisfy at least one of these conditions in order to run the 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, 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 for more information about the installation.properties file.

Syntax

fteChangeDefaultConfigurationOptions

Read syntax diagramSkip visual syntax diagramfteChangeDefaultConfigurationOptions configuration_options

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.