IBM Support

PK33728: APPLICATION RECOVERY TOOL V10 SUPPORT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Application Recovery Tool v10 support
    KEYWORDS: IMSV10TGT/K
    ADDITIONAL SYMPTOMS:
    1. ABEND0C7        PB 8966
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of Application Recovery Tool.          *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1. All DB2 functions. ART can now use   *
    *                      the FAST or QFAST access method to      *
    *                      access the DB2 catalog for DB2 V8       *
    *                      (parameter ACCESS of the DRMXDB2S       *
    *                      member). Before this fix, a message     *
    *                      DRMU89-004I: ACCES=FAST IS UNAVAILABLE  *
    *                      IN THIS SOFTWARE VERSION was issued.    *
    *                      PB 5149                                 *
    *                      2. DRMRECOV: When a recover is made on  *
    *                      a DEDB database, the notify command     *
    *                      that is generated is incorrect.         *
    *                      PB 6138                                 *
    *                      3. DRMIIC: message DRMIIC-001I:         *
    *                      NOTHING TO DO FOR THIS PARAMETER SET is *
    *                      issued when processing is required      *
    *                      because the object have been modified   *
    *                      since it's previous image copy.         *
    *                      PB 6171                                 *
    *                      4. PB 6260: Potential error messages    *
    *                      DRMU35-002E: PRILOG NOT FOUND after     *
    *                      DST (Daylight Saving Time) change.      *
    *                      5. PB 6413: DRMFIC, DRMIIC, DRMMERGE:   *
    *                      New value W for the FLUSH parameter.    *
    *                      6. PB6428: Enhancement: It is now       *
    *                      possible to specify in the DRMXCUST     *
    *                      member a USER without specifying PSW.   *
    *                      7. PB 6450: Function: DRMFIC/DRMDLET2.  *
    *                      An ISPF error can occur when using the  *
    *                      function on TS=CATALOG. The text of     *
    *                      the ISPF error is:                      *
    *                      Data truncation occurred - Data for     *
    *                      CHAR format variable "DBNAME" was too   *
    *                      long.                                   *
    *                      8. PB 6471: Function DRMFIC, DRMIIC,    *
    *                      DRMMERGE, DRMIC, DRMCA, parameter       *
    *                      DUNIT is ignored when DVOL is also      *
    *                      coded.                                  *
    *                      9. PB 6580: When running on a sysplex   *
    *                      IMS environment, ART uses the Extended  *
    *                      MCS consoles to issue the IMS commands. *
    *                      The console name was created using a    *
    *                      random value. As the EMCS are not       *
    *                      freed by the system, and are release    *
    *                      only during the next reinitialization.  *
    *                      10. PB 6662: When running on a sysplex  *
    *                      IMS environment, potential error        *
    *                      message DRMV19-006E: CURRENT OLDS NOT   *
    *                      DETECTED. INTERNAL ERROR ISSUED.        *
    *                      11. PB 6664: Function DRMVIC used       *
    *                      without the TS parameter (or with       *
    *                      TS=NONE) and with only a PLAN= or       *
    *                      PKLIST= fails with abend U4001 and      *
    *                      without error messages.                 *
    *                      12. PB 6704: Potential abend S0C4 in    *
    *                      IMS V8 when split LOG records are       *
    *                      found in the DBRC RECON dataset.        *
    *                      13. PB 6729: Function CS1AOP with       *
    *                      action=DEALLOC. A potential loop can    *
    *                      occur when the IMS database is          *
    *                      allocated to a batch job. The RETRY     *
    *                      value is incorrectly set to the value   *
    *                      of MAXTIME parameter.                   *
    *                      14. PB 6885: DRMIC: For very large DB   *
    *                      and IC allocated on DISK, the           *
    *                      generated DD statement can contain      *
    *                      negative values for the space           *
    *                      parameter if the number of bytes in     *
    *                      exceeds 2147483647. The size is         *
    *                      incorrectly processed as a signed       *
    *                      integer.                                *
    *                      15. PB 6888: DRMVIC: the DRMVIC         *
    *                      function doesn't detect an IMS batch    *
    *                      programm running in PROCOPT=L. The VIC  *
    *                      point is taken and the function         *
    *                      finishes correctly. The correct         *
    *                      processing is to wait until the         *
    *                      program finishes before taking the VIC  *
    *                      point.                                  *
    *                      16. PB 7149: DRMRECOV: new parameter    *
    *                      REUSEIC allows to execute for an IMS    *
    *                      data base several recover that use the  *
    *                      same image copies as input. REUSEIC=N   *
    *                      (default). When an IC is used during a  *
    *                      RECOV operation it is considered as     *
    *                      obsolete for future RECOV operations.   *
    *                      17. PB 7566: DRMVIC: the DRMVIC         *
    *                      function doesn't detect a utility run   *
    *                      in LOG NO on the requested TS or any    *
    *                      non logged updates on an IMS DB.        *
    *                      18. New AUXTS parameter in functions    *
    *                      DRMFIC, DRMIIC, DRMMERGE, DRMDLET2,     *
    *                      DRMRECOV, DRMCHECK, DRMMAP and DRMAOP.  *
    *                      19. New NOTLOGD parameter in functions  *
    *                      DRMFIC, DRMIIC, DRMVIC, DRMRECOV.       *
    *                      20. Support of the CLONE table spaces.  *
    *                      21. Support of IMS V10.                 *
    *                      22. After this fix is applied, ART      *
    *                      will only support IMS V8, V9 and V10.   *
    *                      Versions of IMS prior to version 8 are  *
    *                      no longer supported.                    *
    *                      23. IMS V10 support: Specification of   *
    *                      the IMS level in the DRMXIMSS and       *
    *                      DRMXISGS members.                       *
    *                      24. Reformatting the RECON VIC VSAM     *
    *                      clusters.                               *
    *                      25. Support of the IMS V10 timestamps   *
    *                      up to the microsecond.                  *
    *                      26. Support of the FLASH COPY in IMS    *
    *                      V10.                                    *
    *                      27. Parallel Access RECON:              *
    *                      The DBRC RECON file allows record       *
    *                      level sharing of the RECON data. ART    *
    *                      is fully compatible with this new       *
    *                      feature of IMS V10. This compatibility  *
    *                      is transparent to the user and does     *
    *                      not require any parameter setting.      *
    *                      28. Support of DB2 V9, including all    *
    *                      new type of table spaces and indexes.   *
    *                      29. New catalog table spaces are        *
    *                      processed in the DB2 functions (FIC,    *
    *                      IIC, MERGE, VIC, RECOV, MAP, AOP)       *
    *                      30. New TSSET parm in functions DRMFIC, *
    *                      DRMIIC, DRMMERGE, DRMDLET2, DRMRECOV,   *
    *                      DRMMAP and DRMAOP.                      *
    *                      31. DRMVIC: Support of the auxilary     *
    *                      table spaces and of the not logged      *
    *                      objects.                                *
    *                      32. DRMVIC performs a QUIESCE with a    *
    *                      void SYSIN but ends with RC 0. This     *
    *                      occurs when CLONE is set to Y.          *
    *                      PB 8821                                 *
    *                      33. The SYSIN generated for the         *
    *                      DFSURDB0 utility is incorrect           *
    *                      regarding timestamp specification.      *
    *                      Several symptoms:                       *
    *                      - incorrect timestamp format            *
    *                      - invalid timestamp value               *
    *                      - incorrect local time offset           *
    *                      (TU-LOCAL)                              *
    *                      - in IMS V10, MINVERS is not specified  *
    *                      34. DRMRECOV does nothing if recovery   *
    *                      to VIC point is requested and DSSEL     *
    *                      has a numeric value.                    *
    *                      Miscelaneous errors occur running       *
    *                      DRMRECOV against clone tablespaces.     *
    *                      PB 8853                                 *
    *                      35. msgDRMU78-003I (undocumented since  *
    *                      not an actual message number) issued    *
    *                      instead of DRMU78-002I (THE FOLLOWING   *
    *                      XXXXXSPACE(S) WITH PARTITION) when      *
    *                      running DRMRECOV against partitioned    *
    *                      DB2 tablespaces.                        *
    *                      PB 8854                                 *
    *                      36. U4003 ABEND occurs when running     *
    *                      DRMVIC with a SYSIN data set containing *
    *                      more than one VIC statement.            *
    *                      PB 8855                                 *
    *                      37. Irrelevant msgDRMRECOV-008I         *
    *                      (NO CHANGE HAS OCCURRED FOR dbname) is  *
    *                      issued and no recovery is performed.    *
    *                      PB 8858                                 *
    *                      38. U4002 ABEND occurs when running     *
    *                      DRMRECOV or DRMMAP or DRMVIC or DRMAOP  *
    *                      against IMS databases only. This        *
    *                      occurs when:                            *
    *                      - both IMSID and DB2ID are specified    *
    *                       although only IMSID is needed          *
    *                      - DRMEXEC cannot access DB2 load        *
    *                       modules                                *
    *                      - the value for CLONE in DRMRECOV       *
    *                       parmlib member is not set to N         *
    *                      PB 8885                                 *
    *                      39. DRMRECOV to VIC point fails         *
    *                      (U4001 and SQLCODE=-110) although       *
    *                      DRMVIC ended succesfully. This occurs   *
    *                      when DRMVIC is run with CLONE=Y option. *
    *                      PB 8887                                 *
    *                      40. Miscelaneous error occurs (among    *
    *                      which S0C7, U4001 ABEND) when runnning  *
    *                      DRMVIC, DRMRECOV, DRMMAP function due   *
    *                      to incorrect THT record added by ART.   *
    *                      PB 8966                                 *
    *                      41. Potential abend S80A in all DB2     *
    *                      functions: DRMAOP, DRMDCHEK, DRMDLET2,  *
    *                      DRMFIC, DRMIIC, DRMMERGE, DRMRECOV,     *
    *                      DRMVIC.                                 *
    *                      PB 8973                                 *
    *                      42. IMS V10: Messages V08-002E and      *
    *                      DSP0243I about RECON allocation in      *
    *                      DRMCA and DRMRRORG functions.           *
    *                      PB 8987                                 *
    ****************************************************************
    * RECOMMENDATION: APPLY the PTF.                               *
    ****************************************************************
    1. Not a bug
    2. Module CS1NTRCV and skeleton DRMSRECV were changed to use
    the correct syntax in the notify.recov command.
    3. Module DRMIIC was changed to correctly retrieve the updates
    made on the TS.
    4. Modules SDIUY09, S710Y21 and S810Y21 were changed to process
    correctly this case.
    5. Not a bug
    6. Not a bug
    7. Module SDIUU88 was changed to process the DBNAME on 8
    characters maximum.
    8. The corresponding modules were changed to process the DUNIT
    together with the DVOL when both are coded.
    9. Module DRMIMSRO was changed to reuse the existing EMCS names.
    The names used are $IN00000 to $INnnnnn.
    10. Module DRMIMSRO was changed to retrieve correctly the result
    of the IMS commands.
    11. Module DRMVIC was changed to initialize correctly the column
    FLDEFNO of the ISPF table TDBTS.
    12. Module S810U20 was changed to use the correct buffer size
    when reading from the RPL.
    13. The maximum duration of the wait is now limited by the
    MAXTIME parameter rather than by a number of retry.
    14. The size is now processed asn an unsigned integer value.
    15. Module SDIUV19 is changed to retrieved in the DBRC RECON
    data set the DBNCDDST field that contains x'07' when the
    database is allocated for exclusive use.
    16. Not a bug
    17. Module DRMVIC and skeleton DRMQREC were changed to process
    correctly non logged operations.
    18. Not a bug
    19. Not a bug
    20. Not a bug
    21. Not a bug
    22. Not a bug
    23. Not a bug
    24. Not a bug
    25. Not a bug
    26. Not a bug
    27. Not a bug
    28. Not a bug
    29. Not a bug
    30. Not a bug
    31. Not a bug
    32. cssvic was changed to write a QUIESCE SYSIN even when
    CLONE=Y.
    33. cs1recov, sdiuy09, cssrchal, csurecov and sa10U20 were
    fixed.
    34. cs1recov, sdiuu88, sdiuv58, sdiuu88, sdiuv87, sdiuv90,
    sdiuv95, sdiuv96, sdiuv97, sdiux88 and csurects were fixed.
    35. sdiuu78 was fixed to issue the message with the right
    number.
    36. sdiuv66 was changed to handle multiple DRMVIC statement in a
    single SYSIN data set
    37. Unspecified.
    38. cs1aop, cs1map, cs1recov and cs1vic were fixed not to
    attempt useless DB2 access when only IMS objects are involved.
    39. sdiuv66 was fixed to store the RBA into the VIC RECON
    dataset.
    40. Unspecified.
    41. Modules sdiuv50 and sdiux50 were fixed to  issue a GETMAIN
    with a correct value.
    42. Modules sdiuv08 and sa10u20 were changed to allocate the 3
    RECONn ddnames before invoking module DFSURX00.
    

Problem conclusion

Temporary fix

Comments

  • APPLY the PTF.
    

APAR Information

  • APAR number

    PK33728

  • Reported component name

    APPL RECOVERY T

  • Reported component ID

    5697F5600

  • Reported release

    120

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2006-10-27

  • Closed date

    2007-10-08

  • Last modified date

    2010-08-27

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

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

    UK30015

Modules/Macros

  • DRMAMS   DRMAOP   DRMAUTH  DRMCA    DRMCB
    DRMCHECK DRMCMD0  DRMDBASE DRMDCHEK DRMDLET1 DRMDLET2 DRMDSUBS
    DRMEXEC  DRMFIC   DRMIC    DRMIIC   DRMILGS  DRMIMFIS DRMIMSRO
    DRMINFIS DRMINIT  DRMINSTL DRMISTIM DRMJBFIS DRMJOBCD DRMKDEFI
    DRMKDEFS DRMKIAOP DRMKIDL2 DRMKIFIC DRMKIIC  DRMKIIIC DRMKIMAP
    DRMKIMER DRMKINII DRMKINIS DRMKINSV DRMKINS1 DRMKINS2 DRMKIREC
    DRMKIVIC DRMKJCHE DRMKJCHS DRMKJOBC DRMLDSTS DRMMAP   DRMMDISK
    DRMMDLET DRMMERGE DRMMJCDB DRMMPLIB DRMNTRCV DRMPINSV DRMPLAN
    DRMPLIB  DRMPPRIM DRMQCKII DRMQDIC  DRMQDI2  DRMQINDX DRMQIXPT
    DRMQIXP2 DRMQKIC  DRMQLIX  DRMQLI2  DRMQLOCK DRMQLTS  DRMQMAP
    DRMQPKDP DRMQPLLP DRMQRCV  DRMQREC  DRMQRLTS DRMQTSPR DRMQTSP2
    DRMQTTSS DRMQTUN  DRMQUERY DRMQVIC  DRMRBSDS DRMRCKIC DRMRDTS
    DRMRECOV DRMRPLLP DRMRREC  DRMRRORG DRMRTSP2 DRMSAMS  DRMSAMSU
    DRMSCAT9 DRMSCHEK DRMSCOP  DRMSCOPD DRMSCOPP DRMSCOP2 DRMSDLT1
    DRMSDLT2 DRMSDSAL DRMSERII DRMSFIC  DRMSIC   DRMSIIC  DRMSIMSI
    DRMSMERG DRMSRCOV DRMSRCTS DRMSRECI DRMSRHAL DRMSTDBT DRMSVIC
    DRMUALLD DRMUFIC  DRMUIIC  DRMUMERG DRMUMRGS DRMUPSYN DRMURCOV
    DRMURCST DRMURCTS DRMUTL0  DRMVIC   DRMXPROC
    

Fix information

  • Fixed component name

    APPL RECOVERY T

  • Fixed component ID

    5697F5600

Applicable component levels

  • R120 PSY UK30015

       UP07/10/18 P F710

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"1.2.0","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020