Guardian Procedure Calls Reference Manual

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, 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, 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 17 (page 394). 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 appended before this value begins. The length of each fixed-length value is given in Table 17
(page 394). Every variable-length item has an associated value that gives its length, as specified
in the table.
values-length
input
INT:value
is the size in bytes of values.
error-item
output
INT .EXT:ref:1
if present, returns the index of the item in item-list that was being processed when an error
was detected, or is one greater than the number of items in item-list if an error was detected
after the processing of individual items was completed. The index of the first item in item-list
is 0.
FILE_CREATELIST_ Procedure 393