Updates to IMS Online Reorganization Facility for z/OS V1.2 User's Guide

Product documentation


Abstract

Updates that apply to IMS Online Reorganization Facility Version 1 Release 2 User's Guide (SC27-1577-06).

Content

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



Update 6
Date of change: April 2014
Change description: User's Guide updates. These updates include documentation changes by APAR PM39102 and APAR PM37656.
Topic: Changes are made to the following multiple topics:

> 2.0 Configuring IMS Online Reorganization Facility
>> 2.1 Restrictions

The restriction list has been modified as follows:

IMS Online Reorganization Facility does not support the following items:
  • Batch jobs that run as DLI, DBB, or ULU region types and that access the database during the reorganization process
  • Applications that update the database during the reorganization process by using a PCB that references a logical DBD
  • Start of changeApplications that update the HALDB during the reorganization process by using a PCB with PROCSEQ= codedEnd of change
  • HSAM databases
  • HIDAM databases with compressed root keys
  • Databases and database data sets that are not registered to DBRC
  • Start of changeDatabases that are registered as non-recoverable with DBRCEnd of change
  • Start of changeDatabases that have external logical relationshipsEnd of change
  • Fast Path databases
  • Reorganization of multiple HALDB partitions in one step (you can do this type of reorganization in parallel with separate IMS Online Reorganization jobs)
  • HALDB DBD changes
  • Reorganization of HALDB M-V data sets
  • Uncataloged or corrupted databases
  • Databases using PDF
  • Start of changeMulti-volume OSAM databases that are not created by using the standard DFSMS methodsEnd of change
=============
> 2.0 Configuring IMS Online Reorganization Facility
>> 2.9 Configuring your IMS Online Reorganization Facility runtime environment
>>> 2.9.2 HRFSETOP and HRF#ssid module parameters

Descriptions of the following parameters have been added:

Start of change
NOTINIT ERROR | IGNORE
    If the database is defined to an IMS subsystem, IMS Online Reorganization Facility checks whether the corresponding ACBLIB member exists in that subsystem and ends with an error when the ACBLIB member is not found. Specify NOTINIT=IGNORE if you want the job to continue even when the ACBLIB member is not found in that subsystem. When NOTINIT=IGNORE is specified, IMS Online Reorganization Facility treats the database the same as it treats a database that is not defined to the IMS subsystem.

    Default: ERROR
End of change

Start of change
UNITPOOL uuuuuuuu
    A 1- to 8-character unit name to be used for OSAM shadow data set allocations. This value is required only if you want to have shadow data sets allocated in the specified unit pool. This parameter is effective only for OSAM databases.

    Default: none
End of change

Start of change
VOLPOOL vvvvvv
    A 1- to 6-character volume serial to be used for OSAM shadow data set allocations. This value is required only if you want to have shadow data sets allocated in the specified volume pool. This parameter is effective only for OSAM databases.

    Default: none
End of change

=============
> 4.0 Using IMS Online Reorganization Facility
>> 4.4 HRFSYSIN DD statement keywords

Descriptions of the following keywords have been added:

Start of change
SORTNUM
    Description
      This keyword is optional for REORG HRFSYSIN DD statements, but is not applicable for UNLOAD HRFSYSIN DD statements. It is used to specify the segment count threshold to switch from on-memory processing to using external sorting when IMS Online Reorganization Facility reorganizes a database that has non-unique keys. If the number of segments exceeds this value, external sorting is used to map the relative byte addresses (RBAs) of segments between the original database and the shadow database.

      This keyword is effective only when you are running with IMS High Performance Unload. If IMS High Performance Unload is not used, external sorting is used. The maximum value is 9999999.

    Format
      0-9999999

    Default value
      5000
End of change

Start of change
VOLALLO
    Description
      This keyword is optional for REORG HRFSYSIN DD statements, but is not applicable for UNLOAD HRFSYSIN DD statements. It is used to override the space allocation when creating the database data sets. The following variables are supported:
      nn
        Is the number of volumes to be used. This parameter is for SMS controlled allocations. If nn is greater than 1, candidate volumes are defined. If nn is zero, VOLALLO is ignored.
      pppp
        Is the number of cylinders for the primary allocation. The default is 300 and the maximum is 2000.
      ssss
        Is the number of cylinders for the secondary allocation. The default is 300 and the maximum is 2000.

    Format
      ( nn,pppp,ssss)

    Default value
      (0,300,300)
End of change



Update 5
Date of change: July 2013
Change description: Documentation changes by APAR PM89944 and PM91589. These APARs add two new parameters to the runtime option modules HRFSETOP and HRF#ssid.
Topic: Changes are made to the following multiple topics:

> 2 Configuring IMS Online Reorganization Facility
>> 2.9 Configuring your IMS Online Reorganization Facility runtime environment
>>> 2.9.2 HRFSETOP and HRF#ssid module parameters

The following new parameter has been added by APAR PM89944:

Start of change
DBRCHIPR = N | NO | Y | YES
    Specifies the timestamp precision for DBRC commands. DBRCHIPR=N or NO requests to generate DBRC commands with 12-digit timestamps. DBRCHIPR=Y or YES requests to generate DBRC commands with 16-digit timestamps. DBRC commands that have 16-digit timestamps can be processed only when the MINVERS value in the RECON data set is equal to or higher than 10.1.

    Default: N
End of change

The following new parameter has been added by APAR PM91589 :

Start of change
FEOV = Y | YES | N | NO
    Specifies whether to include the NOFEOV keyword in the /DBR command during the Takeover phase. FEOV=N or NO specifies to include the NOFEOV keyword, which means that there is no forced end of volume. You can override the value specified on this parameter by using the FEOV keyword in the HRFSYSIN DD statement.

    Default: Y
End of change



Update 4
Date of change: May 2013
Change description: User's Guide updates.
Topic: Changes are made to the following multiple topics:

> 2.0 Configuring IMS Online Reorganization Facility
>> 2.9 Configuring your IMS Online Reorganization Facility runtime environment
>>> 2.9.2 HRFSETOP and HRF#ssid module parameters

Description of the XCFRETRY parameter has been added as follows:

Start of change
XCFRETRY nn
    A 2-digit numeric value that indicates the number of times that IMS Online Reorganization Facility automatically retries to send XCF messages in situations where sufficient XCF message buffer is not available (IXCMSGORSNNOBUFFER). When the number is exceeded, the IMS Online Reorganization Facility job stops.

    Attention: Use this parameter with caution because it can possibly degrade the performance of IMS when the XCF send errors occur repeatedly.

    Default: 0
End of change

The following obsolete parameter has been removed:

XCFMAX nnnn
    A 0-2000 numeric value for maximum storage for XCF buffer usage. This parameter specifies a megabyte limit, that is used to store unprocessed messages that are received through XCF. This limit is provided to protect against cases where the IMS Online Reorganization Facility cannot keep up with the changes that are being captured from the online IMS subsystems.
    When the XCFMAX limit is reached, the IMS Online Reorganization Facility batch job abends.
    Default: 300

=============
> 7.0 IMS Online Reorganization Facility messages and codes
>> 7.2 Messages

The explanation for the following message has been modified:

HRF01517E Error encountered during capturetype capture for DBD dbdname: FUNC= function RC= xxxx RSN= xxxx

Explanation: The IMS Online Reorganization Facility was unable to capture a change record for a DBD.
System action: Record capture is terminated for the DBD. The IMS Online Reorganization Facility job is notified of the records that were being captured. The IMS Online Reorganization Facility job abends.
Start of changeUser response: If the parameters shown in the message are 'FUNC=IXCMSGO, RC=000C, RSN=0004', the message indicates that an XCF send error, which is caused by an XCF message buffer shortage, has occurred. In this case, consider increasing the MAXMSG value on the CLASSDEF or PATHOUT definition. You can find information about XCF message buffers in z/OS MVS Setting Up a Sysplex. Alternatively you can use the XCFRETRY parameter in HRFSETOP to specify the retry count for such XCF send errors.
For other errors, report the problem to IBM Software Support. End of change

The following new message has been added by APAR PM87739:

Start of change
HRF01572E Waiting for database pause has expired

Explanation: An attempt to pause the database has timed out.
System action: The process terminates.
User response: Resubmit the IMS Online Reorganization Facility job. If the error persists, contact IBM Software Support.
End of change



Update 3
Date of change: March 2013
Change description: User's Guide updates.
Topic: Changes are made to the following multiple topics:

> 2.0 Configuring IMS Online Reorganization Facility
>> 2.1 Restrictions

An Attention note has been added to the first item in the list. Also, a new item has been added to the list (second item) .

IMS Online Reorganization Facility does not support the following items:
  • Batch jobs that run as DLI, DBB, or ULU region types and that access the database during the reorganization process
    Start of changeAttention: Running outside of DBRC might cause a data integrity exposure. For example, if a DBB or DLIBATCH job is running with DBRC=N, IMS Online Reorganization Facility does not detect it and proceeds with the reorganization. The Takeover phase then attempts to allocate the database data sets as DISP=OLD and fails if the DBB or DLI job is still running. Additionally, if a DBB or DLIBATCH job that runs with DBRC=N finishes before the Takeover phase, those updates are not captured by IMS Online Reorganization Facility because such a job runs as DLI or DBB region type.End of change
  • Start of changeApplications that update the database during the reorganization process by using a PCB that references a logical DBDEnd of change
  • HSAM databases
  • HIDAM databases with compressed root keys
...

=============
> 7.0 IMS Online Reorganization Facility messages and codes
>> 7.2 Messages

The following new messages have been added:

Start of change
HRF01180E Sort work ddname has not enough disk space

Explanation: The indicated ddname cannot allocate enough sort work space.
System action: Processing terminates.
User response: Override the DD with sufficient disk space so that the system can allocate enough sort work space for the DD.
End of change

Start of change
HRF01570E Waiting for BMPs has expired

Explanation: The number of retry attempts to stop BMP jobs reached the maximum number that is set by the BMPRETRY parameter in the HRFSETOP runtime option module.
System action: The process terminates.
User response: Wait for the BMP jobs that are shown in the WTOR message to end, and resubmit the IMS Online Reorganization Facility job. You can increase the maximum number of retry attempts by specifying the BMPRETRY parameter in the HRFSETOP runtime option module. If the database is used by long running BMP jobs, consider enabling BMP job pause handling. For more information, see "Managing BMP pauses".
End of change



Update 2
Date of change: May 16, 2012
Change description: Documentation change by APAR PM62694. Added a description about the new parameter "UNLMAXRC".
Topic:
> 2.0 Configuring IMS Online Reorganization Facility
>> 2.9 Configuring your IMS Online Reorganization Facility runtime environment
>>> 2.9.2 HRFSETOP and HRF#ssid module parameters

Start of change
UNLMAXRC n
    A 1-digit numeric value that specifies the maximum acceptable return code from the HD unload utility. This parameter is ignored when you are running IMS High Performance Unload. The valid values are 0 and 4. Specify 4 only if you can accept the return code 4 from HD Unload and want to have the reorganization processing continued.

    Default: 0
End of change



Update 1
Date of change: April 22, 2011
Change description: Added note about requirement to install Tools Base in the same SMP/E target and distribution zones as your other IBM IMS Tools.
Topic:
> 2.0 Configuring IMS Online Reorganization Facility
>> 2.5 Configuring the base environment

Before you can perform the more advanced configuration steps, you must configure a basic IMS™ Online Reorganization Facility environment.

Start of change
Before you begin
If you are using IMS Tools Base for z/OS V1.1, you must install the IMS Tools Base for z/OS V1.1 (FMID HAHN110) in the same SMP/E target and distribution zones as your other IBM IMS Tools products. For more information, see: http://www.ibm.com/support/docview.wss?uid=swg21495808. End of change

...

Publication number

SC27-1577-06

Copyright date

1996, 2011

Original publication date

2011/4/22

Product Alias/Synonym

ORF
Online Reorganization Facility

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS Tools
IMS Online Reorganization Facility

Software version:

1.2.1

Operating system(s):

z/OS

Reference #:

7018217

Modified date:

2014-04-23

Translate my page

Machine Translation

Content navigation