Structure of the DXEGOVA control block

The DXEGOVA control block passes to the governor exit routine information about a user's resource constraints. This information is located in a resource control view called Q.RESOURCE_VIEW.

The following table provides the name of each field in the DXEGOVA control block, with its data type and purpose. Each data type is listed as it appears in the DS statement that defines the field in the DSECT. For example, for the GOVOROWS field, the letter F indicates that this field contains a full-word integer. The DS statement for GOVOROWS appears as GOVOROWS DS F.

The layout of the control blocks and the information that they contain applies to all QMF environments. Therefore, some of the information shown in the control blocks might not apply to QMF in the environment that you are using.

Table 1. Fields of the DXEGOVA interface control block to the governor
Field Data type Description
GOVCADDR A Contains the address to branch to for canceling an activity.
GOVFUNCT XL1 Indicates the type of function call. Possible values are:
  • GOVINIT (session initialization); GOVTERM (session termination)
  • GOVSCMD (start command); GOVECMD (end command)
  • GOVCONN (connect command)
  • GOVSDBAS (start database retrieval operation); GOVEDBAS (end database retrieval operation)
  • GOVSACTV (suspend QMF activity for user think time); GOVRACTV (resume QMF activity)
  • GOVABEND (start of an abnormal ending)
GOVGROUP CL16 Contains the name of the user's resource group. This value does not change during a QMF session.
GOVNAME CL8 Contains the name of the control block (DXEGOVA). This value does not change during a session. It can serve as an eye catcher in a dump of virtual storage.
GOVOROWS F Contains the number of rows for the user's resource group in the resource control table. This value does not change during a session, and can be zero.
GOVRESC 10XL128 Contains information from the resource control table. This information is divided into 10 contiguous blocks of storage that are structured like DSECT GOVRESCT. A block contains information about one of the rows for the user's resource group in the QMF resource control table.
  • If the resource group has less than 10 rows, unused blocks are those at the end of the field.
  • If the resource group has more than 10 rows, use the GOVNEXTR field (in the GOVRESCT DSECT) to access additional rows.
GOVRESCT DSECT Describes the block of storage containing information about one of the user's rows of the resource control table.
GOVOPTN(CL16)
Contains the value in the RESOURCE_OPTION column of the resource control table. Blocks in the chain are ordered alphabetically on the content of this field.
GOVNULLI(H)
Null indicator for INTVAL column.
GOVINTVL(F)
Value of INTVAL column.
GOVNULLF(H)
Null indicator for FLOATVAL column.
GOVFLOAT(D)
Value of FLOATVAL column.
GOVNULLC(H)
Null indicator for CHARVAL column.
GOVCHLEN(H)
Length of data in CHARVAL column.
GOVCHAR(CL80)
Value in CHARVAL column.
GOVNEXTR(A)
Points to the block of data for the next resource table row. Contains zero if this is the last row.

Any null indicator in the structure is zero when its corresponding column value isn't null. If the column value is null, the indicator is not zero.
GOVSQLCA A Address of the SQL communications area (SQLCA), which holds information about the SQL SELECT query on the resource control view (Q.RESOURCE_VIEW).
GOVSQLRC F Return code from the SQL SELECT query on the resource control view (Q.RESOURCE_VIEW). If it is nonzero, the query failed and no rows are passed to the governor.
GOVUSERS CL2048 Scratchpad area, retained between session calls. QMF does not change this value.

The following figure shows the structure of the DXEGOVA control block.

Figure 1. The DXEGOVA control block
********************************************************************** 00001000
*                                                                    * 00002000
*        CONTROL BLOCK NAME: DXEGOVA                                 * 00003000
*                                                                    * 00004000
*        FUNCTION:                                                   * 00005000
*                                                                    * 00006000
*            THIS IS THE INTERFACE CONTROL BLOCK BETWEEN QMF AND     * 00007000
*            THE GOVERNOR EXIT ROUTINE.                              * 00008000
*                                                                    * 00009000
*        STATUS: Version 13.1 RELEASE 1 LEVEL 0                        * 00010000
*                                                                    * 00011000
*        INNER CONTROL BLOCKS: NONE                                  * 00012000
*                                                                    * 00013000
*        CHANGE ACTIVITY: NA                                         * 00014000
*                                                                    * 00015000
*        CHANGE DATE: NA                                             * 00016000
*                                                                    * 00017000
********************************************************************** 00018000
*                                                                      00019000
DXEGOVA  DSECT                                                         00020000
         DS    0D                                                      00021000
GOVNAME  DS    CL8           -- CONTROL BLOCK IDENTIFICATION           00022000
         SPACE                                                         00023000
GOVEXCTL DS    XL72          -- EXIT CONTROL                           00024000
         ORG   GOVEXCTL                                                00025000
GOVFUNCT DS    XL1           ----- FUNCTION CODE                       00026000
GOVINIT  EQU   1             -------- INITIALIZATION OF SESSION        00027000
GOVTERM  EQU   2             -------- TERMINATION OF SESSION           00028000
GOVSCMD  EQU   3             -------- START COMMAND                    00029000
GOVECMD  EQU   4             -------- END COMMAND                      00030000
GOVCONN  EQU   5             -------- CONNECT COMMAND                  00031000
GOVSDBAS EQU   6             -------- START DATA BASE                  00032000
GOVEDBAS EQU   7             -------- END DATA BASE                    00033000
GOVSACTV EQU   8             -------- SUSPEND QMF ACTIVITY             00034000
GOVRACTV EQU   9             -------- RESUME QMF ACTIVITY              00035000
GOVABEND EQU   10            -------- QMF ABEND OPERATION              00036000
GOVPAD10 DS    CL7           ----- RESERVED FIELD                      00037000
         SPACE                                                         00038000
GOVCADDR DS    A             ---- ADDR TO BRANCH TO FOR CANCELLATION   00039000
         SPACE                                                         00040000
GOVOROWS DS    F             ---- NUMBER OF OPTION ROWS RETRIEVED      00041000
         SPACE                                                         00042000
GOVSQLRC DS    F             ---- RESOURCE TABLE SQL RETURN CODE       00043000
         SPACE                                                         00044000
GOVSQLCA DS    A             ---- ADDRESS OF SQLCA FOR ERROR CONDITION 00045000
         SPACE                                                         00046000
GOVGROUP DS    CL16          ---- GROUP NAME                           00047000
GOVPAD20 DS    CL32          ---- RESERVED FIELD                       00048000
SPACE                                                                  00049000
GOVUCTL  DS    XL304         -- USER CONTROL AREA                      00050000
         ORG   GOVUCTL                                                 00051000
GOVUSERS DS    CL2048        ----- USER SCRATCH PAD AREA               00052000
GOVPAD30 DS    CL48          ----- RESERVED FIELD                      00053000
         SPACE                                                         00054000
         DS    0D                                                      00055000
GOVRESC  DS    10XL128       -- RESOURCE CONTROL TABLE                 00056000
         ORG   GOVRESC                                                 00057000
GOVRESCT DSECT               -- RESOURCE CONTROL TABLE MAPPING         00058000
         DS    0D                                                      00059000
GOVOPTN  DS    CL16          ----- RESOURCE OPTION                     00060000
GOVNULLI DS    H             ----- INTEGER NULL INDICATOR              00061000
GOVPAD40 DS    CL2           ----- RESERVED FIELD                      00062000
GOVINTVL DS    F             ----- INTEGER OPTION REPRESENTATION       00063000
GOVNULLF DS    H            ----- FLOATING POINT NULL INDICATOR        00064000
GOVPAD50 DS    CL6          ----- RESERVED FIELD                       00065000
GOVFLOAT DS    D            ----- FLOATING POINT OPTION REPRESENTATION 00066000
GOVNULLC DS    H            ----- CHARACTER NULL INDICATOR             00067000
GOVCHLEN DS    H            ----- LENGTH OF THE CHARACTER OPTION       00068000
GOVCHAR  DS    CL80         ----- CHARACTER OPTION REPRESENTATION      00069000
GOVNEXTR DS    A            ----- POINTER TO NEXT RESOURCE CONTROL ROW 00070000