各管理情報のパラメータファイル生成
すでに登録済みの各管理情報から、管理情報バッチ登録コマンド（UTLIUPDT）で使用するパラメータファイル（定義カード）を生成することができます。
下記の設定を満たしていない場合、パラメータファイルが正しく生成されません。
コマンドラインで実行する場合
エミュレータの設定（「ホスト・コード・ページ」）と、このコマンドを実行するジョブのCCSID（コード化文字セット識別コード）とパラメータファイルのCCSID（コード化文字セット識別コード）が下記のいずれかを満たすように設定してください。
【設定1】
-
エミュレータの設定とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）に65535を設定する
-
パラメータファイルのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
【設定2】
-
エミュレータの設定とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）に65535を設定する
-
パラメータファイルのCCSID（コード化文字セット識別コード）に65535を設定する
【設定3】
-
エミュレータの設定とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
-
ジョブのCCSID（コード化文字セット識別コード）をシステム動作環境設定ファイルのHULFTキャラクタセットと一致させる
-
パラメータファイルのCCSID（コード化文字セット識別コード）は任意
バッチジョブで実行する場合
このコマンドを実行するバッチジョブのCCSID（コード化文字セット識別コード）と、パラメータファイルのCCSID（コード化文字セット識別コード）が下記のいずれかを満たすように設定してください。
【設定1】
-
バッチジョブのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
-
パラメータファイルのCCSID（コード化文字セット識別コード）は任意
【設定2】
-
バッチジョブのCCSID（コード化文字セット識別コード）を65535に設定する
-
バッチジョブのCCSID（コード化文字セット識別コード）とシステム動作環境設定ファイルのHULFTキャラクタセットを一致させる
(1) 管理情報パラメータファイル生成コマンド
プログラムインタフェース
CALL ライブラリ名/UTLIGEN PARM(['LIB=ライブラリ名']
'F=filename' 'I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}' ['ID=id']
['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])
パラメータ説明
- LIB=ライブラリ名
-
HULFTがインストールされているライブラリ名（省略時値 HULFT）
先頭英字の10バイト以内の英数字で指定します。
- F=filename
-
パラメータファイル名（省略不可）
「ライブラリ名/ファイル名(メンバ名)」の形式で指定します。
ファイルが存在しない場合は、新規にファイルを作成します。すでに存在する場合は、上書きで作成します。
- I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}
-
パラメータファイルを生成する管理情報を選択（省略不可）
- SND
-
: 配信管理情報
- RCV
-
: 集信管理情報
- JOB
-
: ジョブ起動情報
- HST
-
: 詳細ホスト情報
- TGRP
-
: 転送グループ情報
- FMT
-
: フォーマット情報
- MFMT
-
: マルチフォーマット情報
- ID=id
-
生成対象のIDまたはホスト名（省略可）
省略すると指定した管理情報の全情報を含むパラメータファイルが生成されます。
詳細ホスト情報以外のIDは50バイト以内の英数字で指定します。詳細ホスト情報のホスト名は68バイト以内の英数字で指定します。
アスタリスク（*）を使用することにより、IDの前方一致指定が可能です。
- G
-
管理情報パラメータファイル生成コマンドが出力するエラーメッセージの表示抑制（省略可）
省略するとエラーメッセージが表示されます。
- OUTPUT=filename
-
管理情報パラメータファイル生成コマンドが出力するエラーメッセージの出力先（省略可）
「ライブラリ名/ファイル名(メンバ名)」の形式で指定します。
省略するとエラーメッセージは出力されません。
ログファイルのレコード保持件数は無制限です。
- EXIT CL変数名
-
管理情報パラメータファイル生成コマンドが出力するエラーコードの受け取りとCL変数名（省略可）
EXITとCL変数名は連続して指定してください。
異常終了の場合のみ、エラーコードをCL変数へセットします。
省略するとエラーコードはセットされません。
パラメータファイルは、レコード長224バイト以上かつ、2バイト文字セットが使用可能であるファイルを使用してください。正しいパラメータファイルが生成できない場合があります。
「'I={SND|RCV|JOB|HST|TGRP|FMT|MFMT}' 'ID=id'」を繰り返すことにより、複数の情報を含むパラメータファイルを生成することができます。
コマンドインタフェース
UTLIGEN PARMFILE( ) PARMMBR( ) FILETYPE((i id)) LIBRARY( ) MSG( ) FILE( ) MBR( )
パラメータ説明
- PARMFILE
-
パラメータファイルのライブラリ名とファイル名（省略不可）
「ライブラリ名/ファイル名」の形式で指定します。
それぞれ先頭英字の10バイト以内の英数字で指定します。
ファイルが存在しない場合は、新規にファイルを作成します。既に存在する場合は、上書きで作成します。
- PARMMBR
-
パラメータファイルのメンバ名（省略時値 *FILE）
先頭英字の10バイト以内の英数字で指定します。
- FILETYPE
-
パラメータファイルを生成する情報（省略不可）
- i
-
パラメータファイルを生成する管理情報を選択
- SND
-
: 配信管理情報
- RCV
-
: 集信管理情報
- JOB
-
: ジョブ起動情報
- HST
-
: 詳細ホスト情報
- TGRP
-
: 転送グループ情報
- FMT
-
: フォーマット情報
- MFMT
-
: マルチフォーマット情報
- id
-
生成対象のIDまたはホスト名
“*ALL”を指定すると、指定した管理情報の全情報が生成されます。
詳細ホスト情報以外のIDは50バイト以内の英数字で指定します。詳細ホスト情報のホスト名は68バイト以内の英数字で指定します。
アスタリスク（*）を使用することにより、IDの前方一致指定が可能です。
- LIBRARY
-
HULFTがインストールされているライブラリ名（省略時値 HULFT）
先頭英字の10バイト以内の英数字で指定します。
- MSG
-
エラーメッセージの表示抑制（省略時値 *YES）
- *NO
-
: エラーメッセージを表示しない
- *YES
-
: エラーメッセージを表示する
- FILE
-
エラーメッセージ出力先ファイルのライブラリ名とファイル名（省略可）
「ライブラリ名/ファイル名」の形式で指定します。
それぞれ先頭英字の10バイト以内の英数字で指定します。
省略するとエラーメッセージは出力されません。ログファイルのレコード保持件数は無制限です。
- MBR
-
エラーメッセージ出力先ファイルのメンバ名（省略時値 *FILE）
先頭英字の10バイト以内の英数字で指定します。
'FILETYPE'の'(i id)'を繰り返すことにより、複数のパラメータファイルを生成することができます。
(2) 記述例
CALL HULFT/UTLIGEN PARM('F=MYLIB/IGEN(TEST)' 'I=SND' 'ID=S*' 'I=RCV' 'ID=RCV00001')
上記のように記述すると、配信管理情報に登録されている「S」で始まるすべてのファイルIDおよび、集信管理情報に登録されているファイルID「RCV00001」から、パラメータファイル「MYLIB/IGEN(TEST)」を生成します。
(3) 高強度暗号強制モードの設定を変更した場合の注意
システム動作環境設定の高強度暗号強制モード（STRONGKEYMODE）の設定値を“1（有効）”から“0（無効)”に、または“0（無効）”から“1（有効）”に変更する場合、以下の手順でパラメータファイルの設定を見直してください。
- 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更する前の状態でパラメータファイルを生成する。
- パラメータファイルの暗号キーを高強度暗号強制モード（STRONGKEYMODE）の設定値を変更後の状態で使用できる暗号キーに設定し直す。
- 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更し、パラメータファイルを登録する。
上記の手順に従わず、高強度暗号強制モード（STRONGKEYMODE）の設定値を変更してパラメータファイルを生成すると、暗号キーに“%ERROR”と出力されます。