16.20 - DBCHSAD - Teradata Tools and Utilities

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

prodname
Teradata Tools and Utilities
vrm_release
16.20
created_date
September 2019
category
Programming Reference
featnum
B035-2417-108K

Purpose

Stores the address of a variable at a specified location.

The alternate six-character name for DBCHSAD is DBCHSA.

Interface

This routine is called with the following parameters, stylistically presented (the actual syntax varies according to the programming language being used):

DBCHSAD(ReturnCode,Target,Source)

In high-level languages, the details of the parameter list are handled by the compiler. For Assembler, the parameter list consists of contiguous 4 byte entries, each containing the 31 bit address of a parameter. The last address has the first bit set to one to indicate the end of the list.

The parameters for this routine are:

Argument Content
ReturnCode A 4 byte unsigned integer field into which the return code will be placed by CLIv2.
Target The area where the source address will be stored.
Source Address to be stored.

Usage Notes

DBCHSAD is intended for use in COBOL and other languages that do not support pointer manipulation.