15.10 - Country 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

Country Id is a two-byte field that specifies the country variant of 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 Country Id.

Because the Country Id qualifies the language, Language Id must also be specified. When a language is commonly used in several countries, the Country Id may be specified to select messages that are unique to that country.

The Country Id is defined by the ISO 3166-1 standard. The value is in EBCDIC, and both lowercase and uppercase characters are permitted.

 

In this language...

The variable name for Country Id is...

COBOL

DBCNICID

PL/I

DBCNICID

C

dbcniCid (case is significant)

IBM Assembler

DBCNICID

 

This routine...

Does this for Country Id. . .

DBCHINI

writes

DBCHCL

reads CON

 

Country Id is used by...

To...

applications

write

DBCHINI initializes the Country Id to the default value provided in the HSHSPB being used. The distributed HSHSPB provides no default for Country Id; therefore, unless a Country is specified, the Language Id alone defines the message language.

If a Country Id is appropriate for an application, the application should perform the following procedure before calling DBCHCL for the connect function:

1 Set Change Options to ‘Y‘.

2 Change the value for Country Id as follows:

 

If the language is...

Then set Country Id to...

Arabic

No country differentiation supported.

Danish (Denmark)

DK

German (Germany)

DE

German (Switzerland)

CH

Greek (Greece)

GR

English (United States)

US

English (United Kingdom)

GB

Spanish (Spain)

ES

Finnish (Finland)

FI

French (France)

FR

French (Belgium)

BE

French (Canada)

CA

French (Switzerland)

CH

Hebrew (Israel)

IL

Icelandic (Iceland)

IS

Italian (Italy)

IT

Italian (Switzerland)

CH

Japanese (Japan)

JP

Korean (Republic of Korea)

KR

Dutch (Netherlands)

NL

Dutch (Belgium)

BE

Norwegian (Norway)

NO

Portuguese (Portugal)

PT

Portuguese (Brazil)

BR

Romansh/Grishun (Switzerland)

CH

Russian (Russian Federation)

RU

Swedish (Sweden)

SE

Thai (Thailand)

TH

Turkish (Turkey)

TR

Chinese (China)

CN

Chinese (Taiwan)

TW

Messages are distributed in United States English (Language Id 'EN', optional Country Id 'US') only, although customers or Teradata Corporation in the various countries might provide additional languages. The mechanism by which the CLIv2 error messages are 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 is returned. For example, the message 'CLI0538 REQUEST REJECTED BY DELAY' would be presented as:

CLI0538 (REQUIRED MESSAGE TABLE IS NOT AVAILABLE)