Delegate-user-identity - Teradata Tools and Utilities

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

Product
Teradata Tools and Utilities
Release Number
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-12
dita:mapPath
dsu1527114222346.ditamap
dita:ditavalPath
dsu1527114222346.ditaval
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

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