 |
» |
|
|
|
User Logging is performed programmatically by using the intrinsics
listed below.
The user that starts an application which calls the User Logging
intrinsics, must have User Logging (LG) or System Supervisor
(OP) capabilities.
Refer to the Intrinsics Reference Manual
(32650-90028) for the syntax of the
following intrinsics: | | | |  | NOTE:
There are no major differences between Native Mode and Compatibility
Mode for User Logging.
| | | | |
- BEGINLOG
BEGINLOG writes a special record to the user logfile to
mark the beginning of a logical transaction:
The logging memory buffer is flushed to ensure that the record
gets to the logfile.
The data parameter can be used to write data to the
logfile in the BEGINLOG record.
The mode parameter is used to specify WAIT
or NOWAIT I/O for the intrinsic.
- CLOSELOG
CLOSELOG removes the link to the logging facility:
A record is written to the logfile to record the close
for the user.
The mode parameter is used to specify WAIT
or NOWAIT I/O for the intrinsic.
- ENDLOG
ENDLOG writes a special record to the user logfile
to mark the end of a logical transaction:
The logging memory buffer is flushed to ensure that the record
gets to the logfile.
The data parameter can be used to write data to
the logfile in the ENDLOG record.
The mode parameter is used to specify WAIT
or NOWAIT I/O for the intrinsic.
- FLUSHLOG
FLUSHLOG flushes the records in the User Logging memory
buffer to the logfile. This ensures that those records will be
recoverable in the event of a system failure.
- LOGINFO
LOGINFO provides information about an open logfile and
the previous logfile (if one exists) in the logfile set, or it
may be used to obtain information about the whole logfile set
(for example, the total number of records written).
- LOGSTATUS
LOGSTATUS provides information about a current, open
logfile (for example, to determine the amount of space
available in a DISC logfile).
- OPENLOG
OPENLOG links the calling application to a User Logging process:
The logging identifier specified in the logid parameter, must be a valid logging identifier for an active logging process.
An index is returned which is used in subsequent intrinsic calls to reference the OPENLOG link to the User Logging process.
A record is written to the logfile to identify the user opening the logfile.
The mode parameter is used to specify WAIT or NOWAIT I/O for the intrinsic.
- WRITELOG
WRITELOG writes a record, of the user's data, to a logfile.
The mode parameter is used to specify WAIT,
NOWAIT I/O, or WRITE-and-FLUSH for the intrinsic.
|
