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-01)

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-01)

Content

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


Update 3
Date of change: July 2020
Change description: Documentation changes by APAR PH26679.
Topic: Configuring IMS Database Recovery Facility > Configuring the product environment > Environmental control statements

The range and default value of the READNUM(nn,tn) parameter have been changed as follows: 

...

READNUM(nn,tn)

Tip: If possible, use the same system for recovery that was used to create the logs. If you are using a system with less capacity than the original system, consider reducing the READNUM (nn) value. If the DRF log read task (RVRD) abends with S878, consider reducing the READNUM (tn) value. 

READNUM parameter syntax


image 4822

The total number of concurrent read threads allowed is specified by tn. The actual number might be larger than tn if some input data sets exist that can be read from devices other than tape drives. The default maximum number of total concurrent read threads is tn or 3, whichever is greater.

If you do not specify READNUM, the system default of (3,3) is used.


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

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

Topic: Configuring IMS Database Recovery Facility > Configuring the product environment > Environmental control statements

The range and default value of the MAXSEC(nnnn) parameter have been changed as follows:

...

MAXSEC(nnnn)

...

Secondary allocations are calculated as 10% of the primary allocation +1.

Range: 1-3276
Default: 600

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

Topic: Troubleshooting > Runtime messages (FRD)

Messages FRD3302I and FRD6124A have been changed as follows:

FRD3302I   reason text : RC=rc RSN=xxxxxxxx
Explanation:This is an informational message issued with message FRD3301W that explains the reason the dynamic space calculation was bypassed.
reason text indicates the reason for the aborted calculation and is one of the following:
...

INPUT IMAGE COPY IS NOT ON DASD : RC=04 RSN=xxxxxxxx
The input image copy being used for the recovery is not on a direct access storage device.
xxxxxxxx is the device type of the input image copy volume (the UCBTYP field of IEFUCBOB).

...

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

FRD6124A   INVALID DATA ENCOUNTERED. KEYWORD: keyword RSN=rsn
Explanation: The data associated with the indicated keyword was not valid.
In the message text:
...
rsn
...

ICNOTIFY(DRF) AND ICNDX(Y) ARE MUTUALLY EXCLUSIVE
The ICNOTIFY(DRF) and ICNDX(Y) parameters are mutually exclusive and cannot be specified at the same time.

...


Update 1 
Date of change: January 2020
Change description: Documentation changes by APAR PH12756. The KEYLABEL keyword has been added to the list of the parameter that are associated with the UTILGBL() environmental statement and ADD IC() command.
Topics: Changes apply to multiple topics.

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

Topic: Configuring IMS Database Recovery Facility > Configuring the integrated auxiliary utilities environment > Reference: Utility control statement parameters

KEYLABEL parameter has been added to the table as follows:

Utility control statement parameter Integrated auxiliary utility Valid on UTILGBL() Valid on ADD(IB()) Valid on ADD(IC()) Valid on ADD(PC()) Description
... ... ... ... ... ... ...
ITKBSRVR ... ... ... ... ... ...
KEYLABEL IMS HP Image Copy Yes No Yes No Specifies the name of the key label that is used to encrypt the image copy output data sets.
MAXFSD ... ... ... ... ... ...
... ... ... ... ... ... ...
--------------------
Topic: Configuring IMS Database Recovery Facility > Configuring the integrated auxiliary utilities environment > Reference: Utility control statements > Integrated auxiliary utility parameters for IMS HP Image Copy

KEYLABEL parameter has been added between the ICNMRULE and MGMTCLAS parameters as follows:

Syntax diagram

...

image 2088

...

Parameter reference

...

KEYLABEL(key-label-name)

   This parameter specifies the name of the key label used to encrypt the image copy output data sets.

   key-label-name

      The name of the key label to be used for allocating the encrypted image copy output data set.
      The name that you define, is one-to 64-characters long.

   This parameter does not have a default.

...

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

Topic: Using IMS Database Recovery Facility > Using the integrated auxiliary utilities > Reference: ADD IC() command

KEYLABEL parameter has been added between the ICNMRULE and MGMTCLAS parameters as follows:

Syntax for ADD IC() command

...

image 2089

...

Parameter reference for ADD IC() command

...

KEYLABEL(key-label-name)

   This parameter specifies the name of the key label used to encrypt the image copy output data sets.

   key-label-name

      The name of the key label to be used for allocating the encrypted image copy output data set.
      The name that you define, is one-to 64-characters long.

   This parameter does not have a default.

...

Publication Number

SC27-8441-01

[{"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"}],"ARM Case Number":"","Platform":[{"code":"PF035","label":"z/OS"}],"Version":"2.1.0"}]

Document Information

Modified date:
16 July 2020

UID

ibm11169530