JCL MVA

Copies a value from the source 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 which is to receive the data.

source is the data to be copied. The source can be a direct or indirect reference to a buffer or select register, or a literal string.

NOTES

New values will be copies to the destination in ascending ASCII sequence.

If a new value already exists in the destination buffer, it will not be copied.

If the source data is multivalued, it will be copied to the destination without modification. This might create duplicate values and invalidate the ascending sequence.

If the destination is the input buffer, the buffer pointer will be left at the beginning of the destination parameter.

EXAMPLE 1

PIB contains: ABC^DEF^GHI

Command	File Buffer 1 Before	File Buffer 1 After
`MVA &1.1 %3`	`000 Key 001 FFF]HHH 002 YYY`	`000 Key 001 FFF]GHI]HHH YYY`

EXAMPLE 2

File buffer 2 contains:

000 Key 001 GG]YY 002 AAA

Command	File Buffer 1 Before	File Buffer 1 After
`MVA &1.1 &2.1`	`000 Key 001 FFF]HHH 002 YYY`	`000 Key 001 FFF]GG]YY]HHH YYY`

JCL