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

The SPI Procedures
SPI Programming Manual—427506-006
3-24
SSMOVE and SSMOVETKN Procedures
SSMOVE and SSMOVETKN Procedures
The SSMOVE and SSMOVETKN procedures copy tokens from one SPI buffer to
another. One call can copy a single token, a sequence of tokens with the same token
code, or a list.
SSMOVE performs a sequence of SSGET and SSPUT operations. Likewise,
SSMOVETKN performs a sequence of SSGETTKN and SSPUTTKN (or SSGET and
SSPUT) operations. The two procedures produce the same results, and they 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.
General Syntax
token-id input
INT .EXT:ref:* (SSMOVE)
INT(32):value (SSMOVETKN)
is a token code or (for SSMOVE only) a token map that identifies the token to be
copied. If
token-id is a list token, the entire list is copied.
source-buffer input, output
INT .EXT:ref:*
is the SPI buffer containing the token or tokens to be copied.
source-index input
INT:value
if greater than zero, identifies the first occurrence of
token-id to be copied from
the source buffer. (One or more occurrences can be copied, depending on the
value of
count.) A source-index value of 1 specifies that the copy is to start
with the first occurrence of the token code, a value of 2 specifies the second
occurrence, and so on.
if zero or not supplied, directs SSMOVE or SSMOVETKN to start with the next
occurrence of the token code after the current-token pointer in the source buffer.
SSMOVE ( token-id ! i
SSMOVETKN , source-buffer ! i/o
, [ source-index ] ! i
, dest-buffer ! i/o
, [ dest-index ] ! i
, [ count ] ! i/o
, [ ssid ] ) ! i