Guardian Procedure Calls Reference Manual

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.
Returned Value
INT
The length (in bytes) of the file name in extname, or 0 if an error occurred.
Considerations
FNAME32EXPAND differs from FNAMEEXPAND in these 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, see the Distributed Name Service (DNS) Manual.
626 Guardian Procedure Calls (F)