Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-41
FILE_CREATELIST_ Procedure
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.
item-list input
INT .EXT:ref:*
is an array that specifies the file-creation attributes for which values are supplied in
the
values parameter. Each element of the array must be of type INT and contain
an item code from Table 5-3
, later in this subsection. Some items require the
presence of other items and must be supplied in a particular order, as noted in the
table.
number-of-items input
INT:value
is the number of items supplied in
item-list.
values input
INT .EXT:ref:*
is the array in which the values for the file attributes specified in
item-list are
supplied. The values should be supplied in the order specified in
item-list.
Each value begins on an INT boundary; if a value has a length that is an odd
number of bytes, an unused byte should be appendend before the following value
begins. The length of each fixed-length value is given in Table 5-3
. Every