Deletion of Send Log records or Receive Log records

HULFT accumulates one log record in the Send and Receive Log file (HULFT.LOG) for each of the Send processing or the Receive processing. Delete unnecessary log records regularly.

Send and Receive Log Deletion Program (XRLOGDEL)

Program Name

XRLOGDEL

XRSYSIN Definition Card

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

OPLSELECT=Operation Log Output Option (*1) 
DATEFMT=Date Format

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

XRCRD Definition Card

The following shows the format of the definition card for deleting the records of the Send Log and the Receive Log:

Format of definition card

             a               b 
DELINF {ISS|RCV}[,FILE-ID=fileid] 
             c              d         e         f 
  [{,YMD=date1 [-date2]|,DAY=999|,LASTWEEK|,LASTMONTH}]

= Remarks =

If the definition card spans two lines, use either of the following two methods to define the definition card:

Describe the first line up to column 71, and then insert a hyphen (-) in column 72. Describe the second line starting in column 1.
Describe a line up to a comma (,) that follows a parameter, insert a single byte space, and then insert a hyphen (-) in column 71 or before.

Input contents of definition card

a. Type of log records to be deleted

This parameter defines whether to delete records of the Send Log or the Receive Log. (Mandatory)

ISS:: Send Log
RCV:: Receive Log

b. File ID

This parameter defines the file ID for the Send Log records or the Receive Log records that you want to delete. (Optional)

Specify alphanumeric characters (and "_" if desired) within 50 bytes starting with an uppercase alphabetic character for this parameter.

To delete Send Log records or Receive Log records for instant transfer, specify "_INSTANT_TRANSFER_" for the file ID.

Defaulting this parameter sets all file IDs as deletion targets.

c. Date

This parameter defines the date for the Send Log records or the Receive Log records that you want to delete. (Optional)

Specify an 8-byte numeric string for each date of this parameter.

Specify the date in the format that you defined for the Date Format (DATEFMT) in the System Environment Settings.

Specify the date in either of the following formats:

YMD=date1
YMD=date1-date2

When you use the format 'YMD=date1-date2,' date1 must be earlier than date2.

When you define this parameter with 'YMD=date1,' the program deletes the log records for date1.

For the format 'YMD=date1-date2,' the program deletes the log records from date1 to date2. The range of the deletion target includes the defined dates of 'date1' and 'date2.'

Defaulting this parameter deletes all log records for the file ID that you define.

HULFT searches for deletion targets based on the Send start date or the Receive start date.

d. Number of days for which the latest records are not deleted

This parameter is defined to delete the records of the Send Log or the Receive Log except for the log records for the defined number of days prior to the current date. (Optional)

Specify a value from '1' to '366' for this parameter.

e. Deletion of the records of the Send Log or the Receive Log that were stored the previous week

This parameter is defined to delete old records of the Send Log or the Receive Log that were stored the previous week up to Saturday. (Optional)

The program deletes old records of the Send Log and the Receive Log including the records that were stored on the previous Saturday.

f. Deletion of the records of the Send Log or the Receive Log that were stored the previous month

This parameter is defined to delete old records of the Send Log or the Receive Log that were stored on or before the last day of the previous month. (Optional)

The program deletes old records of the Send Log and the Receive Log including the records that were stored on the last day of the previous month.

= Remarks =

You cannot default all the parameters shown below. You must specify at least one parameter.

File ID
Date
Number of days for which the latest records are not deleted
Deletion of the records of the Send Log or the Receive Log that were stored the previous week
Deletion of the records of the Send Log or the Receive Log that were stored the previous month

Example of JCL

//XRLOGDEL JOB  CLASS=A,MSGCLASS=B                                              
//XRLOGDEL EXEC PGM=XRLOGDEL                                                    
//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=*                                                        
//SYSOUT   DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
DELINF ISS,FILE-ID=LOOPTEST,YMD=20030401-20030501                               
DELINF RCV,FILE-ID=LOOPTEST,YMD=20030401-20030501                               
//

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