fteChangeDefaultConfigurationOptions: change default configuration options for MFT
Use the fteChangeDefaultConfigurationOptions command to change the default configuration options that we want Managed File Transfer to use. The value of the configuration options defines the group of properties files that Managed File Transfer uses.
Important: On IBM MQ for Multiplatforms, 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, we 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 during installation and are based on your default coordination queue manager. By using the fteChangeDefaultConfigurationOptions command we can change the default coordination queue manager that is defined in the installation.properties file. If we 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 we 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
Parameters
- configuration_options
- Required. This parameter specifies the default configuration options that we 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.
Parent topic: MFT commands
Related information