Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-222
PROCESSHANDLE_TO_FILENAME_ Procedure
processhandle input
INT .EXT:ref:10
is the process handle to be converted. If a null process handle (-1 in each word) is
specified, the process handle of the calling process is used.
filename:maxlen output:input
STRING .EXT:ref:*, INT:value
returns the process file name of the process designated by
processhandle.
filename includes the node name of the process; it does not include qualifiers.
maxlen is the length in bytes of the string variable filename.
filename-length output
INT .EXT:ref:1
is the actual length of the value returned in
filename. If an error other than 18
(unknown system) is returned, 0 is returned for this parameter.
options input
INT:value
specifies options. The fields are:
<0:14> Not currently used (specify 0)
<15> For named processes: if set, specifies that the sequence number not
be included in
filename for a named process. If this bit is not set,
the sequence number is included. For unnamed processes: the
sequence number is always included in
filename, regardless of the
value of this bit.
The default is 0.
Considerations
If the process is named, PROCESSHANDLE_TO_FILENAME_ looks up the process
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 PROCESSHANDLE_TO_FILENAME_
procedure, refer to the
Guardian Programmer’s Guide.