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

The SPI Procedures

SPI Programming Manual—427506-006

3-7

SSPUT and SSPUTTKN Procedures

The SSPUT and SSPUTTKN procedures insert tokens in an SPI buffer previously

initialized by SSINIT. The two procedures are identical except for the type of the

token-id parameter (SSPUT passes token-id by reference and SSPUTTKN

passes it by value) and the consequent fact that SSPUTTKN cannot be used with a

token map.

General Syntax

buffer input, output

INT .EXT:ref:*

is the SPI buffer in which tokens are placed.

token-id input

INT .EXT:ref:* (SSPUT)

INT(32):value (SSPUTTKN)

is a token code or (for SSPUT only) a token map. This parameter either identifies

the token being supplied or indicates a special operation. In the latter case, the

interpretation of the

token-value parameter can vary; see Special Operations

With SSPUT and SSPUTTKN on page 3-8

token-value input

STRING .EXT:ref:*

if present, is the value of the token. Its data representation is determined by the

token-type field of the

token-id.

count input

INT:value

is the token count. The

token-value parameter is an array of count elements,

each of which is described by the

token-id. If not supplied, the count defaults to

ssid input

INT .EXT:ref:6

SSPUT ( buffer ! i/o

SSPUTTKN , token-id ! i

, [ token-value ] ! i

, [ count ] ! i

, [ ssid ] ) ! i