Guardian Procedure Calls Reference Manual

Parameters
partialname:length
input:input
STRING .EXT:ref:*, INT:value
is a valid, partially qualified file name or file-name pattern that is to be resolved. partialname
can also be a valid DEFINE name (see the description of the options parameter). The value
of partialname must be exactly length bytes long. See caution under Considerations.
fullname:maxlen
output:input
STRING .EXT:ref:*, INT:value
contains the resulting fully qualified file name. The buffer must be distinct from the
partialname, override-name, search, and defaults areas.
maxlen is the length in bytes of the string variable fullname.
fullname-length
output
INT .EXT:ref:1
returns the actual length of the resolved file name returned in fullname. 0 is returned if an
error occurs.
options
input
INT:value
specifies options. If omitted, the default value is 0. The bits, when equal to 1, indicate:
MeaningBit
Reserved (specify 0).<0:5>
If partialname consists of a unqualified disk file name as $volume.filename, and if the <14>
option bit is not set, then the fullname (output parameter) will contain the subvolume from the supplied
or implicit defaults.
<6>
If set, causes the contents of partialname to be validated using FILENAME_SCAN_.<7>
If <14> is also set, then a subvolume name will be accepted as valid input. If <14> is not set, then a
subvolume name is not accepted as valid input and file-system error 14 is returned.
If partialname consists of a simple unqualified disk file name, a DEFINE name is generated to be used
as if an override-name has been supplied with that name. The generated name is an equal sign (=)
<8>
followed by partialname. This name convention corresponds to the ASSIGN name convention used
by TAL. This option cannot be used unlessoverride-name is omitted or has a length of 0.
If search is supplied and a search fails to find an existing file, FILENAME_RESOLVE_ resolves
partialname using the first entry in the search DEFINE. If this option is not specified and a search fails
to find an existing file, FILENAME_RESOLVE_ returns error 11.
<9>
If a DEFINE name other than one translated by options.<11> or options.<12> is supplied for
partialname, FILENAME_RESOLVE_ returns error 13.
<10>
If a DEFINE name is supplied for partialname, and if the DEFINE has a file name associated with it,
that file name is returned as the result. (Error 198 is returned if the DEFINE doesn't exist; error 13 is
<11>
returned if DEFMODE is OFF.) If neither this option nor options.<12> is specified, then
FILENAME_RESOLVE_ returns the DEFINE name as the result. This option causes DEFINE names to be
translated more often than options.<12>, but doing so causes the extra information carried in the
DEFINEs to be lost. (Note that CLASS TAPE and SPOOL DEFINEs carry such information. TAPE DEFINEs
do not necessarily have any specific file name associated with them, and so are not always translated
by this option. CLASS SORT, SUBSORT, CATALOG, DEFAULTS, and SEARCH DEFINE names are never
changed by this option.)
FILENAME_RESOLVE_ Procedure 587