2.7.4 SQL連絡領域の構成と内容
DMLを実行すると，HiRDB/SDはDMLが正常に実行されたかどうかを示す情報をUAPに返します。これらの情報を受け取るための領域をSQL連絡領域といいます。SQLCODE，SQLWARN1〜SQLWARNFは，SQL連絡領域に格納されます。
- 〈この項の構成〉
(1) SQL連絡領域の構成
SQL連絡領域の構成を次の図に示します。
|
|
![[図データ]](GRAPHICS/ZU027401.GIF)
- 注
-
-
( )内は領域の長さ（単位：バイト）を示しています。
-
SQLCABC，SQLCODE，およびSQLERRDの長さは，long型のサイズになります。
-
(2) SQL連絡領域の内容
SQL連絡領域の内容については，マニュアル「HiRDB Version 9 UAP開発ガイド」の「SQL連絡領域の構成と内容」の「SQL連絡領域の内容」を参照してください。
マニュアル「HiRDB Version 9 UAP開発ガイド」の記載内容と異なる部分だけ，次の表に示します。
|
レベル番号※ |
連絡領域名 |
データ型 |
長さ（バイト） |
内容 |
|---|---|---|---|---|
|
2 |
SQLCODE |
long |
8 |
DMLの実行結果を示すSQLCODEが返される領域です。 |
|
2 |
SQLERRM |
− |
256 |
DMLの実行結果を示すメッセージの情報が返される領域です。 |
|
3 |
SQLERRML |
short |
2 |
SQLERRMC領域に返されるメッセージの長さが返される領域です。 |
|
3 |
SQLERRMC |
char |
254 |
SQLCODEに対応するメッセージが返される領域です。 SQLCODEとメッセージの対応については，マニュアル「HiRDB Version 9 メッセージ」の「メッセージの記述形式」の「メッセージに関する注意事項」を参照してください。 |
|
2 |
SQLERRD |
long |
8×6 |
未使用 |
- （凡例）
-
−：該当しません。
- 注※
-
レベル番号は，SQL連絡領域の包含関係を示しています。例えば，レベル番号1の連絡領域はレベル番号2の連絡領域で構成されることを示しています。
(3) SQL連絡領域の展開
SQL連絡領域のデータ記述項は，pdsdbcblコマンドによるプリプロセスの際に，登録集原文のCOPY文がポストソースに自動的に出力されます。そのため，SQL連絡領域のデータ記述項を，COBOLソースプログラム中に記述する必要はありません。
登録集原文によって展開されるデータ記述項については，マニュアル「HiRDB Version 9 UAP開発ガイド」の「SQL連絡領域の展開」を参照してください。