Default actions in DISPLAY ARRAY

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

Field validation occurs and different DISPLAY 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 created for the DISPLAY ARRAY dialog
Default action Description
accept

Validates the DISPLAY ARRAY dialog (validates current row selection)

Creation can be avoided with ACCEPT attribute.

cancel

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

Creation can be avoided with CANCEL attribute.

close

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

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

help

Shows the help topic defined by the HELP clause.

Only created when a HELP clause is defined.

nextrow

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

Only created if DISPLAY ARRAY used 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 ARRAY used 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 ARRAY used 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 ARRAY used with a screen record having only one row.

find

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

Only created if the context allows built-in find.

findnext

Searches for the next row matching the value entered during the fglfind dialog.

Only created if the context allows built-in find.

The accept and cancel default actions can be avoided with the ACCEPT and CANCEL dialog control attributes:
DISPLAY ARRAY arr TO sr.* ATTRIBUTES( CANCEL=FALSE, ... )
  ...