IT34780: MFT Redistribution 'fteCreateEnvironment' command does not validate the installation name argument

APAR status

• Closed as program error.

Error description

• When using the 'fteCreateEnvironment' command to configure the
  environment for a Redistributable Managed File Transfer Agent,
  it is possible to specify an invalid Installation name, for
  example:
  
      MFT9.2LTS
  
  which includes a '.' character, which is not permitted in the
  Installation name.  When the 'fteSetupCoordination' command is
  subsequently used to create properties files and the
  coordination queue manager directory for Managed File Transfer,
  this command will fail with the following error message:
  
  BFGUB0054E: The installation name 'MFT9.2LTS' is invalid and
  cannot be used in this command.
  

Local fix

• Reissue the 'fteCreateEnvironment' command and provided a valid
  installation name which can contain up to 16 alphabetic and
  numeric characters.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of the Redistributable Managed File
  Transfer Agent, who are issuing the command:
  
    fteCreateEnvironment
  
  with the '-n' argument, to specify an "installation name".
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When using the 'fteCreateEnvironment' command, it is possible to
  specify an invalid Installation name (e.g., MFT9.2LTS), which
  will be accepted by the command without indicating an error.
  
  Subsequently, when running fteSetupCoordination command is used
  to create properties files and the coordination queue manager
  directory for Managed File Transfer, this command will fail with
  the following error message:
  
  BFGUB0054E: The installation name 'MFT9.2LTS' is invalid and
  cannot be used in this command.
  

Problem conclusion

• The fteCreateEnvironment command has been updated to generate an
  error when providing an invalid installation name.
  
  eg.
  $source ./fteCreateEnvironment -d ${HOME}/data -n
  MQ_MFT_LONG_INSTALLNAME
  5724-H72 Copyright IBM Corp.  2008, 2020.  ALL RIGHTS RESERVED
  BFGCL0812E: The installation name argument supplied on the
  fteCreateEnvironment command, 'MQ_MFT_LONG_INSTALLNAME', is not
  a permitted MQ installation name.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.2 LTS   9.2.0.2
  v9.x CD    9.2.2
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  MQ BASE V9.2

• Fixed component ID

  5724H7281

Applicable component levels