16.20 - Client Return Codes - Teradata Tools and Utilities

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

Teradata Tools and Utilities
September 2019
Programming Reference

Client software uses return codes to provide information about operations on the client. The value that is returned as a return code from a CLIv2 routine is generated by the CLIv2 routine itself or is passed back from some other client-resident module used by the CLIv2 routine. A return code of zero is normal, and a return code of nonzero represents an exception.

A return code can appear in three areas:

  • In the Assembler register 15 (the most direct and reliable location to find a return code)
  • In a parameter in the call itself (if CLIv2 cannot access this parameter, the return code will not appear here)
  • In the Return-code field of the DBCAREA (if CLIv2 cannot access the DBCAREA or this field, the return code will not appear here)