PI70130: COPY WITH FLASHCOPY ENDS WITH RC00 INSERTING ONE ROW IN SYSCOPY EVEN IF DFSMSDSS RETURNED RC08 ON COPY COMMAND

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A COPY with FLASHCOPY option gets RC08 back from DFSMSDSS due
  to a syntax error, as showed in following returned messages:
  TEMPLATE TEMPF DSN 'C25574.&DB..&TS..P&PART(2,4).(+1)'
  VOLCNT(255) GDGLIMIT  8 DISP(MOD, CATLG, CATLG)
  COPY LIST POA01C FULL YES SHRLEVEL CHANGE FLASHCOPY YES
  FCCOPYDDN(TEMPF)
  COPY DATASET(INCLUDE( -.
  DB2GXC0.DSNDBC.C25574.TEST1.I0001.A001 , -
  ....
  RENAMEU( -.
  (DB2GXC0.DSNDBC.C25574.TEST1.I0001.A001 , -.
  C25574.C25574.TEST1.P0001(+1) ) -.
  ....
  ADR141E (001)-RI03 (12), ERROR IN DATA SET NAME
  C25574.C25574.TEST1.P0001.
  ADR017E (001)-CLTSK(01), 2016.197 11:08:08 TASK NOT SCHEDULED
  DUE TO ERROR. TASK RETURN CODE 0008.
  ADR012I (SCH)-DSSU (01), 2016.197 11:08:08 DFSMSDSS PROCESSING
  COMPLETE.
  HIGHEST RETURN CODE IS 0008 FROM:
  SYNTAX.
  TASK
  001.
  .
  The syntax error detection is valid and expected, however the
  utility job ended with RC00 and a row in SYSIBM.SYSCOPY was
  incorrectly inserted.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All DB2 12 for z/OS users of COPY and REORG utility using    *
  * the FlashCopy function.                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * 1. COPY utility ended with RC0 instead of RC8 when an        *
  * incorrect TEMPLATE DSN was specified for the FlashCopy image *
  * copy (FCIC).                                                 *
  * 2. REORG utility with FLASHCOPY YES ended with RC4 instead   *
  * of RC8 when DSSPRINT was needed but was missing.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Two problems are fixed in this APAR:
  1. User submitted a COPY utility job with FLASHCOPY YES or
  FLASHCOPY CONSISTENT and specified an incorrect TEMPLATE DSN
  which caused an incorrect data set name to be built.  The
  TEMPLATE DSN specified a relative GDG name like this:
    TEMPLATE TEMPF DSN 'DB2CAT.&DB..&TS..P&PART(2,4).(+1)'
  When the COPY utility invoked DFSMSdss to create the FCIC,
  DFSMSdss returned ADR0141E - ERROR IN DATA SET NAME and RC8 due
  to the syntax error.  The COPY utility incorrectly ended with
  RC0 and a SYSCOPY record was inserted for the FCIC even though
  the creation of the FCIC was not successful.
    This problem could also occur for REORG and LOAD when an
  incorrect TEMPLATE DSN is specified with FLASHCOPY YES or
  CONSISTENT.
    Note that GDGs are not supported for FCICs because GDGs must
  be sequential data sets while FCICs are VSAM data sets.
  
  2. User ran the REORG utility using FlashCopy function with
  SYSPRINT allocated to a data set (instead of SYSOUT=*). The
  REORG issued DSNU047I - A REQUIRED DD CARD OR TEMPLATE IS
  MISSING. NAME=DSSPRINT, but ended with a final return code of
  RC4 instead of RC8.
  
  
  Additional Keywords:  MSGDSNU047I MSGADR0141E RC04 RC08 RC00
  SYSIBM.SYSCOPY
  

Problem conclusion

• 1. The FlashCopy utility driver code has been modified to
  terminate the FCIC creation process when a return code of 8 or
  greater has been received from DFSMSdss.  This fix affects the
  COPY, REORG and LOAD utilities.
    For COPY on a list of objects, the FCIC creation process will
  be terminated for a DFSMSdss return code of 8 or greater even if
  OPTIONS EVENTS(ITEMERROR,SKIP) has been specified, because the
  RC8 or greater indicates a type of error that would encompass
  all objects in the list.
  
  2. REORG utility using FlashCopy has been modified to end with
  RC8 when the DSSPRINT data set is needed but is missing.
  

Temporary fix

Comments

APAR Information

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

  PI69849

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

  UI45826

Modules/Macros

• DSNUGFCD
  

Fix information

• Fixed component name

  DB2 OS/390 & Z/

• Fixed component ID

  5740XYR00

Applicable component levels

• RC10 PSY UI45826

     UP17/04/08 P F704 ¢

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.