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


Chapter 2 Building a Screen : Task C: Enter PF Key, Scrolling, and Cursor Information

Task C: Enter PF Key, Scrolling, and Cursor Information
Purpose of this Task
This task is used to:
PF Key, Scrolling, and Cursor Information Segment
The following example illustrates the fields used to enter PF key, scrolling, and cursor information:

 
PFkey Assignments Scroll Amount Entry Default Cursor Position
--------------- ---------------- ----------------
Up: 7 Down: 8 Table: COMP_TITLE Table: EXPENSE_DATA
Left: 10 Right: 11 Field: SCROLL_AMT Field: MONTH
Validation Exit: 12
Help: 1 Refresh: 24

 
Assign PF Key Values
You can specify which PF keys are used to scroll screen tables, exit, and access help when the user displays a screen.
Exceptions
You can optionally re-assign all the PF key values except for the Refresh key. TIBCO Object Service Broker automatically assigns PF24 as the key to refresh your screen to its state after the last command was issued (works for primary and line commands).
Changes
To change the default for one of the PF keys, specify an integer denoting a previously undefined PF key. You can disable a function by typing zero into the field.
Validation Exit
The Validation Exit key is used to escape from situations when a validation failure occurred. Normally all PF keys are ignored until the screen passes validation; however, the Validation Exit key is processed during a validation failure. The result of using the Validation Exit key during a validation failure is that the exception VALIDATEFAIL is raised. For more information on the VALIDATEFAIL exception, refer to TIBCO Object Service Broker Programming in Rules.
Using the Validation Exit key on a valid screen has no effect and normal PF key processing takes place. This means you can assign another function to the Validation Exit key using the FCNKEYS table.
Define the Scroll Amount Entry
You can define one of the fields of a screen table to work with the scroll keys, if required. Your user can then use the Scroll field (displayed in the upper right corner of the screen) to specify a valid scroll amount when using your screen.
The following fields are used to define the scroll amount entry. Before you define these fields, you must define the field to work with the scroll keys using the Screen Table Painter. For more information on the Screen Table Painter, refer to Chapter 3, Defining Screen Tables.
 
Enter the name of the screen table. This must be an existing screen table in the screen you are defining and the screen table must contain the scroll field.
Enter the name of the field. This must be an existing field in the screen table named in the Table field. This is where the user specifies the scroll amount.
 
If you defined a scroll amount field for a screen in the scroll amount entry segment from the Screen Definer, make sure you initialize it with a value before you display the screen.
Define the Default Cursor Position
When the user first displays a screen, the cursor is located in the first position of the default field. If there is no default field, the cursor is located in the first unprotected field starting from left to right then top to bottom. You can define a default cursor position, if required.
The following fields are used to define the default cursor position. Before you define these fields, you must define the field for the default cursor position using the Screen Table Painter. For more information on the Screen Table Painter, refer to Chapter 3, Defining Screen Tables.
 
Enter the name of the screen table. This must be an existing screen table in the screen you are defining and the screen must contain the default field.
Enter the name of the field using the Screen Table Painter. This must be an existing field in the screen table named in the Table field. This field is where the cursor is to appear when the user displays the screen.

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