Guardian Procedure Calls Reference Manual

MeaningBit
If a DEFINE name is supplied for partialname, and if the DEFINE contains only a file name (that is, it
is a simple MAP DEFINE), then FILENAME_RESOLVE_ returns that file name as the result. (Error 198 is
<12>
returned if the DEFINE doesn't exist; error 13 is returned if DEFMODE is OFF.) If neither this option nor
options.<11> is specified, then the DEFINE name is returned as the result.
If a logical device number (LDEV) appears as part of partialname, FILENAME_RESOLVE_ translates
it to the corresponding symbolic device name.
<13>
A single name part supplied in partialname is to be treated as a subvolume name or pattern.<14>
All alphabetic characters in the resolved file name are to be shifted to upper case. If this option is not
specified, characters transferred from partialname to fullname are unchanged. Characters taken
from defaults are always shifted to upper case, regardless of this option.
<15>
override-name:override-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if override-length is not 0, specifies a DEFINE name to be used as the
primary input instead of partialname. If used, the value of override-name must be exactly
override-length bytes long. If the DEFINE name does not exist, or if DEFMODE is OFF,
partialname is processed as normal.
search:search-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if search-length is not 0, specifies the name of a CLASS SEARCH DEFINE
that is used to resolve single-part file names by testing for the file's existence in several
subvolumes. See Considerations for details. If used, the value of search must be exactly
search-length bytes long. If the DEFINE does not exist, DEFMODE is OFF, or partialname
does not consist of a single name part, then no searching is done and no error is reported.
defaults:defaults-length
input:input
STRING .EXT:ref:*, INT:value
if supplied and if defaults-length is not 0, specifies either a default subvolume to be used
for name resolution or the name of a CLASS DEFAULTS DEFINE to be used for name resolution.
If used, the value of defaults must be exactly defaults-length bytes long and must be
in this form:
[[\node.]$volume.]subvolume
Any part of the supplied default value that is used in the resolved file name is shifted to upper
case, regardless of the value of options.<15>.
Omitted name parts are taken from the =_DEFAULTS DEFINE. If this parameter is omitted or if
defaults-length is 0, the value of the VOLUME attribute of the =_DEFAULTS DEFINE is
used.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
588 Guardian Procedure Calls (F)