Guardian Procedure Calls Reference Manual

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:
default volname. First two bytes can be "\sysnum," in which case "$" is omitted from volume name.
(blank-filled on right)
[0:3]
default subvolname (blank-filled on right)[4:7]
corresponds directly to word[1:8] of the command interpreter startup message. For the startup message
format, see the Guardian Procedure Errors and Messages Manual.
[0:7]
Returned Value
INT
The length (in bytes) of the file name in external-filename. If an invalid file name is specified,
0 is returned.
Considerations
FNAMEEXPAND converts local file names to local names and network file names to network names.
When network file names are involved, FNAMEEXPAND converts the system name to the appropriate
system number (see Example). (If the system name is unknown, FNAMEEXPAND supplies 255 for
the system number; FNAMEEXPAND calls LOCATESYSTEM for this work.)
Results of file name expansion by FNAMEEXPAND:
• file-id returns as:
$default-volname (blank-fill)[0:3]
default-subvolname (blank-fill)[4:7]
file-id (blank-fill)[8:11]
• subvolname.file-id returns as:
$default-volname (blank-fill)[0:3]
default-subvolname (blank-fill)[4:7]
file-id (blank-fill)[8:11]
FNAMEEXPAND Procedure (Superseded by FILENAME_SCAN_ Procedure and FILENAME_RESOLVE_ Procedure) 619