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

The SPI Procedures

SPI Programming Manual—427506-006

3-34

SSIDTOTEXT Procedure

The SSIDTOTEXT procedure converts an internal form subsystem ID (SSID) to its

external representation.

General Syntax

len returned value

INT

returns the number of characters placed into

chars. Zero is returned if one of the

errors (0, 29), (4,0), or (8,0) occurs. Some other errors may prevent the subsystem

name from being obtained. In those cases, a text representation of the subsystem

ID is still produced, but it contains the subsystem number rather than the

subsystem name.

ssid input

INT .EXT:ref:6

contains the subsystem ID to be converted into displayable form.

chars output

STRING .EXT:ref:*

is the string into which the displayable representation of ssid is placed. The

number of characters placed into

chars is returned as len. For a description of

the external form of the subsystem ID, see Considerations

on page 3-35.

The caller is responsible for supplying enough space in

chars to hold the result.

No more than 23 characters can be placed into

chars.

len := SSIDTOTEXT ( ssid !i

, chars !o

[, status ] ); !o