READA and READS Control Variables
Describes variables for use with READA.
RLX
/IFI reads the values of several control variables at the time your exec issues a READA request. Your exec can assign values to these variables before you issue the READA or READS service to control how the command operates.- WBUFECBSpecifies the address of anevent control block which Db2 should post when the buffer fills up with trace records.optionalExample:wbufecb = GETMAIN(4)In this example, aRLX/SDK GETMAIN function is used to obtain 4 bytes of memory to be used as an ECB.
- WBUFBCSpecifies a byte count (in Kilobytes) for the amount of data Db2 places in the buffer. When this much data accumulates, Db2 posts the ECB addressed by WBUFECB. If WBUFBC is 0 or is not specified, then Db2 posts the ECB addressed by WBUFECB when the buffer is full.Example:wbufbc = 32In this example, an ECB whose address is stored in the REXX variablewbufecbis posted when 32 KB of trace data accumulate in the OPx destination.
- WBUFSIZE(K_bytes)Specifies the size (in kilobytes) of the Db2 return area (within the address space of your monitor exec) into which the trace data is copied. This value should correspond to any BUFSIZE operand you specify explicitly on the -START TRACE command. The default value is the size set when Db2 is installed.Example:wbufsize = 32In this example, a 32 KB return area is allocated for READA or READS commands.
- WBUFFMT(default|custom|both|none)Specifies whether the READA or READS service should perform default or custom mapping of trace data into REXX variables. The default is to create REXX variables whose names correspond to the field names of IFCID-mapping macros.The custom mapping facility lets you define just the fields of interest within a record. In this case, only one stem variable is returned to a caller: IFC.i.Option both causes both default and custom mapping to occur. Option none indicates that no mapping occurs. In this case, only one variable is returned to a caller. The REXX variable IFIRETA contains the entire return area. You must format this area manually.