Enscribe Programmer's Guide

Table 9 Comparison of LKS Files, LKS2 Files, Standard Queue Files, EKS Files, and EKS Files with
Increased Limits (continued)
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
512, 1 KB, 2 KB, 4
KB, 32 KB
512, 1 KB, 2 KB, 4
KB
512, 1 KB, 2 KB, 4
KB (With increased
512, 1 KB, 2 KB, 4
KB
Block Length
limits, 32 KB is
supported.)
Up to 27,648Up to 4040Up to 4040 (With
increased limits, up to
27,648.)
Format 1: Up to 4062
Format 2: Up to 4040
Record Length
Up to 2048Up to 255Up to 255 (With
increased limits, up to
2048.)
Up to 255Primary Key Length
Up to ~2048Up to ~255Up to ~255 (With
increased limits, up to
Up to ~255 (Not
applicable to Enscribe
Queue files.)
Alternate Key Length
~2048.) (Not
applicable to Enscribe
Queue files.)
Up to 255Up to 255Up to 255
4
(Not
applicable to Enscribe
Queue files.)
Up to 255
4
(Not
applicable to Enscribe
Queue files.)
Partition Partial Key
Length
Up to 100Up to 100Up to 100
4
(Not
applicable to Enscribe
Queue files.)
Up to 100
4
(Not
applicable to Enscribe
Queue files.)
Number of Alternate
Key Files
~1 TB~1 TB~1 TBFormat 1: ~2 GB – 1
MB
Maximum Partition
Size
Format 2: ~1 TB
~127 TB~63 TB~16 TBFormat 1: ~32 GB –
16 MB
Maximum File Size
Format 2: ~16 TB
1
The primary partition of an enhanced key-sequenced file cannot contain user data and is used instead to store a portion
of the file’s label.
2
Although the maximum number of extents for the primary partition of an EKS files is configurable, in practice DP2 will
never allocate more than 1 extent.
3
HP reserves the right to change this value in the future. The actual extent size will be increased to the minimum if necessary.
4
Or limited by the file label space.
IMPORTANT: You might not be able to create key-sequenced files with all possible combinations
of number of secondary partitions, partial key length, and number of alternate keys because of
file label space limitations. For example, if you attempt to create a key-sequenced file with 15
secondary partitions, 255-byte partial keys, and 100 alternate key files, the file creation API returns
an error 1027, indicating that the file cannot be created because of label restrictions. To resolve
this problem, reduce the number of secondary partitions, partial key length, or the number of
alternate keys.
Converting a Legacy Key-Sequenced File to an Enhanced Key-Sequenced File
The following scenario is an example where the number of partitions for a customer database is
increased beyond 16 partitions with a reconfiguration of the number of partitions, the number of
extents per partition, and the partition key for the first secondary partition.
72 Key-Sequenced Files