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

FREMOVE

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Marks the current record in a KSAM file for deletion.


NOTE: For KSAM files only.

Syntax



           I16V
  FREMOVE (filenum);

Parameters


filenum

16-bit signed integer by value (required)

Passes the file number of the file where the record is to be deleted.

Operation Notes


Split stack calls are permitted.

Deleted records can be read with this intrinsic.

(KSAM/3000) When executed, the first word of the current record is set to 1's; the record is not physically deleted from the file. When the file is read by a KSAM read intrinsic, the deleted records are not read.

(KSAM/XL or KSAM64) When executed, the first bit in the record header is set to 1.

Condition Codes


CCE (2)Request granted.
CCG (0)Request denied. The logical end-of-data was encountered.
CCL (1)Request denied. An error was encountered or the record does not contain the requested key value; the record is not deleted.

Related Information


Intrinsics FFINDBYKEY, FINDN, FREADBYKEY, FREADC
Manuals Using KSAM XL
KSAM/3000 Reference Manual




FRELATE


FRENAME