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

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

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 = X

    B = B

    E = M

    O = M

    F = F

    G = N

    P = P

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

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

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

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

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

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

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

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