File Utility Programming (FUP) Reference Manual

FUP Overview
File Utility Program (FUP) Reference Manual523323-015
1-29
Unique Features of EKS Files
Unique Features of EKS Files
Enhanced Key-Sequenced Files (EKS) have the following unique features:
The primary partition does not store user data but instead stores the file metadata.
When creating an EKS file, the partial key of the first secondary partition must be
explicitly set to all zeros.
For example, SET PART(1,$FC11,16,16[0,0,0,0,0])
When creating an EKS file, the primary and secondary extent size of the primary
partition must be greater than or equal to 140 otherwise, the default value of 140 is
used.
When accessing the primary partition of an EKS file, in an unstructured mode,
reads on the file return FEEOF (1) and writes on the file return FEFILEFULL (45).
This is because the metadata stored in the primary partition cannot be accessed by
non-privileged applications.
Unique features of Key-Sequenced File with Increased Limits
Key-sequenced file with icreased limits file is a general term which is applied to
either a Format 2 legacy key-sequenced file (1-16 partitions) or an EKS file (17-64
partitions) with at least one of these new increased limits: 65-128 partitions (for
EKS files only), block size of 32 KB, record size greater than 4040 and less than or
equal to 27,648 bytes, a primary key size greater than 255 and less than or equal
to 2048 bytes, or an alternate key size which meets the following alternate key size
criteria:
The alternate keys are unique, and the alternate key length in bytes is greater
than 253 and less than or equal to 2046.
The alternate key allows duplicates, is defined as an insertion-ordered,
and the sum of (10 + alternate key length + primary-key length ) is a value in
bytes greater than 255 and less than or equal to 2048.
The alternate key allows normal duplicates, and the sum of (alternate key
length + primary-key length ) is a value in bytes greater than 253 and less than
or equal to 2046.
The primary partition does not store user data but instead stores the file metadata.
When creating a key-sequenced file with increased limits (EKS file with increased
limits), the partial key of the first secondary partition must be explicitly set to all
zeros.
For example, SET PART(1,$FC11,16,16[0,0,0,0,0])
Note. An Enscribe standard queue file may be a Format 2 legacy key-sequenced file with
increased limits. However, an Enscribe Tuxedo queue file may not be a Format 2 legacy key-
sequenced file with increased limits.