Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-264
PROCESSSTRING_SCAN_ Procedure
name:maxlen output:input
STRING .EXT:ref:*, INT:value
if present, returns the name of a node or process. If
stringtype is less than 3,
name returns the node name that was contained in the process string (if no node
name was specified, the returned value of
namelen is 0). If stringtype is 3, the
returned value is the specified process name, including the node name, if present.
maxlen is the length in bytes of the string variable name.
namelen output
INT .EXT:ref:1
if present, returns the actual length of the value returned in
name. If an error
occurs, 0 is returned.
cpu output
INT .EXT:ref:1
if present, returns the processor value contained in the process string when
stringtype is 1 or 2; otherwise -1 is returned.
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:
<15> 0 Error 13 occurs if options <15> =0 and the input string name
exceeds 6 characters including the ‘$’ character.
1 Causes an input string exceeding 6 characters to be accepted
without error..
<0:14> Reserved (specify 0)
When
options is omitted, 0 is used.