Guardian Procedure Calls Reference Manual

TEXTTOSSID Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The TEXTTOSSID procedure scans a character string, expecting to find the external representation
of a subsystem ID starting in the first byte (no leading spaces accepted). It returns the internal
representation of the subsystem ID it finds.
Syntax for C Programmers
#include <cextdecs(TEXTTOSSID)>
short TEXTTOSSID ( char *chars
,short *ssid
,[ __int32_t *status ] );
Syntax for TAL Programmers
len := TEXTTOSSID ( chars ! i
,ssid ! o
,[ status ] ); ! o
Parameters
chars
input
STRING .EXT:ref:*
is the string containing the external representation of a subsystem ID. The number of characters
scanned is returned as len. For the description of the external form of a subsystem ID, see
Considerations.
ssid
output
INT .EXT:ref:6
receives the internal form of the subsystem ID contained in chars.
status
output
INT(32) .EXT:ref:1
a status code which indicates any problems encountered (the two numbers describe the two
halves of the INT(32) value):
No error.(0,0)
Problem with calling sequence:(0,x)
required parameter missing29x:
insufficient stack space632
1418 Guardian Procedure Calls (T-V)