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

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

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

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.

Note: 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

delegateUserIdentity

IBM Assembler

DBCNIDI

 

This routine...

Does this for Delegate‑user‑identity...

DBCHINI

writes

DBCHCL

reads (RCON)

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'

  • DBCNIDIN for Assembler
  • DBC_DelegateIdNo for C
  • DBC‑NO for COBOL
  • DBC_DELEGATE_ID_NO for PL/I
  • indicates that the new connection's user identity is delegated to the Teradata Database for use by application there.

    'Y'

  • DBCNIDIY for Assembler
  • DBC_DelegateIdYes for C
  • DBC‑YES for COBOL
  • DBC_DELEGATE_ID_YES for PL/I