Guardian Procedure Calls Reference Manual

Returned Value
INT
A status value indicating the outcome of the comparison:
The file names do not refer to the same file.-1
The file names refer to the same file.0
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
1
A value less than -1 is the negative of a file-system error code; in these cases, the comparison is
not attempted.
Some of the most common negative file-system error codes returned are:
An invalid file name specification for either file name is made.-13
The device does not exist. Only one of the file names is passed in logical device number format (requiring a
check of the device table), and the file name represents a device connected to a remote node.
-14
No such system is defined in this network. Only one of the file names is passed in logical device number
format (requiring a check of the device table), and the file name represents a device connected to a remote
node.
-18
A parameter or buffer is out of bounds.-22
All paths to the system are down. Only one of the file names is passed in logical device number format
(requiring a check of the device table), and the file name represents a device connected to a remote node.
-250
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.
616 Guardian Procedure Calls (F)