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
15.10
Language
English (United States)
Last Update
2018-10-07
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

DBFERQ

DBFERQ is the End Request function of DBCHCL.

DBFEEQ 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 is:

    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

     

    DBCAREA Parameters

    The following fields in the DBCAREA may be read or written to by DBFERQ, depending on the application program’s environment.

    Input Arguments

  • Change Options
  • Function
  • Input Request Id
  • Input Session Id
  • Return Time
  • Tell About Crash
  • Wait Across Crash
  • Wait For Response
  • Output Arguments

  • Message Length
  • Message Text
  • Return Code