DBFERQ - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-12
dita:mapPath
uny1527114222311.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

DBFERQ is the End Request function of DBCHCL.

DBFERQ is used to explicitly close a request, discard its response, and de-allocate internal data structures related to the request.

How It Works

DBFERQ performs the following functions:
  • If the application has requested option updates, performs option set/validation logic
  • If not Keep Response, and the EndRequest has been received, continues
  • If Keep Response, or if the EndRequest parcel has not been received, sends a Continue Request message containing a Cancel parcel
  • If the session is active, awaits completion
  • Sends a Continue Request message containing a Cancel parcel and awaits completion
  • Destroys request context

Successful End Request Operation

The sequence of operations for a successful end request operation follows:
  1. Call DBCHCL for DBFERQ
  2. Check for return code of zero

The DBFERQ applies to requests generated by calling DBCHCL for the DBFCON, DBFRSUP, and DBFIRQs.

The DBFERQ ensures that the Teradata SQL request’s response is discarded, thus freeing space on the database computer, and de-allocates CLI internal buffers (thus freeing space on the client).

These space-saving operations make it valuable to call DBCHCL for the DBFERQ as soon as the response is no longer required by the application program. In fact, it is still valuable (especially on IBM PC clients) to call DBCHCL for the DBFERQ even if the request was submitted with Keep Response set to N and the response was consumed or discarded by the Teradata Database.

DBCHCL always de-allocates the response buffer.

DBCHCL does not use the Open Requests field.

Values Read and Used, But Not Stored

The values for Wait Across Crash, Tell About Crash, Return Time, and Wait For Response are read and used, but not stored.

Interface

Function: DBFERQ - End Request
Purpose: Terminate/cleanup specified request
Parms: