dc_dam_status

ANSI C ，C++の形式

#include <dcdam.h>
int  dc_dam_status(char *lfname,struct DC_DAMSTAT *stbuf,
                   int phyfilno,DCLONG flags)

K&R版 C の形式

#include <dcdam.h>
int  dc_dam_status(lfname,stbuf,phyfilno,flags)
char       *lfname;
struct  DC_DAMSTAT  *stbuf;
int        phyfilno;
DCLONG     flags;

●lfname

論理ファイル名を，1〜8バイトの名称で設定します。

●stbuf

論理ファイルの状態を受け取る構造体 DC_DAMSTATのアドレスを設定します。構造体には，dc_dam_status関数に設定した論理ファイルの状態が返されます。

●phyfilno

DAMサービスで使う領域です。ヌル文字（0）を設定します。

●flags

DCNOFLAGSを設定します。

●stbuf

論理ファイルの状態を示す情報が，構造体 DC_DAMSTATで返されます。構造体の形式は次のとおりです。

struct  DC_DAMSTAT {
                    int   st_block_len;
                    int   st_block_num;
                    char  st_file_ph_name[64];
                    char  st_file_stat;
                    char  st_file_def;
                    char  st_file_sec;
                    char  st_filler_1;
                    int   st_file_inf;
                    };

• st_block_len

  論理ファイルのブロック長が返されます。

• st_block_num

  論理ファイルのブロック数が返されます。

• st_file_ph_name

  論理ファイルに対応した物理ファイル名が返されます。

• st_file_stat

  論理ファイルの現在の状態が，次に示す値のどれかで返されます。

  DCDAM_ST_NOT_HOLD … 論理ファイルへアクセスできます。

  DCDAM_ST_HOLD_LOG … 論理ファイルは，論理閉塞されています。

  DCDAM_ST_HOLD_OBS … 論理ファイルは，障害閉塞されています。

  DCDAM_ST_HOLD_REQ … 論理ファイルへ閉塞要求中です。

• st_file_def

  DAMサービス定義で指定した論理ファイルの属性が，次に示す値のどれかで返されます。

  DCDAM_ST_QUICK…ディファード更新処理の対象でないDAMファイルです。

  DCDAM_ST_DEFERRED… ディファード更新処理対象のDAMファイルです。

  DCDAM_ST_NORECOVER… 回復対象外のDAMファイルです。

  DCDAM_ST_CACHELESS…キャッシュレスアクセス指定の回復対象外のDAMファイルです。

• st_file_sec

  DAMサービス定義で指定した論理ファイルのセキュリティ属性が，次に示す値のどれかで返されます。

  DCDAM_ST_NON… セキュリティの指定はありません。

  DCDAM_ST_SEC… セキュリティの指定があります。

• st_filler_1

  予備領域1（ヌル文字（0）が設定されます）。

• st_file_inf

  予備領域2（-1が設定されます）。