管理情報パラメーターファイル生成コマンド
すでに登録済みの各管理情報から、管理情報バッチ登録コマンド（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キャラクターセットを一致させる
-
プログラムインターフェイス
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)'を繰り返すことにより、複数のパラメーターファイルを生成することができます。
記述例
CALL HULFT/UTLIGEN PARM('F=MYLIB/IGEN(TEST)' 'I=SND' 'ID=S*' 'I=RCV' 'ID=RCV00001')
上記のように記述すると、配信管理情報に登録されている「S」で始まるすべてのファイルIDおよび、集信管理情報に登録されているファイルID「RCV00001」から、パラメーターファイル「MYLIB/IGEN(TEST)」を生成します。
高強度暗号強制モードの設定を変更した場合の注意
システム動作環境設定の高強度暗号強制モード（STRONGKEYMODE）の設定値を“1（有効）”から“0（無効)”に、または“0（無効）”から“1（有効）”に変更する場合、以下の手順でパラメーターファイルの設定を見直してください。
- 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更する前の状態でパラメーターファイルを生成する。
- パラメーターファイルの暗号キーを高強度暗号強制モード（STRONGKEYMODE）の設定値を変更後の状態で使用できる暗号キーに設定し直す。
- 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更し、パラメーターファイルを登録する。
上記の手順に従わず、高強度暗号強制モード（STRONGKEYMODE）の設定値を変更してパラメーターファイルを生成すると、暗号キーに“%ERROR”と出力されます。