Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-236
FNAMEEXPAND Procedure
(Superseded by FILENAME_SCAN_ Procedure and
external-filename input
STRING:ref:27 or STRING:ref:35
is the file name to be expanded. The file name must be in the form:
[\sysname.]file-name or
definename
followed by a delimiter, and where file-name is in one of these forms:
[$volname.][subvol-name.]file-id
$processname[.#1st-qualif-name[.2nd-qualif-name]]
$devname
$ldevnum
the delimiter that follows file-name can be any character that is not valid as part
of an external file name, such as blank or null. When the
external-filename is
34 characters and a delimiter is required, the length of the
external-filename
expands to 35 characters.
When \
system is present, $volname cannot consist of eight characters unless
\
system is the local system and default-names does not include a system
number. In that case the output name is in local form.
internal-filename output
INT:ref:12
is an array of 12 words where FNAMEEXPAND returns the expanded file name.
FNAMEEXPAND (unlike FNAMECOLLAPSE) can have the same source and
destination buffers (file names) since it uses a temporary intermediate storage area
for the conversion. (See “Considerations” for the form of the returned
internal-
filename.)
default-names input
INT:ref:8
is an array of eight words containing the default volume and subvolume names to
be used in file name expansion. The
default-names values are used when the
corresponding values are not specified in
external-filename (see
“Considerations” below).
default-names is of the form:
[0:3] default volname. First two bytes can be “\sysnum,” in which case “$” is
omitted from volume name. (blank-filled on right)
[4:7] default subvolname (blank-filled on right)