PQ84113: MISCELLANEOUS FIXES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Miscellaneous fixes
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Application Recovery Tool for IMS   *
  *                 and DB2 Databases.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: -Generated job ends with RC 8 and       *
  *                      messages                                *
  *                      DSNU050I DSNUGUTC - COPY TABLESPACE     *
  *                      DSNDB01.SYSUTILX COPYDDN(LP8) FULL NO   *
  *                      SHRL                                    *
  *                      DSNU182I -DSN1 DSNUGUCC - COPY MUST BE  *
  *                      THE ONLY UTILITY IN SYSIN               *
  *                      DSNU012I DSNUGBAC - UTILITY EXECUTION   *
  *                      TERMINATED, HIGHEST RETURN CODE=8       *
  *                      when DRMIIC is run with TS=CATALOG.     *
  *                      This happens for the SYSIN of the COPY  *
  *                      utility includes all catalog            *
  *                      tablespaces.                            *
  *                      -DRMIC generates image copy steps       *
  *                      with no dataset name in sysin. This     *
  *                      occurs when DRMIC is run against a set  *
  *                      of databases that contains ADS          *
  *                      (area data set) having the UNVAIL       *
  *                      status. Messages V23-001E: DATASET NOT  *
  *                      CATALOGED (with no dataset name) are    *
  *                      issued and the image copy step fails    *
  *                      with RC 8 (msgDFS339I FUNCTION IM HAS   *
  *                      COMPLETED ABNORMALLY RC=08 is issued).  *
  *                      -wrong DSName is used for copy          *
  *                      datasets when a FULL COPY is taken      *
  *                      instead of an INCREMENTAL COPY. ICP,    *
  *                      ICS, ICR and ICV instead of FICP, FICS, *
  *                      FICR and FICV is used as second         *
  *                      qualifier.                              *
  *                      A Full IC is made instead of an         *
  *                      Incremental IC if one of the following  *
  *                      conditions is fullfilled :              *
  *                      a) the update ratio is greater than     *
  *                      UPDTPRCT                                *
  *                      b) the tablespace is in COPY PENDING    *
  *                      state and COPYPEND=FULL is specified    *
  *                      c) there is no Full IC for the          *
  *                      tablespace and COPYPEND=FULLis          *
  *                      specified                               *
  *                      -irrelevant msgDRMIIC-001I: NOTHING     *
  *                      TO DO FOR THIS PARAMETER SET is issued  *
  *                      when DRMIIC is run with COPYPEND=FULL,  *
  *                      DSSEL=DATASET against a partition       *
  *                      tablespace which all partitions have    *
  *                      the COPY PENDING state.                 *
  *                      -JCL error (msgIEF645I INVALID          *
  *                      REFERBACK IN THE REF SUBPARAMETER OF    *
  *                      THE VOLUME FIELD) in generated JCL      *
  *                      when DRMRECOV is run against a given    *
  *                      set of tablespace wich related IC are   *
  *                      on tape. This issue occurs when a       *
  *                      HALDB or a database with several        *
  *                      DDNames is selected.                    *
  *                      -The maximum amount of time (MAXTIME    *
  *                      for DRMVIC and DRMAOP or DRMTIME for    *
  *                      DRMRECOV) allowed for the critcal       *
  *                      phase of DRMVIC, DRMAOP and DRMRECOV    *
  *                      is ignored. It occurs especially when   *
  *                      the response time of IMS is long (Ieg,  *
  *                      MS SYSPLEX environments).               *
  *                      -The rebuild index steps generated by   *
  *                      DRMRECOV ends with RC 8 when HALDB are  *
  *                      involved. This is due to the fact the   *
  *                      RECOVTYP keyword is not in column #19.  *
  *                      msgDFS1982I iReason Code = 10 Recovery  *
  *                      type specified in DFSPREC0 control      *
  *                      card is invalid is issued.              *
  *                      -The date of the oldest IC calculated   *
  *                      by DRMDLET1 is incorrect. It depends    *
  *                      on the list of the selected databases   *
  *                      (DB=).                                  *
  *                      -DRMAOP fails when a PRILOG contains    *
  *                      a compressed data set name.             *
  *                      MsgU35-001I: PRILOG TS timestamp,       *
  *                      msgU35-003E: LOG REACHED WITH INVALID   *
  *                      VOLLIST COUNT and                       *
  *                      msgV19-097E: INTERRUPT BY               *
  *                      NON-RECOVERABLE ERROR are issued.       *
  *                      -endless loop on /DIS PART after /DBD   *
  *                      DBMASTER (HALDB) with DRMAOP            *
  *                      ACTION=INQUIRY against a PHIDAM-HALDB   *
  *                      database.                               *
  *                      This occurs if a partition is started   *
  *                      between the moment when /DBD command    *
  *                      is performed and the moment when /DIS   *
  *                      against the re-started partition is     *
  *                      issued. DRMAOP does not recognizes the  *
  *                      status of the partition and re-issues   *
  *                      the /DIS command many times before      *
  *                      DRMAOP fails.                           *
  *                      -DRMRRORG fails when it is run against  *
  *                      an IMSPLEX having stopped members.      *
  *                      -DRMRECOV fails when the REBUILD Index  *
  *                      steps end with RC 4.                    *
  *                      -Irrelevant or incorrect DSNUM 1        *
  *                      keyword generated in COPY sysin when    *
  *                      DRMFIC or DRMIIC is run with            *
  *                      DSNUM=DATASET against a non             *
  *                      partitioned tablespace.                 *
  ****************************************************************
  * RECOMMENDATION: Install this APAR fix PQ84113.               *
  ****************************************************************
  

Problem conclusion

• -DRMIIC skeletton was modified in order to generate separated
  COPY steps for each tablespace of the catalog
  -CSSIMSEX skeleton, SDIUU40 and DRMIC load modules were
  modified in order to ensure that at least one of the ADS of a
  given area is available before attempting to launch a copy
  against the database. If all ADS have the UNAVAIL status, no IC
  step is generated and msgDRMIC-030I is issued
  -CSQTSPRT, CSQIXPRT, CSQIXPR2, CSSCOP, CSSCOI, CSSCOPPR,
  CSSCOPDD, CSSFIC, CSSIIC skeletons were modified to use FICx
  instead of Icx as second qualifier for the copy datset name
  when a FIC must be made instead of a IIC.
  -SDIUV79 load module was modified. DRMIIC generates a Full
  Image Copy step instead of issuing msgDRMIIC-001I:
  -DRMRECOV, SDIUU40, SDIUY14 were modified.
  -DRMVIC, DRMAOP, DRMRECOV and SDIUV19 were modified and SDIUY16
  was added.
  -DRMSIHAL skeleton was modified to generate a valid syntax.
  To do so, the following 2 lines were used.
     )TBA 19
     PARTITION=&DBD RECOVTYP=BOTH
  -DRMDLET1 was modified.
  -S510U35, S610U35, S710U35 and S810U35 csects have been
  modified.
  -SDIUV19 csect within CS1VIC CS1RECOV CS1AOP load modules was
  modified. The command /DIS command is run against the database
  master instead of the partition so that DRMAOP recieve the
  expected answer from IMS.
  -DRMRRORG was modified. The /RMLIST DBRC='recon status'. Is
  issued to all the members of the IMS group using the /ROUTE
  command.
  -COND clauses with the CSSIXHAL skeletton were modified to
  tolerate RC 4.
  -CSQTSPRT, CSQIXPRT, CSQIXPR2, CSSCOP, CSSCOI, CSSCOPPR,
  CSSCOPDD, CSSFIC, CSSIIC skeletons were modified to not
  generate DSNUM 1 with tthe COPY sysin when the object to be
  copied is not partitioned.
  

Temporary fix

Comments

APAR Information

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

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

Modules/Macros

• DRMAOP   DRMDLET1 DRMFIC   DRMIC    DRMMAP
  DRMQIXPT DRMQIXP2 DRMQTSPR DRMRECOV DRMRRORG DRMSCOI  DRMSCOP
  DRMSCOPD DRMSCOPP DRMSDLT1 DRMSFIC  DRMSIHAL DRMSIIC  DRMSIMSE
  DRMVIC
  

Fix information

• Fixed component name

  APPL RECOVERY T

• Fixed component ID

  5697F5600

Applicable component levels

• R120 PSY UQ90866

     UP04/08/03 P F408

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.