Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-227
FNAME32EXPAND Procedure
(Superseded by FILENAME_SCAN_ Procedure )
intname output
STRING .EXT:ref:32
is an array of 32 characters where FNAME32EXPAND returns the expanded file
name. This array can be the same array as
extname.
defaults input
STRING .EXT:ref:16 or 18
is an array of eight words containing the default volume and subvolume name (and
optionally system number) that is to be used in the file name expansion. This array
has the same format as the corresponding parameter to FNAMEEXPAND.
Or it is an array of nine words where the first word contains the default system
number and the remaining eight words contain the default volume and subvolume
names.
Considerations
FNAME32EXPAND differs from FNAMEEXPAND in the following ways:
•
All 35 characters of the extname parameter must be addressable, even if the
actual file name occupies less space.
•
All alphabetic characters in the internal name are in upper case.
•
Internal names returned by the procedure are always in network form.
•
FNAME32EXPAND accepts file names that have eight-character device names in
network format or file names where a default system number is passed in the
defaults parameter.
•
FNAME32EXPAND returns 0 if the defaults parameter specifies a system
number that is not currently defined.
•
FNAME32EXPAND returns 0 if a parameter is missing or if a bounds error occurs
on a parameter. It also returns 0 if the first byte of
defaults is not “\$”, blank,
or 0.
•
If a default system other than the caller’s system and an eight-character default
volume name are desired, the
defaults parameter must be in the nine-word
format. FNAME32EXPAND interprets the
defaults parameter as being nine
words in length if the high-order byte of the first word is zero.
Related Programming Manual
For network programming applications, refer to the Distributed Name Service (DNS)
Manual.