Guardian Procedure Calls Reference Manual

the process string, the current default value in the =_DEFAULTS DEFINE is used for determining
the process handle.
length-used
output
INT .EXT:ref:1
if present, returns the number of characters in string that are part of the process string. If
error 13 is returned, length-used is the number of characters that were accepted as valid
before the name was determined to be invalid.
processhandle
output
INT .EXT:ref:10
if present, returns the process handle of the designated process. A null process handle (-1 in
each word) is returned if the designated process does not exist or if the form of the process
string does not designate a particular process (for example, if only cpu is supplied).
stringtype
output
INT .EXT:ref:1
if present, returns a value indicating the form of the process string contained in string, and
therefore which output parameters have significant values. Valid values are:
Asterisk form (that is, "*")0
Single processor form (for example, "2")1
Processor, PIN form (for example, "2,137")2
Name form (for example, "$PSRV")3
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.
PROCESSSTRING_SCAN_ Procedure 1181