VSI Datatrieve V7.4-4

VSI is pleased to introduce VSI Datatrieve V7.4-4 for VSI OpenVMS x86-64 and OpenVMS IA-64.

VSI Datatrieve is a tool for managing information. It is a high-level interactive query and report generation tool. Datatrieve works against flat files, indexed files, and databases. Such data files are delimited using record definitions stored in the VSI Data Dictionary (VDD).

This document outlines the changes made to Datatrieve after its porting to OpenVMS x86-64 and OpenVMS IA-64, including the introduction of support for VDD.

VSI Datatrieve V7.4-4 can be installed by a suitably privileged user on an OpenVMS system that meets the following minimum software requirements:

Before installing VSI Datatrieve V7.4-4, ensure that the appropriate dictionary environment has been installed and configured as described in Section 2, ''Requirements''.

If using VDD, ensure that the VDD environment has been set up as outlined above. Then, run the command below from a privileged account (such as the SYSTEM account).

$ @SYS$UPDATE:VMSINSTAL * device-name:[username.DATATRIEVE]

The installation will then proceed as follows (output may differ slightly from that shown below depending on various factors):

 OpenVMS  Software Product Installation Procedure V9.2-3


It is 5-OCT-2026 at 17:05.

Enter a question mark (?) at any time for help.

* Are you satisfied with the backup of your system disk [YES]? 

* Enter installation options you wish to use (none):

The following products will be processed:

  DTRA V7.4


 Beginning installation of DTRA V7.4 at 17:05

%VMSINSTAL-I-VALSIGN, Performing product kit validation of signed kits ...
Success
%VMSINSTAL-I-VALPASSED, validation of DTRA074.A_VNC succeeded
Success
%VMSINSTAL-I-VALPASSED, validation of DTRA074.B_VNC succeeded
Success
%VMSINSTAL-I-VALPASSED, validation of DTRA074.C_VNC succeeded
%VMSINSTAL-I-RESTORE, Restoring product save set A ...
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

            DATATRIEVE V7.4-4 Installation Procedure

  © Copyright 2026 VMS Software, Inc. and Hewlett-Packard Enterprise Development LP

* Do you want support for VDD (VSI Data Dictionary) [YES]?


        Product:      DTR or DTR-USER
        Producer:     VSI
        Version:      V7.4-4
        Release Date: 01-OCT-2026


* Does this product have an authorization key registered and loaded? Yes
* Do you want to use default answers for all questions [YES]?

    The DATATRIEVE IVP will be put in the SYS$COMMON:[SYSTEST.DTR]
    directory. You may run the IVP immediately after the completion of
    the installation procedure answering YES to the next question or
    later issuing the following command:

    @SYS$COMMON:[SYSTEST.DTR]DTR$IVP.COM DTR32.EXE


* Do you want to run the IVP after the installation [YES]?
* Proceed with this installation [YES]?

    All questions regarding the installation have now been asked.

%VMSINSTAL-I-RESTORE, Restoring product save set B ...
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTEST.DTR].

    Providing the following LSE language(s):

        DATATRIEVE


    During the installation, a file called
    DTRSTUP.COM has been added to SYS$STARTUP:

    The site-dependent start-up file, SYS$MANAGER:SYSTARTUP.COM
    should have the following line added:

   $ @SYS$STARTUP:DTRSTUP.COM

%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.ADT].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.DEMO].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.FORMS].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.GUIDE].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.PLOTS].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.DEMO.RDB].
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[DTR.DTR$LIB.DEMO.DBMS].

    **************************************************************
    DATATRIEVE User Environment Test Packages (UETPs)
    have been provided and can be run after the installation is
    complete. They are invoked from DATATRIEVE as follows:

    DTR> @sys$common:[systest.dtr]dtr     ! The general test
    DTR> @sys$common:[systest.dtr]plots   ! The plots test
    DTR> @sys$common:[systest.dtr]rdb     ! The Rdb test
    DTR> @sys$common:[systest.dtr]forms   ! The Forms test


    Before invoking these files from a user's account you must
    execute the procedure :
                    @DTR$LIBRARY:NEWUSER.COM
    This procedure loads the DATATRIEVE definitions into the
    user's dictionary and the data files in the user's directory.
    This procedure must be executed by each user needing
    the DATATRIEVE examples
    ****************************************************************



Restoring UETP-related Oracle Rdb objects

    The following error messages may be safely ignored:

        %RMU-I-AIJRSTAVL, 0 after-image journals available for use
        %RMU-I-AIJISOFF, after-image journaling has been disabled
        %RMU-W-USERECCOM, Use the RMU Recover command.
        %CDD-I-MBLRSYNINFO, unsupported entity - marked Incomplete


    *******************************************************************

    A database for the DATATRIEVE UETP that utilizes Oracle Rdb
    cannot be created because the Rdb monitor is not running.
    Although the installation has not been aborted, the UETP will
    not function properly. It is recommended that you start the
    Oracle Rdb monitor then re-run this installation. 

    *******************************************************************


Cleanup the UETP-related Oracle Rdb objects
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
 
            DATATRIEVE V7.4-4 Installation Procedure

  © Copyright 2026 VMS Software, Inc. and Hewlett-Packard Enterprise Development LP


Executing IVP for:  DATATRIEVE V7.4-4

  © Copyright 2026 VMS Software, Inc. and Hewlett-Packard Enterprise Development LP


    Test completed successfully
    ***************************

    IVP COMPLETED SUCCESSFULLY
    **************************

IVP completed for:  DATATRIEVE V7.4-4


        Installation of DTRA V7.4 completed at 17:06

    Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

    Creating installation data file: VMI$ROOT:[SYSUPD]DTRA074.VMI_DATA


        VMSINSTAL procedure done at 17:06

VSI Datatrieve has now been successfully installed on your system.

The following issues and limitations have been discovered at the time of this release:

ACL-Related Commands

When Datatrieve is used with VDD, commands related to privileges are not supported because VDD does not currently provide ACL functionality. As a result, Datatrieve privilege-related commands will fail if used. For example:

DTR> SHOWP YACHTS
%VDD-E-INTERR1, internal error:

The affected commands are DEFINEP, DELETEP, and SHOWP.

Executing CDO Commands From Datatrieve

When Datatrieve is used with VDD, the Datatrieve CDO command (which allows users to execute CDO commands from inside Datatrieve) is not supported and will fail if used. For example:

DTR> CDO DIRECTORY
internal error: !AF
%VDD-E-INTERR1, internal error:

Commands can instead be run by exiting Datatrieve and executing them directly in VDO.

Protocol Usage

CDD supports two protocols, NAD and DMU. When Datatrieve is used with CDD, either protocol may be used.

VDD supports only the DMU protocol. As a result, when Datatrieve is used with VDD, it always operates using the DMU protocol.

This difference has minimal impact for the user, as the results from both protocols are mostly the same.