These user actions will not result in control returning
to the dialog function:
- Typing no input and pressing the Enter key (assuming that neither a )REINIT nor a )PROC section exists in the panel definition).
- Typing no input and entering the UP or DOWN command. This is true if scroll return to function is not defined, but there are enough rows to satisfy the scroll request.
- Entering a system command other than UP, DOWN, END, or RETURN. For example, HELP, SPLIT, or CURSOR.
- Entering an application command that SELECTs another dialog.
After display of a panel using TBDISPL, and before control returns to the dialog function:
- The contents of all input fields in the fixed portion are stored in the dialog variable specified in the panel definition.
- If there were no selected rows to process, the CRP is set to TOP
(zero)
and the variable values are unpredictable
.
If scroll return to function is defined and rows are needed to satisfy
the scroll request, the scroll return system variables are set in
the function pool. - If there were any selected rows, the CRP is positioned to the
first of these, and the row is retrieved from the table. The values
of all variables from that row are stored into the corresponding dialog
variables. All input fields in the selected model set on the display
are then stored in the corresponding dialog variables. The input fields
can or cannot correspond to variables in the table.
Variable ZTDSELS contains the number of rows that were selected. The value of ZTDSELS can be checked in the )PROC section of the panel definition, or it can be checked by the dialog function.
- The row number that corresponds to the first model set currently displayed on the screen is stored in the system variable ZTDTOP. If, in a dialog, you want to reposition the scrollable data as the user last saw it, you must reposition the CRP to the row number stored in ZTDTOP before reinvoking the TBDISPL service with the panel name specified. This is not necessary if the panel name is not specified.