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

SPI Programming in TAL
SPI Programming Manual427506-006
9-5
SSMOVE and SSMOVETKN
SSMOVE and SSMOVETKN
The SSMOVE and SSMOVETKN procedures are identical except for the type of the
token-id parameter (SSMOVE passes token-id by reference and SSMOVETKN
passes it by value) and the consequent fact that SSMOVETKN cannot be used with a
token map. In TAL programs, you can use SSMOVETKN 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 SSMOVE. You must use SSMOVE when
supplying a token map.
Examples
For example programs written in TAL, see Appendix E, SPI Programming Examples.
{ status := } { SSGET } ( buffer ! i/o
{ CALL } { SSGETTKN } , token-id ! i
, [ token-value ] ! i/o
, [ index ] ! i
, [ count ] ! i/o
, [ ssid ] ) ; ! i/o
{ status := } { SSMOVE } ( token-id ! i
{ CALL } { SSMOVETKN } , source-buffer ! i/o
, [ source-index ] ! i
, dest-buffer ! i/o
, [ dest-index ] ! i
, [ count ] ! i/o
, [ ssid ] ) ; ! i