SEGREC_PREFIX keyword

Use the SEGREC_PREFIX keyword to specify the contents of the fields within the prefix portion of the segment records, which are to be written to an extract or an unload file.

This keyword is valid only when EFORMAT=USER is specified with the EXTRACT command, or FORMAT=USER is specified with the UNLOAD command or the RELOAD command.

SEGREC_PREFIX is an optional keyword for the following commands:
  • EXTRACT
  • RELOAD
  • UNLOAD
Related keywords:
SEGREC_SUFFIX keyword
Format:
Read syntax diagramSkip visual syntax diagramSEGREC_PREFIX=(,literalbuilt-in_variable,VL=YESNO)
literal
Specify one or more alphabetic or numeric characters that are contained within apostrophes (' ') or within quotation marks (" "). You can specify an optional data-type declaration as follows:
  • C'xxxxxx' (character): Case-sensitive character data. You must specify a minimum of 1 and maximum of 28 characters (28 bytes).
  • F'xxxxxx' (signed binary): Must contain only numeric digits. You must specify a minimum of 1 and maximum of 19 digits (4 bytes).
  • P'xxxxxx' (packed decimal): Assumed positive. Must contain only numeric digits. You must specify a minimum of 1 and maximum of 31 digits (16 bytes).
  • X'xxxxxx' (unsigned binary): Must be an even number of hexadecimal characters. You must specify a minimum of two hexadecimal characters (representing 1 byte) and a maximum of 56 hexadecimal characters (representing 28 bytes).
You can also declare the length, by specifying it before the data-type declaration.
Example:
8C'CUSDB'
2P'01'
Built-in_variable
The following built-in variables can be specified.
Built-in variable name Data type Contents
AREA_NAME 8C Area name
AREA_NUMBER 1X Area number (1 byte)
AREA_NUMBER2 2X Area number (2 bytes)
DBD_AREAS 2F Number of areas in DBD
DBD_LEVELS 2F Maximum hierarchic level in DBD
DBD_NAME 8C DBD name
DBD_SEGMENTS 2F Number of segment types in DBD
KEY or SEGMENT_KEY nC Key for current segment
ROOT_KEY nC Key for root segment
ROOT_KEY_LENGTH 2F Length of root segment key
RUNDATE 4X Date when FPA started
RUNDATETIME 12X Date and time when FPA started
RUNTIME 4X Time when FPA started
SEGMENT_ATTR 1X Segment attribute (Only for the UNLOAD or the RELOAD command)
X'40': SDEP segment
X'04': Fixed-length segment
X'02': Compressed segment
SEGMENT_CKEY nC Concatenated key for current segment
SEGMENT_CKEY_LENGTH 2F Length of concatenated key for current segment
SEGMENT_CODE 1X Segment code
SEGMENT_KEY_LENGTH 2F Length of current segment key
SEGMENT_LENGTH 2F Length of segment (When COMPRESS=YES is specified, the length of the compressed segment)
SEGMENT_LEVEL 1X Segment level
SEGMENT_NAME 8C Segment name
SEGMENT_OCCURRENCE 4X Segment code and segment sequence number for the current hierarchical level (Only for the UNLOAD or the RELOAD command)
SEGMENT_SCSQ_DEF (X 3X) × n Segment code and segment sequence number for the defined hierarchical level (Only for the UNLOAD or the RELOAD command)
SEGMENT_SCSQ_MAX (X 3X) × 14 Segment code and segment sequence number for all hierarchical levels (Only for the UNLOAD or the RELOAD command)
TODAY 4X Date when FPA started
VL=YES
Request a length prefix.
VL=NO
Suppress a length prefix.
Default:
VL=YES
Site default support:
Not supported.
Alias:
PREFIX
Keyword abbreviation:
Supported.