Guardian Procedure Calls Reference Manual

Table 17 FILE_CREATELIST_ Item Codes (continued)
DescriptionSize
(Bytes)
Item
Code
Do not index when null.<0>
Unique.<1>
Do not update.<2>
Insertion order duplicates.<3>
Reserved. Must be zero.<4:15>
These fields have the same semantics as the corresponding fields of item 101. The length of this
item in bytes is 14 times item 100. This item is an alternate form for item 101, and if used, must
immediately follow item 100 in place of item 101.
Alternate-file relative name-length array. An array of INT byte counts, each giving the length of the
corresponding alternate-file name in item 109. The length of this item is two times item 102. This
*108
item is an alternate form for item 103, and if used, must immediately follow item 102 in place of
item 103.
Alternate-file relative names. Concatenated names of the alternate-key files. Each name occupies
the number of characters specified in the corresponding entry of item 108; total length of this
*109
parameter is the sum of the values in item 108. The names must be fully qualified, except the system
name can be missing. If the system name is missing, the system of the primary file is used. Also, an
implicit system is not recorded explicitly with the file, and so it remains relative to the primary file
if copied to another system.
The volume portion of the name can be eight characters (including the "$") only if the specified or
implied system is the same as the system where the primary partition is created. This item is an
alternate form for item 104 and, if used, must immediately follow item 108.
The items 178-179 must both be supplied if either is supplied, and they must be supplied as consecutive items in the
order presented here:
Physical volume name length. The length in bytes of the name given by item 179.2178
Physical volume name. When creating a file on a SMF virtual volume, the physical volume on which
the file is to reside. The name is in external form and optionally includes the node name; if the node
*179
name is unspecified, it is taken from the =_DEFAULTS DEFINE. The physical volume must be a
member of the pool associated with the virtual volume. If this item is not supplied, the SMF subsystem
chooses a physical volume from the pool.
Suggested primary processor. If not -1 (null), and if there is a choice of suitable physical volumes,
the processor number of the processor desired to contain the primary process of the disk process
2180
providing the physical storage for the file. This value is advisory only and does not have any effect
if the file is not being created on a SMF virtual volume, if a physical volume is specified by using
item 179, or if no suitable physical volume is available on which a virtual disk process in the
specified processor could place a file.
Items 187 and 188 are optional when creating a partitioned SMF file. These items must both be supplied if either is
supplied; they must be supplied at some point after item 90 (number of partitions) and must be supplied as consecutive
items in the order presented here:
Partition physical volume name-length array. For SMF files, an array of INT values that give, for
each extra (secondary) partition, a length for the physical volume name, which is supplied in item
*187
188. If a length is 0, the corresponding extra partition has its physical volume selected by the SMF
subsystem. A length must be 0 if the corresponding partition volume (in item 93) is not a SMF virtual
volume. The length of this item is 2 times the number of partitions (item 90).
Partition physical volume names. For SMF files, the concatenated names of the secondary partition
physical volumes. Each name occupies the number of characters specified in the corresponding
*188
entry of item 187; the total length of this item equals the sum of the values in item 187. The names
can be partially qualified, in which case the missing node name is taken from the =_DEFAULTS
DEFINE. Each physical volume must be a member of the pool associated with the corresponding
partition volume given in item 93.
FILE_CREATELIST_ Procedure 399