Guardian Procedure Calls Reference Manual

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 to 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:
Return process name if possible; if it is unavailable, return cpu,pin form. See Considerations.0
Return process name; if it is unavailable, report the error. See Considerations.1
Return cpu,pin form in all cases.2
A process name is unavailable if processhandle refers to a named process that no longer
exists.
The default is 0.
Returned Value
INT
A file-system error code that indicates the outcome of the call.
Considerations
• A process string is a string of characters that identifies a process or a set of processes. Process
strings are commonly used in command lines (for example, in the TACL STATUS command).
PROCESSHANDLE_TO_STRING_ returns a process string in one of these forms:
[\node.]cpu,pin
[\node.]$process-name
• If you request the process name for a named process, PROCESSHANDLE_TO_STRING_ looks
up the process by name. If the process does not exist and named-form is specified as 1,
error 14 is returned.
• Conversion of the process handle does not necessarily include any check for the existence of
the process; error 0 might be returned for a nonexistent process.
Related Programming Manual
For programming information about the PROCESSHANDLE_TO_STRING_ procedure, see the
Guardian Programmer's Guide.
1146 Guardian Procedure Calls (P)