MVA

Copies a value from the source field to the destination buffer and stores it as a multivalue.

Syntax

MVA destination source

Syntax Elements

destination is a direct or indirect reference to a buffer or select register where you want the data copied to.

source is the data you want to copy. The source can be:

  • a direct or indirect reference to a buffer or select register that contains the data you want to copy.
  • a string of one or more characters.

Operation

The new value is stored in ascending ASCII sequence.

If the source data already exists in the destination buffer, it is not duplicated.

If the source itself is multivalued, it is copied, as is, to the destination. This might create duplicate values and destroy the ascending sequence (see Example 2).

If the destination is the input buffer, the buffer pointer is positioned at the beginning of the parameter specified by the destination.

Example 1

Command

File Buffer 1 Before

File Buffer 1 After

MVA &1.1 &1.3

000 1494
001 DEF]GHI
002 JKL
003 FOR

000 1494
001 DEF]FOR]GHI
002 JKL
003 FOR

Example 2

Command

File Buffer 3 Before
and After

File Buffer 1 Before

File Buffer 1 After

MVA &1.1 &3.2

000 AAA
001 BBB
002 FX]Y]Z
003 END

000 ABC
001 DEF]GHI
002 JKL
003 MNO

000 ABC
001 DEF]FX]Y]Z]GHI
002 JKL
003 MNO