OpenTP1 Version 7 Programming Guide
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
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 |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.