Send and Receive Log File Reorganization (XRREORG)

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. For efficient use of unused space, 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.

Running of Send and Receive Log File Reorganization program (XRREORG)

Program Name

XRREORG

XRSYSIN Definition Card (Optional)

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 the following:

HULFT10 for zOS Operation Manual : Operation log control

Status code

Table 3.22 Status Code
Status Code	Description & Measures
0	No error, successfully completed.
4	User canceled the operation, because the file to be processed had been in use.
8	Error occurred. Look up the output error message in the following and find the measures to take: HULFT10 for zOS Error Codes and Messages : Status codes and detail codes for Receive processing

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). If you cancel the job, restore the Send and Receive Log file (HULFT.LOG) by referring to Restoration in case of error in this section.
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). Since execution of the Post-send Job and the Post-receive Job occurs after writing of log records, the Post-send Job and the Post-receive Job are not executed during reorganization. Therefore, when 'J' (Successful Job Completion) is specified for the Notification of the Receive Management Information, carrying out the Receive processing during reorganization causes the host on the sending side to wait for a response from the Receive system, and possibly time out.

Usage of Send and Receive Log File Reorganization program (XRREORG)

The following is an example of a JOB statement for the Send and Receive Log File Reorganization program (XRREORG):

[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

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 following shows how to restore the Send and Receive Log file (HULFT.LOG):

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

If HULFT system is running, issue the Send and Receive Log File Open command to HULFT system. For details about the Send and Receive Log File Open command, refer to the following:

HULFT10 for zOS Operation Manual : Command for opening the Send and Receive Log file

2. End HULFT system.

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

HULFT10 for zOS Operation Manual : HULFT startup and end

3. Execute the AMS command VERIFY.

Execute the AMS command VERIFY.

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 about the AMS command VERIFY, refer to DFSMS Access Method Services for Catalogs.

An example of JCL for the AMS command VERIFY is given below.

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).

An example of JCL for executing RELOAD is given below.

Example of JCL

//XRRELOAD JOB CLASS=A,MSGCLASS=B                                               
//STEPLIB  DD DSN=HULFT.LOAD,DISP=SHR                                           
//XRRELOAD EXEC PGM=XRREORG,PARM='RELOAD'                                       
//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=HUL001                                                    
//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
OUT	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	HUL001	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) with enough capacity to store the log records, and execute RELOAD again.

Restoration of the Send and Receive Log file (HULFT.LOG) is now completed.

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

After the program is executed, restart the Send program (XRSND), the Receive program (XRRCV), and the Observe program (XRACCPT). For details, refer to the following:

HULFT10 for zOS Operation Manual : HULFT startup and end