# 集配信履歴ファイルの再編成

集配信履歴ファイルの履歴情報を削除すると、DASDに未使用領域が発生し、DASDの使用効率に問題が発生します。DASDの未使用領域を効率的に使用できるようにするため、履歴情報の削除を実施した後は、集配信履歴ファイル再編成プログラムを使用して再編成を行うことをお勧めします。

## 集配信履歴ファイルの再編成プログラム

### プログラム名

XRREORG

### XRSYSIN定義カード（省略可）

HULFTシステムの動作環境を設定します。設定内容の詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : 各項目の説明

定義カードの形式

    JESC=JESコマンドの頭文字
    OPLSELECT=操作ログ出力選択 (*1)

*1 | : | 操作ログ出力機能を使用する場合は、操作ログ関連の設定が必要です。詳細は「操作ログの動作設定」を参照してください。

### JCL例

    //XRREORG  JOB  CLASS=A,MSGCLASS=B
    //*
    //XRREORG  EXEC PGM=XRREORG
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRLOG    DD   DSN=HULFT.LOG,DISP=SHR
    //XRLOG1   DD   DSN=HULFT.LOG.PATH1,DISP=SHR
    //XRLOG2   DD   DSN=HULFT.LOG.PATH2,DISP=SHR
    //XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR
    //XRPRINT  DD   SYSOUT=*
    //XRWRK    DD   DSN=HULFT.LOG.BKUP,
    //              DISP=(NEW,CATLG,CATLG),UNIT=SYSDA,
    //              SPACE=(CYL,(5,1),RLSE),VOL=SER=HUL001
    //SYSOUT   DD   SYSOUT=*
    //SYSPRINT DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル
XRSYSIN | HULFT.PARMLIB(HULPRM) | システム動作環境設定ファイル
XRWRK | HULFT.LOG.BKUP | 集配信履歴ファイル（バックアップファイル）

パラメーター名 | 項目名 | 説明
--- | --- | ---
UNIT | SYSDA | UNIT
VOL=SER | HUL001 | ボリューム名

注意

集配信履歴ファイルの再編成プログラムの実行中は、ジョブのキャンセルは行わないでください。実行中にジョブをキャンセルした場合、集配信履歴ファイルが破損することがあります。そのため、ジョブをキャンセルした場合は必ず集配信履歴ファイルを復旧してください。詳細は「異常時の復旧方法」を参照してください。

### 異常時の復旧方法

集配信履歴ファイル再編成プログラムの実行中に異常が発生した場合、集配信履歴ファイルが破損することがあります。

集配信履歴ファイルの復旧方法の手順を以下に示します。

1. 集配信履歴ファイルオープンコマンドを実行します。

HULFTが稼働中の場合、HULFTに集配信履歴ファイルオープンコマンドを発行してください。集配信履歴ファイルオープンコマンドの詳細は、「集配信履歴ファイルオープンコマンド」を参照してください。

2. HULFTを終了します。

配信プログラム、集信プログラム、および要求受付プログラムを終了してください。HULFTの終了方法は、「HULFTの起動と終了」を参照してください。

3. AMSコマンドのVERIFYコマンドを実行します。

AMSコマンドのVERIFYコマンドを実行します。

集配信履歴ファイルのクローズを妨げるエラーの後で、カタログにデータ・セットの終わりを正しく反映させます。AMSコマンドのVERIFYコマンドについては、「DFSMS Access Method Services for Catalogs」を参照してください。

以下に、AMSコマンドのVERIFYコマンドのJCL例を示します。

- JCL例

      //VERIFY   JOB  CLASS=A,MSGCLASS=B
      //VERIFY   EXEC PGM=IDCAMS
      //XRLOG    DD   DSN=HULFT.LOG,DISP=SHR
      //XRLOG1   DD   DSN=HULFT.LOG.PATH1,DISP=SHR
      //XRLOG2   DD   DSN=HULFT.LOG.PATH2,DISP=SHR
      //SYSPRINT DD   SYSOUT=*
      //SYSIN    DD   *
      VERIFY FILE(XRLOG)
      VERIFY FILE(XRLOG1)
      VERIFY FILE(XRLOG2)
      //

  DD名 | 項目名 | 説明
  --- | --- | ---
  XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
  XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
  XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル

4. RELOADを実行します。

集配信履歴ファイルのバックアップファイルからのローディング処理を行います。

以下に、RELOADを実行するJCL例を示します。

- JCL例

      //XRRELOAD JOB CLASS=A,MSGCLASS=B
      //*
      //XRRELOAD EXEC PGM=XRREORG,REGION=2048K,
      //         PARM='RELOAD'
      //STEPLIB  DD DSN=HULFT.LOAD,DISP=SHR
      //XRLOG    DD DSN=HULFT.LOG,DISP=SHR
      //XRLOG1   DD DSN=HULFT.LOG.PATH1,DISP=SHR
      //XRLOG2   DD DSN=HULFT.LOG.PATH2,DISP=SHR
      //XRWRK    DD DSN=HULFT.LOG.BKUP,
      //         DISP=(OLD,KEEP,KEEP),UNIT=SYSDA,
      //         VOL=SER=VOL001
      //XRSYSIN  DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR
      //

  DD名 | 項目名 | 説明
  --- | --- | ---
  STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
  XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
  XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
  XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル
  XRWRK | HULFT.LOG.BKUP | 集配信履歴ファイル（バックアップファイル）
  XRSYSIN | HULFT.PARMLIB(HULPRM) | システム動作環境設定ファイル

  パラメーター名 | 項目名 | 説明
  --- | --- | ---
  UNIT | SYSDA | UNIT
  VOL=SER | VOL001 | ボリューム名

  注意

  集配信履歴ファイルの領域が不十分な場合、RELOADに失敗する場合があります。履歴レコードを格納するために十分な容量を指定して集配信履歴ファイルを再創生し、再度RELOADを実行してください。

以上で集配信履歴ファイルの復旧は完了です。

改めて集配信履歴ファイルの再編成プログラムを実行してください。

実行後に、配信プログラム、集信プログラム、および要求受付プログラムを再起動してください。詳細は「HULFTの起動と終了」を参照してください。

注意

集配信履歴ファイルの再編成プログラムの実行中は、集配信履歴ファイルへの書き込み処理は待機状態となります。

配信後ジョブは、配信履歴が書き込まれた後に実行されます。このため、集配信履歴ファイルの再編成中は配信後ジョブは実行されません。

集信後ジョブは、集信履歴が書き込まれた後に実行されます。このため、集配信履歴ファイルの再編成中は集信後ジョブは実行されません。

また、集配信履歴ファイルの再編成中に以下の設定で集信を行った場合、配信側ホストが集信の応答待ちとなり、タイムアウトする場合があります。

- 集信管理情報の集信完了通知（RCVEND-NOTICE）に“J（ジョブ完了）”を設定