Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-237
FNAMEEXPAND Procedure
(Superseded by FILENAME_SCAN_ Procedure and
[0:7] corresponds directly to word[1:8] of the command interpreter startup
message. Refer to the
Guardian Procedure Errors and Messages Manual
for the startup message format.
Considerations
•
Expanding network file names
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 “Examples”). (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:
[0:3] $default-volname (blank-fill)
[4:7] default-subvolname (blank-fill)
[8:11] file-id (blank-fill)
•
subvolname.file-id returns as:
[0:3] $default-volname (blank-fill)
[4:7] subvolname (blank-fill)
[8:11] file-id (blank-fill)
•
$volname.file-id returns as:
[0:3] $volname (blank-fill)
[4:7] default-subvolname (blank-fill)
[8:11] file-id (blank-fill)
•
$volname.subvolname.file-id returns as:
[0:3] $volname (blank-fill)
[4:7] subvolname (blank-fill)
[8:11] file-id (blank-fill)
•
$processname.#1st-qualif-name returns as:
[0:3] $processname (blank-fill)
[4:7] #1st-qualif-name (blank-fill)
[8:11] (blank-fill)
•
$processname.#1st-qualif-name.2nd-qualif-name returns as:
[0:3] $processname (blank-fill)
[4:7] #1st-qualif-name (blank-fill)
[8:11] 2nd-qualif-name (blank-fill)