16.20 - DBCHUEC - 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

A deprecated routine now replaced by DBCHUE.

Interface

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

DBCHUEC(ReturnCode,ContextArea,UserECB)

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.
ContextArea A 4 byte unsigned integer field for internal use by CLIv2.
UserECB The application allocated area for use as the User ECB.

For CICS applications, the User ECB must be in SHARED storage.

Usage Notes

  • The DBCHUEC routine does not itself wait for completion of any event.
  • The user ECB may be canceled by specifying a User ECB address of binary zeroes.