Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-215
PROCESSHANDLE_DECOMPOSE_ Procedure
nodenumber output
INT(32) .EXT:ref:1
if present, returns the number of the node in which the process designated by
processhandle resides.
nodename:maxlen output:input
STRING .EXT:ref:*, INT:value
if present, returns the name of the node in which the process designated by
processhandle resides.
maxlen is the length in bytes of the string buffer nodename.
nodename-length output
INT .EXT:ref:1
is the actual length of the value returned in
nodename, in bytes.
procname:maxlen output:input
STRING .EXT:ref:*, INT:value
if present, returns the name of the process designated by
processhandle if the
process is named. The returned value is the simple name beginning with a dollar
sign; it does not include a node name or ASCII sequence number.
maxlen is the length in bytes of the string buffer procname.
procname-length output
INT .EXT:ref:1
is the actual length of the value returned in
procname, in bytes. For unnamed
processes,
procname-length is 0 and there is no error.
sequence-number output
FIXED .EXT:ref:1
if present, returns the sequence number from the specified process handle.
Considerations
If you specify procname or procname-length, and processhandle designates a
named process, PROCESSHANDLE_DECOMPOSE_ looks up the process by name.
If it does not exist, error 14 is returned.