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


Chapter 15 Editing Rules : Expanding Token Information

Expanding Token Information
While editing a rule, you can display information in browse format for the following types of tokens: rules, tables, fields, screens, reports, and routines. Selected information appears for each token type. You can expand a token named in the rule using a function key or primary command, or expand on any allowable token type not named within the rule using a primary command.
Types of Token Information Available
The following list outlines what kind of information appears, based on the type of token:
 
If the field is a global field (a field defined in the centralized field dictionary table in your TIBCO Object Service Broker database), a summary of global usage appears.
The name of the screen, and the names of its screen tables and some of their attributes. Within the display, the screen tables can be expanded to the level of screen fields.
The name of the report, and the names of its report tables and some of their attributes. Within the display, the report tables can be expanded to the level of report fields.
Expanding a Token at the Cursor Position
Positioning your cursor on a token name and pressing PF14 causes the screen to split horizontally into two portions. As shown in the following screen, the upper portion displays the rule being edited and the lower portion displays information about the selected token in a browsable format. To scroll in either portion, position your cursor in the desired portion and press PF7 to scroll up or PF8press to scroll down.

 
RULE EDITOR ===> SCROLL: P
EMPLOYEES_RAISE(JOBTITTLE, REGION);
_ LOCAL RAISE, RATE;
_ ---------------------------------------------------------------------------
_ JOBTITLE = 'SENIOR ANALYST'; | Y N N
_ JOBTITLE = 'ANALYST'; | Y N
_ ------------------------------------------------------------+---------------
_ RATE = 0.1; | 1
_ RATE = 0.05; | 1
_ RATE = 0.02; | 1
_ GET EMPLOYEES(REGION) WHERE POSITION = JOBTITLE; | 2
PFKEYS: 1=HELP 3=END 12=CANCEL 13=PRINT 14=EXPAND 2=DOCUMENT 22=DELETE
+---------------------------- TDS Table : EMPLOYEES -------------------------+
| PARAMETER TYPE SYNTAX LENGTH DECIMAL |
| ---------------- - - ------ ------- |
| REGION I C 16 0 |
| |
| FIELD TYPE SYNTAX LENGTH DECIMAL KEY |
| ---------------- - - ------ ------- - |
| EMPNO I P 3 0 P |
| LNAME S C 22 0 S |
| PFKEYS: 7=UP 8=DOWN 15=CLOSE |
+----------------------------------------------------------------------------+

 
Displaying Rule, Routine, or Table Information
To display a rule, routine, or table, position your cursor on the desired token name and press PF14. Because the information appears in browse mode, you can also display the rule you are currently editing.
Displaying Screen Information
To display screen information, the cursor must be positioned on the screen name within a DISPLAY statement. After positioning the cursor, press PF14.
Displaying Report Information
To display report information, the cursor must be positioned on the report name within a call to the $SETRPTMEDIUM or $RPTPRINT tools or within a PRINT statement. After positioning the cursor, press PF14.
Expanding With the Primary Command EXPAND
The primary command EXPAND also invokes the expand facility. You specify EXPAND using the format:
EXPAND token_name token_type
token_ type is optional and can be one of the following: RULE, REPORT or RPT, SCREEN or SCR, TABLE or TBL. If no type is specified the search hierarchy is: reports, screens, tables, rules, and routines. The first match found is expanded within a display area.
The following shows an example of the command EXPAND:
RULE EDITOR ===> EXPAND EMP_EXPENSE RPT<Enter>
Nesting Expanded Displays
You can expand more than one token at a time. This is known as nesting. To nest an expanded display, position the cursor on the desired object within the display and press PF14.
Nesting expanded displays is permitted for rules, screens, and reports. Within screens you can also nest screen tables, and within reports you can also nest report tables. Nesting is not permitted from within a routine, table, or field.
Closing the Expanded Display
To close an expanded display and exit to the previous display, press PF15. If you press PF15 in the top-most display, it closes the expand facility. If you are in a lower nested level, press PF15 outside of the expanded display to exit the expand facility, or type in the command CLOSE in the primary command field and press Enter. Either method closes all open displays.
See Also
TIBCO Object Service Broker Managing Data about tables.
TIBCO Object Service Broker Defining Reports about reports.
TIBCO Object Service Broker Defining Screens and Menus about screens.
TIBCO Object Service Broker Shareable Tools about the use of tools, including routines.

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