16.20 - Delegate-user-identity - 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

Delegate-user-identity is a one-byte EBCDIC field that indicates whether the new connection's user identity is made available to applications on Teradata Database so that they may act on behalf of the user. The identity is an internal representation of the identity, not simply a cleartext password.

Use of this option requires specification of a Mechanism-name.

Delegate-user-identity exists only when DBCHINI had been called for a DBCAREA with Total-length set to at least 640 (that is, the returned DBCAREA Level value is at least 1). For a smaller DBCAREA, Delegate-user-identity is ignored.

Logon mechanisms are currently not supported for a mainframe-connected system.
In this language... The variable name for Delegate-user-identity is...
COBOL DELEGATE-USER-IDENTITY
PL/I DELEGATE_USER_IDENTITY
C, C++ delegateUserIdentity
IBM Assembler DBCNIDI
This routine... Does this for Delegate-user-identity...
DBCHINI writes
DBCHCL reads (RCON)
C, C++ delegateUserIdentity
IBM Assembler DBCNIDI
Delegate-user-identity is used by... To...
applications write

One of the following values can be set before initiating a request:

If... Then set Connect-type to...
indicates that a new connection is established. 'N'
  • DBC-NO for COBOL
  • DBC_DELEGATE_ID_NO for PL/I
  • DBC_DelegateIdNo for C and C++
  • DBCNIDIN for Assembler
indicates that the new connection's user identity is delegated to the Teradata Database for use by application there. 'Y'
  • DBC-YES for COBOL
  • DBC_DELEGATE_ID_YES for PL/I
  • DBC_DelegateIdYes for C and C++
  • DBCNIDIY for Assembler