Ending a Request - Teradata Tools and Utilities

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

Product
Teradata Tools and Utilities
Release Number
17.00
Published
June 2020
Language
English (United States)
Last Update
2020-06-18
dita:mapPath
lvt1544831946862.ditamap
dita:ditavalPath
obe1474387269547.ditaval
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

Storage is acquired both by the database and CLIv2; therefore, an application needs to release resources by letting CLIv2 know the application has finished processing the request (either successfully or because an error has occurred).

The End Request function releases the resources associated with a particular request. To end a request, an application must performs the following steps:

  1. Modify the DBCAREA.
    • Set the Function to End Request.
    • Set the Input CLIv2 Session Id used to initiate the request.
    • Set the Input-CLIv2-request-number to the Output-CLIv2-request-number obtained when the request was initiated.
    • Optionally set the following:

      Message-area-pointer

      Message-area-length

  2. Call DBCHCL to perform the End Request function.
  3. Check the return code from DBCHCL:
    Return Code Results
    0 The request is successfully ended.
    anything else Process the return code and DBCAREA message and resubmit the End Request.