CBLDCDAM('OPEN')

PROCEDURE DIVISIONの指定

CALL 'CBLDCDAM' USING 一意名1 一意名2

DATA DIVISIONの指定

01 一意名1.
   02 データ名A  PIC X(8) VALUE 'DCDAMSVC'.
   02 データ名B  PIC X(5).
   02 FILLER    PIC X(3).
   02 データ名C  PIC X(8).
   02 FILLER    PIC S9(9) COMP.
   02 FILLER    PIC S9(9) COMP.
   02 データ名H  PIC S9(9) COMP.
   02 FILLER    PIC X(28).
01 一意名2.
   02 データ名E  PIC X(4) VALUE 'OPEN'.
   02 データ名F  PIC X(1).
   02 データ名G  PIC X(1).
   02 FILLER    PIC X(1).
   02 FILLER    PIC X(1).
   02 データ名Z  PIC S9(9) COMP VALUE ZERO.

●データ名A

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

●データ名C

論理ファイル名を8文字以内で設定します。8文字に満たない場合は，後ろを空白で埋めてください。

●データ名E

論理ファイルのオープンを示す要求コードを「VALUE 'OPEN'」と設定します。

●データ名F

ブロック排他をするかファイルの排他をするかを設定します。

VALUE 'B'…ブロック排他

VALUE 'F'…ファイル排他

ファイル排他を指定できるのは，次に示す場合です。

• 回復対象のDAMファイルを，トランザクションの範囲内でオープンする場合

• 回復対象外のDAMファイルをオープンする場合

●データ名G

論理ファイルへのアクセスで排他エラーが起こったとき，排他解除待ちをするかどうかを設定します。データ名Fに「VALUE 'F'」を設定した場合は，使うDAMファイルが回復対象かどうかで動作が異なります。

VALUE 'W'… 排他解除待ちをします。

VALUE 'N'… 待たないで，エラーリターンします。

どちらも設定しなかった場合は「VALUE 'N'」が仮定されます。

データ名F，データ名Gに設定できる値は，使うDAMファイルが回復対象かどうかで異なります。詳細は次のとおりです。

• 回復対象のDAMファイルの場合

  データ名Gの排他解除待ちは，論理ファイルのオープン以降のアクセス（CBLDCDAM('READ')とCBLDCDAM('WRIT')）で排他エラーが起こった場合の設定となります。CBLDCDAM('OPEN')で排他エラーが起こった場合の設定ではありません。CBLDCDAM('OPEN')で排他エラーが起こった場合には，無条件に「01602」でエラーリターンします。

  回復対象のDAMファイルにアクセスする場合の，データ名F，データ名Gに設定した値と排他の設定内容を次に示します。

  データ名F	データ名G※	排他の設定内容
  'F'	△	ファイル排他
  'B'	'W'	ブロック排他，排他エラー時は解除待ち
  	'N'	ブロック排他，排他エラー時はエラーリターン

  （凡例）

  △：''（空白）を設定してください。

  注※

  データ名Fに'B'を設定し，データ名Gの設定を省略した場合は，'N'が仮定されます。

• 回復対象外のDAMファイルの場合

  データ名Gの排他解除待ちは，排他エラーが起こった場合の設定となります。

  CBLDCDAM('OPEN')，CBLDCDAM('READ')およびCBLDCDAM('WRIT')で排他エラーが起こった場合に，データ名Gに設定した値に従って，排他の解除を待つかどうかが決まります。データ名Gに 'N' を設定，または省略した場合に排他エラーが起こったときは，「01602」でエラーリターンします。

  回復対象外のDAMファイルにアクセスする場合の，データ名F，データ名Gに設定した値と排他の設定内容を次に示します。

  データ名F	データ名G※	排他の設定内容
  'F'	'W'	ファイル排他，排他エラー時は解除待ち
  	'N'	ファイル排他，排他エラー時はエラーリターン
  'B'	'W'	ブロック排他，排他エラー時は解除待ち
  	'N'	ブロック排他，排他エラー時はエラーリターン

  注※

  省略した場合は，'N'が仮定されます。

  回復対象か回復対象外かに関係なく，データ名Fにファイル排他を設定するとファイル全体に排他を掛けるため，CBLDCDAM('READ')およびCBLDCDAM('WRIT')で排他エラーは起こりません。そのため，排他解除待ちをするかどうかを設定できません。CBLDCDAM('READ')およびCBLDCDAM('WRIT')のデータ名に設定した排他解除待ち種別は無視されます。

●データ名Z

0を設定します。

●データ名B

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

●データ名H

ファイル記述子が返されます。