IBM Support

Updates to IBM IMS Recovery Solution Pack for z/OS 2.1 - IMS Database Recovery Facility User's Guide and Reference (SC27-8441-02)

Release Notes


Abstract

Updates to IBM IMS Recovery Solution Pack for z/OS 2.1 - IMS Database Recovery Facility User's Guide and Reference (SC27-8441-02)

Content

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

Update 4
Date of change: May 2021
Change description: Documentation change by APAR PH34679
Topic: Troubleshooting > Runtime messages (FRD)
System action of message FRD3001I has been modified and user response has been deleted as follows:

FRD3001I UNEXPECTED RETURN CODE FROM SORT, RC=return code

Explanation: The SORT program ended with an unexpected RC. See the prior SORT messages for more information. In the message text the following value applies:

return code

Represents the return code received from the SORT program. See the appropriate SORT program documentation for an explanation of the return code.

start of changeSystem action: Recovery processing by this subordinate address space is stopped. If the ERRORCONT parameter was not specified on the START command, the entire recovery process stops. If this message is followed by the U0385-17 abend, then save the job documentation and call IBM Software Support for assistance. 

User response: Determine the cause of the failure and rerun recovery for the entries that did not complete recovery. end of change

Module: FRXLSRT1


Update 3
Date of change: March 2021
Change description: Documentation change for a new message
Topic: Troubleshooting > Runtime messages (FRD)

The following new message has been added:

start of change

FRD4311E THE DATA SET OR AREA CANNOT BE RECOVERED BECAUSE IT WAS NOT RESTORED

Explanation: The data set is empty, even though the USEDBDS, USEAREA, USEUICLAST, or USEUICTIME option was specified. 

System action: Recovery stops.

User response: Restore the data set in advance and rerun the recovery with the USEDBDS, USEAREA, USEUICLAST, or USEUICTIME option.

Module: FRXIOSM0,FRXIVSM0

end of change

Update 2
Date of change: March 2021
Change description: Documentation changes by APAR PH34542
Topics: Changes apply to multiple topics.

------------------------------

Topic: Configuring IMS Database Recovery Facility > Configuring the product environment > Environmental control statements
"Note" for ICNOTIFY(HPIC | DRF) parameter has been modified as follows:
Reference: Environmental control statements

...

ICNOTIFY(HPIC | DRF)

...

Note: 

ICNOTIFY(DRF) and ICNDX(Y) are mutually exclusive.

start of changeICNOTIFY(DRF) is valid only when the OUTOUT option is PRO or BOTH. If ICNOTIFY(DRF) is specified with an OUTPUT option other than PRO or BOTH, ICNOTIFY(DRF) is overridden with ICNOTIFY(HPIC).end of change

------------------------------

Topic: Troubleshooting > Runtime messages (FRD)
A new reason for message FRD6124A has been added after 'NOT SUPPORTED WITH INCREMENTAL IC TYPE':

FRD6124A INVALID DATA ENCOUNTERED. KEYWORD: keyword RSN=rsn

Explanation: The data associated with the indicated keyword was not valid.

...

rsn

...

NOT SUPPORTED WITH INCREMENTAL IC TYPE

...

start of changeICNOTIFY(DRF) IS IGNORED WHEN OUTPUT(DUP|ICR|ICRCA) IS SPECIFIED

ICNOTIFY(DRF) is specified with an OUTPUT option other than PRO or BOTH.
ICNOTIFY(DRF) is overridden with ICNOTIFY(HPIC).end of change

TWO CHARACTER VALUE IS REQUIRED

...

System action: 

start of changeProcessing continues for the following reasons:

USESLBIC(Y) IS IGNORED WHEN USEDBDS OR USEAREA IS SPECIFIED

USESLBIC(Y) IS IGNORED WHEN USEUICLAST OR USEUICTIME IS SPECIFIED

ICNOTIFY(DRF) IS IGNORED WHEN OUTPUT(DUP|ICR|ICRCA) IS SPECIFIED

Recovery stops for other reasons.end of change

User response: 

start of changeNone required for the following reasons. However, it is suggested that the parameters be changed to allowed combinations.

USESLBIC(Y) IS IGNORED WHEN USEDBDS OR USEAREA IS SPECIFIED

USESLBIC(Y) IS IGNORED WHEN USEUICLAST OR USEUICTIME IS SPECIFIED

ICNOTIFY(DRF) IS IGNORED WHEN OUTPUT(DUP|ICR|ICRCA) IS SPECIFIED

For other reasons, correct the format of the data and resubmit the recovery.end of change


Update 1
Date of change: February 2021
Change description: Documentation changes by APAR PH33542
Topic: Troubleshooting > Runtime messages (FRD)

Explanation and user response for the reason "IMAGE COPY ALREADY TAKEN" of message FRD6022A have been modified as follows:

FRD6022A UNABLE TO RECOVER: dbname, reason

Explanation: A RECOVER START command was issued, but the database data set or area cannot be recovered. This message is sent to the issuer of the command.

...

reason

...

IMAGE COPY ALREADY TAKEN

start of changeThe OUTPUT(ICR) option was specified, and the IMS Database Recovery Facility tried to create an incremental image copy as a concurrent image copy. However, the last incremental image copy was the concurrent image copy and there were no log data sets (SLDS) to apply thereafter. Therefore, no new incremental image copy was created. end of change

...

User response: Take the appropriate action based on the specified reason:

...

IMAGE COPY ALREADY TAKEN

start of changeIn order to create a new incremental image copy, archive the log data set containing the update log records. Otherwise, no action is required.end of change

...

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU054","label":"Systems w/TPS"},"Product":{"code":"SSS8TR","label":"IMS Recovery Solution Pack for z/OS"},"ARM Category":[{"code":"a8m0z000000cvZPAAY","label":"IMS Recovery Solution Pack for z/OS"}],"Platform":[{"code":"PF035","label":"z/OS"}],"Version":"2.1.0"}]

Document Information

Modified date:
25 May 2021

UID

ibm16411209