Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Building a Screen : Task B: Specify Screen Tables

Task B: Specify Screen Tables
Purpose of this Task
This task is used to specify the attributes and position of each screen table on the screen. There are two types of attributes you can specify:
Screen Table Segment
The following example illustrates the fields used to specify screen tables. To view the ShowPartial Occs and Empty Occs fields to the right, press PF11.

 
SCREEN TABLES: Origin Max Title Fix Last
Name Row Col occ Scroll Validation Rule Rows Col Row Col
---------------- --- --- --- - --------------- -- --- --- ---
_ COMP_TITLE 1 1 1 N 0 0 0 0
_ EXPENSE_DATA 5 1 * Y VALID_NUMBER 5 0 0 0
_ EXPENSE_TOTAL -5 1 1 N 0 0 0 0
_ FCNKEY_SPECS -1 1 1 N 0 0 0 0

 
Defining Required Screen Table Attributes
The following fields are used to define the required screen table attributes. For each field, press PF1 for valid values.
 
This field indicates the name of the screen table. Since screen tables are shareable, you can type the name of an existing screen table or create a new screen table. The maximum number of screen tables that can be specified for a screen is 25.
This field identifies the first row of the screen table. The screen length used for validation is the number of rows on your screen. Negative numbers indicate the distance from the bottom of the screen to the row. Positive numbers indicate the distance from the top of the screen to the row.
This field identifies the first column of the screen table. The screen width used for validation is the number of columns on your screen. The maximum width of a screen table is 254 characters. Negative numbers indicate the distance from the right side of the screen to the column.
This field specifies the maximum number of row occurrences that can be inserted into the screen table. This is not the maximum number of occurrences that can appear at one time. An asterisk (*) indicates an unlimited number of occurrences.
Defining Optional Screen Table Attributes
The following fields are used to define optional screen table attributes. To view additional fields, press PF11. For valid values, press PF1.
 
This field indicates the name of the validation rule to be executed during a screen display. The rule ensures that changes made to the data in a screen table satisfy criteria specified in the rule. The validation rule is executed once per display and is also executed after any existing reference check is performed on a field.
Refer to Chapter 3, Defining Screen Tables for more information on reference checking and TIBCO Object Service Broker Managing Data for more information on validation rules.
This field specifies the number of lines to be treated as title rows in scrollable screen tables. The first <nn> lines of the screen table remain on the screen when scrolling up or down.
This field is used for scrollable screen tables. The Fix Col field identifies the number of columns in a screen table that are to remain on the physical screen when the screen is scrolled left or right. These columns are typically grouped together to form a column of data.
Literal text created in the Screen Table Painter is split based on these fixed columns. After you save the screen definition, a message could appear on the workbench to inform you of overlap conditions. Press PF2 to display a list of screen fields that span the fixed column boundary.
This field specifies the last row the screen table occupies on the screen, so that you can set the height of the screen table on the screen. If it is set to 0 or null, the screen table fills all the rows until another screen table starts. If you set this attribute, you must also set the last column attribute.
This field specifies the last column the screen table occupies on the screen, so that you can specify the right edge of the screen table on the screen. If it is set to 0 or null, the screen table occupies the entire remainder of columns. If you want to have screen tables side by side on the screen, you must use this attribute to set the right edges of the screen tables. If you set this attribute, you must also set the last row attribute.
This field determines whether part of an occurrence should appear on the screen if the occurrence spans multiple rows (or lines) and cannot fit on one screen.
This field controls the number of empty occurrences of a screen table that appear on the user’s terminal. The Empty Occs specification provides a quick method for developers to display screen occurrences for data entry applications automatically, using either the default null specification or a value greater than zero. A value of zero disables this feature and forces the application rules to control the screen display content through INSERTs of the screen table prior to the screen DISPLAY.
 
For a screen table to appear, it must begin on the displayable screen image. For example, if a screen table begins in column 81 and it appears on a screen that is only 80 columns wide, it is not visible even by scrolling. The number of displayed columns in the screen table is the maximum amount scrolled when scrolling the table left or right.
Excluding Screen Tables
If after adding a screen table, you want to exclude or remove it from the current screen definition, complete the following tasks:
1.
2.
The screen table is excluded from the definition; it is not deleted from the system. You remain in the screen you are defining.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved