TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-384
#SSMOVE Built-In Function
Considerations
•
#SSMOVE does not alter any tokens copied from the source buffer.
•
After a successful copy, #SSMOVE changes the source buffer position for a
subsequent #SSGET(V) to the position of the last token moved.
•
When #SSMOVE copies a token identified by a token map, it truncates or pads the
value according to the map specifications, and adjusts the
ZSPI^TKN^MAX^FIELD^VERSION header field of the destination buffer
appropriately.
•
You can use #SSMOVE to move an incomplete list (one with no end-list token) if,
and only if, you omit the DINDEX option or specify dest-index as zero. If you
supply a nonzero dest-index, meaning that you are requesting a replacement
operation, an incomplete list causes #SSMOVE to return a “token not found” status
code (-8).
•
If an error occurs on #SSMOVE, you can set the ZSPI^TKN^LASTERR and
ZSPI^TKN^LASTERRCODE indications in either the source buffer or the
destination buffer, depending on whether the error occurred on the logical
#SSGETV or #SSPUTV part of the copy.