IBM Support

PH04826: BFGCUSTM fails with a BFGCL0722E error

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as duplicate of another APAR.

Error description

  • When running the BFGCUSTM member within the SBFGCMDS PDSE
    provided by IBM MQ Managed File Transfer for z/OS, the following
    error occurs:
    
    5724-H72 Copyright IBM Corp.  2008, 2018.  ALL RIGHTS RESERVED
    BFGCL0722E: fteCustom has been invoked with an invalid argument.
    

Local fix

  • The original REXX code in row 103 is:
    
    "bpxbatsl pgm" PGM MYARGS.
    
    A workaround is remove MYARGS in that row 103 in BFGZCMD.
    

Problem summary

Problem conclusion

Temporary fix

Comments

  • USERS AFFECTED:
    This issue affects users of IBM MQ Managed File Transfer for
    z/OS who use the BFGCUSTM member to configure IBM MQ Managed
    File Transfer for z/OS.
    
    
    Platforms affected:
    z/OS
    
    PROBLEM DESCRIPTION:
    IBM MQ Managed File Transfer for z/OS provides a PDSE called
    SBFGCMDS which can be used to set up a IBM MQ Managed File
    Transfer configuration, agents and loggers. In order to use the
    PDSE, the following steps should be carried out:
    
    - Make a copy of the SBFGCMDS dataset for each agent and logger
    that you want to create.
    - Edit the BFGCUSTM member within the dataset, replacing strings
    that have the format:
    
        ++<string>++
    
       with the appropriate values.
    - Submit BFGCUSTM.
    
    When the BFGCUSTM member is submitted, it invokes another member
    within the PDSE called BFGZCMD, passing in the following
    arguments:
    
    - STDIN
    - TMPDIR=/tmp
    - PGM=++bfg_prod++/bin/fteCustom
    
    (where ++bfg_prod++ is the Unix System Services (USS) directory
    on the mainframe where IBM MQ MFT is installed). BFGZCMD
    contains some REXX, which processes these arguments and makes
    the following call:
    
    "bpxbatsl pgm" PGM MYARGS
    
    to invoke the fteCustom command. fteCustom will then create a
    number of new members within the PDSE that contain JCL specific
    to the agent or logger.
    
    Unfortunately, the BFGZCMD member did not process the arguments
    correctly. This meant that when the BFGCUSTM member was
    submitted:
    
    - PGM was correctly set to ++bfg_prod++/bin/fteCustom
    - However, MYARGS was incorrectly set to
    PGM=++bfg_prod++/bin/fteCustom
    
    As a result, BFGZCMD made the following call:
    
      "bpxbatsl pgm" ++bfg_prod++/bin/fteCustom
    PGM=++bfg_prod++/bin/fteCustom
    
    PGM=++bfg_prod++/bin/fteCustom was not a valid argument for the
    fteCustom command, and so it failed with the error:
    
    BFGCL0722E: fteCustom has been invoked with an invalid argument.
    
    
    CONCLUSION:
    The BFGZCMD member within the IBM MQ Managed File Transfer
    V9.1.0 PDSE has been updated to correctly parse the arguments
    that are passed to it from the BFGCUSTM member. This allows the
    fteCustom command to run successfully and create the new members
    in the PDSE for an agent or logger.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.12
    v9.0 LTS   9.0.0.6
    v9.1 CD    9.1.2
    v9.1 LTS   9.1.0.2
    
    The latest available MQ 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
    ---------------------------------------------------------------
    This APAR is a duplicate of PH10549
    

APAR Information

  • APAR number

    PH04826

  • Reported component name

    IBM MQ MFT Z/OS

  • Reported component ID

    5655MF900

  • Reported release

    910

  • Status

    CLOSED DUB

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-11-05

  • Closed date

    2021-04-15

  • Last modified date

    2021-04-15

  • 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

    IBM MQ MFT Z/OS

  • Fixed component ID

    5655MF900

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":"910"}]

Document Information

Modified date:
16 April 2021