Send and Receive Log File Reorganization program

Deletion of log records from the Send and Receive Log file (HULFT.LOG) creates unused space in the DASD, causing problems in the operation efficiency of the DASD. In order to use unused space in the DASD more efficiently, it is recommended that you reorganize the log file by using the Send and Receive Log File Reorganization program (XRREORG) after you delete log records.

Send and Receive Log File Reorganization Program (XRREORG)

Program Name

XRREORG

XRSYSIN Definition Card (Optional)

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the following:

HULFT10 for zOS Administration Manual : Explanation of each field

Format of definition card

JESC=JES Command Acronym 
OPLSELECT=Operation Log Output Option (*1)

When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs.

Example of 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 Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XRLOG	HULFT.LOG	Send and Receive Log File ID Key File
XRLOG1	HULFT.LOG.PATH1	Send and Receive Log Host Name Key File
XRLOG2	HULFT.LOG.PATH2	Send and Receive Log Date Key File
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File
XRWRK	HULFT.LOG.BKUP	Send and Receive Log File (backup file)

Parameter Name	Value	Description
UNIT	SYSDA	UNIT
VOL=SER	HUL001	Volume Name

Note

Do not cancel the job during execution of the Send and Receive Log File Reorganization program (XRREORG). Cancelation of the job during execution may cause corruption of the Send and Receive Log file (HULFT.LOG). Therefore, if you cancel the job, be sure to restore the Send and Receive Log file (HULFT.LOG). For details, refer to Restoration in case of error.

Restoration in case of error

If an error occurs during execution of the Send and Receive Log File Reorganization program (XRREORG), the Send and Receive Log file (HULFT.LOG) may be corrupted.

The procedure for restoring the Send and Receive Log file (HULFT.LOG) is as follows:

1. Execute the Send and Receive Log File Open command.

If HULFT is running, issue the Send and Receive Log File Open command to HULFT. For details on the Send and Receive Log File Open command, refer to Command for opening the Send and Receive Log file.

2. Terminate HULFT.

End the Send program (XRSND), the Receive program (XRRCV), and the Observe program (XRACCPT). For details on how to end HULFT, refer to HULFT startup and end.

3. Execute the AMS VERIFY command .

Execute the AMS VERIFY command.

After an error prevents the Send and Receive Log file (HULFT.LOG) from closing, make the catalog recognize the end of data set correctly. For details on the AMS VERIFY command, refer to DFSMS Access Method Services for Catalogs.

The following shows an example of the JCL for the AMS VERIFY command:

Example of 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 Name	Value	Description
XRLOG	HULFT.LOG	Send and Receive Log File ID Key File
XRLOG1	HULFT.LOG.PATH1	Send and Receive Log Host Name Key File
XRLOG2	HULFT.LOG.PATH2	Send and Receive Log Date Key File

4. Execute RELOAD.

Execute loading processing of the backup file of the Send and Receive Log file (HULFT.LOG).

The following shows an example of the JCL for executing RELOAD:

Example of 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 Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XRLOG	HULFT.LOG	Send and Receive Log File ID Key File
XRLOG1	HULFT.LOG.PATH1	Send and Receive Log Host Name Key File
XRLOG2	HULFT.LOG.PATH2	Send and Receive Log Date Key File
XRWRK	HULFT.LOG.BKUP	Send and Receive Log File (backup file)
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File

Parameter Name	Value	Description
UNIT	SYSDA	UNIT
VOL=SER	VOL001	Volume Name

Note

If the Send and Receive Log file (HULFT.LOG) does not have enough space, RELOAD may fail. Re-create the Send and Receive Log file (HULFT.LOG), defining enough capacity to store log records, and execute RELOAD again.

The restoration of the Send and Receive Log file (HULFT.LOG) is now complete.

Execute the Send and Receive Log File Reorganization program (XRREORG) again.

After executing the program, restart the Send program (XRSND), the Receive program (XRRCV), and the Observe program (XRACCPT). For details, refer to HULFT startup and end.

Note

Writing processing to the Send and Receive Log file (HULFT.LOG) is suspended during execution of the Send and Receive Log File Reorganization program (XRREORG).

HULFT executes the Post-send Job after writing of the Send Log records has completed. Therefore, HULFT does not execute the Post-send Job during execution of the Send and Receive Log File Reorganization program (XRREORG).

HULFT executes the Post-receive Job after writing of the Receive Log records has completed. Therefore, HULFT does not execute the Post-receive Job during execution of the Send and Receive Log File Reorganization program (XRREORG).

When you carry out the Receive processing during the execution of the Send and Receive Log File Reorganization program (XRREORG) with the following settings, the host on the sending side waits for a response from the host on the receiving side and a time-out may occur:

Specification of 'J' (Successful Job Completion) for the Receive Completion Notification (RCVEND-NOTICE) in the Receive Management Information