HP 3000 Manuals HP 3000 Manuals
CLOSELOG
NM and CM callable.
Closes access to the user logging facility. User logging (LG) or system
supervisor (OP) capabilities are required.
Syntax
______________________________________
| |
| I32 I16 I16 |
| CLOSELOG(index,mode,logstatus);|
______________________________________
Parameters
index 32-bit signed integer by reference (required)
Passes access capabilities to the user logging
system. This is the value returned in the index
parameter of the OPENLOG intrinsic.
mode 16-bit signed integer by reference (required)
Passes a value, indicating whether the user logging
facility should suspend the process if it cannot
complete the request for service immediately:
Value Meaning
0 Wait
1 Nowait
logstatus 16-bit signed integer by reference (required)
Returns one of the following values, indicating the
success/failure of the intrinsic call:
Value Meaning
0 Successful
1 Nowait mode requested; user logging process busy
4 Incorrect index parameter passed
5 Incorrect mode parameter passed
7 Illegal capability; user logging (LG) or system
supervisor (OP) capabilities required
9 Error occurred while writing
12 System out of disk space; user logging cannot proceed
14 Invalid access to user logging file
15 End-of-file encountered
Operation Notes
The number of users and log entries are independent of the number of
times the OPENLOG/CLOSELOG intrinsics are called within an application.
The user logging facility establishes a logging buffer (LOGBUFF) entry
and increments the user count only at the first OPENLOG call. Another
counter keeps track of the number of times OPENLOG and CLOSELOG are
called. The counter is incremented for every OPENLOG and decremented for
every CLOSELOG. This ensures that the entry in LOGBUFF is released only
for the last CLOSELOG call (call counter = 0).
Related Information
Intrinsics OPENLOG
Commands None
Manuals User Logging Programmer's Guide (32650-90027)