Deleting records from the Observe Log

In the Observe Log, HULFT keeps one log record each time the application acknowledges a request such as the Send Request or the Resend Request. Delete unnecessary data from logs regularly.

(1) Observe Log Deletion command

Program interface

CALL Library name/UTLOBSRM PARM(['LIB=Library name'] 'S=service|A'
   {['FROM=DATE1'] ['TO=DATE2'] ['I']|
   ['DAY=day']|['LASTWEEK']|['LASTMONTH']}
   ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

S=service|A

Service Name of the log record to be deleted (Mandatory)

Specify this parameter as an alphanumeric character string of 8 bytes or less.

S=service :: service name specified
A :: all service names

You can omit this parameter only when the parameter "I" is specified (Specifying this parameter and the parameter "I" at the same time is not allowed).

For the details of service name, refer to Administration Manual.

FROM=DATE1 TO=DATE2

Date of the log record to be deleted (Optional)

Specify this parameter in numbers of 8 bytes in length.

When the "FROM=" is omitted, all the log records on and before the date that you specify for the "TO=" become the target of this command.

When the "TO=" is omitted, all the log records on and after the date that you specify for the "FROM=" become the target of this command.

When both are omitted, log records of all dates become target of this command. You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings, and DATE1 must be earlier than or equal to DATE2.

The log record of the dates you specified for the Date1 and the Date2 are included in the target records to be deleted.

I

Interactive mode (Optional)

Following the displayed message, enter the range of service name and date.

DAY=day

Number of days to be exempted from deletion of log records (Optional)

Specify this parameter in the range of "1" to "366".

Specifying this parameter leaves the log records from the specified number of days ago and deletes the rest.

LASTWEEK

Deletion of log records up to the previous week (Optional)

Specifying this parameter deletes the log records that have been kept on and before previous Saturday (Including the log record of the previous Saturday).

LASTMONTH

Deletion of log records up to the previous month (Optional)

Specifying this parameter deletes the log records that have been kept on and before the last day of previous month (Including the log record of the last day of the month).

G

Control of the error messages that the Observe Log Deletion command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Observe Log Deletion command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Observe Log Deletion command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must immediately follow the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

= Remarks =

You cannot specify parameters related to date (namely, "FROM=", "TO=", "DAY=", "LASTWEEK", "LASTMONTH")more than once.
In interactive mode ("I"), you can use only "FROM=" or "TO=" among the parameters related to date.

Command interface

UTLOBSRM SERVICE( ) FROM( ) TO( ) DAY( ) INTERACT( )
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

SERVICE

Service Name of the log record to be deleted (Mandatory)

Specify this parameter as an alphanumeric character string of 8 bytes or less.

If *ALL is specified, all the services become the target of this command.

FROM TO

Target date of the Observe Log to be deleted (Optional)

Specify this parameter in numbers of 8 bytes in length.

When the FROM is omitted, all the log records on and before the date that you specify for the TO become the target of this command.

When the TO is omitted, all the log records on and after the date that you specify for the FROM become the target of this command.

When both are omitted, log records of all dates become target of this command.

You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings, and FROM must be earlier than or equal to TO. The log record for the specified date is included in the records to be deleted.

DAY

Number of days to be exempted from deletion of log records ("*NO" by default)

Specify this parameter in the range of "1" to "366".

Specifying this parameter leaves the log records from the specified number of days ago and deletes the rest.

Specifying "*LW" deletes the log records that have been kept on and before previous Saturday (Including the log record of the previous Saturday).

Specifying "*LM" deletes the log records that have been kept on and before the last day of previous month (Including the log record of the last day of the month).

INTERACT

interactive mode ("*NO" by default)

According to the displayed message, enter the service and the range of date.

*NO :: Deletes log records in non-interactive mode
*YES :: Deletes log records in interactive mode

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

(2) Example of entry in interactive mode

Input of Service Name

When you omit the parameter of the Service Name of the log record to be deleted to run the command, enter the target Service Name after the following prompt message appears:

PLEASE INPUT SERVICE NAME.(DEFAULT IS ALL) 
>Service name

If you want to omit this, press only the Enter key.

In this case, all service names are targeted for deletion.

Enter Range of Dates

When you omit the parameter of the date of the records to be deleted to run the command, enter the target range of dates after the following prompt message appears:

FROM (DEFAULT IS OLDEST) 
>Date(YYYYMMDD) 
TO (DEFAULT IS LATEST) 
>Date(YYYYMMDD)

If you want to omit this, press only the Enter key.

When omitted, all dates are targeted for deletion.

When service name and date range are entered correctly, the following confirmation message is displayed

SURE ? (Y/N)

If you want to delete, enter "Y".

If you want to cancel the deletion, enter "N".

When specified data does not exist in Observe Log file, the following message is displayed and the process ends

UTLOBSRM   :HUL1253 OBJECT RECORD NOT EXIST

= Remarks =

The date format varies depending on a value of the Date Format (DATEFMT) that is specified in the System Environment Settings

For details, refer to Administration Manual.