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


Chapter 3 Tools : SETCURSOR

SETCURSOR
Positions the cursor in the field of the screen table, in the specified screen. (C)
Invocation
CALL SETCURSOR(screen, table, field)
 
The name of the screen. Its syntax is C (fixed-length character string) with length 16.
Usage Notes
If you supply valid values for screen, table, and field, the cursor is positioned on the current occurrence of the field when the screen appears. If no current position is established, the call is ignored.
If the value for screen, table, or field is invalid, an error occurs.
If table or field are not specified, the call to SETCURSOR is ignored.
The screen server determines the type of terminal you are using (for example, Mod 5) and if any screen table is placed beyond the screen boundary, it treats it as an invisible table that cannot be viewed. Since the screen table is not displayable, calls to SETCURSOR are ignored.
Example
The following rule positions the cursor on the EMPLOYEE# field of the example screen and displays the screen below:

 
SETCURSOR_1;
_ ------------------------------------------------------------------------
_ ------------------------------------------------------------+-----------
_ EMPLOYEE_DATA.EMPNO=80000; | 1
_ INSERT EMPLOYEE_DATA('EMPLOYEE_SCR'); | 2
_ CALL SETCURSOR('EMPLOYEE_SCR', 'EMPLOYEE_DATA', 'EMPNO'); | 3
_ DISPLAY EMPLOYEE_SCR; | 4
_ ------------------------------------------------------------------------

 
Resulting Output
Executing this rule displays the following screen:

 
Employee Name Employee#
------------- ---------
80000

 

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