Listing records from the Observe Log

The Observe Log list can be displayed.

(1) Observe Log List Display command

Program interface

CALL Library name/UTLOBSLIST PARM(['LIB=Library name'] ['S=service']
   ['H=hostname'] ['FROM=DATE1'] ['TO=DATE2'] ['L']
   ['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

Service Name (Optional)

When omitted, all the services become the targets of this command.

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

H=hostname

Target host name to be displayed in a list (Optional)

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

When omitted, all the host names become the targets of this command.

FROM=DATE1 TO=DATE2

Target date to be displayed in a list (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 output in a list.

L

Display the host name in full. (Optional)

Since all 68 bytes of Host Names are displayed, 1 record of log is displayed in 2 lines.

When omitted, only the first 8 bytes of the host name is displayed and a record of log is displayed per line.

G

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

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Observe Log List Display 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 List Display 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.

Command interface

UTLOBSLIST SERVICE( ) HOSTNAME( ) FROM( ) TO( ) DSPTYPE( )
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

SERVICE

Service Name (Optional)

When omitted, all the services become the targets of this command.

HOSTNAME

Target host name to be displayed in a list (Optional)

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

When omitted, all the host names become the targets of this command.

FROM TO

Target date to be displayed in a list (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 that is specified for the Date Format (DATEFMT) of the System Environment Settings, and the date specified for the FROM must be earlier than or equal to the date specified for the TO. The log record of the date you specified is included in the target records to be output in a list.

DSPTYPE

Display the host name in full. (*SHORT by default)

*SHORT :: Display the first 8 bytes of the host name.
*LONG :: Display the Host Name in 68-byte length.

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) Output example

When parameter L is specified:

SSERVICE  HOSTNAME   DATE        TIME      STATUS    
                                                    
HULJOB   AS400                                      
                    2017/12/29  15:07:16  0000-0000 
HULJOB   AS400                                      
                    2017/12/29  15:08:06  0000-0000 
HULJOB   AS400                                      
                    2017/12/29  15:08:54  0000-0000

When parameter L is omitted:

SERVICE   HOSTNAME  DATE        TIME      STATUS   
                                                   
HULJOB    AS400     2017/12/29  15:07:16  0000-0000
HULADMIN  WINDOWSM  2017/12/29  15:59:06  0000-0000
HULADMIN  WINDOWSM  2017/12/29  16:22:01  0000-0000