Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-263
PROCESSSTRING_SCAN_ Procedure
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the operation.
string:length input:input
STRING .EXT:ref:*, INT:value
is a character string to be searched to find a valid process string.
string must be
exactly
length bytes long. A valid process string must begin at the first character
of
string. It can occupy the entire length of string, or it can occupy the left-
hand portion and be followed by a character that is not valid in that part of a
process string. If a node name is not present in 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:
0 Asterisk form (that is, “*”)
1 Single processor form (for example, “2”)
2 processor, PIN form (for example, “2,137”)
3 Name form (for example, “$PSRV”)