Guardian Procedure Calls Reference Manual

PROCESSSTRING_SCAN_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The PROCESSSTRING_SCAN_ procedure scans an input string for a process string and returns
the corresponding process handle or a single component of the process string converted to internal
form. Device names are optionally accepted in the input string. See Considerations (page 1182) for
the definition of process string.
Syntax for C Programmers
#include <cextdecs(PROCESSSTRING_SCAN_)>
short PROCESSSTRING_SCAN_ ( char *string
,[ short length ]
,[ short *length-used ]
,[ short *processhandle ]
,[ short *stringtype ]
,[ char *name ]
,[ maxlen ]
,[ short *namelen ]
,[ short *cpu ]
,[ short *pin ]
,[ short options ] );
The parameter maxlen specifies the maximum length in bytes of the character string pointed to
by name, the actual length of which is returned by namelen. All three of these parameters must
either be supplied or be absent.
Syntax for TAL Programmers
error := PROCESSSTRING_SCAN_ ( string:length ! i:i
,[ length-used ] ! o
,[ processhandle ] ! o
,[ stringtype ] ! o
,[ name:maxlen ] ! o:i
,[ namelen ] ! o
,[ cpu ] ! o
,[ pin ] ! o
,[ options ] ); ! i
Parameters
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
1180 Guardian Procedure Calls (P)