Message Area Pointer - Call-Level Interface Version 2

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

Product
Call-Level Interface Version 2
Release Number
15.10
Language
English (United States)
Last Update
2018-10-07
dita:id
B035-2417
lifecycle
previous
Product Category
Teradata Tools and Utilities

Message Area Pointer is a four-byte field that specifies the address of an area into which any error message will be placed when a non-zero return code occurs. The Message Area Length field specifies the length of the addressed area. CLIv2 does not alter this value, so after the value is set, it remains unless changed by an application.

 

In this language...

The variable name for Message Area Pointer is...

COBOL

DBCIMSGP

PL/I

DBCIMSGP

C

dbciIMsgP

IBM Assembler

DBCIMSGP

 

This routine...

Does this for Message Area Pointer...

DBCHINI

writes

DBCHCL

reads

 

Message Area Pointer is used by...

To...

applications

writes

An error message is returned when a CLIv2 routine that uses the DBCAREA ends with a non-zero return code. The message is contained either in the Message Text field within the DBCAREA or in the area addressed by Message Area Pointer. A message is never returned in both places. If Message Area Pointer is not specified, the Message Text field contains the message and Message Text Length returns the length of the message. If Message Area Pointer is specified, the area addressed contains the message and Message Length returns the length of the message.

If an error occurs while building the message, the Message Return Code field contains a CLIv2 return code. When this code is not zero, the text of the message may or may not be usable, depending on the nature of the error.

The character set used to construct the message is indicated by Message Charset Used. The session character set is always used if it is known, but if the error occurred before this character set is known, the default CLIv2 character set is used.

When a CLIv2 routine that uses the DBCAREA ends with a zero return code, any text from a previous error is overwritten with spaces in the character set indicated by Message Charset Used, and the length of the message is zeroed.