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 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)
    • IMS Version 13 Release 1 (5635-A04)

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

The following limitation has been added:

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

==================
> 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. This 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:
    • 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:

This 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.




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. This type applies only to IMS Version 11 or earlier.
    SEQUENCE #
      ...
    CLOSE
      ...
    VERIFY
      ...
    TRKCALC
      ...
    MISSING RCD
      A sequence of WADS records has fewer records than it should. This type applies only to IMS Version 12 or later.




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:

To 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.

==================
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
...
The OPT column shows the following VSO options (VSO and PRELOAD) and the PREOPEN option for the area used by IMS:
    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
    This 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. ...




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 vvvvvvvv vvvvvvvvvvvvv FAILED FOR STRUCTURE str-name. RETCODE=ret-code, RSNCODE=rsn-code.

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

vvvvvvvv vvvvvvvvvvvvv
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.

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



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: ...
It is possible that the OLDSs were not specified in the DD statements or for dynamic allocation, or that errors occurred in the specified OLDSs.
System action: ...
User Response: Determine 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.



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:
    The 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.

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

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:
    The 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.

...



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: If 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.
User Response: If the job has abnormally ended, check whether DD statement for WADS 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.



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. The OLDS defined as a DFSMS striped extended-format data set can be specified.
    ...

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

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

The following message has been added:

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.



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)
    • IMS Version 12 Release 1 (5635-A03)

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

The following limitation has been added:

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
>> 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.
    This 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:
    • 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

    This 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.
    ...

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

The description has been changed as follows:

...
This 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.

==================
> 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.
    This type applies only to IMS Version 11 or earlier.
VERIFY
    An error occurred while verifying a format of WADS.
    This type applies only to IMS Version 12.
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: ...
If 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.
System action: ...
User response: ...
If 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.




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

Add comments

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