Guardian Procedure Calls Reference Manual

pin
output
INT .EXT:ref:1
if present, returns the PIN value contained in the process string when stringtype is 2;
otherwise -1 is returned.
options
input
INT:value
specifies desired options. The fields are:
Error 13 occurs if options <15> = 0 and the input string name exceeds 6 characters including
the ‘$' character.
0<15>
Causes an input string exceeding 6 characters to be accepted without error.1
Reserved (specify 0).<0:14>
When options is omitted, 0 is used.
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).
PROCESSSTRING_SCAN_ accepts process strings in these forms:
[\node.]cpu,pin
[\node.]cpu
[\node.]$process-name
[\node.]*
• If you request the processhandle, PROCESSSTRING_SCAN_ verifies that the process exists.
If the process does not exist, a null process handle (-1 in each word) is returned. If you supply
a process name that represents an existing process pair, the returned process handle is that
of the current primary.
1182 Guardian Procedure Calls (P)