 |
» |
|
|
|
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: - VaIue
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 - Manual
User Logging Programmer's Guide
|
Printable version
