TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-382
#SSMOVE Built-In Function
#SSMOVE Built-In Function
Use #SSMOVE to copy tokens from one message buffer to another. #SSMOVE
performs a sequence of #SSGETV and #SSPUTV operations.
option
can be any of these:
COUNT count
specifies the maximum number of token values to move, unless token-id is
a list token; in that case, count specifies the maximum number of lists to move.
If you omit this option, count defaults to 1.
DINDEX dest-index
if dest-index is greater than zero, it identifies the first occurrence of token-
id to be replaced in the destination buffer. A value of 1 specifies that
replacement is to start with the first occurrence of the token code, 2 specifies
the second occurrence, and so on. If the specified occurrences are not found in
the destination buffer, #SSMOVE appends the tokens being moved to the end
of the buffer.
If dest-index is zero, it directs #SSMOVE to add the tokens from the source
buffer to the end of the destination buffer. If you omit this option, dest-index
defaults to zero.
SINDEX source-index
if source-index is greater than zero, it identifies the first occurrence of
token-id to be copied from the source buffer. One occurrence or multiple
occurrences can be moved, depending on the value of the count parameter. A
source-index value of 1 specifies that copying is to start with the first
occurrence of the token code, 2 specifies the second occurrence, and so on.
If source-index is zero, #SSMOVE selects the next occurrence of the token
code after the current position in the source buffer. If you omit this option,
source-index defaults to zero.
SSID ssid
is a subsystem ID that qualifies the token ID. If you omit it, or if it is equal to
zero (0.0.0), it defaults to the subsystem ID of the current list or, if the current
position is not in a list, to the subsystem ID specified in the SPI message
header (ZSPI^TKN^SSID). The version field of SSID is not used in searching
the source buffer.
#SSMOVE [ / option [ , option ] ... / ]
source-var dest-var token-id