Default actions in INPUT ARRAY

When an INPUT ARRAY instruction executes, the runtime system creates a set of default actions.

Field validation occurs and different INPUT ARRAY control blocks are executed based on the invoked default action.

This table lists the default actions created for this dialog:

Table 1. Default actions for INPUT ARRAY
Default action Description
accept

Validates the INPUT ARRAY dialog (validates fields and leaves the dialog)

Creation can be avoided with ACCEPT attribute.

cancel

Cancels the INPUT ARRAY dialog (no validation, INT_FLAG is set to TRUE)

Creation can be avoided with CANCEL attribute.

close

By default, cancels the INPUT ARRAY dialog (no validation, INT_FLAG is set to TRUE)

Default action view is hidden. See Implementing the close action.

insert

Inserts a new row before current row.

Creation can be avoided with INSERT ROW = FALSE attribute.

append

Appends a new row at the end of the list.

Creation can be avoided with APPEND ROW = FALSEattribute.

delete

Deletes the current row.

Creation can be avoided with DELETE ROW = FALSEattribute.

help

Shows the help topic defined by the HELP clause.

Only created when a HELPclause is defined.

nextrow

Moves to the next row in a list displayed in one row of fields.

Only created if DISPLAY ARRAYused with a screen record having only one row.

prevrow

Moves to the previous row in a list displayed in one row of fields.

Only created if DISPLAY ARRAYused with a screen record having only one row.

firstrow

Moves to the first row in a list displayed in one row of fields.

Only created if DISPLAY ARRAYused with a screen record having only one row.

lastrow

Moves to the last row in a list displayed in one row of fields.

Only created if DISPLAY ARRAYused with a screen record having only one row.

find

Opens the fglfind dialog window to let the user enter a search value, and seeks the row matching the value.

Only created if the context allows built-in find.

findnext

Seeks the next row matching the value entered during the fglfind dialog.

Only created if the context allows built-in find.

The insert, append, delete, accept and cancel default actions can be avoided with dialog control attributes:
INPUT ARRAY arr TO sr.* ATTRIBUTES( INSERT ROW=FALSE, CANCEL=FALSE, ... )
   ...