Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-233
FNAMECOMPARE Procedure
(Superseded by FILENAME_COMPARE_
1 The file names refer to the same volume name, device name, or process name
on the same system; however, words [4:11] are not the same:
filename1[4] <> filename2[4] FOR 8
A value less than -1 is the negative of a file-system error code; in these cases, the
comparison is not attempted.
filename1 input
INT:ref:12
is the first file name that is compared. Each
filename array can contain either a
local or a network file name in 12-word internal format. Refer to Appendix D, File
Names and Process Identifiers for the definitions of file names.
filename2 input
INT:ref:12
is the second file name that is compared.
Considerations
•
The arrays containing the file names for comparison are not modified.
•
Alphabetic characters not upshifted
Alphabetic characters within qualified process names are not upshifted before
comparison.
•
Passing DEFINE names
Either or both of the file name parameters can be DEFINE names. For CLASS
MAP DEFINEs, the procedure uses the file name given by the DEFINE to make
the comparison. A name that designates a DEFINE of another class compares
equal only to a name that designates the same DEFINE. If a DEFINE name is a
logical name but no such DEFINE exists, the procedure returns the negative file-
system error -198 (missing DEFINE).
•
Passing logical device numbers for file names
If a logical device number format (such as $0076) is used for one file name but not
for the second file name, the device table of the referenced system is consulted to
determine whether the names are equivalent. This is the only case where the
device table is used.
•
FNAMECOMPARE and negative file errors
Negative file-system error codes indicate that a logical device number format is
passed for one file name and not for the second and that the device is connected
to a remote network node. Some of the most common negative file-system error
codes returned are: