PH04826: BFGCUSTM fails with a BFGCL0722E error

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