Deletion of Observe Log records

HULFT accumulates one log record in the Observe Log for each execution of the following:

  • Send Request

  • Resend Request

  • Job Execution Result Notification

  • Remote Job Execution

  • Post-receive Job Result Inquiry Request

  • Connection from HULFT Manager

Delete unnecessary log records regularly.

Observe Log Deletion Program (XRRQLDEL)

Program Name

XRRQLDEL

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

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

XRCRD Definition Card

The following shows the format of the definition card for deleting the records of the Observe Log:

Format of definition card

               a                 b              c        d          e    
DELRQL [REQ-ID=req-id][{,YMD=date1 [-date2]|,DAY=999|,LASTWEEK|,LASTMONTH}]

Input contents of definition card

a. Service name

This parameter defines the service name for the log records that you want to delete (Optional).

For details, refer to the following:

HULFT10 for zOS Administration Manual : Observe definition settings

Defaulting this parameter sets all service names as deletion targets.

b. Date

This parameter defines the date for the Observe 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 records of the Observe Log for date1.

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

Defaulting this parameter sets all Observe Log records for the service name that you define as deletion targets.

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

This parameter is defined to delete the records of the Observe Log except for the latest log records for the defined number of days up to the current date. (Optional)

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

d. Deletion of the Observe Log records that were stored the previous week

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

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

e. Deletion of the Observe Log records that were stored the previous month

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

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

= Remarks =

You cannot default all parameters. At least one parameter must be specified.

Example of JCL

//XRRQLDEL JOB  CLASS=A,MSGCLASS=B                                              
//XRRQLDEL EXEC PGM=XRRQLDEL                                                    
//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   *                                                               
DELRQL 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