FABPMAIN BLKMAPIN data set

The FABPMAIN BLKMAPIN data set contains your description of the processing to be done by the BLOCKMAP processor. It contains the target relative byte addresses (RBAs). The BLOCKMAP processor prints a list of all pointers that point to each target RBA.

The target RBAs specified can be the RBAs of segments that have undamaged as well as damaged pointers.

Usually, sufficient information about pointer chaining for a pointer error is automatically produced during an HD Pointer Checker run in the TYPE=ALL or TYPE=CHECK process. If you need information about the pointer chains of other segments, use the BLKMAPIN data set and the CHECKREC data set as the input in TYPE=BLKMAP; a stand-alone run of the BLOCKMAP process.

To list pointers that are free of errors, you must include as input the CHECKREC data set created by specifying CHECKREC=YES in the TYPE=ALL or TYPE=SCAN process. Also be careful about the following considerations:

  • When IN-CORE pointer checking is done, all pointers validated in memory are discarded from the CHECKREC data set and they are not printed in the BLOCKMAP process.
  • When HASH pointer checking is done, pointer information is not generated in the CHECKREC data set or printed in the BLOCKMAP process.

If you need to see all the pointers, rerun the pointer checker with no HASH pointer checking or no IN-CORE pointer checking.

Subsections:

Format

This control data set usually resides in the input stream. However, it can also be defined as a sequential data set or as a member of a partitioned data set. It must contain one 80-byte fixed-length record for each target RBA to be processed. BLKSIZE, if coded, must be a multiple of 80.

The BLKMAPIN data set can be coded as shown in the following figure.

Figure 1. Format of the BLKMAPIN data set
//BLKMAPIN DD *
00100001 A0003FC7D
00100001 B00600CD8
002     0100000400
002     0200000812
/*
1  4    9 11

Record format

There is only one record type in the BLKMAPIN data set.
Position
Description
1
The 3-digit field contains the database number. The field contains hexadecimal digits.
4
If HALDB, the 5-digit field contains the partition ID. The field contains decimal digits. If non-HALDB, this field must be blank.
9
If non-HALDB, the 2-digit field contains data set group number. The field contains hexadecimal digit. If HALDB, the 1-digit field contains data set group number contains a character.
11
This 8-digit field contains the target RBA. This field contains eight hexadecimal digits with leading zeros (if needed).