The SNAPPIT DD data set contains the CI Map/CI Dump report produced
by the FABADA1 program.
Format
The data set contains 133-byte fixed-length
records, and block size (if coded in your JCL statement) must be a
multiple of 133. You should code your DD statement as follows:
//SNAPPIT DD SYSOUT=A
CI Map/CI Dump report
This report provides the CI map/CI dump as a part of the processing. With this
report, you can get all the CIs necessary to analyze any broken database without having to perform
another run to obtain such information.
Purpose
The CI Map/CI Dump report is used to analyze DEDB area CIs in order to determine
the best way to repair them. The report provides the following information:
CI map that is a list of CI header, all the segments, free space elements, scrap bytes, unknown
area, and CI trailer that the DEDB Pointer Checker found in the CI.
CI dump that is logically formatted based on the CI map.
Report content: (CI Map section)
The following figure shows the CI map section of the CI Map/CI Dump report.
The following are the descriptions for this figure.
STORAGE
The memory address of the first byte in that line of the CI map.
TYPE
The one of the following entries in database CI:
segment-name
The segment that includes prefix and data.
FSE
The free space element.
SHORT-FS
Scraps (that is, free space less than 4 bytes).
UNKNOWN
Area that the DEDB Pointer Checker could not identify as segment, FSE, or scrap
bytes area. If the CI is in SDEP part, segments and unused area are treated as unknown area.
HEADER
The first 4 or 8 bytes of the CI that contains the following items:
FSEAP 2 bytes
Offset to the first Free Space Element (FSE). These two bytes are unused if the CI is in the
SDEP part as it does not contain FSEs.
CI 2 bytes
Describe the use of this CI and the meaning of the four next bytes. DSECT DBFDBLK in the
distributed IMS libraries provides a detailed mapping of these
fields.
RAP 4 bytes
Root Anchor Point if this CI belongs to the base section of the root addressable part. All root
segments randomizing to this CI are chained off this RAP in ascending key sequence. There is only
one RAP per CI.
Note: In the dependent and independent overflow parts, these 4 bytes are used by Fast
Path for control information. There is no RAP in SDEP CIs.
TRAILER
The last 13 bytes of the CI that contains following items:
CUSN 2 bytes
CI update sequence number (CUSN) maintained in each CI except in the SDEP part.
RBA 4 bytes
Relative byte address (RBA) of this CI.
RDF 3 bytes
Record definition field (VSAM control information).
CIDF 4 bytes
CI definition field (VSAM control information).
RBA
The relative byte address of the area defined by this CI map entry.
ADDRESS
The address in memory.
FLAGS
Always contains zero.
SC
The segment code. The value is zero if TYPE contains the segment name.
COUNTERS
Always contains zero.
LENGTH
The length of the area defined by this CI map entry.
ROOT#
Always contains zero.
Report content: (CI Dump section)
The following figure shows the CI dump section of the CI Map/CI Dump report.
The following are the descriptions for this figure:
RBA
The relative byte address of the first byte in that line of the printed CI dump.
OFFSET
The offset from the first bytes of the CI to the first byte in that line of the printed CI
dump.