F-CLEAR

Clears a specified file buffer.

Syntax

F-CLEAR file-buffer-number

F-C file-buffer-number

Syntax Elements

file-buffer-number
is the number of the file buffer to be cleared. Valid numbers are 1 to 47, but note that 19 and 20 are reserved for system Procs.

file-buffer-number can be a direct or indirect file buffer reference.

Operation

The F-CLEAR command clears the specified file buffer.

The F-CLEAR command should be used prior to building a record in a file buffer. This guarantees that the file buffer is empty prior to its use.

The Proc processor does not allow a reference to a file buffer unless the file has been cleared or opened.

You do not need to use an F-CLEAR command prior to using an F-OPEN command. The F-OPEN command also clears the specified file buffer.

Example

001 PQN
002 F-CLEAR 1
003 MV &1.1 "data....."
004 MV &1.2 %1
.
.
.

This example clears file buffer 1 prior to building a new record.