IBM Support

PH04826: BFGCUSTM fails with a BFGCL0722E error

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 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

  • ****************************************************************
    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.
    

Problem 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
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH04826

  • Reported component name

    IBM MQ MFT Z/OS

  • Reported component ID

    5655MF900

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-11-05

  • Closed date

    2018-11-15

  • Last modified date

    2018-11-28

  • 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

[{"Business Unit":{"code":"BU050","label":"BU NOT IDENTIFIED"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"910","Edition":""}]

Document Information

Modified date:
28 November 2018