17.10 - Cleaning Up CLI - Call-Level Interface Version 2

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

Call-Level Interface Version 2
Release Number
Release Date
October 2021
Content Type
Programming Reference
Publication ID
English (United States)

DBCHCLN is the CLI routine used to clean up all CLI memory. The following processes take place when the application program no longer needs to use the database.


The application calls DBCHCLN. Calling DBCHCLN should be the last CLI call that the process makes. See DBCHCLN for more information.


A dummy DBCAREA is allocated and the DBFDSC function is invoked repeatedly for each session opened by the application until all the sessions are logged off or an error occurs. An error or success message is then returned to the application.


If the return code is not normal, the application makes the appropriate changes and re-submits to DBCHCLN. Otherwise, the application’s ties to the database are gone.