GML::START - Identify Grids to be Managed by GML
Syntax
CALL "GML::START"
Description
This procedure identifies the grids to be managed by the Grid Management Library. This procedure is used once in the application code at startup, just prior to calling program GML_I. When procedure START is executed a GML_INIT$ template is returned to the calling programming with the variables dimensioned based on the value in variable GML_QTY%, which denotes that quantity of grid sets to be managed by the GML. The GML_INIT$ template variables are as follows ([s] denotes the grid set number):
|
Variable |
Description |
|---|---|
|
GML_INIT.MAIN_ID%[s] |
main grid control ID |
|
GML_INIT.COL_HEADER_ID%[s] |
column header control ID |
|
GML_INIT.ROW_HEADER_ID%[s] |
row header control ID |
|
GML_INIT.SYSGUI%[s] |
GUI system device channel number |
|
GML_INIT.CONTEXT%[s] |
control context |
|
GML_INIT.LUM_QTY% |
quantity of look-up controls (see GML Look-Up Manager Feature for additional information) |
A Main Grid control ID must contain a value that returns the number 1 when using the MOD(n,5) function, such as in the example where MOD(5001,5)=1. A Column Header control ID for the same grid must be equal to the Main Grid Control ID+1, while the Row Header Control ID must equal to the Main Grid control ID+2. If a main grid does not have an associated column header control and/or row header control, then the variables for those control ID's in template GML_INIT$ must be set to 0.
Example
Two grids to be managed by the GML. Since grid set 1 does not contain a row header control, the row header ID value is set to 0.
|