Default actions created by a DIALOG block

Default actions ease the implementation of the controller by providing expected actions.

According to the sub-dialogs defined in a (declarative or procedural) DIALOG block, the runtime system creates a set of default actions. These actions are provided to ease the implementation of the controller. For example, when using an INPUT ARRAY sub-dialog, the dialog instruction will automatically create the insert, append and delete default actions.

Table 1 lists the default actions created for the DIALOG interactive instruction, according to the sub-dialogs defined:

Table 1. Default actions created for the DIALOG block
Default action Control Block execution order
help

Shows the help topic defined by the HELP clause.

Only created when a HELP clause or option is defined for the sub-dialog.

insert

Inserts a new row before current row.

Only created if INPUT ARRAY is used; action creation can be avoided with INSERT ROW = FALSE attribute.

append

Appends a new row at the end of the list.

Only created if INPUT ARRAY is used; action creation can be avoided with APPEND ROW = FALSE attribute.

delete

Deletes the current row.

Only created if INPUT ARRAY is used; action creation can be avoided with DELETE ROW = FALSE attribute.

nextrow

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

Only created if DISPLAY ARRAY or INPUT 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 or INPUT 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 or INPUT 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 or INPUT 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 seeks to the row matching the value.

Only created if the context allows built-in find.

findnext

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

Only created if the context allows built-in find.

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