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

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

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

プログラム名

XRREORG

XRSYSIN定義カード（省略可）

HULFTシステムの動作環境を設定します。設定内容の詳細は、「アドミニストレーションマニュアル」のシステム動作環境設定を参照してください。

定義カードの形式

OPLSELECT=操作ログ出力選択 (*1)

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

JCL例

\         JOB  XRREORG,LIST=(A,JS)                                              
\XRREORG  EX   XRREORG,RSIZE=2048,OPT=DUMP                                      
\         FD   STEPCAT=DA,FILE=USERCAT                                          
\         FD   XRLOG=DA,FILE=HULFT.LOG,AMP=AMORG                                
\         FD   XRLOG1=DA,FILE=HULFT.LOG.PATH1,AMP=AMORG                         
\         FD   XRLOG2=DA,FILE=HULFT.LOG.PATH2,AMP=AMORG                         
\         FD   XRSYSIN=DA,FILE=HULFT.PARMLIB,MEMBER=HULPRM                      
\         FD   XRWRK=DA,VOL=HUL001,CYL=(5,1),DISP=(CAT,KEEP),          C        
          FILE=HULFT.LOG.BKUP                                                   
\         JEND

FD名	項目名	説明
STEPCAT	USERCAT	カタログ簿データセット名
XRSYSIN	HULFT.PARMLIB(HULPRM)	システム動作環境設定ファイル
XRLOG	HULFT.LOG	集配信履歴ファイルIDキーファイル
XRLOG1	HULFT.LOG.PATH1	集配信履歴ホスト名キーファイル
XRLOG2	HULFT.LOG.PATH2	集配信履歴日付キーファイル
XRWRK	HULFT.LOG.BKUP	集配信履歴ファイル（バックアップファイル

パラメータ名	項目名	説明
VOL	HUL001	ボリューム名

注意

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

異常時の復旧方法

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

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

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

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

2. HULFTを終了します。

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

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

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

集配信履歴ファイルのクローズを妨げるエラーの後で、カタログにファイルの終わりを正しく反映させます。AMSコマンドのVERIFYコマンドについては、「AMSコマンド文法書」を参照してください。

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

JCL例

\         JOB  VERIFY,LIST=(A,JS)                                               
\VERIFY   EX   KQCAMS                                                           
\         FD   STEPCAT=DA,FILE=USERCAT                                          
\         FD   XRLOG=DA,FILE=HULFT.LOG,AMP=AMORG                                
\         FD   XRLOG1=DA,FILE=HULFT.LOG.PATH1,AMP=AMORG                         
\         FD   XRLOG2=DA,FILE=HULFT.LOG.PATH2,AMP=AMORG                         
\         FD   XRSYSIN=DA,FILE=HULFT.PARMLIB,MEMBER=HULPRM                      
\         FD   SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A                          
\         FD   SYSIN=*                                                          
VERIFY FILE(XRLOG)                                                              
VERIFY FILE(XRLOG1)                                                             
VERIFY FILE(XRLOG2)                                                             
\        JEND

FD名	項目名	説明
STEPCAT	USERCAT	カタログ簿データセット名
XRLOG	HULFT.LOG	集配信履歴ファイルIDキーファイル
XRLOG1	HULFT.LOG.PATH1	集配信履歴ホスト名キーファイル
XRLOG2	HULFT.LOG.PATH2	集配信履歴日付キーファイル
XRSYSIN	HULFT.PARMLIB(HULPRM)	システム動作環境設定ファイル

4. RELOADを実行します。

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

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

JCL例

\         JOB  XRREORG,LIST=(A,JS)                                              
\XRREORG  EX   XRREORG,RSIZE=2048,OPT=DUMP                                      
\         PARA RELOAD                                                           
\         FD   STEPCAT=DA,FILE=USERCAT                                          
\         FD   XRLOG=DA,FILE=HULFT.LOG,AMP=AMORG                                
\         FD   XRLOG1=DA,FILE=HULFT.LOG.PATH1,AMP=AMORG                         
\         FD   XRLOG2=DA,FILE=HULFT.LOG.PATH2,AMP=AMORG                         
\         FD   XRSYSIN=DA,FILE=HULFT.PARMLIB,MEMBER=HULPRM                      
\         FD   XRWRK=DA,FILE=HULFT.LOG.BKUP                                     
\         JEND

FD名	項目名	説明
STEPCAT	USERCAT	カタログ簿データセット名
XRLOG	HULFT.LOG	集配信履歴ファイルIDキーファイル
XRLOG1	HULFT.LOG.PATH1	集配信履歴ホスト名キーファイル
XRLOG2	HULFT.LOG.PATH2	集配信履歴日付キーファイル
XRSYSIN	HULFT.PARMLIB(HULPRM)	システム動作環境設定ファイル
XRWRK	HULFT.LOG.BKUP	集配信履歴ファイル（バックアップファイル）

注意

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

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

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

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

注意

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

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

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

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

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