OpenTP1 Version 7 Programming Guide

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

2.6 Audit log output

An audit log is a file containing historical information about the operations performed on OpenTP1 programs by system developers, operators, and users, together with the program behavior triggered by those operations.

In OpenTP1, an entry is output to the audit log when an operation is executed on a UAP, or when internal processing takes place in a UAP. To acquire user-specified audit log data, call the function dc_log_audit_print() from the UAP.

The figure below shows the flow of collecting an audit log from UAPs.

Figure 2-52 Outline of audit logging from UAPs

[Figure]

The table below lists the items entered in an audit log file and describes their content. The items that can be specified from the UAP are the message ID, source component, event type, event result, action information, and comment.

Table 2-3 Items output to audit log file

Specified by Item Output length (max. bytes) Description
Items specifiable from a UAP Message ID 11 The ID of the audit log entry
Source component 3 The name of the component in which the event occurred.
The source component is output in the format *AA, where AA is the value specified by the function dc_log_audit_print().
Event type 32 The event category
Event result 10 The result of the event
Action information 32 The action initiated on the object by the subject who caused the event (Refer/Add/Update/Delete etc.)
Comment 1024 A comment describing the nature of the event
Items specified automatically by OpenTP1 Header information 12 Header information in the audit log
Sequence number 7 The sequence number of the entry
Date and time 29 The date and time when the entry was logged
Source program 32 The name of the programin which the event occurred
Source process ID 10 The ID of the process in which the event occurred
Source location 255 Information identifying the host where the event occurred
Subject ID information 256 Information identifying the user who caused the event
Object information 256 The service name
Output only when an entry is logged from within a service function; not output otherwise.
Object location information 64 The user server name
Request source host 255 Information identifying the host that sent the request, when the event involves the linking of multiple programs
Not output if there is no information about the request source host.
Location ID information 64 The path specified in the DCDIR environment variable