15.10 - Ending a Request - Call-Level Interface Version 2

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

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.