Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-34
FILE_CREATE_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
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.
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