Modifying Action Diagrams › Understanding Built-In Functions › Selection Parameters for Date Built-In Functions › *MOVE ARRAY Built-in Function

*MOVE ARRAY Built-in Function

The *MOVE ARRAY built-in function allows you to move multiple instances of an array. To specify an array subfield, specify the Array Subfield name, Array Name and Array Index (Element Number).

Use *MOVE ARRAY in the following ways:

• Move the value of one array subfield into another array subfield, either in the same array or a different array.
• Move the value of an array subfield into a field in a non-array context, for example, WRK or LCL.
• Move the value of a field in a non-array context or a constant value or a valid condition into an array subfield.

Note: In all these cases, the special value *ALL can be used in place of a field name. *ALL pertains to all fields in the specified array index.

For more information and examples, see the*MOVE ARRAY Examples.

When using the *MOVE ARRAY function, the array must be a multiple-instance array, using the new ARR context, or a parameter context where the parameter is defined as a multiple-instance array parameter.

For a working scenario using the *MOVE ARRAY built-in function, see the Appendix How to Create a Deployable Web Service Using a Multiple-instance Array.