PQ60462: THE PTF'S UQ64349 AND UQ64515 NEED TO PE'D. THE FOLLOWING APAR NEEDS TO BE OPENED TO SUPERSEDE BOTH OF THESE PTF'S.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Error Description:
  > This APAR introduces IMS V8 support as well as addressing
    additional problems:
  >
  > Problem #1:
  > Users affected: All Program Restart Facility users migrating
    to IMS V8.
  >
  > Problem Description: IMS Version 8 support to the IMS
    Program Restart Facility needs to be added.
  >
  > Problem #2:
  > Users affected: All Program Restart Facility users.
  >
  > Problem Description: Support is being added for the new
    NOMSG542 and NO681542 special checkpoint id's introduced
    by APAR PQ48495 and PQ51736.
  Problem #3:
  > Users affected: All Program Restart Facility users.
  >
  > Problem Description: The special restart options CTX data
    set is not being deleted if the application does not issue
    any CHKP calls.
  Problem #4: Users affected: All Program Restart users
    installing the sample usermods to their IMS V7 systems.
  > Problem Description: Member IRTUM71D in the IRTSAMP
    library is missing '++MAC(IRTXZSR) DISTLIB(ADFSMAC).'
    statement after the first MEND statement just before
    the MACRO and IRTXZSR statements.
  > Recommendation: Install this corrective maintenance.
  >
  > Problem #5:
  Users affected: All Program Restart users which have
  applications that only initialize the first three bytes
  of the XRST checkpoint ID I/O area to spaces before
  issuing the initial XRST call.
  
  Problem Description:  Applications only initializing
  the first three bytes of the XRST checkpoint ID I/O
  area before the initial XRST call are abending with
  a U0102 abend code.  While the current IMS documentation
  states that the IO area must be initialized to spaces
  > (up to 30 bytes depending on the reference), the actual
    base IMS code has only been checking the first three
    bytes for spaces. The maintenance for this APAR will
    allow Program Restart to maintain compatibility with
    the actual base IMS code.
  >
  Problem #6:
  >
  > Users affected: All Program Restart users
  > Problem Description: JCLIN to install modules
    IRTXIOA0 and IRTURRC0 is missing, causing
    message GIM43401W to be displayed during APPLY
  > processing for UQ64349.
  > Recommendation: For the above problems, Install this
    maintenance.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS.          *
  ****************************************************************
  * PROBLEM DESCRIPTION: THIS APAR INTRODUCES IMS V8 SUPPORT AS  *
  *                      WELL AS ADDRESSING ADDITIONAL PROBLEMS. *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  THIS APAR IS ADDRESSING SEVERAL ISSUES AND PROBLEMS.
  ITEM #1: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS
  WHO ARE MIGRATING TO IMS VERSION 8.
  DESCRIPTION: IMS VERSION 8 SUPPORT IS BEING ADDED TO THE IMS
  PROGRAM RESTART FACILITY.
  ITEM #2: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS.
  DESCRIPTION: SUPPORT IS BEING ADDED FOR THE NEW NOMSG542 AND
  NO681542 SPECIAL CHECKPOINT ID'S INTRODUCED BY APARS PQ48495
  AND PQ51736.
  ITEM #3: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS.
  DESCRIPTION: THE SPECIAL RESTART OPTIONS CTX DATASET IS NOT
  BEING DELETED IF THE APPLICATION DOES NOT ISSUE ANY CHKP CALLS.
  ITEM #4: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS
  INSTALLING THE SAMPLE USERMODS TO THEIR IMS V7 SYSTEMS.
  DESCRIPTION: MEMBER IRTUM71D, IN THE IRTSAMP LIBRARY, IS
  MISSING A '++MAC(IRTXZSR) DISTLIB(ADFSMAC).' STATEMENT AFTER
  THE FIRST MEND STATEMENT JUST BEFORE THE MACRO AND IRTXZSR
  STATEMENTS.
  RECOMMENDATION: INSTALL THIS CORRECTIVE MAINTENANCE.
  ITEM #5: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS
  WHO HAVE APPLICATIONS THAT ONLY INITIALIZE THE FIRST THREE
  BYTES OF THE XRST CHECKPOINT ID I/O AREA TO SPACES BEFORE
  ISSUING THE INITIAL XRST CALL.
  DESCRIPTION: APPLICATIONS ONLY INITIALIZING THE FIRST THREE
  BYTES OF THE XRST CHECKPOINT ID I/O AREA BEFORE THE INITIAL
  XRST CALL ARE ABENDING WITH A U0102 ABEND CODE. WHILE THE
  CURRENT IMS DOCUMENTATION STATES THAT THE I/O AREA MUST BE
  INITIALIZED TO SPACES, (UP TO 30 BYTES DEPENDING ON THE
  REFERENCE), THE ACTUAL BASE IMS CODE HAS ONLY BEEN CHECKING
  THE FIRST THREE BYTES FOR SPACES. THE MAINTENANCE FOR THIS APAR
  WILL ALLOW PROGRAM RESTART TO MAINTAIN COMPATIBILITY WITH THE
  ACTUAL BASE IMS CODE.
  ITEM #6: USERS AFFECTED: ALL PROGRAM RESTART FACILITY USERS.
  DESCRIPTION: JCLIN TO INSTALL MODULES IRTXIOA0 AND IRTURRC0 IS
  MISSING, CAUSING MESSAGE GIM43401W TO BE DISPLAYED DURING APPLY
  PROCESSING FOR UQ64349.
  

Problem conclusion

• THE PROGRAM RESTART FACILITY CODE HAS BEEN MODIFIED TO
  ADDRESS ALL ISSUES AND PROBLEMS.
  

Temporary fix

Comments

• ×**** PE02/07/17 FIX IN ERROR. SEE APAR PQ62340  FOR DESCRIPTION
  

APAR Information

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

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

  UQ66680

Modules/Macros

•    H23D210J IRT#CPID IRT#IGNR IRT#INCL IRTAINCL
  IRTALLOC IRTAOPT0 IRTAUSRL IRTDDA10 IRTDSL10 IRTHKIB0 IRTINCD0
  IRTIVACB IRTIVBMP IRTIVDBD IRTIVDLI IRTIVINI IRTIVOLC IRTIVPG1
  IRTIVPSB IRTIVS1M IRTIXT05 IRTIXT06 IRTIXT07 IRTIXT08 IRTJCLIN
  IRTML99  IRTMTB05 IRTMTB06 IRTMTB07 IRTMTB08 IRTPDLTC IRTPHELP
  IRTPH100 IRTPH200 IRTPH210 IRTPH211 IRTPH212 IRTPH213 IRTPH214
  IRTPH215 IRTPH216 IRTPH300 IRTPJOBS IRTPOS05 IRTPOS06 IRTPOS07
  IRTPOS08 IRTPPRIM IRTPRE00 IRTPUOPS IRTRCLST IRTRCZAP IRTRFE05
  IRTRFE06 IRTRFE07 IRTRFE08 IRTSA51A IRTSA51B IRTSA51D IRTSA61A
  IRTSA61B IRTSA61D IRTSA71A IRTSA71B IRTSA71D IRTSR51A IRTSR51B
  IRTSR51D IRTSR61A IRTSR61B IRTSR61D IRTSR71A IRTSR71B IRTSR71D
  IRTUM51A IRTUM51B IRTUM51C IRTUM51D IRTUM51F IRTUM61A IRTUM61B
  IRTUM61C IRTUM61D IRTUM61F IRTUM61Z IRTUM71A IRTUM71B IRTUM71C
  IRTUM71D IRTUM81A IRTUM81B IRTUM81C IRTUM81D IRTUPX00 IRTURRC0
  IRTWMSG0 IRTXIOA0 IRTXISPF IRTXRI05 IRTXRI06 IRTXRI07 IRTXRI08
  IRTXRST0 IRTXSC05 IRTXSC06 IRTXSC07 IRTXSC08 IRTXSORT IRTXZSC
  IRTXZSR  IRTZSC05 IRTZSC06 IRTZSC07 IRTZSC08 IRTZSR05 IRTZSR06
  IRTZSR07 IRTZSR08 IRT1PROF IRT5ACB  IRT5OLCA IRT6ACB  IRT6OLCA
  IRT7ACB  IRT7OLCA IRT9AJBS IRT9EINC IRT9VINC
  

Fix information

• Fixed component name

  IMS PGM RESTART

• Fixed component ID

  5655E1400

Applicable component levels

• R210 PSY UQ66680

     UP02/05/30 P F205 a

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.