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.