Ending a Request - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
15.10
Language
English (United States)
Last Update
2018-10-07
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

Storage is acquired both by Teradata 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 Id to the Output CLIv2 Request Id 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.