HP 3000 Manuals HP 3000 Manuals
Chapter 2 User Logging Intrinsics 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.