Delegate-user-identity - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
16.10
Published
May 2017
Language
English (United States)
Last Update
2018-05-07
dita:mapPath
jen1488824663137.ditamap
dita:ditavalPath
Audience_PDF_include.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