HP 3000 Manuals HP 3000 Manuals
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:
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)