Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-44
FILENAME_RESOLVE_
Converts a partially qualified file name to a fully qualified file name.
options
#include <cextdecs(FILENAME_RESOLVE_)>
short FILENAME_RESOLVE_ ( const char *partialname /* i */
,short length /* i */
,char *fullname /* o */
,short maxlen /* i */
,short *fullname-length /* o */
,[ short options ] /* i */
,[ const char *override-name ]/* i */
,[ short length ] /* i */
,[ const char *search ] /* i */
,[ short length ] /* i */
,[ const char *defaults ] /* i */
,[ short length ] ); /* i */
Bits 0-7 Reserved (specify 0).
Bit 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.
Bit 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.
Bit 10 If a DEFINE name other than one translated by options. Bit 11 or
options. Bit 12 is supplied for partialname,
FILENAME_RESOLVE_ returns error 13.
Bit 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.
Bit 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. If neither
this option nor options. Bit 11 is specified, then the DEFINE name is
returned as the result.
Bit 13 If a logical device number (LDEV) appears as part of partialname,
FILENAME_RESOLVE_ translates it to the corresponding symbolic
device name.
Bit 14 A single name part supplied in partialname is to be treated as a
subvolume name or pattern.
Bit 15 All alphabetic characters in the resolved file name are to be shifted to
upper case.