COMPAKTOR Reports

Extents map

COMPAKTOR produces a map showing all of the data sets and free spaces on the volume in sequence by location. For SIMULATE and COMPAKT, maps are produced showing the condition of the volume both BEFORE and AFTER the operation. The map shows the data set name, the location, and size of each extent, and the extent number and total number of extents. For the first extent of a data set, the map shows the data set organization, the type and quantity of secondary allocation, the last block pointer, the total size of the data set, and how much of the allocated space is unused.

COMPAKTOR normally highlights the lines for the VTOC and the free spaces, to make them stand out more. (If you plan to look at the map from a terminal, we recommend that you specify HILIGHT=NO, because the highlighting would appear as duplicated lines.)

For non-VSAM data sets, the LAST BLK TTR points to the highest used record in the data set; the first 4 digits are the highest used track (in hex, relative to zero) and the last 2 digits are the highest record number on that track (in hex). EMPTY TRKS is based on the total allocation minus the used tracks for PS and PO data sets.

For VSAM components, the LAST BLK TTR contains generated information. The first 4 digits are the last track of the highest used Control Area (in hex, relative to zero) in the cluster as derived from the HI-USED-RBA value in the VVDS entry for the cluster and the last 2 digits are the number of tracks per Control Area (CA), in hex, except the hi-order x’80’ flag is on to indicate that COMPAKTOR was unable to release space on this component. If the TTR contains non-zero data, then EMPTY TRKS indicate unused tracks in the cluster. These values may be zero for VSAM components in the AFTER MAP.

See the following page for a sample COMPAKTion Extent Map.

For volumes with more than 64K tracks and less than 65,521 cylinders, such as the 3390-9, the map is in a slightly different format with starting and ending cylinders on the left and 5-digit cylinder numbers. The MAPFORMAT=NEW operand can force this format even on smaller DASD volumes.

For EAV volumes, the map format shows the starting and ending “CCHH” values on the left allowing up to 7-digits for the “CC”. Additionally, 8-digits are supported for the extent length. The VTOC Summary section displays the number of Format 8 and 9 DSCBs as well. The “Combined Summary” section may show track values with a “M” suffix denoting the values displayed are in megabytes. The MAPFORMAT=EAV operand can force this format even on smaller DASD volumes.

Sample COMPAKTOR control cards

To release space and compact the volume, a two-step job is run performing the space release first followed by the fast compaction of the volume. In the compaction step, the first parameter (0) of the SIZEKEEP= operand is used to maximize free space consolidation.

COMPAKTOR produces a summary showing many statistics for each volume. For SIMULATE and COMPAKT, two columns show the statistics BEFORE and AFTER the operation. There are statistics for the volume as a whole, for various categories of data sets, and for the VTOC. Some uses of the summary map are discussed in COMPAKTOR-Output.

Before COMPAKTion, data set ICF1.CPKV0908.KSDS1 was in 123 extents and after COMPAKTion this VSAM data component went into one extent.

Combined summary

COMPAKTOR produces a combined summary, with two lines (BEFORE and AFTER) with selected statistics from the summary of each volume processed, sorted by volume serial number. Only one line is printed for MAP. The combined summary is printed on ddname SYSSUMM, if present, or at the end of SYSMAP if not.

Here is a sample combined summary report.

1. Reduction in Free Space Areas
2. Actual Elapsed Time
   Many of these fields are extracted from the Summary Report on the previous page, and are described in Section 40.15 “COMPAKTOR Output”. Some are unique to this report. Briefly, the fields are:

• 
  
  • NUMBER OF TRACKS - Total tracks on the volume
  • NUMBER OF DSNS - Total data sets on the volume
  • >1 EXTS - Number of data sets with more than one extent
  • ALLOCATED TRACKS - Total allocated tracks
  • ALLOCATED EXTS - Total allocated extents
  • ALLOCATED %AL - Percentage of total tracks allocated
  • FREE TRACKS - Total tracks not allocated
  • FREE AREAS - Number of free space areas
  • FREE LARGEST - Largest free area size in tracks
  • FRAG INDEX - IBM fragmentation index
  • EMPTY TRACKS IN… - Total unused tracks in VSAM, PS, and PO data sets
  • VTOC SIZE - Total size of the VTOC in tracks
  • VTOC %US - Percentage of the VTOC DSCBs in use
  • TIME - CPK actual elapsed time in minutes (and tenths if less than 99 minutes). For simulation of Fast COMPAKTion (SIM TYPE=FASTCPK) only, this is a conservative estimate; the actual elapsed time is usually less.
  • COMP CODE - CPK completion on this volume:
    • 0 – Successful COMPAKTion
    • ERROR – An error occurred, look for error messages
    • NO IMPRV – Unable to improve the volume
    • BYPASS – Conditional keywords bypassed volume
    • IN RECVY – FASTCPK previously failed; rerun CPK