7.2.1 ADD_ENTRY Parameters
Specifies the name of the list to which the new entry should be added.
The default value of *FIRST specifies that the first list declared in the RDML program by a DEF_LIST (define list) command is the list to be used (which may be a browse or a working list).
If a list name is used then the list name must be declared elsewhere in the RDML program by a DEF_LIST (define list) command.
Specifies whether or not any fields in the list that have special attribute *SELECT should be set to blanks before the new entry is added to the list. Refer to the DEF_LIST command for more details.
This parameter is only valid for browse list processing. It is ignored for working list processing.
Specifies the mode to be set for the entry being added. This overrides the mode that has been set by the SET_MODE command (refer to the SET_MODE command).
The default is *CURRENT which uses the current mode that has been set by the SET_MODE command. Other allowable values are *ADD, *CHANGE, *DELETE and *DISPLAY. A user field name may also be specified, and must be alphanumeric with a length of 3, and must contain one of the values "ADD", "CHG", "DLT" or "DIS".
This parameter is only valid for browse list processing. It is ignored for working list processing.
Specifies the position in the list where the entry is to be added.
The default value of *END specifies that the entry will be added at the end of the list. This is the only value that will be accepted for a browse list.
The other special value of *START specifies that the entry will be added at the beginning of the list, before the current first entry. It is equivalent to specifying the numeric value of 0. This value is only valid for a working list.
A numeric value or field name specifies the number of the entry after which the new entry will be added. Specifying 0 is equivalent to the special value of *START. Apart from 0, the entry number specified must exist in the list when the ADD_ENTRY is executed. A numeric value or field name is only valid for a working list.