8.3.1　INIT要求

機能

蓄積ファイル編集ユーティリティの初期化要求（INIT要求）を行います。

形式

ANSI Cの形式

#include <esafl.h>
int es_afl_init(ESAFL_INPARAM *inparam_pt, ESAFL_OUTPARAM *outparam_pt,
                ESLONG flags)

パラメタの内容

ESAFL_INPARAMのパラメタ内容

typedef struct es_afl_inparam_t{        ………入力ファイルパラメタ構造体
    char    file_dir[1024];             ………蓄積ファイル格納ディレクトリパス
    char    file_name[48];              ………蓄積ファイル名
    char    yobi1[32];                  ………予備
    ESULONG protocol;                   ………プロトコル種別
    char    yobi[92];                   ………予備
} ESAFL_INPARAM;

ESAFL_OUTPARAMFILEのパラメタ内容

typedef struct es_afl_outparam_t{       ………出力ファイルパラメタ構造体    
    char    file_dir[1024];             ………蓄積ファイル格納ディレクトリパス
    char    file_name[48];              ………蓄積ファイル名
    char    test_id[32];                ………テスト識別子
    char    yobi1[4];                   ………予備
    ESULONG file_type;                  ………蓄積ファイル種別
    ESLONG  buf_size;                   ………蓄積バッファサイズ
    char    reuse_flg;                  ………蓄積ファイル上書き有無
    char    yobi[83];                   ………予備
} ESAFL_OUTPARAM;

UAPで値を設定するパラメタ項目

inparam_pt

入力ファイルパラメタ構造体のアドレスを設定します。

GET要求とPUT要求を行うときは、設定してください。拡張PUT要求を行うときは、NULLを設定してください。

入力ファイルパラメタ構造体に次の情報を設定してください。

• 蓄積ファイル格納ディレクトリパス

  入力する蓄積ファイルが格納されているディレクトリを絶対パス名で980バイト以内（Windows版の場合は217バイト以内）で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

• 蓄積ファイル名

  入力する蓄積ファイル名を41バイト以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

• プロトコル種別

  GET要求の対象となるプロトコル種別を論理輪で設定します。

  ESAFL_PROTOMOD_TCP ：TCPプロトコル

  ESAFL_PROTOMOD_UDP ：UDPプロトコル

  ESAFL_PROTOMOD_HTTP：HTTPプロトコル

outparam_pt

出力ファイルパラメタ構造体のアドレスを設定します。

PUT要求と拡張PUT要求を行うときは、設定してください。PUT要求と拡張PUT要求を行わないときは、NULLを設定してください。

出力ファイルパラメタ構造体に次の情報を設定してください。

• 蓄積ファイル格納ディレクトリパス

  出力する蓄積ファイルを格納するディレクトリを絶対パス名で980バイト以内（Windows版の場合は217バイト以内）で設定します。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

• 蓄積ファイル名

  出力する蓄積ファイル名を41バイト以内で設定してください。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

  蓄積ファイル名の命名規則は「5.2.1　蓄積ファイルの構成」を参照してください。任意のファイル名としたときは、ファイル名を変更しないとリプレイ実行を行うことができません。

• テスト識別子

  テスト識別子を31バイト以内で設定します。文字列の最後には、null文字を設定してください。このnull文字は文字列の長さに数えません。

• 蓄積ファイル種別

  出力する蓄積ファイルの種別を設定します。

  ESAFL_FILETYPE_REQ ：本番用の要求電文蓄積ファイル

• 蓄積バッファサイズ

  蓄積ファイルを出力する際に使用する蓄積バッファの最大サイズを1から100（単位：メガバイト）の範囲で設定します。

• 蓄積ファイル上書き有無

  出力先のディレクトリ下に既に蓄積ファイルが存在したときに上書きするかどうかを設定します。

  蓄積ファイルが存在し、上書きしない設定を行っていたときは、エラーリターンします。

  ESAFL_YES ：上書きする。

  ESAFL_NO ：上書きしない。

flags

ESNOFLAGSを設定してください。

HSICから値が返されるパラメタ項目

ありません。

リターン値

注意事項

各パラメタ構造体の予備領域はNULLクリアしてください。