Vision requires the following catalogs. These catalogs comprise the APPLICATION_DEVELOPMENT_3 module.
The ii_framevars catalog describes the local variables and hidden table fields of a frame:
Column Name |
Data Type |
Description |
---|---|---|
object_id |
integer |
Object ID of the frame. |
fr_seq |
smallint |
Sequence number (for ordering). |
var_field |
varchar(32) |
Field name. |
var_column |
varchar(32) |
Column name (if field is a table field). |
var_datatype |
varchar(105) |
Data type of the field. |
var_comment |
varchar(60) |
Comment for the variable. |
The ii_menuargs catalog describes the arguments to be passed to a called frame for a given menu choice:
Column Name |
Data Type |
Description |
---|---|---|
object_id |
integer |
Object ID of frame. |
mu_text |
varchar(32) |
Menu item text. |
mu_seq |
smallint |
Sequence number beginning at 0 (for argument ordering). |
mu_field |
varchar(32) |
Field name in called frame to assign value to. If field name is of the form X.Y, this contains the X portion only. |
mu_column |
varchar(32) |
Portion of field name in called frame to assign value to. Only used when field name is of form X.Y, in which case this contains the Y portion. |
mu_expr |
varchar(240) |
4GL expression (field, constant, byref(), etc.) in the parent frame to assign to field in the called frame. |
The ii_vqjoins catalog describes the joins involved in a visual query:
Column Name |
Data Type |
Description |
---|---|---|
object_id |
integer |
Object ID of the frame. |
vq_seq |
smallint |
Sequence number (for ordering). |
join_type |
smallint |
Type of join specified by this row. |
join_tab1 |
smallint |
Index to table 1 of the join. Relative table number in visual query beginning with 0. |
join_tab2 |
smallint |
Index to table 2 of the join. Relative table number in visual query beginning with 0. (table 2 is always below table 1 in visual query). |
join_col1 |
smallint |
Join column for table 1. Index into array of columns for table 1. (Same as ii_vqtabcols.vq_seq). |
join_col2 |
smallint |
Join column for table 2. Index into array of columns for table 2. (Same as ii_vqtabcols.vq_seq). |
The ii_vqtabcols catalog describes the columns of the tables involved in a visual query:
Column Name |
Data Type |
Description |
---|---|---|
object_id |
integer |
Object ID of the frame. |
vq_seq |
smallint |
Column sequence number (for ordering). |
tvq_seq |
smallint |
Sequence number of table in visual query from ii_vqtables. |
col_name |
varchar(32) |
Column name. |
ref_name |
varchar(32) |
Name used on the form for field containing data. |
adf_type |
smallint |
Type information for column. See description of iicolumns. column_ingdatatype for details. |
adf_length |
integer |
Column size in bytes. |
adf_scale |
integer |
Currently not used. |
col_flags |
integer |
This column contains multiple pieces of information about the column in a bitmap format. The following values are present (expressed in Hex): 0x10 = Column is sequenced (generate new surrogate key value for INSERT statements). |
col_sortorder |
smallint |
Sort order for this column. Set to 0 if not part of sort sequence. For lookup tables, this gives the order of the column in the lookup screen. |
col_info |
varchar(240) |
Information entered by developer for this column in visual query. For Browse & Update frames, this is a query restriction and is added to the WHERE clause of the SELECT statement. For Append frames, this gives default value information and is either used in 4gl assignment statements for a displayed column, or in the INSERT statement for a not-displayed column. |
The ii_vqtables catalog describes the tables involved in a visual query:
Column Name |
Data Type |
Description |
---|---|---|
object_id |
integer |
Object ID of the frame. |
vq_seq |
smallint |
Order of table in visual query. |
vq_mode |
smallint |
This column contains multiple pieces of information about the frame as a whole, in a bitmap format (although note that the first 4 entries below are mutually exclusive; only one of them can appear). Can contain the following values (in Hex): 0x10 = If set, the Qualification Processing frame behavior is Disabled (can only be set for Browse & Update frames) |
tab_name |
varchar(32) |
Table name. |
tab_owner |
varchar(32) |
Table owner. |
tab_section |
smallint |
Visual query section table is in. |
tab_usage |
smallint |
How this table is used in the visual query. |
tab_flags |
integer |
Bitmap flag that indicates the frame behaviors in the visual query. Valid values (in Hex): |
The Application Flow Diagram and Escape Code provide additional Vision Catalog information.
Vision's Application Flow Diagram is built from menu item information in the ii_abfdependencies catalog. See ii_abfdependencies Catalog.
Frame Escape Code is stored in the ii_encodings catalog. See ii_encodings Catalog.
All escape code for a frame is combined into one (possibly resequenced) entry in iiencodings. Each piece of escape code in the entry is preceded by a type code. For example:
1 = form-start
2 = form-end
3 = query-start
4 = query-new-date
5 = query-end
6 = append-start
7 = append-end
8 = update-start
9 = update-end
10 = delete-start
11 = delete-end
12 = menu-start
13 = menu-end
14 = field-entry
15 = field-change
16 = field-exit
17 = user-menuitem