IBM Support

PH31569: OSAM ENCRYPTION SUPPORT FOR IRS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • OSAM encryption support for IMS Recovery Solution Pack.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All IMS Recovery Solution Pack for z/OS      *
    *                 Version 2 Release 1 ( FMID=HAHM210 )         *
    *                 IMS Database Recovery Facility users.        *
    ****************************************************************
    * PROBLEM DESCRIPTION: This APAR enables IMS Database Recovery *
    *                      Facility to support OSAM encryption.    *
    ****************************************************************
    * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
    ****************************************************************
    IMS Database Recovery Facility provides the following support
    for OSAM encryption.
    IMS Database Recovery Facility supports the z/OS data set
    encryption for the IMS OSAM database (*1,*2)
    
    *1:In the following cases, IMS Database Recovery Facility can
       take over the key label and encrypt the newly defined
       database data set with it.
       - When the production database data set is defined by
         specifying DATACLAS with an associated key label.
       - When the SMS data class with an associated key label is
         specified in the DBDSLnnn DATAC control statement.
       - When DISP(PDS) is specified in the DBDSLnnn control
         statement, and IDCAMS define statement for the new database
         data set in the DDEFPDS library has KEYLABEL or DATACLAS
         with an associated key label.
    *2:The use of user-image copies, IC2, SAMEDS ICs, or FlashCopies
       are not supported.
    
    The PTF for the following IMS APAR is required to use the new
    functions:
    - PH27729: IMS Version 15
    
    If you want to create a new image copy dataset for an OSAM
    encrypted database in DRF, the PTF for the following APAR is
    required:
    - PH31513: IMS HP Image Copy for z/OS Version 4 Release 2
    
    If you want to do hash pointer checking in DRF, the PTF for
    the following APAR is required:
    - PH24727: IMS HP Pointer Checker for z/OS Version 3 Release 1
    Otherwise, it causes the following symptoms:
    - IMS HP Pointer Checker (HPPC) exits with a number of
      unexpected error messages about the OSAM encrypted database.
    - Incorrect values for physical blocks per track are reported in
      the HPPC validation report.
    Therefore, if this APAR is not applicable, run DRF with hash
    pointer checking disabled for recovered databases (without
    specifying the PC keyword in the ADD command).
    

Problem conclusion

  • IMSOSAMLDS/K
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH31569

  • Reported component name

    IMS RCVR SOLUTN

  • Reported component ID

    5655V8600

  • Reported release

    210

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2020-11-11

  • Closed date

    2020-11-24

  • Last modified date

    2024-12-02

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

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

    UI72743

Modules/Macros

  • FRXADF00 FRXADM10 FRXDDCC0 FRXDDCD0 FRXDDCP0 FRXDDCR0 FRXDDDF0
    FRXDDDL0 FRXICAI0 FRXICLI0 FRXICTL0 FRXIIOM0 FRXIOCC0 FRXIOCD0
    FRXIOCN0 FRXIOCP0 FRXIOCR0 FRXIODF0 FRXIOMG0 FRXIOSM0 FRXIRTH0
    FRXISMS0 FRXISMU0 FRXIVCN0 FRXIVSM0 FRXUAPI0
    

Publications Referenced
SC27844101    

Fix information

  • Fixed component name

    IMS RCVR SOLUTN

  • Fixed component ID

    5655V8600

Applicable component levels

  • R210 PSY UI72743

       UP20/11/26 P F011  

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"210"}]

Document Information

Modified date:
03 December 2024