|
|
NM and CM callable.
Posts a record to the logging file marking the end of a logical transaction.
When the record is posted, ENDLOG flushes the user logging memory
buffer to ensure that the record gets to the logging file. User logging (LG) or
system supervisor (OP) capability is required.
Syntax
I32 U16A I16 I16 I16
ENDLOG (index, data, length, mode, logstatus);
Parameters
- index
32-bit signed integer by reference (required)
Passes the access to the user logging system. This is the value returned
in the index parameter of the OPENLOG
intrinsic.
- data
16-bit unsigned integer array (required)
Passes the information to be logged. A log record contains 128 half words,
where 119 half words are available for writing data. For the most
efficient use of log file space, structure arrays with lengths in
multiples of 119 half words.
- length
16-bit signed integer by reference (required)
Passes the length of the data in data. A positive value
indicates half words, while a negative value indicates bytes. If the
length is greater than 119 half words (or 238 bytes), the information in
data is divided into two or more physical log
records.
- mode
16-bit signed integer by reference (required)
Passes a value indicating whether the logging process should suspend your
process if it cannot complete your request for service immediately. If it
is not possible to log the transaction and mode is set to
1 (nowait), the ENDLOG intrinsic indicates through
logstatus that it could not complete your request.
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, and the user logging process is busy |
2 | Parameter out of bounds |
4 | Incorrect index parameter passed |
5 | Incorrect mode parameter passed |
9 | Error occurred while writing |
12 | System out of disk space; user logging cannot proceed |
14 | Invalid access |
15 | End-of-file encountered |
Operation Notes
Use the data parameter of this intrinsic to post user data to
the logging file. This use of ENDLOG is similar to using the
WRITELOG intrinsic, but also denotes the end of a logical transaction.
Related Information
|