Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-165
CREATE Procedure
(Superseded by FILE_CREATELIST_ Procedure )
primary-extent-size
(INT:value)
is the size of the primary extent for the particular partition.
secondary-extent-size
(INT:value)
is the size of the secondary extents for the particular partition. Specifying 0
results in the
primary-extent-size value being used.
The remaining parameters are required for key-sequenced files but can be omitted
for all other file types:
partial-keylen
(INT:value)
is the number of bytes of the primary key of a key-sequenced file that are
used to determine which partition of the file contains a particular record.
The minimum value for
partial-keylen is 1.
partial-keyvalue
(INT:value)
for
partial-keylen bytes, specifies the lowest key value that is allowed
for a particular partition.
Each
partial-keyvalue in partition-parameters must begin on a
word boundary.
For an alternate-key file,
partial-keyvalue must begin with the key-
specifier for the alternate key. For example, if key-specifier = AB,
a partial-key value of 123 becomes a
partial-keyvalue of AB123.
•
File pointer action
The end-of-file pointer is set to zero after the file is created.
•
Disk allocation with CREATE
Execution of the CREATE procedure does not allocate any disk area; it only
provides an entry into the volume’s directory, indicating that the file exists.
•
CREATE failure
If the CREATE fails (that is, condition code other than CCE returns), the reason for
the failure can be determined by calling the FILEINFO or FILE_GETINFO_
procedure and passing -1 as the
filenum parameter.