 |
» |
|
|
|
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. - 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 | |
- Intrinsics
WRITELOG, OPENLOG - Commands
None - Manuals
User Logging Programmer's Guide (32650-90027)
|
