Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-197
FILENAME_RESOLVE_ Procedure
override-name:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
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
length bytes long. If the DEFINE name does not exist, or if
DEFMODE is OFF,
partialname is processed as normal.
search:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
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 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:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
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 length bytes
long and must be in the following 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
length is 0, the value of the VOLUME attribute of the =_DEFAULTS
DEFINE is used.
Considerations
•
FILENAME_RESOLVE_ performs the principal steps of its operation in the
following order.
1. If the caller supplied the name of an existing DEFINE in
override-name, it
substitutes the DEFINE name for
partialname.
2. If the criteria for doing a search are met, it performs a search.
3. If the caller specified the appropriate options, it resolves or reduces DEFINEs.
Caution. Passing an invalid file name or file-name pattern to this procedure can result in a
trap, a signal, or data corruption. To verify that a file name or file-name pattern is valid, use the
FILENAME_SCAN_ procedure.