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

   Executes the specified session file and displays the output on
   your screen.

   Format

     PLAY  file-specification [/qualifier...]

1 - Restrictions

   o  You cannot play a DECwindows session file on a terminal screen.

   o  The /KEYSYM qualifier applies to DECwindows tests only.

2 - Command Qualifiers

 2.1 - /AUTOSYNCH

   Specifies that a DECwindows session file is to be played, producing
   a new session file with text synchronization added.  Only text seen
   during each playback will be used for synchronization purposes.

 2.2 - /COMMAND

   /COMMAND=DCL-command

   Specifies a command action to be executed before playing a
   DECwindows session file.

 2.3 - /DECWINDOWS

   Specifies that the session file being played is a DECwindows
   session file.

 2.4 - /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.5 - /INTERACTIVE

   /INTERACTIVE (D)

   Specifies that the session file being played is an interactive
   terminal session file.

 2.6 - /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> PLAY test-name/DECWINDOWS/KEYSYM=F7

 2.7 - /LOG

   /LOG (D)
   /NOLOG

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

 2.8 - /REALTIME

   /REALTIME
   /NOREALTIME (D)

   Specifies that the speed of interactive terminal session file
   playback is to be based solely on the speed at which it was
   recorded and not on the rate at which the application being
   tested requests input.  This qualifier is useful for testing
   applications that request input before completing processing
   and display of data.

 2.9 - /RESULT_FILE

   /RESULT_FILE=file-specification
   /NORESULT_FILE (D)

   Specifies whether a file is to receive a copy of the output. If
   you specify /RESULT_FILE but do not include a file specification,
   Digital Test Manager places the results in a file named file-name.RES.
   If you specify the /NORESULT_FILE qualifier (the default), the
   session file is played but the output is not saved.

3 - Example

   DTM> PLAY MEMO_TEST.SESSION
   %DTM-I-BEGIN, your interactive test session is now beginning...
     .
     .
     .
   %DTM-S-CONCLUDED, your interactive test session has concluded
   DTM>

   This examples displays a message stating that your interactive
   terminal session is beginning, executes the specified session
   file, and displays a message stating that the execution has
   ended.