1 terms =TITLE terms =TITLE Glossary for DTM Terms DTM has many terms specific to its own use. For more information, double click on any of the terms provided under additional topics. 2 acl =TITLE acl =TITLE Access Control List (ACL) A OpenVMS System protection scheme that grants or denies access to files based on a list of users. With ACLs, you can specify access for a set of users who are not in the same UIC group. See also User identification code (UIC). 2 benchmark_dir =TITLE benchmark_dir =TITLE Benchmark Directory =INCLUDE overview examine open_coll update A OpenVMS directory or Code Management System library that is used for benchmark files. 2 benchmark_file =TITLE benchmark_file =TITLE Benchmark File =INCLUDE overview examine open_coll update A file that contains the expected output of a test. DTM automatically creates a benchmark file when you record an interactive terminal or DECwindows test. You create a benchmark file for a noninteractive test by pulling down the Testing menu and choosing the Review menu item and the Update submenu item during a Review session. 2 collection =TITLE collection =TITLE Collection =INCLUDE overview run One or more tests you select to run as a set. A collection is a "snapshot" of its tests and the library at the time you create the collection. A collection can have prologue and epilogue files, filters, and variables associated with it. To change a collection, you must re-create it. You can execute a test only as part of a collection. 2 coll_epilog_file =TITLE coll_epilog_file =TITLE Collection Epilogue File =INCLUDE terms test_epilog =INCLUDE overview prol_use Created with a text editor, the collection epilogue file contains the commands that enable you to control the environment in which the tests are run. The collection epilogue file is associated with a collection; it is executed after the collection is executed and is the last file executed. Typically, you use the collection epilogue file to delete directories created specifically for the process or for other clean up requirements. 2 coll_prol_file =TITLE coll_prol_file =TITLE Collection Prologue File =INCLUDE terms test_prolog =INCLUDE overview prol_use Created with a text editor, the collection prologue file contains the commands that enable you to control the environment in which the tests are run. The collection prologue file is associated with a collection; it is executed whenever the collection is executed, after the global variables and DTM$COLLECTION_NAME are defined, but before any tests are executed. 2 comm_file =TITLE comm_file =TITLE Command File =INCLUDE overview create Created with a text editor, the command file is a test file that contains the commands to run an application in a noninteractive environment. 2 Comparison_status =TITLE Comparison_status =TITLE Comparison status The result description status of a test: Comparison Aborted, New Test, Not Run, Successful, Unsuccessful, Updated. 2 diff_file =TITLE diff_file =TITLE Difference File =INCLUDE overview compare A file created by DTM after comparing the results file to the benchmark file. DTM generates a difference file only if the result file and benchmark file do not match. 2 Display_device =TITLE Display_device =TITLE Display device A terminal or DECwindows workstation screen. 2 dtm$coll =TITLE dtm$coll =TITLE DTM$COLLECTION_NAME A global symbol DTM assigns to a collection and uses as it executes prologue and epilogue files and test command files. 2 dtm$init =TITLE dtm$init =TITLE DTM$INIT A logical name that you assign to a DTM initialization file. 2 dtm$lib =TITLE dtm$lib =TITLE DTM$LIB A logical name that DTM assigns to the current library. 2 dtm$result =TITLE dtm$result =TITLE DTM$RESULT A logical name that DTM assigns to the result file for a specific test. DTM uses the logical name when it runs the test epilogue file. 2 dtm$test_name =TITLE dtm$test_name =TITLE DTM$TEST_NAME A local OpenVMS symbol that DTM assigns to a test. DTM uses the symbol when it runs that test. 2 dtm$decw$display =TITLE dtm$decw$display =TITLE DTM$DECW$DISPLAY A local OpenVMS symbol that DTM assigns to a DECwindows display. DTM uses the symbol when it records, runs, or plays a test. 2 DTM$DELAY_TIMEOUT =TITLE DTM$DELAY_TIMEOUT =TITLE DTM$DELAY_TIMEOUT Variable A local OpenVMS symbol that DTM assigns to a specified standard OpenVMS delta time. You can use DTM$DELAY_ TIMEOUT to specify your own delay timeout value. 2 DTM$OMIT_PRINTABLE_SCREENS =TITLE DTM$OMIT_PRINTABLE_SCREENS =TITLE DTM$OMIT_PRINTABLE_SCREENS Variable A local OpenVMS symbol that DTM assigns a boolean value that enables or disables the creation of printable versions of the result (.RES_SCREENS) and the benchmark (.BMK_SCREENS) files. 2 field =TITLE field =TITLE Field =INCLUDE terms test_desc =INCLUDE terms field_val A test description element that you use to associate specific information with a test description. The test description fields are test name, template, benchmark, prologue, epilogue, variables, groups, filters, and remark. 2 field_val =TITLE field_val =TITLE Field Value =INCLUDE terms field =INCLUDE terms test_desc A value for a test description field. When you supply a value for a test description field, you associate specific files, variables, filters, or other attributes with the associated test. 2 filter =TITLE filter =TITLE Filter =INCLUDE overview filt_use A means for substituting constant values for the following run-time variables: o Directory names o File names o Version numbers o Date o Time o Traceback information 2 group =TITLE group =TITLE Group =INCLUDE overview set_up grouping_tests A set of tests that are gathered under a single group name so that they can be manipulated as a unit. Tests of similar functions are generally organized into a group. Groups simplify the testing procedure by enabling you to group tests that test specific functions without running unrelated tests. 2 history =TITLE history =TITLE History =INCLUDE overview set_up history A historical record of operations that change the DTM library. For example, CREATE and DELETE operations are logged in the history records; DISPLAY operations are not logged. 2 inp_file =TITLE inp_file =TITLE Input File =INCLUDE overview create rec_inter_term cre_inp_fl A file you can edit that contains a text representation of all user input, nonprintable control characters, and recording functions in a session file for an interactive terminal test. 2 init_fil =TITLE init_fil =TITLE Initialization File A DTM command file to be executed whenever DTM is invoked as a subsystem. 2 inter_term_tst =TITLE inter_term_tst =TITLE Interactive Terminal Test =INCLUDE overview create cre_inter_term A test that includes recorded input and output from an application in a terminal-based environment. You create an interactive terminal test by using the Record functions of DTM. The template file for an interactive terminal test is a session file. 2 inter_dw_test =TITLE inter_dw_test =TITLE Interactive DECwindows Test =INCLUDE overview create cre_decw A test that includes recorded input and output from an application in a DECwindows environment. You create a DECwindows test by using the Record functions of DTM. The template file for a DECwindows-based test is a session file. 2 Keypad_key =TITLE Keypad key =TITLE Keypad key The editing and numeric keypads, as well as the function keys. These keys are user-definable using the DEFINE/KEY command. 2 Keysym =TITLE Keysym =TITLE Keysym A value associated with a key on the keyboard. The key values are translated by means of the KEYSYMDEF.H translation table file and enable DTM to use any keyboard. 2 library =TITLE library =TITLE Library =INCLUDE overview set_up des_lib A OpenVMS directory containing the information DTM needs to manage a test system. The DTM library contains the control file, collection subdirectories, result files, difference files, and, optionally, benchmark and session files. 2 Local_variable =TITLE Local_variable =TITLE Local variable A DCL symbol or logical name that is defined only while the test with which it is associated is running. Local variables can be used by the prologue, template, and epilogue files associated with this test. 2 Mask =TITLE Mask =TITLE Mask A user-defined area on a DECwindows benchmark image that is ignored when the results of a test are compared against the benchmark image. Mask are created using the DTM Screen Editor. 2 noninter_test =TITLE noninter_test =TITLE Noninteractive Test =INCLUDE overview create cre_noninter A test where the template is a DCL command file. 2 Panning =TITLE Panning =TITLE Panning Moving a DECwindows workstation screen image with the pointer; the image remains in the same position relative to the pointer. 2 Primary_reviewer =TITLE Primary_reviewer =TITLE Primary reviewer A person who enters the REVIEW command without the /READ_ONLY qualifier. Only one person at a time can be the primary reviewer of a collection. This reviewer can use all Review subsystem commands. See also Read-only reviewer. 2 Read_only_reviewer =TITLE Read_only_reviewer =TITLE Read-only reviewer A person who enters the REVIEW command with the /READ_ ONLY qualifier. A read-only reviewer can peruse the result descriptions and print files, but cannot make any changes to the result descriptions. A read-only reviewer cannot issue the UPDATE or INSERT commands. 2 reg_test =TITLE reg_test =TITLE Regression Testing A testing method to ensure that software being developed or modified runs consistently and that new features do not affect the correct execution of previously tested features. In regression testing, you run established tests and compare the results with the successful results from previous test runs. If the new results do not conform to the previously verified results, the software may contain errors. When errors exist, the software has regressed. 2 remark =TITLE remark =TITLE Remark =INCLUDE overview set_up history A comment associated with a DTM operation and recorded in the history file. 2 res_desc =TITLE res_desc =TITLE Result Description =INCLUDE overview views A summary of test results, which are accessible with the view functions of DTM. DTM generates a result description for every test description in a collection. 2 res_file =TITLE res_file =TITLE Result File =INCLUDE overview examine disp_results =INCLUDE overview run exec_tests A file containing the results of a test's execution; it is accessible using the Review and Display functions of DTM. 2 Screen_Editor =TITLE Screen Editor =TITLE Screen Editor A utility for viewing benchmark, results, and differences screens and creating masks for benchmark images. 2 Scrolling =TITLE Scrolling =TITLE Scrolling Moving a DECwindows workstation screen image with sliders or increment arrows in the scroll bars. 2 sess_file =TITLE sess_file =TITLE Session File =INCLUDE overview create cre_inter_term =INCLUDE overview create cre_decw A file with the file type .SESSION containing a recording of an interactive terminal or DECwindows session. A session file contains the following data: o A description of the type of display device on which you recorded the test o A record of all input during the recording session o Additional control and timing information 2 templ_dir =TITLE templ_dir =TITLE Template Directory =INCLUDE overview create A OpenVMS directory or Code Management System library used for template files in the current DTM library. 2 templ_file =TITLE templ_file =TITLE Template File =INCLUDE overview create A OpenVMS command procedure that executes a noninteractive test, or a session file containing a recorded Interactive terminal or DECwindows session. Template files exist for the following types of tests DTM can process: Test Template Noninteractive Command file Interactive Session file produced when you record Terminal an interactive session DECwindows Session file produced when you record a DECwindows session 2 Tc_block =TITLE Tc_block =TITLE Terminal characteristics block The first 12-byte record in a session file; it describes the type of terminal on which the terminal session was recorded and the characteristics of that terminal. 2 term_char =TITLE term_char =TITLE Termination Character =INCLUDE overview create rec_inter_term rec_commands The character that is entered twice to terminate the recording of an interactive terminal or DECwindows session. The default termination character is CTRL/P. 2 Test =TITLE Test =TITLE Test A command procedure or recorded session file that executes applications for the purpose of regression testing. 2 test_desc =TITLE test_desc =TITLE Test Description =INCLUDE terms field =INCLUDE terms field_val =INCLUDE overview set_up id_tests A set of fields for which you supply values that point to the files and other entities associated with the test. A test description contains all the information DTM needs to run a particular test. Each test must have a corresponding test description. 2 test_epilog =TITLE test_epilog =TITLE Test Epilogue File =INCLUDE terms coll_epilog_file =INCLUDE overview prol_use Created with a text editor, the optional test epilogue file contains the commands that enable you to control the environment in which DTM records and runs tests. A test epilogue file is associated with a specific test description; it is executed after the test template is recorded or executed and DTM$RESULT is defined, but before DTM-provided filters are applied to the test. Typically, you use the test epilogue file to modify the results file of record-dependent and run-dependent data or other clean up operations. Output from an execution of a test epilogue file appears in the test results and can affect test results. 2 test_prolog =TITLE test_prolog =TITLE Test Prologue File =INCLUDE terms coll_prol_file =INCLUDE overview prol_use Created with a text editor, the optional test prologue file contains the commands that enable you to control the environment in which DTM records and runs tests. A test prologue file is associated with a specific test description; it is executed before the session file is recorded or before the test is executed in a collection. Typically, you use the test prologue file to set up any special environment that the test requires, such as setting up constants, defining versions and logicals, or creating directories. Output from a test prologue file does not appear in the test results. 2 UIC =TITLE UIC =TITLE User identification code A code that determines a user's access rights to a file. See also Access Control List. 2 variable =TITLE variable =TITLE Variable =INCLUDE overview var_use A user-defined OpenVMS symbol or logical name. DTM stores variables in its library for use when it executes tests. There are two types of variables: Global Once created, global variables are accessible by any test in all collections if the test's template, prologue, or epilogue file references the variable. Local Local variables are accessible only to a single test if the variable is referenced in the test's template, prologue, or epilogue file. 2 CMS =TITLE CMS =TITLE Code Management System A software library system that stores files, records changes made to the files, and records user access of the files. 2 pca =TITLE pca =TITLE Performance and Coverage Analyzer (PCA) A software development tool that collects performance and coverage data on a program and enables you to interactively analyze that data. When you use DTM with the Performance and Coverage Analyzer, DTM invokes the Collector of PCA to gather performance and coverage data while tests are running. 2 view =TITLE view =TITLE View =INCLUDE overview views A window that contains a hierarchical display of a DTM library object and any associated objects. You can request that DTM present the information with various levels of detail.