15.10 - Available-character-sets - 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

Available‑character‑sets might be used to allow selection of a character set name from a list of all character sets supported by the Teradata Database.

Refers the TDP whose TDP identifier is addressed by the QEPTIDP field and has length specified by the QEPTLEN field. Since they do not apply, the QEPRQST and QEPTOKEN fields must contain binary zeroes.

Returns the names of the character sets available on the server. The response consists of four fixed fields followed by a variable number of character set names. As many whole character set names as will fit into the response area whose length is indicated by QEPRALEN will be returned. If all names are not returned, another query may be issued specifying the returned token to indicate that names after those already returned are processed.

 

Item Code

Mnemonic

Response DBQERACS (DbqerACS for C)

Field

Value

28

QEPIACS

QERACSTK
('token' for C)

a 4 byte token to be placed into QEPTOKEN to retrieve any additional character set names. The content of the token is undefined and must not be altered by the application.

 

 

QERACSNR
(namesRemaining for C)

a 2 byte unsigned integer indicating the number of character set names not returned.

 

 

QERACSNP
(namesPresent for C)

a 2 byte unsigned integer indicating the number of character set names returned.

 

 

QERACSLN
(nameLen for C)

a 2 byte unsigned integer indicating the length of each character set name.

 

 

Immediately following are the number of names, in EBCDIC, indicated by QERACSNP, each of length indicated by QERACSLN.