OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

logcat (Display message log file)

Format

logcat [-niNIdtHpab] [-f message-log-file-name]

Function

The logcat command outputs the message contents of a message log file to the standard output.

The output operation merges $DCDIR/spool/dclog1 and $DCDIR/spool/dclog2 in chronological order.

The information to be displayed is specified with options.

Options

-n

Display the message serial numbers.

-i

Display the ID of each request source process.

-N

Display the message log output serial numbers within each process.

-I

Display the system ID (the user-specified OpenTP1 identifier).

-d

Display the date of the message log output request.

-t

Display the time of the message log output request.

-H

Display the name of the message log output request source host.

-p

Display the request source program ID.

-a

Display all of the above. If this option is specified together with any of the options above, the specification of the other options is ignored.

-b

Display only the message IDs and message texts without any of the above information. If this option is specified together with any other options, the specification of the other options is ignored. If this option is specified together with the -a option, the -a option is effective, and the -b option is ignored.

-f message-log-file-name~<path name>

Specifies the name of the message log file.

Information from the specified message log file only is displayed.

When this option is omitted, $DCDIR/spool/dclog1 and $DCDIR/spool/dclog2 are merged, and the information is displayed in chronological order.

Output format

The following shows the output format when "ogcat -a" is specified:

aaaaaaa bbbbb ccccccc dd ee...ee ff...ff gg...gg hhh ii...ii jj...jj

aaaaaaa
Message serial number (7 numeric characters)

bbbbb
Process ID (5 numeric characters)

ccccccc
Message serial number within the process (7 numeric characters)

dd
System ID (2 alphanumeric characters)

ee...ee
Date (10 numeric characters), in the format year/month/day

ff...ff
Time (8 numeric characters), in the format hour:minute:second

gg...gg
Request source host name (8 alphanumeric characters) (first eight characters of the host name)

hhh
Request source program ID (3 alphanumeric characters) (ID beginning with * indicates a message issued from a UAP; an ID that does not begin with * indicates a system message)

ii...ii
Message ID (11 alphanumeric characters)

jj...jj
Message text

Output messages

Message ID Description Output destination
KFCA01950-I Help message Standard output,
standard error output
KFCA01951-E Memory is inadequate. Standard error output
KFCA01952-E Error occurred in log service. Standard error output
KFCA01953-E No log file storage directory has been set up. Standard error output
KFCA01954-E Log file open error occurred. Standard error output
KFCA01955-E Collection of log file's last update time failed. Standard error output
KFCA01956-E I/O error occurred. Standard error output
KFCA01957-E Log file format is invalid. Standard error output
KFCA01958-E Log file version is invalid. Standard error output
KFCA01978-E Specification of a command argument is invalid. Standard error output