SA$
- Purpose
- Contains the attributes of the screen or view in use by the caller. This array enables the called method to derive the current display context and allows the context to be restored when control returns to the calling object.
The called method must ensure that this array is not modified before it is returned to the caller, or unpredictable behavior may result.
- Used By
- CONNECT METHOD
Contents
| SA$[0] | View/Screen name. | |
|---|---|---|
| SA$[1] | View/Screen header record. | |
| SA$[2] | (1,1) | Screen attribute table entry length (ASC 1 byte). |
| (2,1) | Number of entries in screen table (ASC 1 byte). | |
| SA$[3] | Screen attribute table: | |
| (1,1) | Screen position (ASC 1 byte). | |
| (2,1) | Screen line (ASC 1 byte). | |
| (3,1) | Screen entry length (ASC 1 byte). | |
| (4,1) | Fixed attribute entry number (ASC 1 byte). | |
| (5,y) | Next screen attribute entry. | |
| SA$[4] | Screen/view formulas: | |
| Note on formula storage: If a formula is entered, the fixed attribute entry number above is set to zero and an entry is built in entry [4]. The screen position and line from the attribute is used to locate the formula. | ||
| (1,2) | Entry length. | |
| (3,1) | Screen position (ASC 1 byte). | |
| (4,1) | Screen line (ASC 1 byte). | |
| (5,1) | Short formula text size 256 bytes (ASC 1 byte). | |
| or | ||
| (5,1) | $00$ Long formula text flag. | |
| (6,2) | Long formula text size. | |
| (x,1) | Mask size (ASC 1 byte). | |
| (x+1,1) | Short formula Thoroughbred Basic statement size 256 bytes (ASC 1 byte). | |
| or | ||
| (x+1,1) | $00$ Long Thoroughbred Basic statement flag. |
| (x+2,2) | Long Thoroughbred Basic statement. | ||
|---|---|---|---|
| (xy,z) | Formula text. | ||
| (x+y+z,m) | Screen mask. | ||
| (x+y+z+m,b) | Thoroughbred Basic statement. | ||
| SA$[5] | View headings when view specified. | ||
| SA$[6] | Link header when view specified. | ||
| SA$[7] | Pointers to numeric masks. | ||
| SA$[8] | Numeric masks. | ||
| SA$[9] | Printable screen when screen specified. | ||
| SA$[10] | Screen input operations table, 8INPUT interface: | ||
| (1,1) | Last field processed. | ||
| (2,1) | B | Pre-process. | |
| A | Post-process. | ||
| H | Help requested. (When first character of help code = “.”). | ||
| F | Formula field. (When FUNC$(3,1) = “ “). | ||
| (3,3) | Screen field offset to continue after pre/post process: | ||
| 0 | Last field processed. | ||
| 1 | Next field (default when exit to pre/post process). | ||
| n | Last field plus n. | ||
| -1 | Previous field. | ||
| -n | Last field minus n. | ||
| (6,1) | Field column (ASC). | ||
| (7,1) | Field line (ASC). | ||
| (8,1) | Field length (ASC). | ||
| (9,1) | Format entry number (ASC). | ||
| (10,1) | Post process term-key. | ||
| (11,1) | Type of input: | ||
| “ “ | Input all data element types. | ||
| “K” | Input only KEY type data elements. MUST SET SPARM$[10](12,1)=” “. | ||
| “N” | Input all non-key fields. MUST SET SPARM$[10](12,1)=” “. | ||
| (12,1) | First time flag: | ||
| “ “ | First time flag. | ||
| “X” | Re-entry. | ||
| (13,1) | Not used. | ||
| (14,1) | Line number offset. | ||
| (15,1) | Offset count limit. | ||
| (16,1) | Replace/Print data in DATA$ [Y or N]. | ||
| (17,1) | Get occurrence window home position in next two bytes [Y or N]. | ||
| (18,1) | Occurrence window home column (binary). | ||
| (19,1) | Occurrence window home line (binary). | ||
| (20,8) | Screen window name (if blank use screen name). | ||
| (28,8) | Screen window name actually created (different from SPARM$[10](20,8) if a window with that name already exists). | ||
| SA$[11] | 8INPUT screen input data element list (format entry numbers). | ||
| SA$[12] | 8INPUT pre processing data element list (format entry numbers). | ||
| SA$[13] | 8INPUT post processing data element list (format entry numbers). | ||
| SA$[14] | Not used. | ||
| SA$[15] | Not used. | ||
| SA$[16] | Not used. | ||
| SA$[17] | 8TEXTF key of data record for corresponding text record. If null, the primary key value will be constructed based on all fields in the format. | ||
| SA$[18] | Not used. | ||
| SA$[19] | Link file definition table. | ||
| SA$[20] | Not used. | ||
| SA$[21] | 8PRINT data element list (format entry numbers). | ||
| SA$[22] | Text field operations table: | ||
| (1,2) | Text file channel number (binary). | ||
| (3,1) | Use valid value defaults for window (Y/N). | ||
| (4,1) | Border type: | ||
| “N” | None. | ||
| “R” | Reverse video line graphic. | ||
| “C” | Character. | ||
| “G” | Line graphic. | ||
| (5,1) | Text field ID. | ||
| (6,1) | Number of lines in window (ASC 1 byte). | ||
| (7,1) | Number of characters per line in window (ASC 1 byte). | ||
| (8,1) | Line 1 of window (ASC 1 byte). |
| (9,1) | Column 1 of window (ASC 1 byte). | |
|---|---|---|
| (10,8) | Text field window name. If none supplied, window name will be “.TEXT.”+sequential number. | |
| SA$[23] | List of CTL values indicating any field input terminated with one of the CTL values, will be treated as a post process. (STR 2 byte masked :“00”). |
From the OPENworkshop Reference, version 8.9.1. Open this page in the PDF