Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
error := FILE_CREATE_ ( filename:maxlen ! i,o:i
,filenamelen ! i,o
,[ file-code ] ! i
,[ primary-extent-size ] ! i
,[ secondary-extent-size ] ! i
,[ maximum-extents ] ! i
,[ file-type ] ! i
,[ options ] ! i
,[ recordlen ] ! i
,[ blocklen ] ! i
,[ keylen ] ! i
,[ key-offset ] ); ! i
Parameters
filename:maxlen
input, output:input
STRING .EXT:ref:*, INT:value
if a permanent file is to be created, is the name of the new file; if a temporary file is to be
created, it is the name of the disk volume on which the file is to be created. If the name is
partially qualified, it is resolved using the contents of the caller's =_DEFAULTS DEFINE. If a
temporary file is created, the name assigned to the file is returned in filename.
maxlen is the length in bytes of the string variable filename.
filenamelen
input, output
INT .EXT:ref:1
on input, gives the length in bytes of the value supplied in filename. On return, it contains
the length of the assigned value in filename for a temporary file or it is unchanged for a
permanent file.
file-code
input
INT:value
is an application-defined value to be assigned to the new file. The definition of codes 100
through 999 is reserved for use by HP. The default value is 0.
primary-extent-size
input
INT:value
specifies the size of the primary extent in pages (2048-byte units). The value is considered to
be unsigned. The system might round the value up to an even number during file creation. The
maximum primary extent size is 65,535 (134,215,680 bytes). If this parameter is omitted or
equal to 0, 1 is used.
secondary-extent-size
input
INT:value
specifies the size of the secondary extents in pages (2048-bytes units). The value is considered
to be unsigned. The system might round the value up to an even number during file creation.
The maximum secondary extent size is 65,535 (134,215,680 bytes). (The maximum number
of secondary extents that a file can have allocated is maximum-extents - 1. See
maximum-extents, following.) If this parameter is omitted or equal to 0, the size of the
primary extent is used.
386 Guardian Procedure Calls (F)