HPlogo MPE/iX Intrinsics Reference Manual > Chapter 6 Command Definitions (FLUSHLOG-GETUSERMODE)

FLUSHLOG

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Flushes the contents of the user logging memory buffer to the user logging file. User logging (LG) or system supervisor (OP) capability is required.

Syntax



            I32    I16
  FLUSHLOG (index, 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.

logstatus

16-bit signed integer by reference (required)

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

ValueMeaning
0Successful
4Incorrect index parameter passed
7Illegal capability; user logging (LG) or system supervisor (OP) capability required
9Error occurred while writing
12System is out of disk space, user logging cannot proceed
14Invalid access
15End-of-file encountered

Operation Notes


The FLUSHLOG intrinsic writes the contents of the user logging memory buffer to the disk destination file. This helps to preserve the contents of the memory buffer in the event of a system failure. This intrinsic does not write special records.

Related Information


Intrinsics BEGINLOG, CLOSELOG, ENDLOG, LOGINFO, LOGSTATUS, OPENLOG, WRITELOG
Manuals User Logging Programmer's Guide




Chapter 6 Command Definitions (FLUSHLOG-GETUSERMODE)


FMTCALENDAR