CLOSELOG
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
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 | BEGINLOG, ENDLOG, FLUSHLOG, LOGINFO, LOGSTATUS, OPENLOG, WRITELOG |
| Manuals | User Logging Programmer's Guide |
|
CLOCK |
COMMAND |