PK31680: ADD SUPPORT FOR RETPD PARAMETER

APAR status

• Closed as new function.

Error description

• IMS Tools Database Recovery Facility does not support the RETPD
  parameter for ADD IC control statement which doesn't make sense.
  RETPD is a supported parameter in IMS Tools High Performance
  Image Copy.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Database Recovery Facility Version 3     *
  *                 Release 1 users who plan to have an image    *
  *                 copy generated as part of the recovery job.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Users may encounter the following       *
  *                      messages while running DRF with the     *
  *                      RETPD HPIC parameter.                   *
  *                      MSGBPE0003E AN ERROR OCCURRED PARSING   *
  *                                  CONFIGURATION MEMBER        *
  *                      MSGBPE0003E FAILING TEXT: "RETPD(23),"  *
  *                      MSGBPE0003E INVALID KEYWORD DETECTED    *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  While invoking recovery with the intent to have DRF generate an
  HPIC image copy, the RETPD parameter is rejected.  RETPD is a
  supported parameter to HPIC to control the image copy retention
  period, however, it is not recognized by DRF.
  

Problem conclusion

Temporary fix

Comments

• DRF is changed to recognize and support the RETPD parameter in
  either the DRF IC() keyword or the UTILGBL() statement.  This
  parameter is passed to HPIC during image copy generation.
  RETPD is mutually exclusive to EXPDT.
  ----
  The following DOC change is made:
  IMS Database Recovery Facility for z/OS User's Guide and
  Reference Version 3 Release 1  (SC18-9407-00)
  
  Chapter 7. Messages and Codes of IMS Database Recovery Facility
  FRD6122A THE FOLLOWING MUTUALLY EXCLUSIVE KEYWORDS WERE
           ENCOUNTERED IN FILE fileid KEYWORD: keyword1
           KEYWORD: keyword2
  
  Explaination: During a parsing operation, mutually exclusive
  keywords were encountered. In the message text:
  
    keyword1
      Identifies on of the keywords in conflict.
    keyword2
      Identifies the other keyword or types of keywords in
      conflict.
  
  The EXPDT and RETPD paramenters may have been specified in the
  control statement, but they are mutually exclusive.
  
  System action:  Recovery stops.
  
  System programmer response:  Correct the problem with the
  keywords, and start the recovery again.
  

APAR Information

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

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

  UK19167

Modules/Macros

• FRXEDRF  FRXEDRF0 FRXEGRM  FRXEGRM0 FRXEPSS0
  FRXESYS  FRXEWSP  FRXIOCN0 FRXIVSM0 FRXPDIR0 FRXRWAE  FRXRWCE
  FRXRWSP  FRXTSIB0 FRXUAPI0 FRXVADD0 FRXVASD0 FRXVSTA0 FRXVSTA1
  FRXVSTA2 FRXVWSP
  

Fix information

• Fixed component name

  IMS DB RECOVERY

• Fixed component ID

  5655I4400

Applicable component levels

• R310 PSY UK19167

     UP06/10/28 P F610