FSPB - Datapage instance structure
Name : DCLFSPB
Function:
This module contains the declarative of the FSPB structure, which maps a generic datapage of a
datafile, that is, a generic 4096 bytes page inside one of the linear VSAM data sets reserved to contain
the SYSOUTs represented in the form of either structured or unstructured data. This structure is used
by several modules of data store to read / write the SYSOUT data, to interpret, clean, import,
and export it.In the datapage structure you can find:
- A prefix, reserved to identify the sysout inside a specific datafile.
Within the more significant prefix data we can list, in the real order:
- The data page status indicator, which characterizes the data as logically deleted (leftmost bit in on)
- The primary key of the sysout
- The RBN (relative block number) of the first page of the SYSOUT
- The total number of pages that constitute the SYSOUT
- The secondary key of the SYSOUT
- The information about the real space used to store into the datapage the whole SYSOUT (if a single page can contain it completely) or a portion of it. Clearly, this length excludes the prefix and itself.
The generic area reserved to contain a SYSOUT data portion is expressed as a generic array of single
characters. The ability to interpret the contents of the data portion of the datapage is reserved to
specific modules of the data store. A SYSOUT data portion inside an unstructured datafile
is represented as an ordered list of variable-length records. However, inside a structured datafile,
a SYSOUT has a more complex layout, to interpret which further mapping structures are needed.
Offsets | |||||
---|---|---|---|---|---|
Dec | Hex | Type | Len | Name (Dim) | Description |
0 | (0) | STRUCTURE | 4096 | FSPB | DATAPAGE INST.STRUC |
0 | (0) | CHARACTER | 86 | SPBPRFX | DATAPAGE PREFIX STR |
DPGDELFL | DATAPAGE STATUS INDICATOR | ||||
2 | (2) | SIGNED | 2 | RESHALFW | RESERVED HALFWORD |
4 | (4) | CHARACTER | 34 | FSXB | PRIMARY KEY CLASS CONTROL |
4 | (4) | CHARACTER | 8 | SXBJOBNM | JOBNAME |
12 | (C) | CHARACTER | 8 | SXBJOBDT | |
12 | (C) | CHARACTER | 4 | SXBYEAR | YEAR OF JOBDATE |
16 | (10) | CHARACTER | 2 | SXBMONTH | MONTH OF JOBDATE |
18 | (12) | CHARACTER | 2 | SXBDAY | DAY OF JOBDATE |
20 | (14) | CHARACTER | 8 | SXBJOBTM | JOB TIME IN X'HHMMSSHH' |
28 | (1C) | CHARACTER | 8 | SXBJOBID | JES JOB IDENTIFIER |
36 | (24) | SIGNED | 2 | SXBDSID | SYSOUT DD IDENTIFIER |
40 | (28) | SIGNED | 4 | SPBRBN | RBN OF THE FIRST SYSOUT |
44 | (2C) | SIGNED | 4 | SPBTOTPG | TOTAL NUMBER OF PAGES FOR SYSOUT |
48 | (30) | CHARACTER | 37 | FSAB | SECONDARY KEYS CLASS |
48 | (30) | CHARACTER | 10 | SABOPRTK | OPERATION TOKEN |
48 | (30) | CHARACTER | 8 | SABOCCTK | OCCURRENCE TOKEN |
56 | (38) | SIGNED | 2 | SABOPRNR | OPERATION NUMBER |
58 | (3A) | CHARACTER | 27 | SABRESRV | RESERVED CHARACTERS |
85 | (55) | CHARACTER | 1 | RESCHAR | RESERVED CHARACTER |
86 | (56) | SIGNED | 2 | SPBDATLT | DATA LENGTH IN DATA DATAPAGE |
88 | (58) | CHARACTER | 4008 | SPBDATA | |
88 | (58) | CHARACTER | 1 | SPBCHARY(4008) | DATA PAGE DATA |
88 | (58) | CHARACTER | 1 | DPGDCHAR | DATAPAGE SINGLEDATA |