使用上の注意
Message Textフィールドは、Return Codeによって示されるメッセージの本文です。 Message Lengthは、DBCHCLのすべての呼び出し(戻りコードがゼロであっても)のあとで使用可能になります。
| 言語 | 変数名 |
|---|---|
| COBOL: | DBCAREA-MSG-TEXT |
| C: DBCAREA.H: | msg_text |
| ルーチン | 動作 |
|---|---|
| DBCHINI: | 書き込み |
| DBCHCL: | 書き込み |
| 使用者 | 動作 |
|---|---|
| アプリケーション プログラム | 読み取り |
Message Lengthのバイト数の分だけが、Message Text内で有効なものとして保証されます。
DBCAREAを使用するCLIルーチンがゼロ以外/ゼロの戻りコードで終了した場合は、エラー メッセージが返されます。 メッセージは、Message Area Pointerでアドレス指定された領域がNULLの場合にのみ、DBCAREA内のMessage Textフィールドに格納されます。 Message Lengthは、メッセージの長さを返します。
このフィールドにメッセージを返すために使用される言語は、DBCAREAのLanguage Idフィールドによって決定されます。 Language Idが判断される前にエラーが発生した場合は、エラー メッセージが英語で返されます。