Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-224
PROCESSHANDLE_TO_STRING_ Procedure
processhandle input
INT .EXT:ref:10
is the process handle to be converted.
process-string:maxlen output:input
STRING .EXT:ref:*, INT:value
returns a process string that represents the process designated by
processhandle. The node name is included in process-string, except as
described under
node.
maxlen is the length in bytes of the string variable process-string.
process-string-length output
INT .EXT:ref
is the actual length of the value returned in
process-string. If an error occurs,
0 is returned.
nodename:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, specifies the node name that should be included
in
process-string. If used, the value of nodename must be exactly length
bytes long.
If
nodename designates the same node as indicated in processhandle, no node
name is included in
process-string. If it does not match the node indicated in
processhandle, or if the parameter is omitted, or if length is 0, then the node
name indicated in
processhandle is included in process-string.
named-form input
INT:value
specifies the form of
process-string to be returned for named processes. The
named-form parameter is ignored for unnamed processes. Valid values are:
0 Return process name if possible; if it is unavailable, return
cpu,pin form. See
“Considerations.”
1 Return process name; if it is unavailable, report the error. See
“Considerations.”
2 Return
cpu,pin form in all cases.
A process name is unavailable if
processhandle refers to a named process that
no longer exists.
The default is 0.