15.10 - Language Id - 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

Language Id is a four-byte field that specifies the language to be used for all CLIv2 error messages returned in the Message Text DBCAREA field, and that were associated with the session being connected. The value specifies a two-character Language Id.

If a language is commonly used in several countries, the Country Id can be used to select messages that are unique to that country. The Language Id is defined by the ISO 639 standard. The entire value is in EBCDIC, and both lowercase and uppercase characters are permitted.

 

In this language...

The variable name for Language Id is...

COBOL

DBCNILID

PL/I

DBCNILID

C

dbcniLid (case is significant)

IBM Assembler

DBCNILID

 

This routine...

Does this for Language Id. . .

DBCHINI

writes

DBCHCL

reads (CON)

 

Language Id is used by...

To...

applications

write

DBCHINI initializes the Language Id to the default value provided in the HSHSPB being used. If the default value for Language Id is not appropriate for an application, perform the following procedure before calling DBCHCL for the connect function:

1 Set Change Options to 'Y'.

2 Change the value for Language Id as follows:

 

If the language is...

Then set Language Id to...

Arabic

AR

Danish

DA

German

DE

Greek

EL

English

EN

Spanish

ES

Finnish

FI

French

FR

Hebrew

IW

Icelandic

IS

Italian

IT

Japanese

JA

Korean

KO

Dutch

NL

Norwegian

NO

Portuguese

PT

Romansh/Grishun

RM

Russian

RU

Swedish

SV

Thai

TH

Turkish

TR

Chinese

ZH

Messages are distributed in United States English (Language Id 'EN', optional Country Id 'US') only, although customers or Teradata Corporation in various countries can provide additional languages.

The mechanism by which the CLIv2 error messages may be defined in other languages is described in Chapter 13: “User-Defined Character Sets.”

If a message must be returned, but messages are not available in the specified language, then the message number with fixed message text of '(REQUIRED MESSAGE TABLE IS NOT AVAILABLE)' in United States English will be returned. For example, the message 'CLI0538 REQUEST REJECTED BY DELAY' would be presented as:

CLI0538 (REQUIRED MESSAGE TABLE IS NOT AVAILABLE)