IBM Support

Updates to IMS Program Restart Facility 2.2 User's Guide and Reference (SC19-3985-05)

Release Notes


Abstract

Updates to IMS Program Restart Facility 2.2 User's Guide and Reference (SC19-3985-05)

Content

The most recent updates appear at the top of the list.

 

Update 1
Date of change: January 2022
Change description: Documentation changes for APAR PH39952. In this enhancement, IMS Program Restart Facility provides a new option that enables you to provide a checkpoint ID by using the CKPTID parameter in the JCL EXEC statement even when there are no CTDS data sets.

Topics: Changes apply to multiple topics.

--------------------------------
Topic: Product options reference > IMS PROC override options reference

The description of the CKPTID parameter has been changed as follows:

CKPTID=NOMSGS | NOMSG540 | NOMSG681 | NOMSG542 | NO681542

Start of changeThe CKPTID option allows you to override the specification of message suppression that is specified by the CKPTID IMS parameter in the JCL of the job. End of change
In the global or job override options, you can specify one of the following values for the CKPTID
option:

...


--------------------------------
Topic: Restarting abended IMS batch jobs > Resolving restart abends caused by indoubt checkpoints

The fourth bullet has been added to the Procedure section, as follows:

Resolving restart abends caused by indoubt checkpoints

A restart of an abended IMS batch job abends if the last checkpoint ID that was supplied by IMS Program Restart Facility is indoubt. If such an abend occurs, determine the correct checkpoint ID and restart option for the job.

Procedure

If a restart of an abended job abends with a PRF U3625 or an IMS U0102 completion code, review the IMS logs and message DFS682I. With this information, select one of these actions:

  • If the restart checkpoint ID that is displayed in message DFS682I matches the checkpoint ID that is displayed in message IRT010W, restart the job by using the last indoubt checkpoint ID:
    ...
  • If the restart checkpoint ID that is displayed in message DFS682I matches the checkpoint ID that is displayed in message IRT017I, restart the job by using the last verified checkpoint ID:
    ...
  • If the job must be restarted from the beginning, restart the job by doing these steps:
    ...
  • Start of changeAlternatively, you can specify USEJCLID=YES and a checkpoint ID that is optimal for the job restart by using the CKPTID parameter in the JCL EXEC statement. To restart a job by using the USEJCLID option, you must make available the log data set that contains the corresponding checkpoint log by specifying an IMSLOGR DD statement. End of change
--------------------------------
Topic: Product options reference > General options reference

The description of IGNXIOA=NO has been changed, and a new option named USEJCLID has been added, as follows:
 

IGNXIOA=YES | NO

Specify one of the following values for this option:

YES

IMS Program Restart Facility ignores data that is provided by the application program in the IOAREA of an XRST call.

NO

If there are no CTA and CTB data sets for the job, IMS Program Restart Facility obtains the restart checkpoint ID from the information that is specified in the IOAREA of an XRST call, if the area is non-blank. In this scenario, you must include a log file in the job, using the //IMSLOGR DD statement, that contains the checkpoint ID.

Start of changeNote: IGNXIOA is ignored if there are CTA and CTB data sets for the job, or if USEJCLID=YES and a checkpoint ID are specified through the PARM field. End of change

Default value is NO.

...
 

Start of changeUSEJCLID=NO | YES

Specify whether you want IMS Program Restart Facility to use the restart checkpoint ID specified by the CKPTID parameter value in the JCL EXEC statement. Select one of the following values for this option:
NO

IMS Program Restart Facility ignores the CKPTID parameter in the JCL EXEC statement. The restart checkpoint ID that is supplied by the IMS Program Restart Facility, if any, will be used.
YES
IMS Program Restart Facility overrides the restart checkpoint ID with the value specified by the CKPTID parameter in the JCL EXEC statement. To restart a job from a user-specified checkpoint, you must make available the log data set that contains the corresponding checkpoint log by specifying the IMSLOGR DD statement. 
If IMS cannot find the corresponding checkpoint log, the restart job will end abnormally with an IMS U0102 completion code.
If no CKPTID parameter is found in the JCL EXEC statement, this option is ignored. 

 

Default value is NO.
End of change

--------------------------------
Topic: Troubleshooting > Runtime messages (IRT) > IRT038W
The suffix of message IRT038 has been corrected (from IRT038W to IRT038I), and its user response has been changed, as follows:
---
Start of changeIRT038I JCL SPECIFIED CKPTID=xxxxxxxx End of change
Explanation
A value for a symbolic checkpoint ID was specified in the JCL for the job being run.
System action
The job uses this checkpoint ID for any IMS Extended Restart processing.
User response
Start of changeThis message is informational; it reminds you to remove this checkpoint ID from the JCL before the next job run to avoid future U0102 abends. End of change
--------------------------------
Topic: Troubleshooting > Runtime messages (IRT) > IRT054I
The explanation and the programmer response of message IRT054I have been changed, as follows:
IRT054I XRST CKPTID=value
Explanation
Start of changeFor some reason, a checkpoint ID that is different from the last verified checkpoint recognized by IMS Program Restart Facility has been selected as the restart checkpoint ID. The checkpoint ID shown in this message will be used for this restart. End of change
System action
The job continues processing.
Programmer response
Start of changeNone. This message is informational. End of change
--------------------------------
Topic: Troubleshooting > ISPF messages (IRTA, IRTB, IRTC)
A new message, IRTC121E, has been added:
Start of change
IRTC121E USEJCLID Option Invalid
Long message
The specified USEJCLID value is not valid. The value must be specified as either YES or NO.
System action
None.
User response
Enter a valid value for the USEJCLID option.

End of change
 

[{"Type":"MASTER","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"},"ARM Category":[{"code":"a8m0z000000cvZOAAY","label":"IMS Program Restart Facility for z\/OS"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"2.2.0"}]

Document Information

Modified date:
16 March 2022

UID

ibm16550436