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

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

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

プログラム名

XRREORG

XRSYSIN定義カード(省略可)

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

定義カードの形式

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

*1

:

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

JCL例

//XRREORG  JOB  CLASS=A,MSGCLASS=B                                              
//JOBLIB   DD   DSN=HULFT.LOAD,DISP=SHR                                         
//JOBCAT   DD   DSN=USERCAT,DISP=SHR                                            
//*                                                                             
//XRREORG  EXEC PGM=XRREORG,REGION=2048K                                        
//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=(NEW,CATLG,CATLG),UNIT=SYSDA,                               
//             SPACE=(CYL,(5,1),RLSE),VOL=SER=HUL001                            
//XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                                 
//                                                                              

DD名

項目名

説明

JOBLIB

HULFT.LOAD

HULFTロードモジュールライブラリ

JOBCAT

USERCAT

カタログ簿データセット名

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

HUL001

ボリューム名

注意

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

異常時の復旧方法

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

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

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

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

2. HULFTを終了します。

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

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

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

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

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

JCL例

//VERIFY   JOB  CLASS=A,MSGCLASS=B                                              
//JOBCAT   DD   DSN=USERCAT,DISP=SHR                                            
//VERIFY   EXEC PGM=KQCAMS                                                      
//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名

項目名

説明

JOBCAT

USERCAT

カタログ簿データセット名

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                                         
//STEPCAT  DD   DSN=USERCAT,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=SHR                                     
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//                                                                              

DD名

項目名

説明

STEPLIB

HULFT.LOAD

HULFTロードモジュールライブラリ

STEPCAT

USERCAT

カタログ簿データセット名

XRLOG

HULFT.LOG

集配信履歴ファイルIDキーファイル

XRLOG1

HULFT.LOG.PATH1

集配信履歴ホスト名キーファイル

XRLOG2

HULFT.LOG.PATH2

集配信履歴日付キーファイル

XRWRK

HULFT.LOG.BKUP

集配信履歴ファイル(バックアップファイル)

XRSYSIN

HULFT.PARMLIB(HULPRM)

システム動作環境設定ファイル

注意

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

 

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

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

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

注意

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

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

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

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

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