 






     Software
     Product
     Description

     ________________________________________________________________

     PRODUCT NAME:  DEC Realtime Test Integrator for VMS, Version 2.0
     SPD 28.30.07

     DESCRIPTION

     DEC Realtime Test Integrator (RT Integrator) for VMS[1] is an
     icon-based, graphical programming environment utilizing the
     subroutine libraries (LIO, LGP and LPS) of VAXlab Software
     Library (VSL). Instead of using a conventional programming
     language, users create and run realtime (data acquisition,
     IEEE-488 and RS-232 instrument control, test and measurement)
     applications by drawing them graphically as flow diagrams.

     Each DEC RT Integrator icon represents a function such as an
     analog or digital input, an arithmetic operation, or a logical
     function. The application is built by using the point-and-click
     method now standard in graphical user interfaces. By pointing
     and clicking the mouse, icons are moved from the libraries to
     the worksurface and then connected to the icons with either
     data flow or signal flow lines. Once the icons are set up, the
     application is ready to run.

     The worksurface acts as a graphical editor, enabling users
     to move, copy, delete, add, cut and paste icons representing
     devices and sections of code. This allows users to create and
     change applications quicker than with traditional programming
     languages.



     ___________________

   [1] Formerly VAXlab Software Library

                                  DIGITAL                  April 1991

                                                          AE-PEHMC-TE

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     Each icon has a set-up menu that allows customization of its
     function for the application. Once built, the application can
     be saved and restored without repeating the set-up operations.
     Since the configuration is saved as an ASCII text file, it can
     be mailed to any other system running DEC RT Integrator and re-
     stored there. This feature allows users to build an application
     on a VMS system and transport it to an ULTRIX system (if the
     ULTRIX version of DEC RT Integrator uses icons that are avail-
     able with both operating systems) or vice versa, and run it with
     few modifications.

     DEC RT Integrator extends its capabilities by allowing users
     to create and modify icons by following a template and detailed
     instructions. Since all icons are modular functions, the indi-
     vidually created icons can be used in all future applications.

     By putting icons together and shrinking them to form a single
     icon, macros can be built and manipulated like any other indi-
     vidual icon. This feature allows the user to create higher order
     representations of an application from basic building blocks.

     For any DEC RT Integrator application, a control panel can be
     created using the data display and user input icons. The con-
     trol panel is a simple user interface representing an instrument
     control panel that novice users and non-programmers can use to
     interact with the application. Little knowledge of DEC RT In-
     tegrator is required to run an application using the control
     panel. Building the control panel requires selecting the ap-
     propriate icons and positioning the user input devices on the
     control panel surface.

     Every application has two conceptual views: a data flow view
     and a signal flow view. DEC RT Integrator allows users to switch
     between both views with the click of a mouse button. In the data
     flow view, the connections between icons represent the flow of
     data through the application. The signal flow view displays the
     application's logic structure.


                                     2

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     Context-sensitive, on-line HELP makes the software environ-
     ment easy to learn. Using the point-and-click method, HELP is
     provided on the specific icon selected.

     DEC RT Integrator was designed to simplify IEEE-488 instrument
     control. The user directly programs the instrument and needs
     no knowledge of the bus itself. String manipulation and other
     support icons simplify the construction of command strings.
     The service request (SRQ) can be detected as a signal in the
     signal flow view and the SRQ status byte is available as data
     in the data flow view. These mechanisms allow instrument events
     to be detected and serviced with the same graphical programming
     techniques used to create the rest of the application.

     DEC RT Integrator allows users to monitor alpha-numeric data
     as it is being collected, and display it as a line plot, point
     plot, or scrolling text. Users can insert the display icons in
     any path of the data flow diagram and use them as a probe to
     trace the data as it flows through the application. In addition
     to monitoring the data, users can also generate PostScript[R]
     files of the plots for hardcopy records.

     In addition to the traditional mathematical and trigonometric
     operations, there are icons to perform noise filtering, scaling,
     multiplexing, or signal processing functions such as FFTs Fast
     Fourier Transformations and power spectrum analysis. A range
     check icon allows users to determine if a data value falls
     outside a given range and take corrective action.

     Time generation functions allow users to trigger applications or
     events using either a realtime clock or a system clock. A time
     stamp can also be put on each data value as it is stored to a
     file.

     DEC RT Integrator software is compatible with DECwindows so
     applications can be controlled from or displayed on any worksta-
     tion, personal computer, or terminal that is compatible with the
     X Window System.

                                     3

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     In addition, the LIO subroutines have the capability to control
     the Preston Scientific GMAD & EMAD-series analog input sub-
     systems when they are interfaced to the Q-bus via the DRQ3B or
     DRV11-WA

     The LIO subroutines permit the user to do the following:

     o  Attach a device and set it up for QIO, connect-to-interrupt
        I/O or mapped I/O

     o  Specify and verify the setup parameters of an I/O device

     o  Release a buffer from the user queue to the device queue

     o  Read a buffer with data from a device

     o  Write a buffer of data to the device

     o  Obtain a buffer from a device queue and put it in the user
        queue

     o  Enqueue multiple buffers to a device for continuous data
        transfer

     o  Detach a device and shut down the I/O process in an orderly
        fashion

     The LSP subroutines perform data format translation, Fast
     Fourier Transformations (FFTs), signal filtering, interval his-
     togramming, and thermocouple voltage-to-temperature conversions.
     Routines are also included to calculate power spectra, cross-
     correlations, auto-correlations, and phase angle and modulus
     spectra.

     The Fourier transform routines handle both real and complex
     data in one or two dimensions, in both the forward and inverse
     directions. Filtering algorithms include simple polynomial
     filtering, nonrecursive filtering, and spectral windowing.

                                     4

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     The LGP subroutines are used to plot data in the form of 2-D,
     3-D, histogram, contour, and realtime plots. Under a DECwindows
     environment, the computations may be done on a client while
     graphics are displayed on a workstation server. The graphs can
     be output as DDIF files for use with other applications, such as
     DECwrite.

     The LGP subroutines allow the user to perform the following
     tasks:

     o  Create a 2-D linear/logarithmic axis system and plot an array

     o  Update a 2-D plot by erasing old data and adding new data

     o  Plot additional data sets on a previously defined graph

     o  Plot a previously stored metafile

     o  Plot a point in one of 10 geometric shapes

     o  Print the screen on an attached printer

     o  Produce a hard copy of the plot displayed on the screen

     o  Create a 2-D contour projection

     o  Add an additional contour chart to the existing one

     o  Create a shaded contour projection

     o  Draw a histogram

     o  Write a text string to a specified location on a plot

     o  Plot standard deviation markers on data points

     o  Plot a 3-D array with hidden line removal

     o  Set up the axis system for a 3-D graph

     o  Clear all or part of a window

     o  Obtain the coordinates of a cursor or input device

     o  Compute the autoscaling parameters for linear and logarithmic
        plots

                                     5

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     o  Fit a cubic spline to a set of data points

     o  Return the value selected from a menu

     o  Prompt the user for a user string

     o  Collect a series of x-y pairs from an input device

     o  Collect a series of values with a specified range from a
        valuator type input device

     In addition, users can add support for any foreign device for
     which a GKS handler exists.

     DEC Realtime Test Integrator for VMS supports the IEZ11, which
     is an IEEE-488 bus-controller for Digital workstations with a
     SCSI interface. DEC RT Integrator for VMS manages all SCSI and
     RS232 interactions allowing users to communicate directly with
     the IEEE-488 bus. This product also supports the VAXBI clock.

     Multiple plotting windows are supported on all terminals.

     HARDWARE REQUIREMENTS

     VAX, MicroVAX, VAXserver or VAXstation configuration as speci-
     fied in the System Support Addendum (SSA 28.30.07-x).

     SOFTWARE REQUIREMENTS

     For Systems Using Terminals (No DECwindows Interface):

     o  VMS Operating System

     For Workstations Running VWS (Required to use the LIO realtime
     plotting device. The icon-based user interface is not available
     to customers who choose the VWS windowing system):

     o  VMS Operating System

     o  VMS Workstation Software

                                     6

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     For Workstations Running DECwindows (Required to use the icon-
     based user interface).

     o  VMS Operating Systems (and necessary components of VMS
        DECwindows)

     o  DEC GKS for VMS

     o  VAX C is required if the user is developing custom icons.

     The DRB32 VMS Drivers are a prerequisite for LIO support of the
     DRB32 and DRB32W devices and I/O subsystems that interface to
     the VAXBI through the DRB32 and DRB32W.

     The RTC01 BI clock is a prerequisite to use BI devices through
     LIO I/O support.

     Refer to the System Support Addendum (SSA 28.30.07-x) for avail-
     ability and required versions of prerequisite/optional software
     and for information regarding components of VMS DECwindows.

     ORDERING INFORMATION

     Development Option

     The Development Kit allows the user to develop realtime applica-
     tions including data acquisition, IEEE-488 and RS-232 instrument
     control, and test and measurement. After an application has
     been developed, it can run on a system which has either the
     Development Kit or the Runtime Kit installed.

     Software Licenses: QL-YWQA9-QB
     Software Media: QA-YWQAA-**
     Software Documentation: QA-YWQAA-GZ
     Software Product Services: QT-YWQA*-**

     Runtime Option

     The Runtime Kit allows the user to run an application, but not
     to develop an application.

                                     7

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     Software Licenses: QL-B15A9-J*
     Software Media: QA-B15AA-**
     Software Product Services: QT-B15A*-**

     *  Denotes variant fields. For additional information on li-
        censes, services, and media, refer to the appropriate price
        book.

     SOFTWARE LICENSING

     This software is furnished under the licensing provisions of
     Digital Equipment Corporation's Standard Terms and Conditions.
     For more information about Digital's licensing terms and poli-
     cies, contact your local Digital office.

     LICENSE MANAGEMENT FACILITY

     This layered product supports the License Management Facility.
     License units for this product are allocated on a CPU capacity
     basis.

     For more information on the License Management Facility, refer
     to the VMS Operating System Software Product Description (SPD
     25.01.xx) or the VMS Operating System documentation set.

     For more information on Digital's licensing policies, contact
     your local Digital office.

     SOFTWARE PRODUCT SERVICES

     A variety of service options are available from Digital. For
     more information, contact your local Digital office.







                                     8

 


     DEC Realtime Test Integrator for VMS, Version 2.0   SPD 28.30.07



     SOFTWARE WARRANTY

     Warranty for this software product is provided by Digital with
     the purchase of a license for the product as defined in the
     Software Warranty Addendum of this SPD.

     [R]  PostScript is a registered trademark of Adobe Systems,
          Incorporated.

     [TM] The DIGITAL Logo, CI, DEC, DECserver, DECwindows, DRB32,
          LA, LA50, Q-bus, MicroVAX, RA, TK, VAXcluster, VAXserver,
          VAXstation, VAX, VAX Ada, VAX BASIC, VAXBI, VAX C, VAX FOR-
          TRAN, VAX Pascal, VMS, VT, VT330 and VT340 are trademarks
          of Digital Equipment Corporation.

























                                     9
