DBCHSAD - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-01
dita:mapPath
ggf1488824663364.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

DBCHSAD returns the address of a given parameter.

It performs this function by storing the source argument at the target address. This allows the DBCAREA pointer arguments to be set in languages that do not support pointer manipulation.

CLI does not go through DBCHSAD’s internal initialization or attempt to find its internal context.

Parameters

DBCHSAD (ReturnCode, TargetAddress, SourceValue)
Int32 *ReturnCode
void **TargetAddress
void *SourceValue

where the following is true:

The parameter... Is the...
ReturnCode After control returns from DBCHSAD, the integer contains a code whose value represents success or failure to copy source value. A return code of zero indicates success; a non-zero return code indicates failure, and the value specifies the reason for the failure.
TargetAddress address of the first byte of the area at which the source value is to be stored.
SourceValue signed integer containing the value to be stored at the target address.