16.20 - Refresh-cached-data - Teradata Tools and Utilities

Teradata® Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

Refresh-cached-data specifies whether response data previously processed by CLIv2 can be re-used or must be reread from the Teradata Database.

This option would not be used by a normal application. It is intended only for diagnostic use.

Refresh-cached-data exists only when DBCHINI had been called for a DBCAREA with Total-length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, Refresh-cached-data is ignored.

In this language... The variable name for Refresh-cached-data is...
COBOL DBRIRCD
PL/I DBRIRCD
C, C++ dbriRCD
IBM Assembler DBRIRCD
This routine... Does this for Refresh-cached-data...
DBCHINI writes
DBCHCL reads (RSUP; IRQ; IWPF)
Refresh-cached-data is used by... To...
applications write

One of the following values may be set before initiating a request:

If the previously processed response... Then set Refresh-cached-data to...
indicates that response data previously processed by CLIv2 can be re-used (default) 'N'
indicates that response data previously processed by CLIv2 must be reread from the Teradata Database. 'Y'

Use mnemonics for the codes. Mnemonics are provided in the language definition file for the DBCAREA.