
                   HP VEE for UNIX, Version B.02.01                    

_______________________________________________________________________
INTRODUCTION

HP VEE for UNIX Version B.02.01 is a bug fix release that includes some 
changes to eliminate problems found in the B.00.01 (HP 9000) and B.01.00 
(Sun) releases.  This release should be used to allow programs, which 
encountered problems in Version B.00.01 or B.01.00, to run.  This release 
should not be used for program development because it includes features 
that are not backward compatible with Version B.00.01 or B.01.00.

     UNIX (R) is a registered trademark of UNIX System Laboratories in 
     the U.S.A. and other countries.


_______________________________________________________________________
INSTALLATION

In addition to this file, "readme.B.02.01", you need to retrieve a new 
executable file (Version B.02.01), which has one of the following names:

* veetest.700.B.02.01.Z    For HP 9000 Series 700 computers running HP-UX
                           Version 8.x or 9.x

* veetest.300.B.02.01.Z    For HP 9000 Series 300 computers running HP-UX
                           Version 8.x or 9.x

* veetest.sun.B.02.01.Z    For Sun SPARCstations running SunOS Version 4.1.x


To install your new executable file, you will need to retrieve it off the 
network, uncompress it, and copy it over your current executable file, 
which has the following path name:

   /usr/lib/veetest/veetest

Before you do this, you may want to copy your current "veetest" 
executable file to a different name, such as "veetest.old".  Then copy 
your new executable file over the current "veetest" file using the 
above path.  (You must do this from "root".)  

This completes the installation.  The new executable file will work 
with the rest of your previously installed HP VEE system.  You can 
start HP VEE in the usual manner.


_______________________________________________________________________
SUMMARY OF FEATURE CHANGES

Version B.02.01 includes the following feature changes:

* Menu "accelerators" have been added, which are indicated by underlined 
  characters in the menu names.  For example, you can get the Edit menu 
  by pressing [Alt]+[E].  Also, many of the keyboard short cuts are now 
  listed in the menus for your convenience.

* The method for editing fields in various objects (for example, 
  the "Function Name" field in the "Call Function" object) has 
  been changed.  When you click on the field, the text cursor 
  appears at the position of the mouse pointer.  You can move the 
  text cursor by clicking the mouse in a different position, or by 
  using the arrow keys.  You can also select any portion of the text 
  in the field by clicking and holding the mouse button, and moving the 
  mouse to the left or right.  This makes it easier to delete or add 
  text in the field.

* When you select "Make Userfunction" in the object menu of a "UserObject", 
  you may be prompted for a name for the User Function.  This occurs if 
  you haven't already entered a valid name in the "UserObject" title 
  field using "Change Title" (described below).

* "Change Title" has been added to each object menu and to the "File" 
  menu.  Use "Change Title" to change the title of an object, or of the 
  program.  (You no longer can type directly in the title field.  However, 
  you can now click and drag on the title bar to move an object.)

* "Print Setup" and "Plotter Setup" have been added to the "File" menu 
  to replace "Printer Config" and "Plotter Config" (formerly under 
  "File" ==> "Preferences").

* "Show Data Flow Rate" has been added to "File" ==> "Preferences".  Use 
  this selection to control the rate at which the data "torpedoes" travel.

* "Delete Globals at PreRun" has been added to "File" ==> "Preferences".  
  By default "Delete Globals at PreRun" is "On" (checked), and all global 
  variables are deleted each time you run the program.  You can turn 
  "Delete Globals" off.  However, if you do, you will need to be careful.  
  It is possible for a program to propagate old data, and to give 
  unexpected results if "Delete Globals" is turned off.

* "To/From DDE (PC)" and "Execute Program (PC)" have been added to the 
  "I/O" menu.  However, these features are designed for the PC, and are 
  not supported on the UNIX platform.

* "I/O" ==> "Instrument" has been changed.  When selected, a new dialog 
  box, "Instrument Select or Configure", appears.  When you select 
  "Add Instrument" or "Edit Instrument" in this dialog box, the 
  "Device Configuration" dialog box appears.  (The old "Configure I/O" 
  selection has been removed from the "I/O" menu.)  The new dialog boxes 
  do not have online help files, so the "Help" button doesn't work.  
  However, reference sections for these dialog boxes follow below.


_______________________________________________________________________
INSTRUMENT SELECT OR CONFIGURE

A dialog box that allows you to add, delete, or edit instruments.


Use:

Click on "I/O" ==> "Instrument" to display the 
"Instrument Select or Configure" dialog box.  Use this dialog box 
to add, edit, and delete instruments from the list of configured 
instruments, and to select and display the three types of instrument  
I/O objects:  Instrument Panels, Component Drivers, and Direct I/O
objects. 


Location:

"I/O" ==> "Instrument ..."


Dialog Information:

The "Instrument Select or Configure" dialog box provides four buttons 
at the bottom: "Get Instr", "Save Config", "Cancel", and "Help".  
The dialog box is divided into three areas:


* A scrollable list of instruments. - Click on an instrument in the list 
  to select it.  Click on it again, or click on the "Get Instr" button 
  to add an instrument I/O object to the work area.  The type of the 
  object will depend on which radio button has been pressed in the 
  "Instrument Type" area, described below.

* "Instrument Type" - This area determines the type of instrument 
  I/O object that is added to the work area when you click on the 
  "Get Instr" button.  There are radio buttons for "Instrument Panel", 
  "Component Driver", and "Direct I/O". 
  (The default is "Instrument Panel".)

* "Instrument Configure" - This area allows you to change instrument 
  configurations.  There are three selections:

  - "Add Instrument" - This selection allows you to add an instrument to 
    the list.  When you click on "Add Instrument", the "Device 
    Configuration" dialog box appears.  You can configure the instrument 
    that you want to add by filling out the fields in this dialog box.

  - "Delete Instrument" - This selection deletes the currently highlighted 
    instrument from the list.  If you make a mistake, just click on the 
    "Cancel" button to recover.

  - "Edit Instrument" - This selection allows you to edit an existing 
    instrument configuration.  When you click on "Edit Instrument", the 
    "Device Configuration" dialog box appears, and you can make changes.

Notes:

When you click on "Get Instr", a "Save Config" also occurs.

An I/O object may be operated with or without actual instruments connected 
to the computer.  If you wish to control a live instrument, you must
set a correct, non-zero address and enable Live Mode.  The address and
Live Mode setting are controlled by way of the "Device Configuration" 
dialog box.  If the address is zero or if "Live Mode" is off, the 
instrument object operates but does not attempt to communicate with 
a physical instrument.

For instrument-specific help, select "Help" from the object menu 
of an "Instrument Panel" or "Component Driver" object, or select 
"Help" ==> "Instruments".

Instrument Panels can be used interactively or within a program.  To set 
the value of an individual component, click on the field containing the
value of the component and complete the resulting dialog box.  To make a
measurement and display the result, click on the corresponding numeric
readout or XY display inside the "Instrument Panel" open view.

It is possible to have more than one object controlling a single 
instrument.  It is also possible to have multiple copies of the same 
driver, each controlling a different physical instrument.  In either 
case, it is the configured name that determines which object controls 
which instrument.

Before HP VEE can communicate with your physical instruments, the 
instruments and your hardware interfaces must be properly configured.  
Refer to your HP VEE installation instructions for further information. 
Your system administrator will need to verify the proper configuration 
of your system's interface drivers.  (These interface drivers are 
different from the instrument driver files included with HP VEE.)


See Also:

"Advanced I/O", "Bus I/O Monitor", "Component Driver", and "Direct I/O" 
in the "HP VEE Reference" manual.

_______________________________________________________________________
DEVICE CONFIGURATION

A dialog box that allows you to configure instruments.


Use:

Use the "Device Configuration" dialog box to add a new instrument 
configuration or to edit an existing configuration.  You can use 
"Device Configuration" to configure either a direct I/O configuration,
or an instrument driver configuration.


Location:

"I/O" ==> "Instrument ..." 


Dialog Information:

The "Device Configuration" dialog box provides the following fields 
and buttons:


NOTE:

Use the [Tab] key to tab from field to field, or click on the desired 
field with the mouse.  Do not press [Enter] (or [Return]) until you 
are finished with the dialog box.  Pressing [Enter] (or [Return]) 
will cause the dialog box to close -- it is equivalent to 
pressing "OK".


* "Name" - Enter a unique name to identify this particular instrument 
  configuration.  Note that more than one configuration, each 
  identified by a unique name, can control a single instrument.  
  On the other hand, you cannot use the same name for two different 
  instruments.  

* "Interface" - Specifies the type of hardware interface used to 
  communicate with the instrument (the default is "HP-IB").  Click 
  on "HP-IB" to display a list of available interface types 
  ("HP-IB", "Serial", and so forth).  If you are using a GPIB 
  interface, select "HP-IB"  for this field.

* "Address (eg 714)" - Specifies the I/O address of your 
  instrument.  The default is "0".  (When you enter a non-zero address, 
  "Live Mode" changes to "ON".)

* "Device Type" - HP VEE does not use this field.  You can enter an 
  optional device type description in this field for your convenience.

* "Timeout (sec)" - Specifies how many seconds HP VEE will wait for 
  an instrument to respond to a request for communication before 
  generating an error.  The default is "5" seconds.

* "Byte Ordering" - Specifies the order the device uses for reading 
  and writing binary data.  HP VEE will determine if byte swapping is 
  necessary.  Click on this field to choose between "MSB" (send 
  Most-Significant Byte first) and "LSB" (send Least-Significant Byte first). 
  All IEEE 488.2-compliant devices use the "MSB" order.  Refer to your 
  instrument manual for more specific information.

* "Live Mode" - Specifies whether "Live Mode" is "ON" or "OFF".  
  If "Live Mode" is off, you can run your program even without your 
  instrument being connected.  However, to actually communicate with 
  the instrument, "Live Mode" must be "ON".  "Live Mode" remains 
  "OFF" until you enter a non-zero address in the "Address" field.  
  Then, "Live Mode" switches to "ON", and you can toggle the field 
  "ON" or "OFF" by clicking on it.

* Config buttons - To complete your device configuration, you must 
  click on one of the following buttons:

  - "Direct I/O Config ..." - Click on this button if you plan to use 
    a "Direct I/O" object to control your instrument.  The 
    "Direct I/O Configuration" dialog box will ask you for additional 
    information, depending on the interface you are using.

  - "Instrument Driver Config ..." - Click on this button if you plan to 
    use an "Instrument Panel" or "Component Driver" to control your 
    instrument.  The "Instrument Driver Configuration" dialog box will 
    ask you for additional information, depending on the interface you 
    are using.

* Address space buttons (VXI only). - If you are using "Direct I/O" to 
  control a VXI device, there are additional options. 

  - "A16 Space Config" - Click on this button if you want to access the 
    VXI device's registers.  Complete the resulting dialog box.

  - "A24/32 Space Config" - Click on this button if you want to access the 
    VXI device's extended memory.  Complete the resulting dialog box.

* "OK" button. - Once you have completed your configuration, press "OK". 


See Also:

"Advanced I/O", "Bus I/O Monitor", "Component Driver", and "Direct I/O" 
in the "HP VEE Reference" manual.


