Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (D-F)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
5-58
FILENAME_RESOLVE_
Converts a partially qualified file name to a fully qualified file name.
filename:length, STRING .EXT:ref:*,INT:value input:input
pattern:length, STRING .EXT:ref:*,INT:value input:input
generic-set, INT .EXT:ref:1 output
-1 The name falls before the first possible match.
0 The name falls within the set of possible matches.
1 The name falls after the last possible match.
error := FILENAME_RESOLVE_ ( partialname:length
,fullname:maxlen
,fullname-length
,[ options ]
,[ override-name:length ]
,[ search:length ]
,[ defaults:length ] );
error, INT returned value
partialname:length, STRING .EXT:ref:*,INT:value input:input
fullname:maxlen, STRING .EXT:ref:*,INT:value output:input
fullname-length, INT .EXT:ref:1 output
options, INT:value input
<0:7> Reserved (specify 0).
<8> If partialname consists of a simple unqualified disk file name, a DEFINE
name is generated to use as override-name. The generated name is an
equals sign (=) followed by partialname.
<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.
<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.