MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 9 573
Command Definitions (MAIL-PUTJCW)
OPENLOG
3 Request to open or write to a user logging process not
running
5 Incorrect
mode
parameter passed
6 Request denied; user logging process suspended
7 Illegal capability; user logging (LG) or system supervisor
(OP) capability required
8 Incorrect password passed
9 Error while writing to the user logging file
12 System out of disk space; user logging cannot proceed
13 Out of user logging entries
15 End-of-file on user logging file
16 Invalid user logging identifier
Operation Notes
The user logging facility establishes a logging buffer (LOGBUFF) entry for every active
process and increments the user count only at the first OPENLOG call. Other counters keep
track of the number of times OPENLOG and CLOSELOG are called for each user; the counter is
incremented for every OPENLOG and decremented for every CLOSELOG for each user. This
ensures that the entry in LOGBUFF is released only if it is the last CLOSELOG call (that is,
call counter = 0). The number of users and log entries are independent of the number of
times the OPENLOG/CLOSELOG intrinsics are called within an application.
Related Information
Commands LOG
Manual User Logging Programmer's Guide