A fix is available
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 number
PQ60462
Reported component name
IMS PGM RESTART
Reported component ID
5655E1400
Reported release
210
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2002-04-24
Closed date
2002-05-28
Last modified date
2002-07-17
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.
[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSAVHR","label":"IMS Program Restart Facility for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0"}]
Document Information
Modified date:
24 January 2022