Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス COBOL言語編


CBLDCDMB('DPUT')

〈このページの構成〉

名称

物理ファイルへブロックの直接出力

形式

PROCEDURE DIVISIONの指定

CALL  'CBLDCDMB'  USING  一意名1  一意名2  一意名3

DATA DIVISIONの指定

01 一意名1.
   02 データ名A  PIC X(8) VALUE 'DCDAMINT'.
   02 データ名B  PIC X(5).
   02 FILLER    PIC X(1).
   02 データ名C  PIC X(63).
   02 FILLER    PIC X(3).
   02 データ名H  PIC S9(9) COMP.
   02 データ名E  PIC S9(9) COMP.
   02 データ名G  PIC S9(9) COMP.
   02 データ名I  PIC S9(9) COMP.
01 一意名2.
   02 データ名D  PIC X(4) VALUE 'DPUT'.
   02 FILLER    PIC X(1).
   02 FILLER    PIC X(1).
   02 FILLER    PIC X(1).
   02 FILLER    PIC X(1).
   02 データ名Z  PIC S9(9) COMP  VALUE  ZERO.
01 一意名3.
   02 データ名F  PIC X(n).

機能

物理ファイルへ,設定した相対ブロック番号に該当するブロックを出力します。

CBLDCDMB('DPUT')は,物理ファイルを再作成出力要求でオープンしてから呼び出してください。

出力データ長がブロック長よりも小さい場合は,ブロックへ出力して残りの領域をヌル文字で埋めます。そして,そのブロック長をデータ名Hに返します。出力データ長がブロック長よりも大きい場合は,CBLDCDMB('DPUT')はエラーリターンします。

物理ファイルへブロックを直接出力するときは,CBLDCDMB('OPEN')で返されたファイル記述子を設定します。

UAPで値を設定するデータ領域

●データ名A

DAMファイルとのインタフェースコードを「VALUE 'DCDAMINT'」と設定します。

●データ名C

物理ファイル名を,(スペシャルファイル名+14文字)以内で設定します。63文字に満たない場合は,後ろを空白で埋めてください。

●データ名E

ファイル記述子を設定します。

●データ名G

出力データ長を設定します。

●データ名I

出力するブロックの相対ブロック番号を設定します。

●データ名D

物理ファイルからブロックの直接出力を示す要求コードを「VALUE 'DPUT'」と設定します。

●データ名F

出力するデータを設定します。

●データ名Z

0を設定します。

OpenTP1から値が返されるデータ領域

●データ名B

ステータスコードが,5けたの数字で返されます。

●データ名H

出力したブロックのブロック長が返されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

01603

データ名Eに設定したファイル記述子は,DAMファイルを正常にオープンして得られた記述子ではありません。

DAMファイルをオープンしていません。

01604

出力データ長に,ブロック長よりも大きい値を設定しています。

01605

DAMファイルにアクセスする順序が間違っています。

01606

相対ブロック番号が間違っています。

01620

出力エラーが起こりました。

01628

アクセスしようとしたDAMファイルは,セキュリティ機能で保護されています。物理ファイルのブロックを出力しようとしたUAPには,アクセス権限がありません。

01646

アクセスしようとしたDAMファイルは,セキュリティ機能で保護されています。該当するファイルに対するACLがありません。

01690

インタフェースコード(データ名A)が間違っています。

01691

要求コード(データ名D)が間違っています。