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