 |
» |
|
|
|
NM and CM callable. Writes database and subsystem file records to the user logging file.
User logging (LG) or system supervisor (OP) capability is required. Syntax | |
I32 U16A I16 I16 I16
WRITELOG(index,data,length,mode,logstatus);
|
Parameters | |
- index
32-bit signed integer by reference (required) Passes your 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 of which 119 are available for writing data.
The most efficient use of log file space is to 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; 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 user logging facility will
suspend the process if it cannot complete the request for service
immediately. If it is not possible to log the transaction
and mode is set to nowait, the WRITELOG intrinsic
indicates through logstatus that it could not complete the request.
| Value | Meaning |
|---|
| 0 | Wait | | 1 | Nowait | | 2 | Write the logging buffer to the disk log file (disk logging)
or the disk buffer file (serial logging) at the first opportunity. |
- logstatus
16-bit signed integer by reference (required) Returns one of the following values, indicating the success/failure of
the call:
| Value | Meaning |
|---|
| 0 | Successful | | 1 | Nowait requested, user logging process 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 on user log file |
Related Information | |
- Intrinsics
BEGINLOG, ENDLOG - Commands
None - Manuals
User Logging Programmer's Guide (32650-90027)
|
