Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-225
PROCESSHANDLE_TO_STRING_ Procedure
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 the following 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,
refer to the
Guardian Programmer’s Guide.