VMS Help DTM, RECORD  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   Records an interactive terminal or DECwindows test.

   Format

     RECORD  test-name [/qualifier...] "remark"

1 - Restrictions

   o  The /APPEND qualifier applies to interactive terminal tests
      only.

   o  The /FILTER qualifier applies to noninteractive and terminal
      tests only.

   o  The /KEYSYM qualifier applies to DECwindows tests only.

   o  The /POINTER_MOTION qualifier applies to DECwindows tests only.

2 - Qualifiers

 2.1 - /APPEND

   Continues recording the specified test after the end of the input
   file is reached. The /APPEND qualifier applies to interactive
   terminal tests only.

   If you specify an input file using the /INPUT qualifier, Digital Test
   Manager records using input from the input file. When the end
   of the input file is reached, this qualifier enables you to
   record further; if you do not specify this qualifier, recording is
   terminated when the end of the input file is reached.

 2.2 - /AUTO_COMPARE

   /AUTO_COMPARE
   /NOAUTO_COMPARE

   The /AUTO_COMPARE and /NOAUTO_COMPARE qualifiers determine whether
   automatic screen comparison is enabled at the start of your
   interactive terminal recording session; there is no automatic
   comparisons for DECwindows tests. By default, automatic screen
   compare is in effect. The /NOAUTO_COMPARE qualifier disables
   automatic screen compare.

 2.3 - /DISPLAY

   /DISPLAY=screen

   Specifies the display device on which the output is to be
   displayed. For interactive terminal sessions, the default is
   SYS$OUTPUT; for DECwindows sessions, the default is the
   DECwindows server and screen, generally indicated by the
   DECW$DISPLAY logical name.

 2.4 - /EPILOGUE

   /EPILOGUE
   /NOEPILOGUE (D)

   Specifies whether Digital Test Manager is to execute the test epilogue
   file when interactive recording terminates.

 2.5 - /FILTERS

   /FILTERS
   /NOFILTERS (D)

   Specifies whether Digital Test Manager is to filter the benchmark
   file that is produced when interactive recording terminates. When
   the test is recorded, Digital Test Manager invokes the filters
   associated with the test.

   When using this command on a test with associated user filter
   variables, the /VARIABLES qualifier must also be used to execute
   those filters.

 2.6 - /INPUT

   /INPUT=file-specification

   Specifies an input file containing a textual representation of an
   interactive terminal or DECwindows session file. For interactive
   terminal tests, you must create the input file by issuing the
   EXTRACT command on a previously recorded session.

   You cannot use wildcards in the file specification.

 2.7 - /KEYSYM

   Specifies the command key that is used in controlling DECwindows
   test sessions. The default command key is F9.

   The command key must be in the DECwindows Latin-1 KEYSYM
   encodings. Display the file DECW$INCLUDE:KEYSYMDEF.H with the DCL
   TYPE command to view the list of the Latin-1 KEYSYM keys.

   For example, to use F7 as the command key, enter the following
   command:

     DTM> RECORD test-name/KEYSYM=F7

 2.8 - /LOG

   /LOG (D)
   /NOLOG

   Controls whether Digital Test Manager displays informational and
   success messages on your screen.

 2.9 - /POINTER_MOTION

   /POINTER_MOTION
   /NOPOINTER_MOTION(D)

   Specifies whether Digital Test Manager records pointer motion for
   DECwindows tests.

 2.10 - /PROLOGUE

   /PROLOGUE
   /NOPROLOGUE (D)

   Specifies whether Digital Test Manager is to execute the test prologue
   file before interactive recording begins.

 2.11 - /REALTIME

   Instructs Digital Test Manager to record and forward keypresses to the
   application as they are entered, and not when the application requests
   them. By default, Digital Test Manager records keypresses and places
   them into the terminal input buffer for an application when the
   application reads from the terminal.

   This qualifier is intended for use in recording tests where an application
   will not read from the terminal until data appears in its terminal buffer.

 2.12 - /TERMINATION_CHARACTER

   /TERMINATION_CHARACTER=character

   Specifies a character sequence for interactive terminal
   sessions that, when pressed twice, terminates the recording
   of an interactive terminal or DECwindows session. The default
   termination character is the sequence CTRL/P. When pressed once,
   CTRL/P temporarily suspends the recording session to introduce a
   recording function. For example, CTRL/P E (end automatic screen
   comparison) is the recording function instructing Digital Test Manager
   to terminate automatic screen comparison and to begin manual
   screen comparison.

   The termination character can be any single character, such as an
   asterisk (*),  or a control sequence, such as CTRL/P. To specify a
   control character, enter a circumflex (^)  followed by a letter.
   For example, to enter the termination character sequence CTRL/D,
   enter a circumflex followed by a D (/TERMINATION_CHARACTER=^D).
   You can also specify a termination character by its ASCII decimal
   representation. For example, you can use ASCII number 16 to
   specify CTRL/P.

   On interactive terminal tests, you can also terminate the
   recording session by entering the DCL LOGOUT command.
   If you do not want an accounting summary, enter the DCL
   STOP/IDENTIFICATION=0 command.

 2.13 - /VARIABLES

   /VARIABLES
   /NOVARIABLES (D)

   Specifies whether Digital Test Manager is to define symbols
   and logical names as specified by the variables associated
   with the test before recording starts.

3 - Example

   DTM> RECORD MAIL_TEST
   _Remark: Going to Record the MAIL facility
   %DTM-I-BEGIN, your interactive test session is now beginning...
   Type CTRL/P twice to terminate the session.

   $
    .
    .
    .
   ^P

   %DTM-I-BMK_SAVED, benchmark has been saved in file DUA1:[USER01.DTMLIB]MAI
   L_TEST.BMK;1
   %DTM-S-RECORDED, test MAIL_TEST has been successfully recorded in file
   DUA1:[USER01.DTMLIB]MAIL_TEST.SESSION
   DTM>

   This example shows the recording of interactive terminal test
   MAIL_TEST.