IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    IT34780

  • Reported component name

    MQ BASE V9.2

  • Reported component ID

    5724H7281

  • Reported release

    920

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-11-04

  • Closed date

    2020-12-01

  • Last modified date

    2020-12-01

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"920"}]

Document Information

Modified date:
25 March 2021