The ADABAS Interface › Operating Instructions › User Table Customization › QENVR Environment Macro

QENVR Environment Macro

              Macro       Operands

 name         QENVR       KEYS=(element name,...,...)
                          [,DEFFBL=-nn|50-]
                          [,TPNAMES=(name,...,...)]

name

is the name of the generated CSECT. The default name is JSIQENVR.

KEYS=

specifies, in a sublist, the element names on which the ADABAS log records are to be sorted and summarized. Valid element names are: JOBNAME, USERID, CMDCODE, and FILENUM.

DEFFBL=

specifies the default format buffer length in case you run ADABAS with LOGCB=NO.

TPNAMES=

specifies, in a sublist, the job name(s) for the teleprocessing monitor(s) used at your installation(s).

Usage Notes:

1. The four data elements JOBNAME, USERID, CMDCODE, and FILENUM provide you with options for summarizing the ADABAS log records. These data elements can be specified in any order or combination on the KEYS parameter.
2. It should be noted that the greater the detail of summarization (number of keys), the greater the number of records written by the ADABAS Interface. Processing time also increases.
3. For most utilization requirements, JOBNAME, USERID, and CMDCODE should be quite sufficient.
4. The TPNAMES operand must be coded to cause translation of the ADABAS user ID for teleprocessing users when processing Version 4 ADABAS log records. ADABAS log records in Version 5 (CLOGLAYOUT=5) format do not require translation and will be passed as they are found in the log records.

The following is a sample Environment Table that you can modify and assemble. It is included as member JSIQENVR in the source library. The load module name for the Environment Table must be QENVR.

JSIQENVR QENVR KEYS=(JOBNAME,USERID,CMDCODE),                         *
               DEFFBL=50,                                             *
               TPNAMES=COMPLETE
*
         END