FABTROOT RAPSIN data set

Edit online

The RAPSIN data set contains the block/RAP assignments used by module FABTRAPS to produce the randomization reports.

Subsections:

Format

This data set is a sequential data set with RECFM=FB and LRECL=42. BLKSIZE must be coded on the DCB parameter of your DD statement.

Record types

There are four record types in the RAPSIN data set:

  • Header record: one per database.
  • Part record: one per partition.
  • Highkey record: more than one per partition.
  • RAP record: one per root segment.

HD Tuning Aid uses Header record and RAP record for non-HALDB, and uses all types of records for HALDB.

The data set can contain records of more than one database. All records for a single database are contiguous. The following two figures show how the data set is organized. It is a product-sensitive programming interface. See Programming interface information to understand the restrictions associated with this type of material.

Begin product-sensitive programming interface information.

Figure 1. RAPSIN data set format
____________________________________________________________
Header record for first database
____________________________________________________________
Part record of first partition for first database
____________________________________________________________
Highkey record of first partition for first database
____________________________________________________________
RAP record of first partition for first database
____________________________________________________________
RAP record of first partition for first database
____________________________________________________________
........
____________________________________________________________
........
____________________________________________________________
Part record of second partition for first database
____________________________________________________________
Highkey record of second partition for first database
____________________________________________________________
RAP record of second partition for first database
____________________________________________________________
RAP record of second partition for first database
____________________________________________________________
........
____________________________________________________________
Header record for second database
____________________________________________________________
Part record of first partition for second database
____________________________________________________________
Highkey record of first partition for second database
____________________________________________________________
RAP record of first partition for second database
____________________________________________________________
.......
____________________________________________________________
Figure 2. RAPSIN data set format
____________________________________________________________
Header record for first database 
____________________________________________________________
RAP record for first database 
____________________________________________________________
RAP record for first database
____________________________________________________________
RAP record for first database 
____________________________________________________________
... ... ... 
____________________________________________________________
Header record for second database 
____________________________________________________________
RAP record for second database 
____________________________________________________________
RAP record for second database 
____________________________________________________________
RAP record for second database 
____________________________________________________________
... ... ... 
____________________________________________________________
Header record for third database 
____________________________________________________________
RAP record for third database 
____________________________________________________________
RAP record for third database 
____________________________________________________________
RAP record for third database 
____________________________________________________________
... ... ... 
____________________________________________________________

End product-sensitive programming interface information.

Header record

The following table shows the header record of the FABTROOT RAPSIN data set.

Table 1. Header record of the FABTROOT RAPSIN data set
Position Length Description
1 2 Database number in hexadecimal
3 2 Zero in hexadecimal
5 8 DBD name
13 4 Database block size in hexadecimal
17 1 C'V' if the database is VSAM
18 1 C'1' if the database is HDAM

C'2' if the database is HIDAM

C'3' if the database is PHDAM

C'4' if the database is PHIDAM

19 8 Module name of partition selection exit
27 8 Randomizing module name
35 4 RAA block number in hexadecimal
39 2 RAP number in each control interval or block (in hexadecimal)
41 2 RESERVED

Part record

The following table shows the part record of the FABTROOT RAPSIN data set.

Table 2. Part record of the FABTROOT RAPSIN data set
Position Length Description
1 2 Database number in hexadecimal
3 2 Partition number in hexadecimal

Partition definition order for PDB

Partition selection order for HALDB

5 8 ZERO in hexadecimal
13 4 Database block size in hexadecimal
17 8 DD name in case of PDB

Partition name in case of HALDB

25 2 Partition ID for HALDB
27 8 Randomizing module name
35 4 RAA block number in hexadecimal
39 2 RAP number in each control interval or block (in hexadecimal)
41 2 Reserved

Highkey record

The following table shows the highkey record of the FABTROOT RAPSIN data set.

Table 3. Highkey record of the FABTROOT RAPSIN data set
Position Length Description
1 2 Database number in hexadecimal
3 2 Partition selection order in hexadecimal
5 3 ZERO in hexadecimal
8 1 Sequence number in Highkey record
9 34 Partition high key string or partition selection string

RAP record

The following table shows the RAP record of the FABTROOT RAPSIN data set.

Table 4. RAP record of the FABTROOT RAPSIN data set
Position Length Description
1 2 Database number in hexadecimal
3 2 Data set group number for non-HALDB

Partition selection order for HALDB (in hexadecimal)

5 3 Block number (in hexadecimal) to which this root segment is randomized
8 1 RAP number (in hexadecimal) to which this root segment is randomized
9 1 C’R’
10 4 Relative byte address (in hexadecimal) at which this root segment is randomized
14 29 The first 29 bytes of the sequence field of this root