Updates to IMS Recovery Solution Pack: IMS High Performance Change Accumulation Utility V1.1 User's Guide

Product documentation


Abstract

Updates that apply to IMS Recovery Solution Pack: IMS High Performance Change Accumulation Utility V1.1 User's Guide (SC19-2905-00).

Content

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


Update 4
Date of change: March 20, 2012
Topics:
Chapter 8. Creating and converting JCL -> Modifying skeletal JCL members
Change description:
Updated information for log data sets on tape devices and DASD.


Modifying skeletal JCL members

IMS HP Change Accumulation Utility analyzes the output from GENJCL and creates multiple job procedures to run in parallel, one for each selected CA group.

Because multiple tasks are created to read the log data sets, the demand on the number of tape device units can exceed the number of available devices. Unnecessary waits would result until a tape device does become available.

The global parameter INLIM allows you to limit the number of log reader tasks that read log data sets in parallel. This parameter also limits the number of tape devices IMS HP Change Accumulation Utility uses.

However, before starting the change accumulation process, DBRC checks the availability of all log data sets and requires that the data sets and their devices be available even though the log read is done in a different address space.

IMS HP Change Accumulation Utility processing modifies the JCL to defer the mounting of tapes while DBRC is performing its checks. Also, to reduce the requirement for devices, you will need to modify your skeletal JCL member as follows:

  • If the log data sets are on permanently mounted devices, no change is required.
  • If all log data sets are on tape devices, ensure that your DFSULOG contains both DISP=SHR and UNIT=(%LOGUNIT,,DEFER).
  • If the log data sets are stored on a combination of both tape devices and DASD, modify the skeletal so that the DASD log data set UNIT parameter definitions are unchanged and the TAPE log data set UNIT parameter definitions are modified. For example:
    %DELETE (%LOGUNIT EQ '3400')                                    
    //DFSULOG  DD  DSN=%LOGDSN,                                    
    //            
    DISP=SHR                                         
    %ENDDEL                                                        
     %DELETE (%LOGUNIT NE '3400')                                    
    //DFSULOG  DD  DSN=%LOGDSN,                                    
    //            
    DISP=SHR,UNIT=(%LOGUNIT,,DEFER),                 
    //             DCB=(BUFNO=32,RECFM=VB)                          
    %ENDDEL

    In this example, if the log unit is 3400, the first DFSULOG DD statement is deleted, and the second one is kept. If the unit is not 3400, the first DFSULOG DD statement is kept and the second is deleted. The value in the delete expression (3400, in the example) is where you expect the log data set to reside. This is either the generic device name as registered with DBRC, or it is a name known to you when the log data set was created.

    For the specific JCL statements required for allocating the DFSULOG on both TAPE and DASD, see the HPCCAJCL sample member.


When the standard procedure method is used for JCL processing, additional skeletal JCL changes must be considered.
1. JES symbols (&name) are not processed.

The JCL is processed to dynamic allocation format which does not accept & symbols. DBRC symbols (%name) are accepted.
2. Only the EXEC PGM=DFSUCUM0 step is merged into the standard procedure.

Other steps from the skeletal JCL are ignored.
3. UNIT=AFF= is processed only for the DFSULOG DD.


Update 3
Date of change: April 27, 2011
Topics:
Chapters 9, 13, and 15.
Change description:
Added information to not enclose the timestamp in quotes or any other special notation.

Chapter 9. IMS HP Change Accumulation Utility JCL parameters -> Operation statements

LOG TIME=YES|time stamp
Requests point-in-time accumulation processing and optionally defines the log-ending time stamp. If a time stamp value is used, it identifies a stopping position within the time period that represents the set of input logs.

To run point-in-time to the last input log, set LOG TIME=YES.

To run point-in-time to a specified time, set LOG TIME=time stamp. The time stamp value is entered in the standard IMS external time stamp format. Offset labels are not acceptable (for example, PST).

Important: Do not enclose the timestamp in quotes or any other special notation.

Chapter 13. IMS HP Change Accumulation Utility special features and functions -> IMS HP Change Accumulation Utility PITCA time stamps

IMS HP Change Accumulation Utility PITCA time stamps

All events are recorded in the RECON with a time stamp. The time stamp is used for command processing, database utility processing, and recovery processing that references the RECON.

The standard punctuated time stamp format is described in detail in the IMS DBRC Guide and Reference. The punctuated forms are supported but exclude labeled offset values.

Important: Do not enclose the timestamp in quotes or any other special notation.
The following examples show the formats that you can use.

  • YYYY.DDD HH:MM:SS.T
    2008.260 08:24:45.7
  • YY.DDD HH:MM:SS.T
    08.260 08:24:45.7

You can identify the log record time stamp to the microsecond for the IMS™ Record Format and Print Module (DFSERA30) or for any utility that enables log record analysis.

Important: PITCA filtering is based on the converted UTC time stamp and not the local time stamp.

Chapter 15. IMS HP Change Accumulation Utility messages -> HPC1209E

HPC1209E Timestamp invalid. Reason code diagcd.
Explanation
The format of the point-in-time timestamp is not a valid IMS™ external timestamp. Timestamp formats are described in the IMS DBRC Guide and Reference. Message DSP0304I in the IMS Messages and Codes manual describes the values for diagcd.

User response
Correct the timestamp value and rerun the job.

Important: When specifying the LOG TIME parameter, do not enclose the timestamp in quotes.


Update 2
Date of change: February 4, 2011
Topics:
Chapter 9. IMS HP Change Accumulation Utility JCL parameters -> Operation statements -> GENJCL definitions
Change description:
The GEN.RETRY option is modified to remove the restriction on no standard procedures (STDPROC) mode; message HPC1352E is updated to remove the STDPROC text as a valid format of the message.

GEN.RETRY=number
Specifies the number of times IMS HP Change Accumulation Utility will reprocess GENJCL for CAGRPs that cannot be accumulated because of the purge time validation error.

Range: 0-3

Default: 0

Valid only for the extended batch environment.

The following restrictions apply:

  • Only accept simple form of GENJCL definitions in HPCSYSIN
  • VOLNUM is not supported
  • Single Address Space (SAS) is not supported
  • Point-in-time (PIT) is not supported
  • New delete data set step if HPCADRI1 RC=4

HPC1352E

GEN.RETRY Status: Reset – VOLNUM | SAS | PIT

Explanation

IMS™ HP Change Accumulation Utility has detected a restriction for the GEN.RETRY command and the current status has been reset to disabled. Refer to the IMS High Performance Change Accumulation Utility for z/OS® User's Guide for more details on the restrictions for GEN.RETRY: VOLNUM | SAS (single address space) | PIT (point-in-time)

User response

Remove the restriction and resubmit IMS HP Change Accumulation Utility.


Update 1
Date of change: December 3, 2010
Topics:
Chapter 15. IMS HPCA messages
Change description:
Added new messages HPC4053E and HPC4054E.

HPC4053E CA Output Master suffix .HPCAP RESERVED for PIT

Explanation
The suffix of the output change accumulation data set that is specified by the DFSUCUMN DD statement in the skeletal JCL is .HPCAP, however, a point-in-time change accumulation is not performed. A suffix of HPCAP is only valid when the LOG TIME command is specified to indicate that a point-in-time change accumulation should be created.
System action
The change accumulation job fails.
User response
Change the data set name for the DFSUCUMN DD statement in the skeletal JCL so that it does not use the .HPCAP suffix, unless a point-in-time change accumulation is being created.

HPC4054E CA Output Master suffix .HPCAP REQUIRED for PIT

Explanation
The LOG TIME command was specified indicating that a point-in-time change accumulation should be created, however, the suffix of the output change accumulation file is not .HPCAP. When a point-in-time change accumulation is created, the output data set name must end with .HPCAP so that IMS™ Database Recovery Facility recognizes it.
System action
The change accumulation job fails.
User response
Change the data set name for the DFSUCUMN DD in the skeletal JCL so that it has the .HPCAP suffix.


Rate this page:

(0 users)Average rating

Document information


More support for:

IMS Tools
IMS Recovery Solution Pack: IMS High Performance Change Accumulation Utility

Software version:

1.1.0

Operating system(s):

z/OS

Reference #:

7020509

Modified date:

2011-04-27

Translate my page

Machine Translation

Content navigation