Arrays

Describes the mapping and assignment of interface fields that contain an OCCURS clause.

When mapping or assigning fields that are an array (have an OCCURS clause), all occurrences are automatically mapped by default. However, if you are mapping or assigning a field manually, use an asterisk (*) to show that all occurrences of that field are mapped or assigned (default), or define it using a subscript to specify a particular occurrence. For example:

fieldname(*)

or

fieldname(4)

For mappings, you cannot normally change the field name from the Mapping dialog box because the purpose of the Mappings function is to specify the mappings for a particular interface field. However, if the interface field has the Occurs property, you can edit the field name so as to specify a subscript. Changing anything other than the subscript results in an error.

By default, for an item with the Occurs property, each occurrence is mapped or assigned to the corresponding occurrence of the application data item. If the number in the Occurs column does not match the OCCURS clause of the originating data item, a warning message appears before the Mapping or Assignment dialog box opens. In this case, use the dialog box to specify mappings or assignments for the individual occurrences. See To map an interface field and To assign a value to a screen, COMMAREA, or work field for details.