MPE/iX Intrinsics Reference Manual (32650-90875)

632 Chapter10
Command Definitions (QUIT-ZSIZE)
WRITELOG
WRITELOG
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: