Guardian Procedure Calls Reference Manual

Considerations
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.
• The FILENAME_UNRESOLVE_ procedure compares a specified file name with the default
subvolume specification and removes left-hand sections that are identical. It scans the input
file name from the left, and when it finds a difference, it returns that part and everything to
the right. Name parts are never removed from the section indicated by level or from sections
to the right of that point.
Examples
error := FILENAME_UNRESOLVE_ ( longname:longlen,
shortname:maxlen,
shortname-len,
level );
This table gives some possible input values for the above example, along with the output. Assume
that the current default values are "\SYS.$VOL.SUB".
shortname (output)levellongname (input)
\mysys.$myvol.mysvol.myfile0\mysys.$myvol.mysvol.myfile
$myvol.mysvol.myfile0\sys.$myvol.mysvol.myfile
$vol.mysvol.myfile0\sys.$vol.mysvol.myfile
mysvol.myfile0mysvol.myfile
sub.myfile1sub.myfile
myfile2sub.myfile
Related Programming Manual
For programming information about the FILENAME_UNRESOLVE_ procedure, see the Guardian
Programmer's Guide.
604 Guardian Procedure Calls (F)