PM08280: ALLOW USER TO CHANGE DB2 AUTOMATION TOOL BATCH BUILD RETURN CODE IF MORE JOBS ARE GENERATED THAN REQUESTED DUE TO MVS RESTRICTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• * MVS restricts the number of steps per job to 254.
  
  * DB2 Automation Tool enforces this limitation to ensure
    valid JCL is created.
  
  * If a user requests Maximum number of jobs = 5 but there
    are too many objects to fit within those 5 jobs,
    DB2 Automation Tool will create additional jobs to
    compensate for the additional objects, while staying within
    the MVS limitations.
  
  The current behavior can create a problem if a user (and their
  scheduler) is unaware of the additional job(s).
  
  
  This fix will add support for an optional parameter called
  'USERJOBS'.  This parameter can be added manually prior to
  execution of the batch build JCL or via a USER skeleton.  The
  parameter will allow the user to override the return code,
  setting it to whatever value they choose when more jobs are
  built than requested because of the MVS limitation of 254 steps
  per job.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of DB2 Automation Tool.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: * MVS restricts the number of steps per *
  *                       job to 254.                            *
  *                      * DB2 Automation Tool enforces this     *
  *                       limitation to ensure valid JCL is      *
  *                       created.                               *
  *                      * If a user requests Maximum number of  *
  *                       jobs = 5 but there are too many object *
  *                       fit within those 5 jobs, DB2           *
  *                       Automation Tool will create additional *
  *                       jobs to compensate for the additional  *
  *                       objects, while staying within the MVS  *
  *                       limitations.                           *
  *                      The current behavior can create a       *
  *                      problem if a user (and their scheduler) *
  *                      is unaware of the additional job(s).    *
  *                      This fix will add support for an        *
  *                      optional parameter called 'USERJOBS'.   *
  *                      This parameter can be added manually    *
  *                      prior to execution of the batch build   *
  *                      JCL or via a USER skeleton.  The        *
  *                      parameter will allow the user to        *
  *                      override the return code, setting it    *
  *                      to whatever value they choose when more *
  *                      jobs are built than requested because   *
  *                      of the MVS limitation of 254 steps      *
  *                      per job.                                *
  ****************************************************************
  * RECOMMENDATION: APPLY the PTF.                               *
  ****************************************************************
  Code has been changed to correct this condition.
  

Problem conclusion

Temporary fix

Comments

• APPLY the PTF.
  

APAR Information

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

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

Modules/Macros

• HAAREORC
  

Fix information

• Fixed component name

  DB2 AUTOMATION

• Fixed component ID

  5697G6300

Applicable component levels

• R310 PSY UK58293

     UP10/07/02 P F007

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.