5.11.2　UOCインタフェース

0

0

アイキャッチャ

8

8

char

pdload

インタフェース領域（’＊UOCINF＊’）

8

8

実行中プログラム

4

4

long

pdload

制御が渡っているプログラム

0：pdload

1：UOC

12

12

呼び出し種別

4

4

long

pdload

UOCに対する処理要求種別

o：開始要求

処理開始の準備要求をします。

入力デ−タファイルのオープンなど，処理の開始準備をします。

e：編集要求^※１

行データの編集要求をします。

（1）の方法では，pdloadが入力した1行分のデータが入力バッファアドレスの指す入力バッファに設定されています。

（2）の方法では，UOCが入力デ−タファイルの読み込みをします。

その後，（1），（2）共にデータを編集した結果を，編集バッファアドレスの指す編集バッファに設定します。

このコールは，データがなくなるか，又はUOCからのリターンコードが0，4以外になるまで繰り返します。

c：終了要求

処理の終了要求をします。

入力デ−タファイルのクローズなど，終了処理をします。

（1）の方法ではpdloadが入力するデータがなくなった場合，（2）の方法ではUOCからリターンコード16を受け取った場合に要求をします。

t：停止要求

処理の強制終了要求をします。

pdload側でエラーが発生した場合，又はUOCからリターンコード0，4，16以外を受け取った場合に，終了要求の代わりにこのコールをします。

開始要求をした場合，正常時は終了要求，異常時は停止要求をします。終了要求又は停止要求以降は，UOCがコールされることはありません。

16

16

認可識別子の長さ

2

2

short

pdload

表の所有者名の長さ

18

18

認可識別子

30

30

char

pdload

表の所有者名

48

48

表識別子の長さ

2

2

short

pdload

表の名称の長さ

50

50

表識別子

30

30

char

pdload

表の名称

80

80

入力データ長^※２

4

8

long

pdload

(1)　バイナリ形式及び拡張DAT形式の入力データファイルの場合，入力バッファ^※３に設定したデータの長さ（全長）を設定します。

(2)　無視されます。

84

88

入力バッファのアドレス

4

8

void*

pdload

(1)　pdloadが入力したデータを格納するバッファのアドレスを設定します。

(2)　無視されます。

88

96

編集データ長^※２※５

4

8

long

UOC

バイナリ形式及び拡張DAT形式の入力デ−タファイルの場合，編集バッファ^※４に設定したデータの長さ（全長）を設定します。

(1)　データを格納しない場合は−1を設定します。

92

104

編集バッファのアドレス

4

8

void*

UOC

UOCで編集したデータを格納するバッファのアドレス

96

112

ユーザパラメタのアドレス

4

8

void*

pdload

srcuoc文のparamオペランドに指定した文字列のアドレスを設定します。paramオペランドを省略した場合はナル値が設定されます。

100

120

システムが使用する情報

4

8

void*

pdload

システムが使用する情報（UOC側では使用しないこと）

104

128

予備

16

16

char

pdload

予備領域（UOC側では使用しないこと）。

なお，最初の１バイトはシステムが使用する領域です。

120

144

リターンコード

4

4

long

UOC

UOCの処理結果を通知するリターンコードです。pdloadから制御を受け取ったUOCは，次の基準でリターンコードを戻してください。この領域はpdloadがUOCをコールするごとにクリア（−1を設定）しているので，毎回設定する必要があります。

0：

開始・終了要求に対する処理が正常に実行された場合，又は編集要求に対して編集バッファに1行分のデータを用意できた場合に設定します。

4：

デバッグなどで，正常時もメッセージを出力したい場合に設定します。

内容は0と同じです。

リターンコードに4を設定した場合，メッセージは3回まで出力されます。メッセージが3回出力された後に4を設定しても無視され，メッセージは出力されません。

8：

UOCの処理中にエラーが発生した場合，それまでの入力処理を有効にして（コミットして）処理を打ち切るときに設定します。

ただし，HiRDB側で内部エラーが発生した場合は，ロールバックされます。コミットされたか，又はロールバックされたかについては，メッセージログに出力されたメッセージで確認できます。

16：

UOCが入力デ−タファイルを読み込む場合，データがなくなったことをpdloadに通知するときに設定します。

また，pdloadが入力デ−タファイルを読み込む場合に，今回受け取ったデータ以降のデータを受け取らないときにも指定できます。

このリターンコードを受け取ると，pdloadは終了処理をします。

20：

UOCの処理中にエラーが発生した場合，それまでの入力処理を無効にして（ロールバックして）処理を打ち切るときに設定します。

リターンコードに0，16以外の値を設定すると，メッセージ埋め込み領域の内容を標準出力及びメッセージログに出力します。メッセージは，末尾に（￥0）を設定して131バイト以内の文字列としてください。

124

148

メッセージ埋め込み領域

132

132

char

UOC

標準出力及びログに出力するメッセージの格納領域