Updates to IMS DEDB Fast Recovery V2.2 User's Guide and Reference

Product documentation


Abstract

Updates that apply to IMS DEDB Fast Recovery V2.2 User's Guide and Reference (SC27-0928-04)

Content

The most recent update is listed first.



Update 13
Date of change: December 2014
Change description: Documentation changes by APAR PI27426. This APAR adds support for IMS Version 14.
Topics: Changes apply to the following multiple topics.

------------------
> 1.0 IMS DEDB Fast Recovery overview
>> 1.5 Hardware and software prerequisites

IMS Version 14 has been added to the following list:

Software requirements

The following programs or subsequent releases are required for installing IMS DEDB Fast Recovery:
  • IMS environment
    One of the following currently supported programs is required:
  • ...
  • Start of changeIMS Version 14 Release 1 (5635-A05)End of change

------------------
>> 1.6 Processing environment limitations

The following limitation has been added:

Start of changeIMS DEDB Fast Recovery does not support the dynamic database definition enhancements, including the capability to load application control blocks from the IMS catalog. These IMS enhancements are included in IMS Version 14. End of change

==================
> 6.0 Recovered CI Print program

Description has been updated as follows:

...
Start of changeThis program is available when the IMS DEDB Fast Recovery job was run in an IMS environment with any IMS version from 9 to 14. End of change
...



Update 12
Date of change: October 2014
Change description: Documentation changes by APAR PM83356. This APAR enhances IMS DEDB Fast Recovery to support the IMS catalog for IMS Version 12 Release 1 and IMS Version 13 Release 1.
Topics: The changes apply to the following multiple topics.

> 4.0 Input and output in an IMS V10 or later environment
>> 4.3 Output in an IMS V10 or later environment
>>> 4.3.1 Backout Required PSB list in an IMS V10 or later environment

Description of the DATABASE field has been updated as follows:

DATABASE
    Start of changeThe DL/I databases (DBD name or HALDB partition name) that will be recovered when you run the Batch Backout utility. End of change
------------------
> 4.0 Input and output in an IMS V10 or later environment
>> 4.3 Output in an IMS V10 or later environment
>>> 4.3.2 Database Status list in an IMS V10 or later environment

Description of the DBD NAME field has been updated as follows:

DBD NAME
    Start of changeThe database name (DBD name, HALDB master name, or HALDB partition name). End of change

==================
> 8.0 Troubleshooting
>> 8.4 Messages

The Explanation section of the following messages has been changed as follows:

DFR3523E IDTEEQE COULD NOT BE DELETED. DL/I DBDNAME= dbd-name

Explanation: Start of changeThe EEQE of the indicated DEDB area or DL/I database (DBD name or HALDB partition name) could not be deleted from the DBRC RECON data set for one of the following reasons: End of change
  • A DBRC call error has occurred.
  • The IMS system that failed was not authorized by DBRC to use the indicated DEDB area or DL/I database.
  • An in-doubt EEQE cannot be deleted, because IMS DEDB Fast Recovery invalidates the in-doubt transaction that changes a DL/I database.
...



Update 11
Date of change: October 2014
Change description: User's guide correction.
Topic:
> 2.0 Program functions of IMS DEDB Fast Recovery
>> 2.5 Checkpoint determination

Checkpoint determination
IMS DEDB Fast Recovery determines the recovery start checkpoint from the checkpoint ID table that is created during the OLDS processing.

If no DL/I database is defined for the IMS to be recovered, or if LCHKPT=Y is specified, IMS DEDB Fast Recovery uses the Fast Path checkpoint identifier (BCPFCKID) as the recovery start checkpoint. If DL/I databases are defined for the IMS to be recovered and LCHKPT=N is specified, IMS DEDB Fast Recovery uses the oldest of the following identifiers as the recovery start checkpoint:
  • Start of change DC checkpoint identifier (BCPLDCID) End of change
  • Start of changeBMP checkpoint identifier (BCPBMPID)End of change
  • LCRE checkpoint identifier (BCPLCKID)
  • Fast Path checkpoint identifier (BCPFCKID)
...



Update 10
Date of change: January 2013
Change description: Documentation changes by APAR PM75251. This APAR adds IMS Version 13 support.
Topics: The changes apply to the following topics:

> 1.0 IMS DEDB Fast Recovery overview
>> 1.5 Hardware and software prerequisites

IMS Version 13 has been added to the following list:

Software requirements

The following programs or subsequent releases are required for installing IMS DEDB Fast Recovery:
  • IMS environment
    One of the following currently supported programs is required:
    • IMS Version 9 Release 1 (5655-J38)
    • IMS Version 10 Release 1 (5635-A01)
    • IMS Version 11 Release 1 (5635-A02)
    • IMS Version 12 Release 1 (5635-A03)
    • Start of changeIMS Version 13 Release 1 (5635-A04)End of change

------------------
>> 1.6 Processing environment limitations

The following limitation has been added:

Start of changeIMS DEDB Fast Recovery does not support the DEDB alter function, which is supported by IMS Version 13 Release 1. End of change

==================
> 4.0 Input and output in an IMS V10 or later
>> 4.2 Input in an IMS V10 or later environment
>>> 4.2.1 JCL requirements in an IMS V10 or later environment

The following description has been updated:

MINVERS=8.1|9.1|10.1 (for IMS V10)
MINVERS=9.1|10.1|11.1 (for IMS V11)
    Specifies the same value as the minimum version of IMS that can sign on to DBRC (also referred to as MINVERS) that is in the DBRC RECON data sets of IMS system that is to be recovered. Start of changeThis parameter cannot be specified in IMS V12 or later. If MINVERS=10.1 or 11.1 is specified, or if IMS DEDB Fast Recovery is run in an IMS V12 environment or in a higher environment, the following time is in microsecond precision: End of change
    • The "UOR TIME(OFFSET)" in Backout Required PSB list
    • The "1ST BLK TIME" in OLDS Sort list
    • The "UORTIME" of DBRC commands to create backout records
    ...

==================
> 6.0 Recovered CI Print program

The following description has been updated:

Start of changeThis program is available for IMS DEDB Fast Recovery when it is run in an IMS Version 9, IMS Version 10, IMS Version 11, IMS Version 12, or in an IMS Version 13 environment. End of change




Update 9
Date of change: January 2013
Change description: Documentation changes by APAR PM46954.
Topic:
> 8.0 Troubleshooting
>> 8.4 Messages

The Explanation section of the following messages has been updated:
  • DFR3100E xxxxxxxxxxx ERROR IN WADS DDNAME=ddname
  • DFR3100E xxxxxxxxxxx ERROR IN WADS PROCESSING

Explanation:
...
    Type
      Meaning
    OPEN
      ...
    READ
      ...
    DEVICE TYPE
      The specified WADS does not exist on the DASD. Start of changeThis type applies only to IMS Version 11 or earlier. End of change
    SEQUENCE #
      ...
    CLOSE
      ...
    VERIFY
      ...
    TRKCALC
      ...
    Start of changeMISSING RCD
      A sequence of WADS records has fewer records than it should. This type applies only to IMS Version 12 or later. End of change




Update 8
Date of change: January 2013
Change description: User's Guide updates.
Topics: The changes apply to the following topics:

> 1.0 IMS DEDB Fast Recovery overview
>> 1.6 Processing environment limitations

The following limitation has been added:

Start of changeTo use dynamic allocation parameter lists that are registered by the DFSMDA macro of IMS V5 or earlier, you must rebuild the lists by using the DFSMDA macro of IMS V6 or later. The minimum level of IMS supported by IMS DEDB Fast Recovery Version 2 Release 2 is IMS Version 6 Release 1. End of change

==================
Description of the OPT column has been updated in the following two topics:
>>> 3.3.5 DEDB Area Status list in an IMS V9 environment
>>> 4.3.5 DEDB Area Status list in an IMS V10 or later environment

Field descriptions
...
Start of changeThe OPT column shows the following VSO options (VSO and PRELOAD) and the PREOPEN option for the area used by IMS: End of change
    V
      The area was a VSO area when IMS failed.
    O
      The area was preopened when IMS failed.
    L
      The area was preloaded when IMS failed. L always appears with both V and O, because the preloaded area must be a preopened VSO area.

------------------
Description of the OPT column has been updated in the following two topics:
>>> 3.3.8 Recovered CI Summary list in an IMS V9 environment
>>> 4.3.8 Recovered CI Summary list in an IMS V10 or later environment

Field descriptions

OPT
    Start of changeThis column gives the VSO options (VSO and PRELOAD) and the PREOPEN option for the area used by IMS. The meanings of the indicators are the same as for a DEDB Area Status list. End of change ...




Update 7
Date of change: June 2011
Change description: User's Guide corrections and updates.
Topics: The changes apply to the following topics.

> 8.0 Troubleshooting
>> 8.4 Messages

The length of the variable that is used in the following message has been changed as follows:

DFR3615W DISCONNECT Start of change vvvvvvvv vvvvvvvvvvvvv FAILED FOR STRUCTURE str-name. RETCODE=ret-code, RSNCODE=rsn-code. End of change

Explanation: ... Start of change Vvvvvvvv vvvvvvvvvvvvv indicates the type of macro as follows: End of change

Start of change vvvvvvvv vvvvvvvvvvvvv End of change
The type of macro and parameter
...
...
==================
> 4.0 Input and output in an IMS V10 or later environment
>> 4.2 Input in an IMS V10 or later environment
>>> 4.2.1 JCL requirements in an IMS V10 or later environment

IMSLOGR DD
IMSLOGR2 DD
ssssssss DD
    ...
    The following description, which was added by APAR PM28790, has been changed as follows:

    The SLDS defined as a large format data set can be specified.

    Start of changeThe SLDS defined as a DFSMS striped extended-format data set can be specified when IMS DEDB Fast Recovery is run on IMS Version 12. End of change



Update 6
Date of change: June 2011
Change description: Documentation change by APAR PM41667. This APAR corrects a problem that might happen when you use IMS DEDB Fast Recovery in an IMS V12 environment.
Topic:
>8.0 Troubleshooting
>> 8.4 Messages

Descriptions for the following message has been changed:

DFR3540E OLDS (SUFFIX=nn) WAS ACTIVE AT IMS FAILURE, BUT UNAVAILABLE IN DSWK

Explanation: ...
Start of changeIt is possible that the OLDSs were not specified in the DD statements or for dynamic allocation, or that errors occurred in the specified OLDSs. End of change
System action: ...
User Response: Start of changeDetermine if all OLDSs that were in use by IMS are correctly specified. See the OLDS Sort list to correct the error and rerun the job. If IMS DEDB Fast Recovery cannot read the OLDS because of an allocation error, an open error, a read error, or the presence of an invalid block, recover it with the Log Recovery utility as needed. Then rerun the job with DBRC=N and AUTO=N. End of change



Update 5
Date of change: June 2011
Change description: Documentation change by APAR PM41329. This APAR provides support the OLDS and WADS that are allocated in the extended addressing space (EAS) of an extended address volume (EAV), which is supported by IMS Version 12 Release 1.
Topic:
> 4.0 Input and output in an IMS V10 or later environment
>> 4.2 Input in an IMS V10 or later environment
>>> 4.2.1 JCL requirements in an IMS V10 or later environment

DFSWADS n DD
    Specifies the write-ahead data sets (WADSs) (where n is 0 - 9). You can specify all WADSs used during IMS online execution, but you must include the WADS that was in use when IMS failed. To avoid executing IMS DEDB Fast Recovery against the active IMS system, you must specify DISP=OLD in the DD statement.

    The WADS defined as a large format data set can be specified.

    The following paragraph is added:
    Start of changeThe WADS that is allocated in the extended addressing space (EAS) of an extended address volume (EAV) can be specified when IMS DEDB Fast Recovery is run on IMS Version 12 and z/OS Version 1 Release 12 or later is used. End of change

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

DFSOLPnn DD
DFSOLSnn DD
    Specifies the online log data sets (OLDSs) that IMS DEDB Fast Recovery is to read to determine the recovery start checkpoint. nn is 00 - 99. DFSOLPnn indicates the primary OLDS, and DFSOLSnn indicates the secondary OLDS. The OLDS ddnames are the same as the ddnames used at IMS online execution.

    The OLDS defined as a large format data set can be specified.

    The following paragraph, which was added by APAR PM28790, has been changed as follows:

    Start of changeThe OLDS defined as a DFSMS striped extended-format data set can be specified when IMS DEDB Fast Recovery is run on IMS Version 12. The OLDS that is allocated in the extended addressing space (EAS) of an extended address volume (EAV) can be specified when IMS DEDB Fast Recovery is run on IMS Version 12 and z/OS Version 1 Release 12 or later is used. End of change

...



Update 4
Date of change: June 2011
Change description: Documentation change by APAR PM40201. This APAR corrects several problems that might happen when you use IMS DEDB Fast Recovery in IMS Version 12.
Topic:
> 8.0 Troubleshooting
>> 8.4 Messages

Descriptions for the following messages have been changed:

DFR3100E xxxxxxxxxxx ERROR IN WADS DDNAME=ddname
DFR3100E xxxxxxxxxxx ERROR IN WADS PROCESSING

Explanation: ...
System action: Start of changeIf the error occurred on a dual WADS, the job continues by using the alternate data set. If errors occurred in both WADSs, or the mode is a single WADS, the job ends with an abend code of U3100. End of change
User Response: Start of changeIf the job has abnormally ended, check whether DD statement for WADS is specified correctly. End of change If there is any error, correct it and rerun the job. If there is no error in the DD statement, contact IBM Software Support.



Update 3
Date of change: January 2011
Change description: Documentation changes by APAR PM28790. This APAR adds support for DFSMS striped extended-format data sets.
Topics: The changes apply to the following topics.

> 1.0 IMS DEDB Fast Recovery overview
>> 1.6 Processing environment limitations

The following limitation, which has been added by APAR PM22078, has been deleted:

DFSMS striped extended-format data sets are supported by IMS Version 12 Release 1, however, IMS DEDB Fast Recovery does not support IMS log data sets as DFSMS striped extended-format data sets.

==================
> 4.0 Input and output in an IMS V10 or later environment
>> 4.2 Input in an IMS V10 or later environment
>>> 4.2.1 JCL requirements in an IMS V10 or later environment

The following descriptions have been added:
:
DFSOLPnn DD
DFSOLSnn DD
    ...
    The OLDS defined as a large format data set can be specified. Start of changeThe OLDS defined as a DFSMS striped extended-format data set can be specified. End of change
    ...

IMSLOGR DD
IMSLOGR2 DD
ssssssss DD
    ...
    The SLDS defined as a large format data set can be specified. Start of changeThe SLDS defined as a DFSMS striped extended-format data set can be specified. End of change
    ...

==================
> 8.0 Troubleshooting
>> 8.4 Messages

The following message has been added:
Start of change
DFR3109E xxxxxxxxxxx ERROR IN OLDS DDNAME=ddname

Explanation: An attempt to calculate the amount of space for the OLDS of the indicated DD name (ddname), which was in use when IMS failed, has resulted in error. xxxxxxxxxxx shows the type of the error.

Type Meaning
DEVTYPE
    MVS DEVTYPE macro has returned an error code.
ISITMGD
    MVS ISITMGD macro has returned an error code.
TRKCALC
    MVS TRKCALC macro has returned an error code.
OBTAIN
    MVS OBTAIN macro has returned an error code.
ZERO BLOCKS
    MVS TRKCALC macro has returned zero for the number of blocks per track.
ZERO TRACKS
    The number of calculated tracks is zero.
System action: The job ends with an abend code of U3109.
User response: Check if the DD statement for OLDS is specified correctly. If there is any error, correct it and rerun the job. If there is no error in the DD statement, contact IBM Software Support.
End of change


Update 2
Date of change: January 2011
Change description: Documentation changes by APAR PM22078. This APAR adds IMS Version 12 support.
Topics: The changes apply to the following topics.

> 1.0 IMS DEDB Fast Recovery overview
>> 1.5 Hardware and software prerequisites

IMS Version 12 has been added to the following list:

Software requirements

The following programs or subsequent releases are required for installing IMS DEDB Fast Recovery:
  • IMS environment
    One of the following currently supported programs is required:
    • IMS Version 9 Release 1 (5655-J38)
    • IMS Version 10 Release 1 (5635-A01)
    • IMS Version 11 Release 1 (5635-A02)
    • Start of changeIMS Version 12 Release 1 (5635-A03)End of change

------------------
>> 1.6 Processing environment limitations

The following limitation has been added:

Start of changeDFSMS striped extended-format data sets are supported by IMS Version 12 Release 1, however, IMS DEDB Fast Recovery does not support IMS log data sets as DFSMS striped extended-format data sets. End of change

==================
> 4.0 Input and output in an IMS V10 or later
>> 4.2 Input in an IMS V10 or later environment
>>> 4.2.1 JCL requirements in an IMS V10 or later environment

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

MINVERS=8.1|9.1|10.1 ( for IMS V10 )
MINVERS=9.1|10.1|11.1 ( for IMS V11 )
    Specifies the same value as the minimum version of IMS that can sign on to DBRC (also referred to as MINVERS) that is in the DBRC RECON data sets of IMS system that is to be recovered.
    Start of changeThis parameter cannot be specified in IMS V12. If MINVERS=10.1 or 11.1 is specified, or when IMS DEDB Fast Recovery is run in IMS V12, the following time is in microsecond precision: End of change
    • The "UOR TIME(OFFSET)" in Backout Required PSB list
    • The "1ST BLK TIME" in OLDS Sort list
    • The "UORTIME" of DBRC commands to create backout records

    Start of changeThis parameter is valid only when DBRC=N is specified in IMS V10 or V11. If DBRC=Y is specified, or if the DBRC= parameter is omitted, this parameter will be ignored. End of change
    ...

==================
> 6.0 Recovered CI Print program

The description has been changed as follows:

...
Start of changeThis program is available for IMS DEDB Fast Recovery when it is run in an IMS Version 9, IMS Version 10, IMS Version 11, or in an IMS Version 12 environment. End of change

==================
> 8.0 Troubleshooting
>> 8.4 Messages

Descriptions for the following messages have been changed:

DFR3100E xxxxxxxxxxx ERROR IN WADS DDNAME=ddname
DFR3100E xxxxxxxxxxx ERROR IN WADS PROCESSING

Explanation: ...
Type Meaning
OPEN
    ...
READ
    ...
DEVICE TYPE
    ...
SEQUENCE #
    ...
CLOSE
    WADS close error.
    Start of changeThis type applies only to IMS Version 11 or earlier. End of change
Start of changeVERIFY
    An error occurred while verifying a format of WADS.
    This type applies only to IMS Version 12. End of change
TRKCALC
    ...

------------------
DFR3114E DYNAMIC ALLOCATION ERROR WADS DDNAME=.. DSN=..
DFR3114E DYNAMIC ALLOCATION ERROR OLDS DDNAME=.. DSN=..
DFR3114E DYNAMIC ALLOCATION ERROR SLDS DSNAME=..
(DFR3114E) ERROR REASON CODE=nnnn
DFR3114E DYNALLOC REQUEST BLOCK LOAD FAIL. MEMBER NAME=..

Explanation: ...
Start of changeIf IMS DEDB Fast Recovery is running in IMS Version 11 or later, and an SLDS is indicated with 'DSNAME=**** COMPRESSED DATA SET ****', the information about SLDSs that is required for recovery might have been compressed by a CLEANUP.RECON command. End of change
System action: ...
User response: ...
Start of changeIf IMS DEDB Fast Recovery is running in IMS Version 11 or later, and the information about SLDSs that is required for recovery has been compressed by a CLEANUP.RECON command, add a DD statement for SLDSs and rerun the job with DBRC=N. End of change




Update 1
Date of change: January 2011
Change description: User guide corrections.
Topics: The changes apply to the following topics.

> 2.0 Program functions of IMS DEDB Fast Recovery
>> 2.1 Program structure and data flow in an IMS V9 environment
>> 2.2 Program structure and data flow in an IMS V10 or later environment

In the following figures, "Redo buffer" has been changed to "DEDB buffer":
  • Figure: Functional structure, control flow, and data flow (IMS V9) (Figure 1 in PDF and BookManager formats)
  • Figure: Functional structure, control flow, and data flow (IMS V10 or later) ( Figure 2 in PDF and BookManager formats)

Publication number

SC27-0928-04

Copyright date

2000, 2010

Original publication date

2011/1/7

Rate this page:

(0 users)Average rating

Document information


More support for:

IMS Tools
IMS DEDB Fast Recovery

Software version:

2.2.0

Operating system(s):

z/OS

Reference #:

7020655

Modified date:

2011-01-11

Translate my page

Machine Translation

Content navigation