フォーマット情報登録コマンド
プログラムインターフェイス
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 のとおりです。
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の項目タイプが指定されていない場合は、デフォルト値で処理します。
-
「=」の前後に項目タイプがない場合や、「=」がない場合は、エラーとなります。