 














             VAX DEC/Test Manager Installation Guide

             Order Number: AA-Z331G-TE



             August 1990

             This document contains instructions for installing VAX DEC
             /Test Manager on the VMS operating system. It also explains
             how to read the online release notes before or after in-
             stalling the product. This document applies to VAX DEC/Test
             Manager Version 3.2 and all maintenance updates throughout
             that version.




             Revision/Update Information:  This revised manual super-
                                           sedes the VAX DEC/Test Manager
                                           Installation Guide (Order
                                           Number AA-Z331F-TE).

             Operating System and Version: VMS Version 5.3 or higher.
                                           Future maintenance releases may
                                           require higher versions.

             Software Version:             VAX DEC/Test Manager Version
                                           3.2
             digital equipment corporation
             maynard, massachusetts

 

             Revised, December 1989
             Revised, August 1990

             The information in this document is subject to change without
             notice and should not be construed as a commitment by Digital
             Equipment Corporation. Digital Equipment Corporation assumes
             no responsibility for any errors that may appear in this
             document.

             The software described in this document is furnished under a
             license and may be used or copied only in accordance with the
             terms of such license.

             No responsibility is assumed for the use or reliability
             of software on equipment that is not supplied by Digital
             Equipment Corporation or its affiliated companies.

             Restricted Rights: Use, duplication, or disclosure by the
             U.S. Government is subject to restrictions as set forth in
             subparagraph (c)(1)(ii)  of the Rights in Technical Data and
             Computer Software clause at DFARS 252.227-7013.

              Digital Equipment Corporation 1984, 1985, 1986, 1987, 1989,
             1990.

             All Rights Reserved.
             Printed in U.S.A.

             The postpaid Reader's Comments forms at the end of this docu-
             ment request your critical evaluation to assist in preparing
             future documentation.

             The following are trademarks of Digital Equipment Corporation:

             ALL-IN-1        EduSystem     RT
             DEC             IAS           ULTRIX
             DEC/CMS         MASSBUS       UNIBUS
             DEC/MMS         PDP           VAX
             DECnet          PDT           VAXcluster
             DECmate         P/OS          VMS
             DECsystem-10    Professional  VT
             DECSYSTEM-20    Q-bus         Work Processor
             DECUS           Rainbow
             DECwriter       RSTS
             DIBOL           RSX           DIGITAL

                                                                    ZK5568

 















                                                                  Contents
          ________________________________________________________________

          Preface .........................................................  v
          Preparing to Install VAX DEC/Test Manager..................    1
            Prerequisite Software....................................... 1
            Accessing the Online Release Notes........................   1
            Installation Procedure Requirements.......................   2
            System Quotas and Privileges...............................  4
            User Account Quotas and Privileges........................   4
            VMS License Management Facility ...........................  5
            Special Requirements ........................................ 6
            Using VMSINSTAL.............................................. 6
          Installing VAX DEC/Test Manager .............................  9
            Installing VAX DEC/Test Manager on a VAXcluster.........    15
            Running VAX DEC/Test Manager on a Mixed VAXcluster .....    16
          After the Installation........................................ 16
            VAX DEC/Test Manager Files ................................. 17
          Running the Installation Verification Procedure
            Separately....................................................  17
          Error Conditions............................................... 18
          Maintenance Updates ........................................... 19
          Determining and Reporting Problems..........................  20
          Sample Installation ........................................... 20







                                                                       iii

 














                                                                   Preface
          ________________________________________________________________



             This document describes how to install VAX DEC/Test Manager
             on the VMS operating system. It is intended for system man-
             agers. This document applies to VAX DEC/Test Manager Version
             3.2 and all maintenance updates in that version. A major ver-
             sion number is represented by the digits to the left of the
             decimal point, and the maintenance update version number is
             indicated by the digits to the right of the decimal point.

             Keep this document with your distribution kit. You will need
             it to install maintenance updates or to reinstall VAX DEC
             /Test Manager for any other reason.

             At the back of this document are two Reader's Comments forms.
             If you have any comments about this document, please fill out
             one form and mail it; your comments will be considered for
             the next revision of the installation guide.

             For more information about installing VAX DEC/Test Manager on
             VMS systems, refer to your processor-specific installation
             /operations guide.

             The installation procedure is described step-by-step and is,
             for the most part, self-explanatory. The system prompts you
             to answer questions and to change volumes, and waits for you
             to tell it to continue.

                                                                         v

 






             Defaults appear in brackets ([])  throughout the installation
             procedure. Text you type is indicated in red.





































          vi

 





          ____________________________________________________________

          Preparing to Install VAX DEC/Test Manager

             Your bill of materials (BOM) and indented bills report (BIL)
             specify the number and contents of your media. Be sure to
             check the contents of your kit against this information.
             If your kit is damaged or if you find that parts of it are
             missing, call your Digital representative.

             Distribution media must be mounted in numerical order. The
             installation procedure prompts you to mount the volumes. For
             more information on how to mount distribution media, refer to
             your processor-specific installation/operations guide, which
             also details several options to the installation procedure.

          ____________________________________________________________

          Prerequisite Software

             VAX DEC/Test Manager Version 3.2 requires VMS Version 5.3 or
             higher.

          ____________________________________________________________

          Accessing the Online Release Notes

             VAX DEC/Test Manager provides online release notes. The
             prompt to display or print the release notes before installa-
             tion appears in step 5 of the installation procedure when you
             invoke VMSINSTAL with the OPTIONS N parameter.

             To obtain the release notes after the installation, type
             or print the file SYS$HELP:DTM$032.RELEASE_NOTES. Online
             help also directs you to the release notes file. After the
             installation, type the following:

               $ HELP DTM RELEASE_NOTES


                                 VAX DEC/Test Manager Installation Guide 1

 





          ____________________________________________________________

          Installation Procedure Requirements

             The installation should take approximately 10 to 20 minutes,
             depending on the type of media and your system configuration.
             Before installing VAX DEC/Test Manager, you must have the
             following privileges and resources:

              o SETPRV privileges, or CMKRNL, WORLD, and SYSPRV privileges

              o A minimum of 8500 blocks of free disk space during instal-
                lation; 6000 blocks are used after installation

              o A minimum of 800 free global pages plus the size (in num-
                ber of disk blocks) of the file SYS$LIBRARY:DCLTABLES.EXE
                at installation; for most efficient operation, you will
                need a total of 800 free global pages plus the size of
                SYS$LIBRARY:DCLTABLES.EXE after installation

              o A minimum of 12 free global sections at installation; 12
                global sections are used after installation

              o The minimum number of VMS classes necessary for full
                functionality as described in the VAX DEC/Test Manager
                System Support Addendum.

                                          NOTE

                 You must ensure that your system has the necessary
                 global page and global section SYSGEN quotas for the
                 installation. Failure to do so could cause the DCL
                 tables to be corrupted in some situations.

             To determine the number of available global pages on your
             system, invoke the VMS Install Utility by typing the follow-
             ing commands:

               $ INSTALL

          2  VAX DEC/Test Manager Installation Guide

 






             Then type the following command:

               INSTALL> LIST/GLOBAL/SUMMARY

                       Summary of Local Memory Global Sections

               153 Global Sections Used,  11200/8800 Global Pages Used/Unused

               INSTALL> EXIT

             When you issue these commands, the system displays a summary
             of the number of global sections used, the number of global
             pages used, and the number of global pages unused. To exit
             from the VMS Install Utility, type the EXIT command.

             VAX DEC/Test Manager requires approximately 800 global pages.
             If fewer than 800 pages are available, you can delete an
             existing known image with the VMS Install Utility, or you
             can increase the GBLPAGES system parameter with the VMS
             System Generation Utility (SYSGEN) by editing the file
             SYS$SYSTEM:MODPARAMS.DAT and then invoking the AUTOGEN com-
             mand procedure, SYS$UPDATE:AUTOGEN.COM. For more information
             on the AUTOGEN command procedure, see your processor-specific
             installation/operations guide.

             You can determine the number of available global sections by
             invoking SYSGEN as follows:

               $ RUN SYS$SYSTEM:SYSGEN
               SYSGEN> USE CURRENT
               SYSGEN> SHOW GBLSECTIONS

               SYSGEN> EXIT

             The last number displayed is the maximum number of global
             sections. Compare this number to the number of global sec-
             tions in use displayed by the VMS Install Utility. VAX DEC
             /Test Manager requires 12 global sections. Therefore, if the
             number of global sections used plus 12 exceeds the maximum
             number of global sections, you must increase the number of
             available global sections before you can install VAX DEC
             /Test Manager. To increase the number, you must increase

                                 VAX DEC/Test Manager Installation Guide 3

 






             the GBLSECTIONS system parameter with SYSGEN by editing
             the file SYS$SYSTEM:MODPARAMS.DAT and then invoking the
             SYS$UPDATE:AUTOGEN.COM procedure. For more information on
             the AUTOGEN.COM procedure, see your processor-specific in-
             stallation/operations guide.

             If the number of global sections used plus 12 is less than
             the maximum number of global sections, you can exit from
             SYSGEN and continue.

          ____________________________________________________________

          System Quotas and Privileges

             VAX DEC/Test Manager Version 3.2 uses a nonpaged dynamic pool
             (NPAGEDYN) that is 20 times the total number of VAX DEC/Test
             Manager users times the maximum size of the buffered I/O
             transfer size (MAXBUF). Note that this rule applies only to
             systems running VMS Version 5.3 software. You should set the
             nonpaged dynamic pool accordingly.

          ____________________________________________________________

          User Account Quotas and Privileges

             To use VAX DEC/Test Manager, each account must have TMPMBX
             and NETMBX privileges and the following minimum requirements:

              o AST limit (ASTLM) of 100

              o Buffered I/O byte count quota (BYTLM) of 60000

              o Enqueue quota (ENQLM) of 1

              o Open file limit (FILLM) of 6

              o Subprocess creation quota (PRCLM) of 3

                                          NOTE

                 DECwindows testing may require quotas for other appli-
                 cations being tested.

          4  VAX DEC/Test Manager Installation Guide

 






             Use the VMS Authorize Utility (AUTHORIZE) to compare the
             current values of these quotas with the requirements for
             VAX DEC/Test Manager. For example, the account used in the
             following example is the SYSTEM account:

               $ SET DEFAULT SYS$SYSTEM
               $ RUN AUTHORIZE
               UAF> SHOW SYSTEM

             To change the values of these quotas, use the VMS Authorize
             Utility's MODIFY command. For more information, see the VMS
             Authorize Utility Manual.

          ____________________________________________________________

          VMS License Management Facility

             The VMS License Management Facility (LMF) is available with
             Version 5.0 or higher of the VMS operating system. VAX DEC
             /Test Manager Version 3.2 requires installation of Version
             5.3 or greater of the VMS operating system. If you are in-
             stalling VAX DEC/Test Manager on a VMS Version 5.3 system,
             you must register your VAX DEC/Test Manager software license.

             The license registration information you need is contained
             in the Product Authorization Key (PAK) that is shipped with
             VAX DEC/Test Manager. The PAK is a paper certificate that
             contains information about the license you have to run a
             particular piece of software.

             During the installation, you are asked if you have registered
             the VAX DEC/Test Manager license and loaded the appropriate
             authorization key. You must register and load your license
             for VAX DEC/Test Manager before you start the installation in
             order to run the Installation Verification Procedure (IVP)
             and use the software.



                                 VAX DEC/Test Manager Installation Guide 5

 






             To register a license under VMS Version 5.3, first log in to
             the system manager's account, SYSTEM. You then have a choice
             of two ways to perform the registration:

              o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it
                prompts you for information, respond with data from your
                PAK.

              o Issue the LICENSE REGISTER DCL command with the appro-
                priate qualifiers that correspond to information on the
                PAK.

             For complete information on using LMF, see the manual on the
             License Management Utility in the VMS documentation set.

          ____________________________________________________________

          Special Requirements

             The executable file SYS$LIBRARY:DECW$TERMINALSHR.EXE must be
             installed with the /OPEN and /SHARE qualifiers. VAX DEC/Test
             Manager does this automatically during the startup procedure.

          ____________________________________________________________

          Using VMSINSTAL

             After you log in to a privileged account to install VAX DEC
             /Test Manager, set the default directory to SYS$UPDATE and
             then invoke VMSINSTAL, the command procedure that installs
             this product. An example of this procedure is shown in steps
             1 and 2 of the Installing VAX DEC/Test Manager section.

             The VMSINSTAL command procedure has the following syntax:

               $ @SYS$UPDATE:VMSINSTAL DTM03n ddn: [OPTIONS N]



          6  VAX DEC/Test Manager Installation Guide

 






             n
             Represents the maintenance update of VAX DEC/Test Manager.
             Refer to the label on the VAX DEC/Test Manager distribu-
             tion kit or the VAX DEC/Test Manager BOM or BIL for the
             maintenance update number of your kit. You can also type
             an asterisk (*) in place of DTM03n. If you are installing
             from magnetic tape, you can use the asterisk to save instal-
             lation time; the asterisk causes VAX DEC/Test Manager to be
             installed with a minimum of tape passes.

             ddn:
             Represents a device name where the distribution volumes will
             be mounted for the VAX DEC/Test Manager installation media,
             where dd is the device code and n is the unit number. It is
             not necessary to use the console drive to install VAX DEC
             /Test Manager. If you do use the console drive, you should
             replace any media you removed from the drive. CSA1: is the
             device name used in examples in this document.

             OPTIONS N
             Is an optional parameter you should provide if you want to
             be prompted to display or print the release notes. If you
             do not include the OPTIONS N parameter, VMSINSTAL does not
             prompt you to display or print the release notes. Note that
             VMSINSTAL permits the use of several other options. For more
             information on the other options, refer to your processor-
             specific installation/operations guide.

             If you do not supply the first two parameters, VMSINSTAL
             prompts you for the product and device names. If you wish to
             be prompted for the product and device names and to display
             or print the release notes, type the following:

               $ @SYS$UPDATE:VMSINSTAL <RETURN>





                                 VAX DEC/Test Manager Installation Guide 7

 






             When you invoke VMSINSTAL, it checks the following:

              o Whether you are logged in to a privileged account. Digital
                recommends that you install software from the system
                manager's account with your default device and directory
                set to SYS$UPDATE.

              o Whether you have adequate quotas for installation.
                VMSINSTAL checks for the following quota values:

                 _ ASTLM = 18

                 _ BIOLM = 20

                 _ BYTLM = 60000

                 _ DIOLM = 11

                 _ ENQLM = 6

                 _ FILLM = 50

                 _ PGFLQUO = 30000

                 _ PRCLM = 18

                 _ TQELM = 10

                 _ WSDEF = 512

                 _ WSQUO = 1024

                 _ WSEXTENT = 3600

                VMSINSTAL then checks whether the following conditions
                exist. If so, discontinue the conditions before resuming
                the installation procedure.

                 o Whether DECnet is up and running

                 o Whether any users are logged in to the system

                If VMSINSTAL detects either of these conditions, you will
                be asked whether you want to continue the installation. If
                you want to continue, type YES. If you want to stop the
                installation, press RETURN.

          8  VAX DEC/Test Manager Installation Guide

 






                Register the information contained in the Product
                Authorization Key that is shipped with VAX DEC/Test
                Manager by using either the VMS License command proce-
                dure (VMSLICENSE) or the LICENSE REGISTER and LICENSE LOAD
                commands, as described in VMS License Management Utility
                Manual.

          ____________________________________________________________

          Installing VAX DEC/Test Manager

             This section contains excerpts from the installation pro-
             cedure and explains each step. Defaults appear in brackets
             throughout the installation procedure.

             To abort the installation procedure at any time, press
             CTRL/Y. When you press CTRL/Y, the installation procedure
             deletes all files it has created up to that point and then
             returns you to DCL level. If you want to retry the installa-
             tion procedure after pressing CTRL/Y, you must proceed from
             step 2.

             Step 1: Log in to a privileged account and set your default
             device and directory to SYS$UPDATE.

          <RETURN>

               Username: SYSTEM <RETURN>
               Password:          <RETURN>
               $ SET DEFAULT SYS$UPDATE <RETURN>









                                 VAX DEC/Test Manager Installation Guide 9

 






             Step 2: Invoke VMSINSTAL.

               $ @VMSINSTAL DTM03n CSA1: OPTIONS N <RETURN>

                     VAX/VMS Software Product Installation Procedure VX.X

               It is 15-JUN-1990 at 09:00.
               Enter a question mark (?) at any time for help.

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

             If you are satisfied with the backup of your system disk,
             press RETURN. Otherwise, type NO and press RETURN to discon-
             tinue the installation.

             Step 3: Insert the first installation kit volume.

               Please mount the first volume of the set on CSA1:.
               * Are you ready? YES <RETURN>
               The following products will be processed:

                 VAX DEC/Test Manager V3.2

                   Beginning installation of VAX DEC/Test Manager V3.2 at 09:03

               %VMSINSTAL-I-RESTORE, Restoring product saveset A...

             To indicate that you want to continue the installation, mount
             volume 1, type YES, and then press RETURN.

             Step 4: Insert the subsequent installation kit volumes.

               %BACKUP-I-READYREAD, mount volume 2 on _CSA1: for reading

               Enter "YES" when ready: YES <RETURN>




          10  VAX DEC/Test Manager Installation Guide

 






             VMSINSTAL prompts you to insert the next volume and waits for
             you to type YES after inserting it. If you type NO, VMSINSTAL
             displays the prompt again. This prompt is displayed only if
             your installation kit contains more than one volume.

             Step 5: Select a release notes option.

             This step applies only if you specified OPTIONS N in step 2.

               Release Notes Options:

                   1. Display release notes
                   2. Print release notes
                   3. Both 1 and 2
                   4. Copy release notes to SYS$HELP
                   5. Do not display, print, or copy release notes

               * Select option [2]: <RETURN>

             If you select option 1, VMSINSTAL displays the release notes
             on line immediately. You can terminate the display at any
             time by pressing CTRL/C.

             If you select option 2, VMSINSTAL prompts you for a queue
             name. Either type a queue name or press RETURN to send the
             file to the default output print device.

               * Queue name [SYS$PRINT]: <RETURN>

             If you select option 3, VMSINSTAL displays the release
             notes on line immediately. You can terminate the display
             at any time by pressing CTRL/C. VMSINSTALL then prompts
             you for a queue name. Either type a queue name or press
             RETURN to send the file to the default output print device.
             The VAX DEC/Test Manager release notes are then copied to
             SYS$HELP:DTM$032.RELEASE_NOTES.

             If you select option 4, VMSINSTAL copies the release notes to
             SYS$HELP immediately.

                                VAX DEC/Test Manager Installation Guide 11

 






             If you select option 5, VMSINSTAL does not display, print,
             or copy the release notes, but moves them to SYS$HELP.
             Typically, this option is selected when the user wants to
             end the installation.

                                          NOTE

                 The release notes file installed by VMSINSTAL is la-
                 beled with the current product name, dollar sign, and
                 a version number (for example, DTM$032). Take care not
                 to delete release notes for previous versions of VAX
                 DEC/Test Manager.

             Next, VMSINSTAL displays the following prompt:

               * Do you want to continue the installation [N]?: Y <RETURN>
               %VMSINSTAL-I-RELMOVED, The product release notes have been successfully
                   moved to SYS$HELP.

             If you want to continue the installation, type YES and press
             RETURN. If you type NO or press RETURN, VMSINSTAL discon-
             tinues the installation. In either case, VMSINSTAL moves the
             release notes to SYS$HELP.

             Step 6: Select installation options.

               * Do you want to purge files replaced by this installation [YES]? <RETURN>

             The directories SYS$EXAMPLES, SYS$HELP, SYS$LIBRARY,
             SYS$MANAGER, and SYS$SYSTEM may contain previous versions
             of VAX DEC/Test Manager files. These files are replaced dur-
             ing the installation with new files, but the old files are
             not automatically purged. Purging is recommended. In response
             to the purging prompt, press RETURN to purge the files or
             type NO to keep them.




          12  VAX DEC/Test Manager Installation Guide

 






             Step 7: Respond to license registration queries.

             VAX DEC/Test Manager supports the VMS License Management
             Facility. The installation procedure displays license in-
             formation about your product and then asks if you have reg-
             istered and loaded your authorization key for VAX DEC/Test
             Manager. The following is an example of such information:

               Product:       DTM
               Producer:      DEC
               Version:       3.2
               Release Date:  dd-mmm-yyyy

               * Does this product have an authorization key registered and loaded?

             If you have not registered and loaded your authorization key,
             you must answer NO to this question. You have to register and
             load your product authorization key to successfully complete
             the installation. If you answer YES to this question and you
             have not registered and loaded the authorization key, you are
             asked if you would like to complete the installation without
             running the IVP. However, the next time you invoke VAX DEC
             /Test Manager you will receive a message indicating that you
             are not licensed to run the product.

               * Do you want to run the IVP after the installation [YES]? YES <RETURN>

             The Installation Verification Procedure runs tests to verify
             that the installation was successful. If the IVP determines
             that you have insufficient quotas to run the IVP, you are
             notified as to which quotas need to be increased and then
             asks if you would like to complete the installation without
             running the IVP. Press RETURN to run the IVP after the in-
             stallation. If you do not want to run the IVP, type NO at the
             prompt.




                                VAX DEC/Test Manager Installation Guide 13

 






             Step 8: Read informational messages.

             The VAX DEC/Test Manager installation procedure produces a
             number of informational messages that report on the progress
             of the installation.

             The success of the installation is indicated by the following
             message:

               %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...

             If the installation procedure is successful, the new or
             modified files are moved to their target directories.

             The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files
             are updated to include the new versions of the VAX DEC/Test
             Manager HELP text and the VAX DEC/Test Manager command line
             definition.

             If you typed YES in response to the prompt that requests a
             file purge at step 6, previous versions of the VAX DEC/Test
             Manager files are now purged.

             Step 9: Observe the installation verification procedure.

             If you chose to run the IVP in step 7, VMSINSTAL calls the
             IVP to verify that VAX DEC/Test Manager was installed suc-
             cessfully.

               %DTM-I-IVPBEGIN, Begin Installation Verification Procedure
               .
               .
               .
               %DTM-I-IVPEND, End Installation Verification Procedure





          14  VAX DEC/Test Manager Installation Guide

 






             Step 10: End the installation procedure.

                  Installation of VAX DEC/Test Manager V3.2 completed at 09:28

                  VMSINSTAL procedure done at 09:28

               $ LOGOUT <RETURN>
               SYSTEM     logged out at 15-JUN-1990 09:29:00.00

             VMSINSTAL deletes or changes entries in the process symbol
             tables during the installation. Therefore, if you are going
             to continue using the system manager's account and you want
             to restore these symbols, you should log out and log in
             again.

          ____________________________________________________________

          Installing VAX DEC/Test Manager on a VAXcluster

             If you want to run VAX DEC/Test Manager on multiple nodes
             of a VAXcluster, first check to see that you have the ap-
             propriate software license. Then, follow these steps after
             installing VAX DEC/Test Manager:

              1. Issue the LICENSE LOAD command to activate the license
                on each node in the VAXcluster on which VAX DEC/Test
                Manager is to be executed as described in the VMS License
                Management Utility Manual.

              2. Run SYS$STARTUP:DTM$STARTUP.COM on each node of the clus-
                ter that has a software license.

                To use the product on other nodes in the VAXcluster,
                you must replace the version of the DCL tables that is
                installed on the other VAXcluster nodes. To do this,
                perform the following steps:

                 a. Log in to a node on the cluster.

                 b. Enter the following command at the DCL prompt:

                             $ INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE <RETURN>

                                VAX DEC/Test Manager Installation Guide 15

 






                 c. Repeat Steps A and B for each node of the cluster.

          ____________________________________________________________

          Running VAX DEC/Test Manager on a Mixed VAXcluster

             Some users may want to run VAX DEC/Test Manager Version 3.2
             on a mixed VAXcluster that supports various versions of VMS
             on different nodes. Note that if VAX DEC/Test Manager Version
             3.2 is to be used for interactive terminal testing with a
             system running Version 5.3 of VMS on the VAXcluster, then
             VAX DEC/Test Manager has to be installed on the Version 5.3
             system.

          ____________________________________________________________

          After the Installation

             VAX DEC/Test Manager is now installed and can be invoked by
             all users with the DTM command.

             The installation procedure modifies the DCL command table so
             that the DTM command is recognized and processed. However,
             the previous command table is still in effect for those users
             who are currently logged in. All logged-in users who want
             to use the DTM command must log out of the system and log in
             again.

             You should edit SYS$STARTUP:SYSTARTUP_V5.COM, the site-
             specific startup file, and add the following line:

               @SYS$STARTUP:DTM$STARTUP.COM

             The VAX DEC/Test Manager installation procedure puts the
             command file DTM$STARTUP.COM in the SYS$MANAGER directory.
             The file DTM$STARTUP.COM contains commands to install VAX
             DEC/Test Manager images.


          16  VAX DEC/Test Manager Installation Guide

 





          ____________________________________________________________

          VAX DEC/Test Manager Files

             The VAX DEC/Test Manager installation places the following
             files in the following directories on the system:

             _____________________________________________________________
             Directory________File_Name___________________________________

             SYS$STARTUP      DTM$STARTUP.COM

             SYS$SYSTEM       DTM.EXE

             SYS$LIBRARY      DTM$DW_DEFAULTS.DAT
                              DTM$DW.UID
                              DTMSHR.EXE
                              DTMIMGSHR.EXE
                              DTM$XTRAP.EXE
                              DECW$SERVER_EXTENSION_XTRAP.EXE

             SYS$LOADABLE_    PCDRIVER.EXE
             IMAGES

             VUE$LIBRARY      DTM$PROFILE.VUE$DAT
                              DTM$VUE_STARTUP.COM

             SYS$HELP         DTM$DW_HELPLIB.HLB
                              DTM$032.RELEASE_NOTES

             SYS$TEST_________DTM$IVP.COM_________________________________

          ____________________________________________________________

          Running the Installation Verification Procedure Separately

             The Installation Verification Procedure (IVP) is usually run
             at installation. If you want to run the IVP separately to
             ensure the integrity of installed files if system problems
             occur, execute the following command procedure:

                                VAX DEC/Test Manager Installation Guide 17

 






               $ @SYS$TEST:DTM$IVP.COM <RETURN>

             If the IVP fails for any reason, the following messages are
             displayed:

               ******************************************************************************
               *                                                                            *
               *              DEC/Test Manager verification procedure failed.               *
               *                                                                            *
               ******************************************************************************

               %VMSINSTAL-E-IVPFAIL, The IVP for VAX DEC/Test Manager V3.2 has failed.

          ____________________________________________________________

          Error Conditions

             If the installation procedure fails for any reason, a message
             like the following is displayed:

               %VMSINSTAL-E-INSFAIL, The installation of VAX DEC/Test Manager V3.2 has failed.

             An error during the installation can occur if one or more of
             the following conditions exist:

              o Operating system version is incorrect

              o Prerequisite software version is incorrect

              o Quotas necessary for successful installation are in-
                sufficient (see the Installation Procedure Requirements
                section)

              o Process quotas required by VMSINSTAL are incorrect (see
                the Using VMSINSTAL section)

              o The VMS HELP library is currently in use

              o The product was registered incorrectly or not registered.

          18  VAX DEC/Test Manager Installation Guide

 






             For descriptions of the error messages generated by these
             conditions, see the VMS System Messages and Recovery
             Procedures Reference Volume, refer to your processor-specific
             installation/operations guide, or the VMS License Management
             Utility Manual.

             If you are notified that any of these conditions exist, you
             should take the appropriate action as described in the mes-
             sage. You may need to change a system parameter or increase
             an authorized quota value.

             If the installation fails, you must restart the installation
             procedure from step 2. If the installation fails due to an
             IVP failure, contact a Digital field service representative.

          ____________________________________________________________

          Maintenance Updates

             Digital may periodically issue maintenance updates of VAX DEC
             /Test Manager. Each update consists of an installation kit.
             You should install this kit as described in this document
             or in any documentation that may accompany the maintenance
             update.

             Each time a maintenance update is released, the version
             number changes. For example, if the current version is 1.0,
             the version number of the first maintenance update will
             be 1.1. In addition, each maintenance update includes new
             release notes. The release notes describe the changes that
             have been made to VAX DEC/Test Manager since the previous
             release.

             The update release notes are provided on line. You should
             read the release notes when you first install VAX DEC/Test
             Manager; they are also accessible at any time after the
             product is installed. For information on reading the release
             notes at the time that you install VAX DEC/Test Manager,
             follow the installation procedure through step 5. To locate
             the release notes after VAX DEC/Test Manager is installed,
             display or print the file SYS$HELP:DTM$032.RELEASE_NOTES.

                                VAX DEC/Test Manager Installation Guide 19

 





          ____________________________________________________________

          Determining and Reporting Problems

             If an error occurs while you are using VAX DEC/Test Manager
             and you believe that the error is caused by a problem with
             VAX DEC/Test Manager, take one of the following actions:

              o If you purchased VAX DEC/Test Manager within the past 90
                days and you think the problem is caused by a software
                error, submit a Software Performance Report (SPR).

              o If you have a Basic or DECsupport Software Agreement,
                call your Customer Support Center. With these services,
                you receive telephone support that provides high-level
                advisory and remedial assistance. For more information,
                contact your local Digital representative.

              o If you have a Self-Maintenance Software Agreement, submit
                a Software Performance Report (SPR).

             If you find an error in the VAX DEC/Test Manager documenta-
             tion, fill out and submit a Reader's Comments form from the
             back of the document in which the error was found. Include
             the section and page number where the error was found.

          ____________________________________________________________

          Sample Installation

             This section contains a sample installation of VAX DEC/Test
             Manager. Note that this is only a sample. Sometimes the
             installation procedure is modified in maintenance updates of
             this product. Because this installation guide is not usually
             revised for maintenance updates, be sure to read the Read
             Before Installing or Using VAX DEC/Test Manager letter before
             you install this product. This letter notes any significant
             changes in the installation that vary from this sample.


          20  VAX DEC/Test Manager Installation Guide

 






               $ @vmsinstal

                       VAX/VMS Software Product Installation Procedure V5.3

               It is 15-JUL-1990 at 08:58.
               Enter a question mark (?) at any time for help.

               %VMSINSTAL-W-DECNET, Your DECnet network is up and running.
               %VMSINSTAL-W-ACTIVE, The following processes are still active:
                       SYSTEM
                       DECW$WM_1
                       DECW$TE_1
                       SYSTEM_TWA123
                       SYSTEM_TWA124
               * Do you want to continue anyway [NO]? YES <RETURN>
               * Are you satisfied with the backup of your system disk [YES]? YES <RETURN>
               * Where will the distribution volumes be mounted: CSA1: <RETURN>

               Enter the products to be processed from the first distribution volume set.
               * Products: DTM032 <RETURN>
               * Options:


















                                VAX DEC/Test Manager Installation Guide 21

 






               The following products will be processed:

                 DTM V3.2


                       Beginning installation of DTM V3.2 at 12:13

               %VMSINSTAL-I-RESTORE, Restoring product saveset A ...
               %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved
                to SYS$HELP.


                       Product:      DTM
                       Producer:     DEC
                       Version:      3.2
                       Release Date: dd-mmm-yyyy


               * Does this product have an authorization key registered and loaded? YES <RETURN>
               * Do you want to run the IVP after the installation [YES]? YES <RETURN>
               * Do you want to purge files replaced by this installation [YES]? YES <RETURN>
               %DTM-I-DONEASK, No further questions will be asked during this installation.
               %VMSINSTAL-I-RESTORE, Restoring product saveset B ...

               %DTM-I-ENDRESTORE, All DEC/Test Manager savesets have been restored.
               %DTM-I-LINKPCDRIVER, Linking PCDRIVER.EXE, ignore no transfer address warning.
               %LINK-W-USRTFR, image VMI$ROOT:[SYSUPD.DTM032]PCDRIVER.EXE;1 has no user transfe
               r address
               %DTM-I-PROHELP, Providing DEC/Test Manager DCL and DECwindows help.
               %DTM-I-PRODCL, Providing DCL verb for DEC/Test Manager.
               %DTM-I-PROEXE, Providing DEC/Test Manager files.
               ********************************************************************************
               *                                                                              *
               *  The DEC/Test Manager IVP has been moved to the SYS$TEST directory.  To run  *
               *  the IVP after installation, enter @SYS$TEST:DTM$IVP.COM.                    *
               *                                                                              *
               ********************************************************************************
               ********************************************************************************

          22  VAX DEC/Test Manager Installation Guide

 






               *                                                                              *
               *  If this installation is being performed on a cluster, you must execute      *
               *                                                                              *
               *                       $ @SYS$STARTUP:DTM$STARTUP.COM                         *
               *                                                                              *
               *  on all nodes in the cluster.  In addition, you must add the above line to   *
               *                                                                              *
               *                        SYS$MANAGER:SYSTARTUP_V5.COM                          *
               *                                                                              *
               ********************************************************************************
               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
               ********************************************************************************
               *                                                                              *
               *                        Installing DEC/Test Manager                           *
               *                                                                              *
               ********************************************************************************
               ********************************************************************************
               *                                                                              *
               *           Begining the DEC/Test Manager verification procedure               *
               *                                                                              *
               ********************************************************************************
               DEC/Test Manager Version 3.2
               %DTM-S-CREATED, DEC/Test Manager library VMI$ROOT:[SYSUPD.DTM032.DTMTEST] create
               d
               %DTM-S-LIBIS, DEC/Test Manager library is VMI$ROOT:[SYSUPD.DTM032.DTMTEST]
               %DTM-I-DEFAULTED, benchmark file name defaulted to TESTX.BMK
               %DTM-S-CREATED, test description TESTX created
               %DTM-S-MODIFIED, test description TESTX modified
               %DTM-I-DEFAULTED, benchmark file name defaulted to DECWX.BMK
               %DTM-I-DEFAULTED, template file name defaulted to DECWX.SESSION
               %DTM-S-CREATED, test description DECWX created

               Test Descriptions in DEC/Test Manager Library VMI$ROOT:[SYSUPD.DTM032.DTMTEST]

               DECWX           "decwindows test"
                   Template        = DECWX.SESSION
                   Benchmark       = DECWX.BMK
                   Prologue        = None Specified
                   Epilogue        = None Specified

                                VAX DEC/Test Manager Installation Guide 23

 






               TESTX           "first test"
                   Template        = DTM$IVP.COM
                   Benchmark       = DTM$IVP.COM
                   Prologue        = None Specified
                   Epilogue        = None Specified
               %DTM-S-CREATED, symbol variable VAR1 created
               %DTM-S-MODIFIED, variable VAR1 modified

               Variables in DEC/Test Manager Library VMI$ROOT:[SYSUPD.DTM032.DTMTEST]

               VAR1            "first variable"
                   Value = NEWVALUE
               %DTM-S-CREATED, group GROUP1 created

               Groups in DEC/Test Manager Library VMI$ROOT:[SYSUPD.DTM032.DTMTEST]

               GROUP1          "test group"
               %DTM-S-CREATED, group GROUP2 created
               %DTM-S-INSERTED, group GROUP1 inserted into group GROUP2
               %DTM-S-REMOVED, group GROUP1 removed from group GROUP2

               Groups in DEC/Test Manager Library VMI$ROOT:[SYSUPD.DTM032.DTMTEST]

               GROUP1              GROUP2
               %DTM-S-CREATED, collection COLL1 created

               Collections in DEC/Test Manager Library VMI$ROOT:[SYSUPD.DTM032.DTMTEST]

               COLL1          1 test    15-JUL-1990 12:28:31
                      Command: CREATE COLLECTION/NOVERIFY COLL1 TESTX "test collection"
                      Status: not run








          24  VAX DEC/Test Manager Installation Guide

 






               %DTM-S-DELETED, collection COLL1 deleted
               %DTM-I-DELETED, test_description DECWX deleted
               %DTM-I-DELETED, test_description TESTX deleted
               %DTM-S-DELETIONS, 2 deletions completed
               %DTM-I-DELETED, variable VAR1 deleted
               %DTM-S-DELETIONS, 1 deletion completed
               %DTM-I-DELETED, group GROUP1 deleted
               %DTM-I-DELETED, group GROUP2 deleted
               %DTM-S-DELETIONS, 2 deletions completed
               %DTM-I-VERFRE, free space list verified
               %DTM-I-VERSTR, string list verified
               %DTM-I-VERCOL, collection list verified
               %DTM-I-VERGRO, group list verified
               %DTM-I-VERTD, test description list verified
               %DTM-I-VERVAR, variables list verified
               %DTM-I-VERARC, archive list verified
               %DTM-I-VERHEAD, user header information verified
               %DTM-I-VERSPACE, contiguous space verified
               %DTM-I-VERCOLDIR, collection directory structure verified
               %DTM-S-VERIFIED, DEC/Test Manager library VMI$ROOT:[SYSUPD.DTM032.DTMTEST] verif
               ied
               ********************************************************************************
               *                                                                              *
               *           DEC/Test Manager verification procedure successful                 *
               *                                                                              *
               ********************************************************************************

                       Installation of DTM V3.2 completed at 12:29

               Enter the products to be processed from the next distribution volume set.
               * Products: exit

                       VMSINSTAL procedure done at 12:32

               $




                                VAX DEC/Test Manager Installation Guide 25
