CAPD block format (LOGID=X'00')

The CAPD block contains fields that describe the name of the exit routine that is to be given control, the name of the physical database, the segment code, and other information that relates to the log record.

The following table lists the CAPD block format.

Table 1. Format for CAPD block (LOGID = X'00')
Field name Data type Field description
NEXT_PTR AL4 Internal use only. Not valid.
PREVIOUS_PTR AL4 Internal use only. Not valid.
USER_EXIT_NAME CL8 The name of the exit routine that is to be given control when an exit routine is requested in addition to logging. Blanks if the exit routine is not defined or is logged by DBCTL.
DATABASE_NAME CL8 The name of the physical database.
DBD_VERSION_PTR AL4 Internal use only. Not valid.
SEGMENT_NAME CL8 The name of the physical segment that was updated and for which the log data was requested.
SEGMENT_CODE XL1 Segment code for compare.
FLAGS XL1 Flag: Bit definition follows:
DEDB_DB X'80' DEDB database.
KEY_NEEDED X'40' Concatenated key needed.
DATA_NEEDED X'20' Segment data needed.
PATH_NEEDED X'10' Path data needed.
  X'08' Reserved for IMS.
  X'04' Reserved for IMS.
  X'02' Reserved for future use.
  X'01' Reserved for future use.
  XL1 Reserved for IMS.
CALL_SEGMENT_LEVEL XL1 Reserved for future use.
CALL_FUNCTION CL4 Call function of request:
REPL
Replace call.
ISRT
Insert call.
DLET
Delete call.
FLD
Field call resulted in this update. Physical function will be REPL.
CASC
Cascade delete as result of application delete call.
DLLP
Delete of a logical parent segment through its logical path because:
  • It was marked as previously deleted from its physical path.
  • It is vulnerable to delete from both the physical and logical paths.
  • The last logical child segment is being deleted.
Gxxx
When subset pointer updates are being captured, this is the get call (for example, GHU, GHNP) that was done.
PHYS_FUNCTION CL4 Physical function performed by DL/I:
REPL
Segment physically replaced.
ISRT
Segment physically inserted.
DLET
Segment physically deleted.
DLPP
Delete this segment on its physical path, but do not physically remove because logical paths to the segment from a logical child still exist.
SSPU
SSP is updated when segment is physically retrieved or segment is not updated in path ISRT or REPL.
CALL_TIMESTAMP XL8 STCK time stamp of call completion.
AREA_NAME CL8 The AREA name for a DEDB database.
LOWEST_LVL_KEY_OR_DATA XL1 The lowest level number for which path data or a part of the concatenated key is added.
  XL39 Reserved for future use.
COMMAND_CODES 0XL12 Command codes.
CMD_CODE_SNGL XL1 Single-character command codes.
CMD_CODE_F X'80' Command code F.
CMD_CODE_L X'40' Command code L.
  XL1 Reserved for future use.
CMD_CODE_DBL 0XL10 Double-character command codes.
CMD_CODE_M XL1 Subset pointer command codes M1 through M8. (*)
CMD_CODE_R XL1 Subset pointer command codes R1 through R8. (*)
CMD_CODE_S XL1 Subset pointer command codes S1 through S8. (*)
CMD_CODE_W XL1 Subset pointer command codes W1 through W8. (*)
CMD_CODE_Z XL1 Subset pointer command codes Z1 through Z8. (*)
  XL5 Reserved for future use
DB_VERSION AL4 Database version number.
PART_NAME CL8 HALDB partition name.
SAVED_DLTWA AL4 Saved DLTWA for compare.
PHYSICAL_ROOT_RBA AL4 RBA of root segment.
STORAGE_SIZE F Internal use only. Not valid.
CONC_KEY_PTR AL4 Internal use only. Not valid.
CONC_KEY_LENGTH H Length of physical concatenated key.
ROOT_KEY_LENGTH XL1 Length of root key.
CAPD_DATA_DIMENSION XL1 Dimension of data array. This value reflects the number of CAPD_DATA Block elements that will be logged for this call. If path data is requested, the first CAPD_DATA block element will be for the root segment, followed by CAPD_DATA block elements for each segment in the path. The next CAPD_DATA block element (first if no path data) is for the segment associated with this request, followed by the CAPD_DATA block element (if any) associated with the before-image data (physical replace operations).
CAPD_DATA_PTR(16) 16AL4 Internal use only. Not valid.
(*): Each bit represents whether the corresponding command code number was specified. For example, if CMD_CODE_S is X'A0', it means that S1S3 was specified on the SSA.