fteChangeDefaultConfigurationOptions

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: 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, 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 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 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 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 MFT configuration options on Multiplatforms for more information about the installation.properties file.


Syntax

fteChangeDefaultConfigurationOptions

fteChangeDefaultConfigurationOptions configuration_options


  • Parameters

      configuration_options
      Required. This parameter specifies the default configuration options 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.