 |
» |
|
|
|
NM and CM callable. Posts a special record to the user logging file to mark the
beginning of a logical transaction. When BEGINLOG is called,
the logging memory buffer is flushed 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
BEGINLOG(index,data,length,mode,logstatus)
|
Parameters | |
- index
32-bit signed integer by reference (required) Passes access information 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 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. 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 logging process should
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 BEGINLOG intrinsic
indicates, through logstatus, that it could not complete the
request:
- logstatus
16-bit signed integer by reference (required) Returns a value, indicating the success/failure of the intrinsic call:
| Value | Meaning |
|---|
| 0 | Successful | | 1 | Nowait mode requested, and 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 |
Operation Notes | |
Use the data parameter of this intrinsic to post user data to
the logging file. This use of BEGINLOG is similar to using
the WRITELOG intrinsic, but also denotes the beginning of a
logical transaction. Related Information | |
- Intrinsics
ENDLOG, WRITELOG - Commands
None - Manuals
User Logging Programmer's Guide (32650-90027)
|
