Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-195
FILENAME_RESOLVE_ Procedure
options input
INT:value
specifies options. If omitted, the default value is 0. The bits, when equal to 1,
indicate the following:
Bit Meaning
<0:7
>
Reserved (specify 0).
<8>
If
partialname consists of a simple unqualified disk file name, a
DEFINE name is generated to use as the
override-name. The
generated name is an equal sign (=) followed by
partialname. This
name convention corresponds to the ASSIGN name convention used by
TAL. This option cannot be used unless
override-name is omitted or
has a length of 0.
<9>
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.
<10>
If a DEFINE name other than one translated by
options.<11> or
options.<12> is supplied for partialname, FILENAME_RESOLVE_
returns error 13.
<11>
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 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.)
<12>
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 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.