# 管理情報パラメーターファイル生成コマンド

すでに登録済みの各管理情報から、管理情報バッチ登録コマンド（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（有効）”に変更する場合、以下の手順でパラメーターファイルの設定を見直してください。

1. 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更する前の状態でパラメーターファイルを生成する。
2. パラメーターファイルの暗号キーを高強度暗号強制モード（STRONGKEYMODE）の設定値を変更後の状態で使用できる暗号キーに設定し直す。
3. 高強度暗号強制モード（STRONGKEYMODE）の設定値を変更し、パラメーターファイルを登録する。

上記の手順に従わず、高強度暗号強制モード（STRONGKEYMODE）の設定値を変更してパラメーターファイルを生成すると、暗号キーに“%ERROR”と出力されます。