Library /sys$common/syshlp/helplib.hlb  —  DTM  EXTRACT
   Extracts an input file from an interactive terminal or DECwindows
   session file.

   Format

     EXTRACT  session-file-specification [input-file-specification]

        [/qualifier...]

1  –  Restrictions

   o  The EXTRACT command is used for interactive terminal and
      DECwindows tests only.

   o  The /TERMINATION_CHARACTER qualifier applies to terminal tests
      only.

2  –  Command Qualifiers

2.1    /DECWINDOWS

   Specifies that the session file is a recorded DECwindows session.

2.2    /INTERACTIVE

   /INTERACTIVE (D)

   Specifies that the session file is a recorded terminal session.

2.3    /LOG

   /LOG (D)
   /NOLOG

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

2.4    /TERMINATION_CHARACTER

   /TERMINATION_CHARACTER=character

   Specifies the character that Digital Test Manager interprets as the
   termination character when you extract the input file from the
   terminal session file. Digital Test Manager uses this information when
   translating recording functions in the session file to special
   strings in the input file.

   If you used a termination character other than the default
   termination character CTRL/P when recording the session file,
   specify that termination character on the EXTRACT command line.

   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 the ASCII number 16 to
   specify CTRL/P.

3  –  Examples

   1.  DTM> EXTRACT SAMPLE.SESSION SAMPLE.INP
       DTM-S-EXTRACTED, input file SAMPLE.INP created
       DTM>

   This example creates the terminal input file SAMPLE.INP.
   You can edit this file and use it in conjunction with the
   RECORD/INPUT command.

   2.  DTM> EXTRACT/DECWINDOWS DECW_SAMPLE.SESSION DECW_SAMPLE.INP
       DTM-S-EXTRACTED, input file SAMPLE.INP created
       DTM>

   This example creates the DECwindows input file DECW_SAMPLE.INP.
   You can edit this file and use it in conjunction with the
   RECORD/INPUT command.
Close Help