# フォーマット情報登録コマンド

## プログラムインターフェイス

    CALL ライブラリー名/UTLDTOF PARM(['LIB=ライブラリー名']
       'F=filename' ['CSTMFILE=filename'] ['FMTID=fmtid'] ['R']
       ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

## パラメーター説明

LIB=ライブラリー名

  HULFTがインストールされているライブラリー名（省略時値 HULFT）

  先頭英字の10バイト以内の英数字で指定します。

F=filename

  FFDを読み込むファイル名（省略不可）

  「ライブラリー名/ファイル名」の形式で指定します。

  注意

  DDSは直接読み込めません。

CSTMFILE=filename

  カスタマイズファイル名（省略可）

  「ライブラリー名/ファイル名(メンバー名)」の形式で指定します。カスタマイズファイルを指定することによって、ユーザー任意の変換規則を設定することができます。カスタマイズファイルの詳細は、「カスタマイズファイルと項目タイプ」を参照してください。

  省略するとデフォルトの変換規則で処理します。

FMTID=fmtid

  登録するフォーマットID（省略可）

  先頭英字の50バイト以内の英数字および“_”で指定します。

  省略するとレコード様式名の先頭10バイトをフォーマットIDとして登録します。

R

  上書き指定（省略可）

  省略すると同一のフォーマットIDが存在する場合にはエラーとなります。

G

  フォーマット情報登録コマンドが出力するエラーメッセージの表示有無（省略可）

  省略するとエラーメッセージが表示されます。

OUTPUT=filename

  フォーマット情報登録コマンドが出力するエラーメッセージの出力先（省略可）

  「ライブラリー名/ファイル名(メンバー名)」の形式で指定します。

  省略するとエラーメッセージは出力されません。

  ログファイルのレコード保持件数は無制限です。

EXIT CL変数名

  フォーマット情報登録コマンドが出力するエラーコードの受け取りとCL変数名（省略可）

  EXITとCL変数名は連続して指定してください。

  異常終了の場合のみ、エラーコードをCL変数へセットします。

  省略するとエラーコードはセットされません。

## コマンドインターフェイス

    UTLDTOF FFDFILE( ) CSTMFILE( ) CSTMMBR( ) FMTID( ) REPLACE( )
       LIBRARY( ) MSG( ) FILE( ) MBR( )

## パラメーター説明

FFDFILE

  FFDの登録されているファイルのライブラリー名とファイル名（省略不可）

  「ライブラリー名/ファイル名」の形式で指定します。

  それぞれ先頭英字の10バイト以内の英数字で指定します。

CSTMFILE

  カスタマイズファイルのライブラリー名とファイル名（省略可）

  「ライブラリー名/ファイル名」の形式で指定します。

  それぞれ先頭英字の10バイト以内の英数字で指定します。

  カスタマイズファイルを指定することによって、ユーザー任意の変換規則を設定することができます。カスタマイズファイルの詳細は、「カスタマイズファイルと項目タイプ」を参照してください。

  省略するとデフォルトの変換規則で処理します。

CSTMMBR

  カスタマイズファイルのメンバー名（省略時値 *FILE）

  先頭英字の10バイト以内の英数字で指定します。

FMTID

  登録するフォーマットID（省略可）

  先頭英字の50バイト以内の英数字および“_”で指定します。

  省略するとレコード様式名の先頭10バイトをフォーマットIDとして登録します。

REPLACE

  上書き指定（省略時値 *NO）

  *NO

    : 既に指定したIDが存在する場合、エラーとなる

  *YES

    : 既に指定したIDが存在する場合、置換えを行う

LIBRARY

  HULFTがインストールされているライブラリー名（省略時値 HULFT）

  先頭英文字の10バイト以内の英数字で指定します。

MSG

  エラーメッセージの表示有無（省略時値 *YES）

  *NO

    : エラーメッセージを表示しない

  *YES

    : エラーメッセージを表示する

FILE

  エラーメッセージ出力先ファイルのライブラリー名とファイル名（省略可）

  「ライブラリー名/ファイル名」の形式で指定します。

  それぞれ先頭英字の10バイト以内の英数字で指定します。

  省略するとエラーメッセージは出力されません。ログファイルのレコード保持件数は無制限です。

MBR

  エラーメッセージ出力先ファイルのメンバー名（省略時値 *FILE）

  先頭英字の10バイト以内の英数字で指定します。

## カスタマイズファイルと項目タイプ

項目タイプのデフォルト値は表6.2 のとおりです。

表6.2 変換規則

FFD項目タイプ | A | B | E | O | F | G | J | P | S | その他
HULFT項目タイプ | X | B | M | M | F | N | M | P | S | I

= 備考 =

- 項目サイズはFFD項目が記憶域内で占有しているバイト数を採用します。採用された項目サイズがHULFTのフォーマット情報項目タイプに適さない場合、エラーとなります。

- 可変長フィールドが使用されている場合はエラーとなります。

- フォーマット情報での「項目名」は、FFDで定義されている「フィールド名」を使用します。

HULFTのフォーマット定義にはないFFDの項目タイプが存在した場合、デフォルトでは「I」タイプの項目としてフォーマット情報に登録されます。カスタマイズファイルを作成し、項目の変換パターンを指定することによって、ユーザー任意の項目タイプとして登録することができます。

- カスタマイズファイルの定義例

      *FFD定義 = HULFT定義 A = XB = BE = MO = MF = FG = NP = P

= 備考 =

- 「=」の左項目にFFDの項目タイプを、右項目にHULFTのフォーマット「項目タイプ」を指定します。

- 「*」で始まる行はコメントです。また、0x7Bで始まる行もコメントになります。

  ただし、0x7Bはコードセットによって表示される文字が変わります。

  日本語コードセットの場合、0x7Bは「#」と表示されます。

- 存在しないHULFTのフォーマット「項目タイプ」を指定した場合は、エラーとなります。

- FFDの項目タイプが重複する場合は、最初に定義されているものが有効になります。

- FFDの項目タイプが指定されていない場合は、デフォルト値で処理します。

- 「=」の前後に項目タイプがない場合や、「=」がない場合は、エラーとなります。