SPI Programming Manual (G06.24+, H06.03+, J06.03+)

The SPI Procedures
SPI Programming Manual—427506-006
3-36
Examples
version
is either a string of digits that represents a TOSVERSION-format (Ann) or a value
from 0 to 65535.
The 0.0.0 form is used to represent the null subsystem ID. Its internal representation is
binary zero. The number of zeros in each field can vary. For example, 000.0.000 is
equivalent to 0.0.0
Examples
These are examples of the external form of the subsystem ID:
TANDEM.SAFEGUARD.D40
TANDEM.94.0
0.0.0
TEXTTOSSID Procedure
TEXTTOSSID scans a character string, expecting to find the external representation of
a subsystem ID starting in the first byte (no leading spaces are accepted). It returns the
internal representation of the subsystem ID that it finds.
General Syntax
len returned value
INT
returns the number of characters placed from
chars. Zero is returned if an error
occurs.
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 a description of the external form of
the subsystem ID, see Considerations
on page 3-37.
ssid output
INT .EXT:ref:6
receives the internal form of the subsystem ID contained in
chars.
len := TEXTTOSSID ( chars !i
, ssid !o
[, status ] ); !o