HELP
An object that writes data to a file using
transaction statements.

USE
Use To File to output a wide variety of
encodings and formats to allow flexible
output to files.  A single pointer is
maintained for each file; therefore, data
output by different To File objects is
written to the file in the order that the
objects operated.

To File Actions:

* WRITE - Writes data to a file using the
specified encoding and format.

* EXECUTE - Repositions the file's write
pointer to the beginning of the file with
(CLEAR) or without (REWIND) erasing the
contents of the file.  EXECUTE REWIND can
only be used when Clear File at PreRun &&
Open is checked.  Note that the file is
automatically closed when the HP VEE model
stops.  However, you may use the EXECUTE
CLOSE transaction to close the file during
model execution.

* WAIT - Waits the specified number of
seconds before executing the next
transaction.

To File Encodings;

* TEXT - Writes all data types to
human-readable files that are easily edited
or ported to other software applications.  
HP VEE numeric data is automatically 
converted to text as it is written.

* BYTE - Converts numeric data to binary
integer and writes the least significant
byte.

* CASE - Maps an enumerated value or an
integer to a string and writes the string.
For example, you could use CASE to accept
error numbers and write error messages.

* BINARY - Writes all data types in an
machine-specific binary format.

* BINBLOCK - Writes all HP VEE data types in
binary files with IEEE 488.2 definite length
block headers.

* CONTAINER - Writes all data types in an HP
VEE specific text format.

LOCATION
I/O ==> To ==> File

OPEN VIEW PARAMETERS

  * Clear at PreRun && Open - Erases file
contents and sets file pointer to the
beginning of the file.  The REWIND
transaction command can only be operated when
Clear File At PreRun && Open is checked.
When Clear File At PreRun && Open is not
checked, data is appended to the end of the
file.
The open view shows the list of transactions
to be executed.

OBJECT MENU

* Config - Allows you to view and edit the
configuration that determines the end-of-line
character and formatting for arrays.

* Add Trans - Adds a transaction to the end
of the list.

* Insert Trans - Inserts a transaction before
(above) the currently highlighted
transaction.

* Cut Trans - Cuts (deletes) the currently
highlighted transaction, but saves it in the
transaction "cut-and-paste" buffer.

* Copy Trans - Copies the currently
highlighted transaction to the transaction
"cut-and-paste" buffer.

* Paste Trans - Pastes a transaction,
previously "cut" or "copied" to the buffer,
in the position before the currently
highlighted transaction.

SHORT CUTS

To quickly insert a transaction, place the
cursor on a transaction.  Press [CTRL-O] to
insert a transaction over the transaction
where you placed the cursor.

To quickly delete ("kill") a transaction,
place the cursor on that transaction and
press [CTRL-K].

To paste a transaction from the "kill"
buffer press [CTRL-Y].

To quickly move to the next or previous
transaction, press [CTRL-N] or [CTRL-P]
respectively.

SEE ALSO
From File and To/From Named Pipe.

"Using Transaction I/O" in Using HP VEE,
chapter 12.
