 |
» |
|
|
|
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: - 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)
|
