Enscribe Programmer's Guide

• When creating an EKS file, the primary extent size of the primary partition is adjusted based
on the block length of the file. The secondary extent size for the primary partition is ignored.
• When accessing the primary partition of an EKS file in unstructured mode, reads on the file
return FEEOF (1) and writes return FEFILEFULL (45). This is because the meta data stored in
the primary partition cannot be accessed by non-privileged applications.
Creating Key-Sequenced Files
You create Enscribe legacy, legacy with increased limits, enhanced key-sequenced files, or enhanced
key-sequenced files with increased limits with the File Utility Program (FUP) or by calling either the
FILE_CREATE_ procedure or the FILE_CREATELIST_ procedure.
If you are using FUP to create a file that contains one or more alternate-key fields, FUP automatically
creates any required alternate-key files. If you are creating the file programmatically, however,
you must create any required alternate-key files yourself (one for each alternate-key field).
When creating a key-sequenced file, your considerations include:
• “Comparing LKS Files, LKS2 Files, Standard Queue Files, EKS Files, and EKS Files with
Increased Limits” (page 71)
• “Converting a Legacy Key-Sequenced File to an Enhanced Key-Sequenced File” (page 72)
• “Logical Records” (page 73)
• “Disk Extent Size” (page 74)
• “Primary Keys” (page 75)
• “Key Compression” (page 75)
• “Index Compaction” (page 76)
Comparing LKS Files, LKS2 Files, Standard Queue Files, EKS Files, and EKS Files
with Increased Limits
Table 9 Comparison of LKS Files, LKS2 Files, Standard Queue Files, EKS Files, and EKS Files with
Increased Limits
EKS Files with
Increased Limits
Allowed Values
EKS File Attributes
Allowed Values
LKS2 and Standard
Queue File Attributes
Allowed Values
LKS and Standard
Queue File Attributes
Allowed ValuesFile Attribute
2221 or 2Format Type
17 up to 12817 up to 64
1
Up to 16Up to 16Number of Partitions
Up to 928Up to 928Up to 928Up to 978Extents for Primary
Partition
2
Up to 928Up to 928Up to 928Up to 978Extents for Secondary
Partition
The primary extent
size of the primary
The primary partition
has a primary extent
Each partition has its
own primary and
Each partition has its
own primary and
Partition File Extent
Sizes
partition is based onsize greater than orsecondary extent size.secondary extent size.
the block length of theequal to 140 pagesThe maximum extentThe maximum extent
file. The secondaryand cannot be lesssize for a format 2 filesize for a format 1 file
extent size for thethan 140 pages.
3
is 536,870,912
pages.
is 65535 pages,
while the maximum primary partition is
Each secondary
extent size for a ignored. Each
partition has its own
format 2 file is
536,870,912 pages.
secondary partition
has its own primary
primary and
secondary extent size.
and secondary extent
size.
Creating Key-Sequenced Files 71