Read-only, read-update, write-update, write-add, write-add complete record types

The journal records written for read-only, read-update, write-update, write-add, and write-add complete record types consist of four sections.

These sections are as follows:
  • The FLJB_GENERAL_DATA section
  • The FLJB_COMMON_DATA section
  • The two caller data image sections:
    • FLJB_CD_KEY (its length is given in FLJB_COMMON_DATA)
    • FLJB_CD_DATA (its length is given in FLJB_COMMON_DATA)

      This section contains the image of the caller data.

Record format

The format of such a record written for these record types is shown in Figure 1.
Figure 1. Layout of record written for read-only, read-update, write-update, write-add, and write-add-complete record types
The fields in this picture are described in the list that follows.
FLJB_GENERAL_DATA
12-byte general data.

See FLJB_GENERAL_DATA.

FLJB_COMMON_DATA
16-byte common data.

See FLJB_COMMON_DATA.

FLJB_CD_KEY
Variable-length caller data key.
FLJB_CD_DATA
Variable-length caller data.

FLJB_GENERAL_DATA

The format of the FLJB_GENERAL_DATA section is shown in Figure 2.
Figure 2. Format of FLJB_GENERAL_DATA section
The fields in this picture are described in the list that follows.
FLJB_RECORD_TYPE
1-byte record type: 
X'80'    Readonly
X'81'    Read update
X'82'    Write update
X'83'    Write add
X'84'    Write add complete
X'86'    Write delete
X'87'    Commit (replication only)
X'88'    Backout (replication only)
X'89'    Unlock (replication only)
X'8E'    File close
X'8F'    File tie-up record
FLJB_BITS
1-byte flag field: 
X'80'    File control autojournal record
X'40'    Forward recovery log record
X'20'    System log record
X'10'    Log-of-log record
X'08'    Written in backout
X'04'    Data set is extended addressing ESDS
X'02'    Replication record
FLJB_FILE_NAME
8-byte file name.
Reserved
2-byte reserved field.

FLJB_COMMON_DATA

The format of the FLJB_COMMON_DATA section is shown in Figure 3.
Figure 3. Format of FLJB_COMMON_DATA section
The fields in this picture are described in the list that follows.
FLJB_CD_BASE_ESDS_RBA
4-byte relative byte address of record in the base data set for an ESDS.

The relative byte address is 0 if the file does not refer to an ESDS, or if it is an extended addressing ESDS.

FLJB_CD_KEY_LENGTH
2-byte length of user data key.

The key length is 4 for an RRDS, a VRRDS, or a standard ESDS; it is 8 for an extended addressing ESDS.

Reserved
2-byte reserved field.
FLJB_CD_DATA_LENGTH
4-byte length of user data.
FLJB_CD_BITS
1-byte flag field: 
X'80'    UOW has been shunted at least once
X'40'    Write massinsert
X'20'    First write-add-complete in massinsert sequence
X'10'    End of massinsert sequence
X'08'    Fixed length record
X'04'    Replication record is auto committed
X'02'    Token used on READ-UPDATE (replication records only)

Combinations of settings are possible.

Reserved
3-byte reserved field.