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

SPI Programming in TAL
SPI Programming Manual427506-006
9-4
SSINIT
SSINIT
SSNULL
SSPUT and SSPUTTKN
The SSPUT and SSPUTTKN 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. In TAL programs, you can use SSPUTTKN when supplying a token code
for the
token-id parameter; doing so avoids the need to store the token code in a
temporary variable before passing it to SSPUT. You must use SSPUT when supplying
a token map.
SSGET and SSGETTKN
The SSGET and SSGETTKN procedures are identical except for the type of the
token-id parameter (SSGET passes token-id by reference and SSGETTKN
passes it by value) and the consequent fact that SSGETTKN cannot be used with a
token map. In TAL programs, you can use SSGETTKN when supplying a token code
for the
token-id parameter; doing so avoids the need to store the token code in a
temporary variable before passing it to SSGET. You must use SSGET when supplying
a token map.
{ status := } SSINIT ( buffer ! o
{ CALL } , buffer-length ! i
, ssid ! i
, header-type ! i
, command ! i
, [ object-type ] ! i
, [ max-resp ] ! i
, [ server-version ] ! i
, [ checksum ] ! i
, [ max-field-version ] ) ; ! i
{ status := } SSNULL ( token-map ! i
{ CALL } , struct ) ; ! o
{ status := } { SSPUT } ( buffer ! i/o
{ CALL } { SSPUTTKN } , token-id ! i
, [ token-value ] ! i
, [ count ] ! i
, [ ssid ] ) ; ! i