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.  These actions can only
be used when Clear File at PreRun is checked.

* 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
machine-specific text format.

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

OPEN VIEW PARAMETERS
Clear at PreRun - Erases file contents
and sets file pointer to the beginning of the
file.  REWIND and CLEAR transaction commands
can only be operated when Clear File At
PreRun is checked.  When Clear File At PreRun
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.

* Delete Trans - Deletes the currently
highlighted transaction.

SEE ALSO
From File and To/From Named Pipe.

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