HELP
An object that communicates with an
HP BASIC/UX process using transactions by 
way of specified named pipes.  This object 
is available in HP VEE-Test only.

USE
Use To/From HP BASIC/UX to communicate with
an HP BASIC/UX program.  Be certain that you
understand how to use named pipes in the
HP-UX environment.

In general, you need to add or modify
transactions to accomplish useful results.
To add a transaction, double-click on the
blank line at the end of the transaction
list.  To edit a transaction, double-click on
the transaction and complete the resulting
dialog box.

Type in the names of the pipes you wish to
use in the Read Pipe and Write Pipe fields.
Be certain that they match the names of the
pipes used by your HP BASIC/UX program and
that the read and write names are not
inadvertently swapped.  Use different pipes
for the To/From HP BASIC/UX objects in
different threads.

A To/From HP BASIC/UX object is generally
preceded by an Init HP BASIC/UX object.

LOCATION
I/O ==> HP BASIC/UX ==> To/From HP BASIC/UX

OPEN VIEW PARAMETERS
The open view shows the list of transactions
to be executed.

OBJECT MENU
* Config - Allows you to view and edit
end-of-line sequences and formatting for
arrays.

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

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

* Delete Trans - Deletes the currently
highlighted transaction.

NOTES
Because of the behavior of named pipes, it is
easiest to structure your HP VEE transactions
and corresponding HP BASIC/UX OUTPUTs and
ENTERs to transmit known or easily parsed
data blocks.  For example, if you are
transmitting strings, determine the maximum
length block you wish to transmit and pad
shorter strings with blanks.  This avoids the
problems of trying to read more data from a
pipe than is available and of leaving
unwanted data in a pipe.

If you are running discless, be certain
you Read and Write to uniquely named pipes.

EXAMPLE
Here are typical To/From HP BASIC/UX settings
and the corresponding HP BASIC/UX program:

To/From HP BASIC/UX Object
   Write Pipe : /tmp/to_rmb 
   Read Pipe  : /tmp/from_rmb
(These default pipes are created for you the
first time the object operates.)

HP BASIC/UX Program
   100 ASSIGN @From_vee TO "/tmp/to_rmb" 
   110 ASSIGN @To_vee TO "/tmp/from_rmb" 
   120 ! Your code here 
   130 ENTER @From_vee;Vee_data 
   140 OUTPUT @To_vee;Rmb_data 
   150 END

SEE ALSO
Init HP BASIC/UX and To/From Named Pipe.

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