SCREEN$
- Purpose
- Passes messages that control the behavior of the screen.
- Used By
- CONNECT SCREEN from a method.
Remarks in italics below indicate how the screen behaves in certain circumstances, and are provided for information.
Contents
| SCREEN$[ALL] | Prior to a CONNECT SCREEN directive, SCREEN$ can be dimensioned to 16 and the values shown below can be set. The values will determine certain SCREEN characteristics. |
|---|---|
| SCREEN$[0] | Execution status. |
| If SCREEN$[0]=“OO3A” and NUM(SCREEN$[3])=0 on entry, then SCREEN$[4] contains the secondary key value directly from the sort file, instead of the display values of the sort fields. | |
| SCREEN$[1] | Screen name. |
| SCREEN$[2] | Key of last record edited. |
| SCREEN$[3] | Sort number. |
| SCREEN$[4] | Key value of record to edit. |
| SCREEN$[5] | Format data string upon exit. |
| SCREEN$[6] | Error status upon exit (when “F” option used in [15]) “X”=failed. |
| SCREEN$[7] | CONNECT message. |
| If “AUTO-EXIT” found in CONNECT message or SCREEN$[15]=“F”: 1. Set SCREEN$[13]=“YY Y”. 2. If SCREEN$[4]=“” then put key value from format data area into MSG$[4]. | |
| SCREEN$[8] | View name for F9. |
| SCREEN$[9] | LET SCREEN[9]=$0102030A0B$ This will only allow entry into elements 1,2,3,10, and 11 as they appear on the screen. |
| SCREEN$[10] | Not used. |
| SCREEN$[11] | Last record read or changed (set after each read and after each record is successfully added or changed). |
| SCREEN$[12] | After read method. |
| SCREEN$[13] | On/Off indicators (YN) (space applies defaults): | ||
|---|---|---|---|
| (1,1) | Exit screen after editing first record. The default is N. | ||
| (2,1) | Skip maintenance mode window. The default is N. | ||
| (3,1) | Auto key range for views. The default is N. | ||
| (4,1) | Skip printing mode. The default is N. | ||
| (5,1) | Sort change allowed. The default is Y. | ||
| (6,1) | Print screen description in window title: | ||
| “ “ | Do not print title. | ||
| “C” | Center heading. | ||
| “R” | Right justify heading. | ||
| “L” | Left justify heading | ||
| The default is “ “. | |||
| (7,1) | Clear key value. The default is N. | ||
| (8,1) | Create window with border. The default is Y. | ||
| (9,1) | Skip F7 Special Functions Menu: “N” - The Screen Special Functions menu is displayed “Y” - The user is taken directly to the Help Type toggle menu without first displaying the Special Functions Menu. | ||
| SCREEN$[14] | Application help code (LLHHHHHHHH). The user can toggle between Application help, Data help, and General help by pressing F7 on any field to display the Help type toggle menu. | ||
| SCREEN$[15] | Maintenance modes: | ||
| “ “ | All modes are available. | ||
| “A” | Add. | ||
| “C” | Change. | ||
| “D” | Delete. | ||
| “I” | Inquire. | ||
| “F” | Logical screen entry. In this mode, records cannot be added, changed, or deleted. If SCREEN$[15]=“F” Set SCREEN$[13]=“YY Y” | ||
| Modes can be used in any combination, except for the “F” mode. For example, IC starts in inquiry mode and enables only change and inquiry. | |||
| An attempt is made to open the file and read using the key value supplied in SCREEN$[4]. If the file open and read are successful, the data read from the record is supplied as the default data for screen entry. Otherwise, format defaults are applied. The screen terminates after the last field is entered. |
| SCREEN$[16] | Window disposition on exit: | |
|---|---|---|
| “N” | Delete screen window before exit. (Default) | |
| “Y” | Do not delete screen window. | |
| “R” | Do not delete screen window on exit, Read and print last record entered before F9 to View. Do not clear last record on exit. | |
| “r” | Do not delete screen window, Read and print last record entered before F9 to view. |
From the OPENworkshop Reference, version 8.9.1. Open this page in the PDF