PowerSORT Workstation V5.0 使用手引書

6.4.7 BSRTFILE構造体

BSRTFILE構造体は、入力ファイル、出力ファイル、メッセージファイルおよび一時ファイルの情報を指定するための構造体です。
BSRTFILE構造体で指定するすべてのファイル情報を省略する場合は、bsrtopen関数のパラメタのfileに<NULL>を指定します。ファイル情報を指定する場合は、領域を確保した上で指定します。

typedef struct {
　　BSPTR_BSFILE 　　　　　inpfile_tbl;
　　BSPTR_UCHAR 　　　　　outfile_addr;
　　BSPTR_BSFILE 　　　　　tmpfile_tbl;
　　BSPTR_UCHAR 　　　　　msgfile_addr;
　　BSPTR_BSFSYS 　　　　inpfsys_tbl;
　　unsigned char　　　　　　outfsys;
　　unsigned char　　　　　　recovery;
　　unsigned char　　　　　　reserve[2];　　/*　reserved　*/
　　BSPTR_BSIDX 　　　　　idx_addr;
　　BSPTR_BSFILE_EXT 　　outfile_tbl;
　　BSPTR_VOID 　　　　　　reserve2;
} BSRTFILE;

■BSRTFILE構造体のメンバ

◆BSPTR_BSFILE　　inpfile_tbl

入力ファイルパス名を指定する場合は、入力ファイルパス名を指定したBSFILE構造体のアドレスを設定します。
標準入力から入力させる場合、またはユーザアプリケーションからレコードを渡す場合(bsrtput関数またはbsrtmrge関数)は、<NULL>を設定します。

◆BSPTR_UCHAR　　outfile_addr

出力ファイルパス名を指定する場合は、出力ファイルパス名のアドレスを設定します。
出力ファイルパス名は<NULL>で終わる文字列です。
出力ファイルを複数指定する場合は、BSRTFILE構造体のoutfile_tblに設定します。
標準出力に出力させる場合、ユーザアプリケーションにレコードを返す場合(bsrtget関数またはbsrtmrge関数)、または出力ファイルを複数指定する場合は<NULL>を設定します。

◆BSPTR_BSFILE　　tmpfile_tbl

一時ファイルパス名を指定する場合は、一時ファイルパス名を指定したBSFILE構造体のアドレスを設定します。
一時ファイルパス名を省略する場合は<NULL>を設定します。一時ファイルパス名を省略すると、以下の優先順位に従って一時ファイルを作成するフォルダを決定します。指定されたフォルダが存在しない場合はエラーとなります。

1. 環境変数BSORT_TMPDIRで指定されたフォルダ
2. 環境変数TEMPで指定されたフォルダ
3. 環境変数TMPで指定されたフォルダ
4. Windowsシステムのフォルダ

◆BSPTR_UCHAR　　msgfile_addr

メッセージファイルパス名を指定する場合は、メッセージファイルパス名のアドレスを設定します。
メッセージファイルパス名は<NULL>で終わる文字列です。
メッセージファイルパス名を省略する場合は、<NULL>を設定します。
メッセージファイルパス名を省略した場合、環境変数BSORT_MSGFILEの指定があれば、指定したファイルにメッセージを出力します。

◆BSPTR_BSFSYS　　inpfsys_tbl

BSFSYS構造体のアドレスを設定します。
入力ファイルパス名を指定しない場合、またはシステムの標準ファイルシステムだけを使用する場合は指定を省略できます。

◆unsigned char　　outfsys

出力ファイルのファイルシステムを設定します。
ファイルシステムについてはBSFSYS構造体を参照してください。出力ファイルパス名を指定しない場合、またはシステムの標準ファイルシステムを使用する場合は指定を省略できます。

◆unsigned char　　recovery

出力ファイルがファイルシステムの許容量を超えた場合のリカバリ処理を設定します。
リカバリ処理は、出力ファイルがファイルシステムの許容量を超えた場合、複数のファイルに分割して出力します。このため、リカバリ処理を指定した場合は出力ファイルを複数指定してください。リカバリ処理の指定がないときに出力ファイルがファイルシステムの許容量を超えた場合には、別の出力ファイルをオープンすることなく出力処理は終了します。リカバリ処理は以下のファイルを処理する場合に指定できます。

• システム標準のファイル(テキストファイル、バイナリファイル)

リカバリ処理を指定する場合は以下を指定します。

定義値	意味
BSRC_FILE	リカバリ処理を行います。

◆BSPTR_BSIDX　　idx_addr

BSIDX構造体のアドレスを設定します。
出力ファイルが富士通COBOLファイルシステムの索引ファイルのときに有効です。富士通COBOLファイルシステムの索引ファイルの場合は省略できません。BSIDX構造体については、BSIDX構造体を参照してください。

◆BSPTR_BSFILE_EXT　　outfile_tbl

BSFILE_EXT構造体のアドレスを設定します。
リカバリ処理を行う場合の出力ファイルの情報を設定します。
また、入力ファイルまたは出力ファイルのファイルシステムにBtrieveファイルシステムを指定した場合に、入力Btrieveファイルのオーナーネーム、または出力Btrieveファイルのインデックス情報を設定します。