Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-211
FILENAME_TO_PROCESSHANDLE_ Procedure
processhandle output
INT .EXT:ref:10
returns the process handle of the process designated by
filename.
Considerations
•
If the file name to be converted by FILENAME_TO_PROCESSHANDLE_
designates something besides a process (for example, a disk file or a tape device),
the procedure returns the process handle of the process that controls the device
(that is, the I/O process).
•
When converting the process file name of a named process,
FILENAME_TO_PROCESSHANDLE_ looks up the process by name in the
destination control table (DCT). If the name is not found, error 14 is returned.
However, it is sometimes possible for the name of a nonexistent process to be
found in the DCT, in which case error 0 is returned. Therefore, even for a named
process, error 0 (successful conversion of a process handle) does not guarantee
that the process exists.
Related Programming Manual
For programming information about the FILENAME_TO_PROCESSHANDLE_
procedure, refer to the
Guardian Programmer’s Guide.
Caution. Passing an invalid file name to this procedure can result in a trap, a signal, or data
corruption. To verify that a file name is valid, use the FILENAME_SCAN_ procedure.