DBCHPEC - Teradata Tools and Utilities

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

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Lake
Product
Teradata Tools and Utilities
Release Number
20.00
Publication Date
October 2023
Content Type
Programming Reference
Publication ID
B035-2417-103K
ft:locale
en-US
ft:lastEdition
2025-11-21
dita:mapPath
apo1695647516691.ditamap
dita:ditavalPath
obe1474387269547.ditaval
ft:sourceId
dita
dita:id
vfj1470443597526
Product Category
Teradata Tools and Utilities

Purpose

Posts an ECB, including the one established by DBCHUE.

The alternate six-character name for DBCHPEC is DBCHPE.

Interface

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

DBCHPEC(ReturnCode,ECB)

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.
ECB The application allocated area for use as the ECB.

Usage Notes

  • After control returns from DBCHPEC, the variable contains a code whose value represents success or failure. A return code of zero indicates success, a nonzero return code indicates failure, and the value specifies the reason for the failure.
  • After the call, the return code variable contains a return code.
  • For more information on ECBs, see IBM documentation.