Space announcement We are no longer updating this space, and you cannot comment on this space. The CHANGE ACCUMULATION PLUS component is now documented in BMC AMI Backup and Recovery for IMS.

CAPCOMPR usage

The CAPCOMPR utility program compares the results of two change accumulation runs that used the same input.

Generally, you compare results from an IMS Database Change Accumulation utility (DFSUCUM0) run with the results from a Change Accumulation utility run. CAPCOMPR is useful primarily during a testing phase.

Important

If you invoke the Incremental Image Copy function in the Change Accumulation utility and you want to compare its output with the output from a different image copy utility program, use the ICPCOMPR utility program provided with the BMC Image Copy utility.

How CAPCOMPR works

CAPCOMPR compares a record in the SYSUT1 data set with its relative record in the SYSUT2 data set.

The record is automatically decompressed, if necessary, before the comparison.

  • If there are differences (such as different DBDs, ddnames, timestamps, or data fields), they are marked with an asterisk and both records (including the compressed version if there was one) are printed.
  • If the number of records that are different exceeds 25, the program terminates with user abend U4095.

The CAPCOMPR reports the number of records compared, the number of differences found, and whether the data sets matched at the end of processing.

If CAPCOMPR finds significant differences in the SYSUT1 and SYSUT2 data sets and you need help in problem resolution, call BMC Customer Support. Save all related output because your Customer Support representative may need to see it.

CAPCOMPR execution

To run CAPCOMPR, use the JCL member #CAPCOMP in the product sample library.

//CAPCOMPR EXEC PGM=CAPCOMPR
//STEPLIB  DD  DSN=BMC.CAP.LOAD,DISP=SHR
//IMS      DD  DSN=IMS.DBDLIB,DISP=SHR
//SYSPRINT DD  SYSOUT=*
//PLUSOUT  DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//SYSUT1   DD  DSN=CAP.CAGRP1,DISP=SHR
//SYSUT2   DD  DSN=IMS.CAGRP1,DISP=SHR

Definitions of pertinent CAPCOMPR DD statements are in the following table:

DD statement

Description

SYSPRINT DD

Identifies the data set to contain the summary of the compare process. It is normally defined as a SYSOUT-type data set.

PLUSOUT DD

Identifies the SYSOUT data set to contain any mismatches.

SYSUT1 DD

Identifies the data set to contain the output change accumulation data generated by the Change Accumulation utility or DFSUCUM0.

SYSUT2 DD

Identifies the data set to contain the output change accumulation data generated by the Change Accumulation utility or DFSUCUM0. If you identify Change Accumulation utility data in SYSUT1, you would normally identify DFSUCUM0 data here.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*