複数ファイル結合

複数のファイルを1つのファイルに結合します。すでに存在する結合ファイルへの追加や、他機種で作成された結合ファイルへの追加も可能です。

(1) 複数ファイル結合コマンド

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

CALL ライブラリ名/UTLJOIN PARM(['LIB=ライブラリ名'] 'INFILE=filename'
   'FILETYPE={B|T|F|M}' ['formatid|multiformatid'] 'OUTFILE=filename'
   'MODE={N|R|M}' ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

パラメータ説明

LIB=ライブラリ名

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

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

INFILE=filename

入力ファイル名（省略不可）

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

「メンバ名」はアスタリスク（*）を使用することで前方一致・後方一致の形式での指定が可能です。

FILETYPE=B|T|F|M

ファイルタイプ（省略不可）

B: : バイナリ形式
T: : テキスト形式
F: : フォーマット形式
M: : マルチフォーマット形式

formatid|multiformatid

フォーマット情報のフォーマットIDまたは、マルチフォーマット情報のマルチフォーマットID（省略可）

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

ファイルタイプに“F”、または“M”を指定した場合は省略できません。

OUTFILE=filename

出力ファイル名（結合ファイル名）（省略不可）

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

MODE=N|R|M

結合ファイルの作成モード（省略不可）

N（新規作成）: : すでに指定ファイルが存在する場合はエラー
R（置き換え）: : すでに指定ファイルが存在する場合は置き換え、存在しない場合は新規作成
M（追加書き）: : すでに指定ファイルが存在する場合は追加書き、存在しない場合は新規作成

“M（追加書き）”を指定した場合、すでに存在しているファイルが結合ファイルでないときはエラーになります。

G

複数ファイル結合コマンドが出力するエラーメッセージの表示抑制（省略可）

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

OUTPUT=filename

複数ファイル結合コマンドが出力するエラーメッセージの出力先（省略可）

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

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

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

EXIT CL変数名

複数ファイル結合コマンドが出力するエラーコードの受け取りとCL変数名（省略可）

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

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

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

注意

「INFILE=filename」指定時のそれぞれファイルタイプにおけるレコードサイズの制限、また「FILETYPE=B|T|F|M」指定時のファイルサイズの制限については、「アドミニストレーションマニュアル」を参照してください。

= 備考 =

「'INFILE=filename' 'FILETYPE=B|T|F|M' 'formatid|multiformatid'」は最大10回繰り返し指定できます。指定方法は、「(2) 記述例」を参照してください。

コマンドインタフェース

UTLJOIN INFINFO((file library member type formatid|multiformatid))
   JOINFILE( ) JOINMBR( ) MAKEMODE( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

パラメータ説明

INFINFO

入力ファイルの情報（省略不可）

file

入力ファイルのファイル名を指定します。

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

library

入力ファイルのライブラリ名を指定します。

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

member

入力ファイルのメンバ名を指定します。

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

アスタリスク（*）を使用することで前方一致・後方一致の形式での指定が可能です。

type

ファイルタイプ

BIN: : バイナリ形式
TXT: : テキスト形式
FMT: : フォーマット形式
MFMT: : マルチフォーマット形式

formatid|multiformatid

フォーマット情報のフォーマットIDまたは、マルチフォーマット情報のマルチフォーマットID

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

ファイルタイプに“FMT”、または“MFMT”を指定した場合は省略できません。

JOINFILE

出力ファイル（結合ファイル）のライブラリ名とファイル名（省略不可）

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

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

JOINMBR

出力ファイル（結合ファイル）のメンバ名（省略時値 *FILE）

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

MAKEMODE

結合ファイルの作成モード

NEW（新規作成）: : 既に指定ファイルが存在する場合はエラー
REP（置き換え）: : 既に指定ファイルが存在する場合は置き換え、存在しない場合は新規作成
MOD（追加書き）: : 既に指定ファイルが存在する場合は追加書き、存在しない場合は新規作成

LIBRARY

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

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

MSG

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

*NO: : エラーメッセージを表示しない
*YES: : エラーメッセージを表示する

FILE

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

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

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

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

MBR

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

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

= 備考 =

「INFINFO」の“(file library member type formatid|multiformatid)”は最大10回繰り返し指定できます。また、入力ファイルに保管ファイルを指定することはできません。

(2) 記述例

ファイル「MYLIB/JOIN1(TEST01)」のフォーマット情報を「FORMAT01」、ファイル「MYLIB/JOIN1(TEST02)」のフォーマット情報を「FORMAT02」として、これらのファイルを結合して「MYLIB/OUT1(TEST)」というファイル名で新規に作成する。

CALL HULFT/UTLJOIN PARM('INFILE=MYLIB/JOIN1(TEST01)' 'FILETYPE=F' 'FORMAT01'
    'INFILE=MYLIB/JOIN1(TEST02)' 'FILETYPE=F' 'FORMAT02' 'MODE=N'
    'OUTFILE=MYLIB/OUT1(TEST)')

ファイル「MYLIB/JOIN2」の中のメンバから「TEST」で始まるメンバをすべてテキストタイプとして結合し、「MYLIB/OUT2(TEST)」というファイルを上書きモードで作成する。

CALL HULFT/UTLJOIN PARM('INFILE=MYLIB/JOIN2(TEST*)' 'FILETYPE=T' 'MODE=R'
    'OUTFILE=MYLIB/OUT2(TEST)')

ファイル「MYLIB/JOIN3」の中のメンバから「T」で始まるメンバのマルチフォーマット情報を「MFORMAT1」としてすべて結合し、「MYLIB/OUT3(TEST)」というファイルを追加モードで作成する。

CALL HULFT/UTLJOIN PARM('INFILE=MYLIB/JOIN3(T*)' 'FILETYPE=M' 'MFORMAT1'
    'MODE=M' 'OUTFILE=MYLIB/OUT3(TEST)')