HPlogo MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions (ABORTSESS - FCLOSE)

ENDLOG

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

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.

ValueMeaning
0Wait
1Nowait

logstatus

16-bit signed integer by reference (required)

Returns one of the following values, indicating the success/failure of the intrinsic call:

ValueMeaning
0Successful
1Nowait mode requested, and the user logging process is busy
2Parameter out of bounds
4Incorrect index parameter passed
5Incorrect mode parameter passed
9Error occurred while writing
12System out of disk space; user logging cannot proceed
14Invalid access
15End-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 BEGINLOG, CLOSELOG, FLUSHLOG, LOGINFO, LOGSTATUS, OPENLOG, WRITELOG
Manuals User Logging Programmer's Guide




DMOVOUT


EXPANDUSLF