- Purpose
- Passes messages that control the behavior of the view.
- Used By
- CONNECT VIEW called from a method.
Contents
| VIEW$[ALL] |
Prior to a CONNECT VIEW directive, VIEW$ can be dimensioned to 18 and the values shown below can be set. The values will determine certain view characteristics. |
|
| VIEW$[0] |
Execution status. |
|
| VIEW$[1] |
View name [,link-name] |
|
|
If view name not found, create view using link specified. If view name not found and link name not specified, a search for a link using the view name will be done. If link found using view name, a view will be created with the same name as found link. |
|
| VIEW$[2] |
Selected key. |
|
| VIEW$[3] |
Which sort. |
|
| VIEW$[4] |
Starting key value when view first displayed. |
|
| VIEW$[5] |
Starting key range allowed while in view. |
|
| VIEW$[6] |
Ending key range allowed while in view. |
|
| VIEW$[7] |
CONNECT message. (SORT n, USING [RANGE FROM TO], SELECT WHEN|secure SELECT WHEN). See VIEW$[13]. |
|
| VIEW$[8] |
Screen name for F9. |
|
| VIEW$[9] |
Cursor mode: |
|
|
C |
Cursor mode. |
|
E |
Entire field in reverse video (uses view color bar). |
|
F |
Full row (modes same as E). |
|
P |
Simulate PRINT VIEW functionality. |
| VIEW$[10] |
Carriage return action: |
|
|
F |
Field edit. |
|
S |
Single record maintenance. Return on F4 at maintenance options. |
|
s |
Same as S except the return is performed after one record is edited. |
|
E |
Exits and returns current key in entry [2]. |
| VIEW$[11] |
Not used. |
|
| VIEW$[12] |
Not used. |
|
| VIEW$[13] |
On/Off indicators (YN) (space applies defaults): |
|
|
|
|
|
(1,1) |
Key change allowed. The default is Y. |
|
|
|
|
(2,1) |
Data change allowed. The default is Y. |
|
|
|
|
(3,1) |
View alterations allowed. The default is Y. |
|
|
|
|
(4,1) |
Leave view window displayed after exit. The default is N. |
|
|
|
|
(5,1) |
Sort change allowed. The default is Y. |
|
|
|
|
(6,1) |
Exit after view display. The default is N. |
|
|
|
|
(8,1) |
Enable secure SELECT WHEN. The default is N. |
|
|
|
| VIEW$[14] |
Application help code (LLHHHHHH),prompt-msg-help-name. Note: The comma (,) separating the application help name and the prompt message help name is required when no application help name is supplied. |
|
|
|
|
| VIEW$[15] |
Active select condition. |
|
|
|
|
| VIEW$[16] |
Command processing mode: |
|
|
|
|
|
(1,1) |
N |
|
|
Count |
|
|
L |
|
|
List (same as a view) |
|
|
S |
|
|
Sum |
|
|
P |
|
|
Print (hard copy) |
|
|
C |
|
|
Copy |
|
|
M |
|
|
Move |
|
|
D |
|
|
Delete |
|
|
c |
|
|
Change |
|
(2,1) |
Verify for C,M,D,c (Y/N) |
|
|
|
|
(3,8) |
Link name for C,M,D |
|
|
|
|
or |
|
|
|
|
|
(2,1) |
|
|
Verify for C,M,D,c (Y/N) |
|
|
(3,n) |
|
|
Change expression. |
|
|
(3+n),x) |
|
|
Command description. |
|
|
or |
|
|
|
|
|
(2,1) |
|
SUM number elements. |
|
|
|
(3,n) |
|
Elements to sum. |
|
|
|
(3+n,x) |
|
Command description. |
|
|
| VIEW$[17] |
Select and/or change expression CPP’d program. |
|
|
|
|
| VIEW$[18] |
View FILE-SUFFIX. |
|
|
|
|
| VIEW$[19] |
For internal use. |
|
|
|
|
| VIEW$[20] |
For internal use. |
| VIEW$[21] |
user supplied override of the view window size and location, format is: comma delimited number of cols for view - defines view width number of rows for view - defines view height starting col for view - defines left most position of the view starting row for view - defines top most position of the view For example: 60,10,2,3 creates a view window 60 cols (characters) wide, 10 rows high, starting at col 2 row 3. |
| VIEW$[22] |
Optional View Heading |
| VIEW$[23] |
Optional data name list. View will display only these datanames. pass as: dn1,dn3,dn3,…dnx Replace “,” with a “;” to signify locked column. Define new/joined columns with the column id A-Z. |
| VIEW$[24] |
Number of data rows to return. Specifying this option will allow the V$ array to be returned to the calling program populated with all of the view column data and the number of records specified in this field. The view will not be displayed on the screen. OO3A will just exit. For example, if VIEW$[24]=“10” then the CONNECT VIEW will not display the view, instead it will return the 10 rows of data in the v$ array. The first row would be the first row of data that would be normally be displayed as defined by all the other parameters in the array that determine the first row of a view. |
| VIEW$[25] |
Joined column display flag. N = Do not display joined column data names. A = Display all data names defined by the joined column Link definition. |
| VIEW$[26] |
RESERVED for internal use to pass joined column information to command processing method OO3A3. |
| VIEW$[27] |
RESERVED for internal use to pass information to command processing method OO3A3 for F8-Query option. |
| VIEW$[28] |
View heading col/row substitution values: The first byte defines the substitution set delimiter used in the string. This is followed by one or more substitution sets: 1 byte substitution value delimiter + 1 byte row number (1,2,3) + 3 byte column number + substitution text + delimiter + 1 byte row number (1,2,3) + 3 byte column number + substitution text + (next entry) Accepts any number of substitution values in any sequence. All substitution values will be padded to column width with trailing spaces. Unless leading spaces are supplied, substitution headings will be left aligned. If the substitution values exceed the defined column width, the substitution value will be truncated. To clear a column heading within a row, define a substitution value of 1 space. This will be padded to full column width and have the effect of clearing out the column heading for that row. |
| VIEW$[29] |
VIP View color settings Row and column color settings can be supplied in one of two formats: SETCOLOR syntax or a view color method name. Support for the view color method provides flexibility for processing complex color rules beyond the scope of the SETCOLOR syntax. SETCOLOR syntax BY ROW: SETCOLOR foreground+background BY ROW WHEN condition SETCOLOR WHITE+RED BY ROW WHEN #OEFCUST.CUST-SALES > 17000 Multiple SETCOLOR commands are supported. Use a “;” to separate commands. VIEW$[29] = “SETCOLOR WHITE+RED BY ROW WHEN”+ “#OESCUST.CUST-SALES > 15000;”+ “SETCOLOR RED+WHITE BY COL.CUST-CODE WHEN “+ “OESCUST.CUST-SALES >17000” Commands are evaluated in order. In the above example an entire row might display with white text on a red background and with the CUST- CODE column displayed with red text on a white background. The color rules are applied each time a row is to be displayed and each time the user moves off a column after entering data. For more information, please see the SetColor Method earlier in this manual. |
| VIEW$[30] |
Set to an “R” will cause the view to be presented in reverse order from the selected sort. |
From the OPENworkshop Reference, version 8.9.1. Open this page in the PDF
