Guardian Procedure Calls Reference Manual

Table 17 FILE_CREATELIST_ Item Codes (continued)
DescriptionSize
(Bytes)
Item
Code
specifies a null value if attributes.<0> = 1. Note that the character
must reside in the right-hand byte.
null-value
(INT:1)
During a write operation, if a null value is specified for an
alternate-key field, and if the null value is encountered in all bytes of
this key field, the file system does not enter the reference to the record
in the alternate-key file. (If the file is read using this alternate-key field,
records containing a null value in this field will not be found.)
During a writeupdate operation (write-count = 0), if a null value
is specified, and if the null value is encountered in all bytes of this
key field within buffer, the file system deletes the record from the
primary file but does not delete the reference to the record in the
alternate file.
contains these fields:attributes
(INT:1)
means a null value is specified.= 1<0>
means the key is unique. If an attempt is made to insert a record that
duplicates an existing value in this field, the insertion is rejected with
an error 10 (duplicate record).
= 1<1>
means that automatic updating cannot be performed on this key.= 1<2>
means that alternate-key records with duplicate key values are ordered
by the value of the primary-key field. This attribute has meaning only
for alternate keys that allow duplicates.
= 0<3>
means that alternate-key records with duplicate key values are ordered
by the sequence in which those records were inserted into the
= 1
alternate-key file. This attribute has meaning only for alternate keys
that allow duplicates.
Reserved (specify 0)<4:15>
The length in bytes of this item is 12 times the value of item 100.
Number of alternate-key files. For disk files, the number of files that are to hold alternate-key records.
The maximum value is 100; the default value is 0. FILE_CREATELIST_ does not automatically create
the alternate-key files.
2102
Alternate-file name-length array. For disk files, an array of INT values, each giving the length in
bytes of the corresponding alternate-file name found in item 104. The length in bytes of this item is
2 times the value of item 102.
*103
Alternate-file names. For disk files, a string array containing the concatenated names of the
alternate-key files. Because each name occupies exactly the number of characters specified in the
*104
corresponding entry of item 103, the total length of this item is the sum of the values in item 103.
The names can be fully or partially qualified. Partially qualified names are resolved using the contents
of the =_DEFAULTS DEFINE. The volume portion of an alternate-file name can be a full eight
characters, including the dollar sign, only if the system (specified or implied) is the same as the
system on which the primary file is being created. Item 109 is an alternate form for this item.
Alternate-key descriptors (32-bit). An array of 14-byte key descriptor entries, one for each alternate
key. Each entry has this structure:
*106
INT key-specifier;
INT key-len;
INT (32) key-offset;
INT key-filenum;
INT null-value;
INT attributes;
attributes has these fields:
398 Guardian Procedure Calls (F)