Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-194
FILENAME_RESOLVE_ Procedure
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
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, later). 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.
error := FILENAME_RESOLVE_ ( partialname:length !
i:i
,fullname:maxlen !
o:i
,fullname-length ! o
,[ options ] ! i
,[ override-name:length ] !
i:i
,[ search:length ] !
i:i
,[ defaults:length ] ); !
i:i