Guardian Programming Reference Summary for pTAL and TAL

Procedure Calls Summary (O-Q)
Guardian Programming Reference Summary for pTAL and TAL—522631-001
7-48
PROCESSSTRING_SCAN_
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.
error := PROCESSSTRING_SCAN_ ( string:length
,[ length-used ]
,[ processhandle ]
,[ stringtype ]
,[ name:maxlen ]
,[ namelen ]
,[ cpu ]
,[ pin ]
,[ options ] );
error, INT returned value
string:length, STRING .EXT:ref:*,INT:value input:input
length-used, INT .EXT:ref:1 output
processhandle, INT .EXT:ref:10 output
stringtype, INT .EXT:ref:1 output
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”)
name:maxlen, STRING .EXT:ref:*,INT:value output:input
namelen, INT .EXT:ref:1 output
cpu, INT .EXT:ref:1 output
pin, INT .EXT:ref:1 output
options, INT:value input
<0:14> Reserved (specify 0).
<15> = 1
= 0
Device names (up to eight characters) are to be accepted in the input string.
Device names are not to be accepted in the input string.