TBDISPL summary

Floating command line
If the command line for a table display panel has been moved to the bottom position, and if no alternate placement has been specified for the long message line, the line directly above the repositioned command line is reserved (left blank) for the display of long messages. Otherwise, if a user entered erroneous data on that line, a long message could overlay that data.

ISPF adjusts display scrolling to account for the line reserved for long messages.
TBDISPL does not modify the table
TBDISPL itself does not modify the table. The dialog function can use the information entered by the user to determine what processing is to be performed and can modify the table accordingly.
Displaying an empty table
It is acceptable to invoke TBDISPL to display a table with no rows. The scrollable portion will consist only of the bottom-of-data marker. In previous versions, this resulted in a severe error, return code = 20, message = ISPT051.
CSRROW and auto-selection
Specifying the CSRROW parameter or control variable without setting the AUTOSEL parameter or control variable to "NO" results in the row being selected, even if the user did not explicitly select the row. This is called auto-selection.
Dual defaults for CAPS and JUST
In the )BODY section of a table display panel, input and output fields default to CAPS(ON) and JUST(LEFT). In the )MODEL section, they default to CAPS(OFF) and JUST(ASIS). These dual defaults exist to allow both new capability in this version and compatibility with previous versions of the product.
Effect of having a )REINIT or )PROC section
TBDISPL behavior is affected by whether a )REINIT or )PROC section is included in the panel definition. When a )REINIT or )PROC section is included, and the user makes no modification to the screen and presses the Enter key, TBDISPL returns control to the dialog function. On the other hand, if neither a )REINIT nor a )PROC section is included, and the user makes no modification to the screen and presses the Enter key, TBDISPL treats this as a "no operation", and control does not return to the dialog function. This is to allow both new capability in this version and compatibility with previous versions of the product.
Search arguments in conjunction with TBDISPL
Only search arguments specifying a forward scan through the table should be used in conjunction with TBDISPL. Otherwise, TBDISPL does not support scrolling through the display.

TBDISPL parameters and their categories:

           Required    Optional
 Service   Parameter   Parameters                  Categories

 TBDISPL   table-name                              in  name
                       [PANEL(panel-name)]         in  name
                       [MSG(message-id)]           in  name
                       [CURSOR(field-name)]        in  name
                       [CSRROW(table-row-number)]  in  number
                       [CSRPOS(cursor-position)]   in  number
                       [AUTOSEL(YES|NO)]           in  key
                       [POSITION(crp-name)]        out number
                       [ROWID(rowid-name)]         out number

in: Indicates that the parameter is used to pass information from the dialog to ISPF.
out: Indicates that the parameter is used to enable ISPF to pass information to the dialog. ISPF will create a variable with the indicated name.
key: Indicates it is a keyword parameter.
name: Indicates the value specified in the parameter is a name.
number: Indicates the value specified in the parameter is a number.

These items can appear in the )BODY section of a table display panel definition:
- Text
- Variables within text, such as "&XYZ"
- Input fields
- Output fields
- Dynamic areas that are not scrollable or extendable
- A graphic area that is not extendable.
These items cannot appear in the )BODY section of a table display panel definition:
- Dynamic areas that are scrollable or extendable
- More than one graphic area. This is true for any panel
- A graphic area that is extendable. Graphic areas are never scrollable.
These items can appear in the )MODEL section of a table display panel definition:
- Text
- Variable model lines
- Input fields
- Output fields.
These items cannot appear in the )MODEL section of a table display panel definition:
- Variables within text
- Dynamic areas
- Graphic areas.
During TBDISPL display, these user actions return control to the dialog function:
- Pressing the Enter key. See item 6 in TBDISPL summary for an exception.
- Entering the END or RETURN command
- Entering the UP or DOWN scroll command when data has been typed into the fixed or scrollable portion of the screen
- Entering the UP or DOWN scroll command when using dynamic table expansion and more rows are needed to satisfy the scroll request.
During TBDISPL display, these user actions do not return control to the dialog function:
- Pressing the Enter key when no data has been typed into the fixed or scrollable portion of the screen and the panel definition has neither a )REINIT nor a )PROC section
- Entering the UP or DOWN scroll command without typing data into the fixed or scrollable portion of the screen. Also, control does not return to the dialog function in either of these two cases:
  - Dynamic table expansion is not defined
  - Dynamic table expansion is defined and the table already contains enough rows to satisfy the scroll.
- Entering a system command other than UP, DOWN, END, or RETURN. For example: HELP, SPLIT, PRINT, or CURSOR.
- Entering an application command that selects another dialog.
These return codes are possible from TBDISPL:
0

There were zero or one selected rows. A scroll may be pending.

4

There were two or more selected rows.

8

The END or RETURN command was entered. Any number of rows, including zero, may have been selected.

12

The specified panel or message could not be found or the specified table was not open.

20

Severe error.
Levels of commands:
System commands

Provided by ISPF and always available to a user, unless explicitly overridden by an application. For example: END, UP, HELP, PRINT.

Application commands

Available to a user throughout operation of an application. For example: a command defined in the active command table that SELECTs another dialog.

Function commands

Meaningful only while operating a particular function within an application. For example, the dialog function can be designed so that TBSORT is invoked when the user enters "SORT" in the command field.
Commands can be entered by:
- Typing information into the command field and pressing the Enter key
- Pressing a function key
- Selecting an ATTENTION FIELD using the light pen or cursor select key.
TBDISPL does not rebuild the display until all selected rows have been successfully processed. Therefore, the CRPs of the displayed table will not match those of the actual table if the order or structure of the table is changed within a TBDISPL series. This can affect correct cursor row placement for a redisplay with message while in the series.
It is recommended that any verification of selected rows be done for all selected rows before performing operations that change the order or structure of the table. This requires that selected row IDs be saved until all selected rows have been retrieved and validated. This affects only the cursor placement as just described. The value passes back in the name specified with the POSITION keyword contains the CRP of the row in the actual table.