VMS Help  —  DTM  REVIEW  Review Subsystem, SHOW
   Displays and describes output files for specified result
   descriptions.

   Format

     SHOW  [result-description-expression] [/qualifier...]

1  –  Command Qualifiers

1.1    /BENCHMARK

   Displays the benchmark file. The default is to state whether
   output files (benchmark, difference, and result files) exist.
   If the benchmark file exists, its file specification is displayed.

   For a noninteractive test, Digital Test Manager displays the benchmark
   file. For an interactive test, Digital Test Manager displays the
   benchmark file screen by screen and provides you with a keypad
   for manipulating the file.

   If the benchmark file is in a CMS library, Digital Test Manager
   fetches the benchmark.

   If you include a comparison status qualifier with the /BENCHMARK
   qualifier, Digital Test Manager displays the benchmark file for result
   descriptions with the specified comparison status.

1.2    /COMPARISON_ABORTED

   States whether output files (benchmark, difference, and result
   files) exist for the specified result descriptions with the
   comparison aborted comparison status. The default is to display
   information for the current result description. If the benchmark
   file exists, its file specification is displayed.

   If you include an output file qualifier with the
   /COMPARISON_ABORTED qualifier, the specified output files are
   displayed for result descriptions with the comparison aborted
   comparison status. You cannot specify a comparison status
   qualifier with a result description name parameter; a result
   description expression is required.

1.3    /DIFFERENCES

   Displays the difference file. The default is to state whether
   output files (benchmark, difference, and result files) exist. If
   the benchmark file exists, its file specification is displayed.

   For a noninteractive test, Digital Test Manager displays the
   difference file. For an interactive test, Digital Test Manager
   displays the benchmark and result files screen by screen with
   differences marked and provides you with a keypad for manipulating
   the files.

   If you include a comparison status qualifier with the /DIFFERENCES
   qualifier, Digital Test Manager displays the difference file for
   result descriptions with the specified comparison status.

1.4    /FILES

   Displays the comparison status for result descriptions and states
   whether output files (benchmark, difference, and result files)
   exist for the result description. The default is /FILES. If the
   benchmark file exists, its file specification is displayed.

   You cannot include the /FILES qualifier with the included
   /BENCHMARK, /DIFFERENCES, /RESULT, and /SUMMARY qualifiers.

1.5    /NEW

   States whether output files (benchmark, difference, and result
   files) exist for result descriptions with the new comparison
   status. The default is to display information for the current
   result description.

   If you include an output file qualifier with the /NEW qualifier,
   the specified output files are displayed for result descriptions
   with the new comparison status. If a test is new, it has a result
   file but it does not have a benchmark or difference file. You
   cannot specify a comparison status qualifier with a result
   description name parameter; a result description expression is
   required.

1.6    /NOT_RUN

   States whether output files (benchmark, difference, and result
   files) exist for result descriptions with the not run comparison
   status. The default is to display information for the current
   result description. If the benchmark file exists, its file
   specification is displayed.

   If you include an output file qualifier with the /NOT_RUN
   qualifier, the specified output files are displayed for result
   descriptions with the not run comparison status. If a test does
   not run, it does not have a result or difference file. It might
   have a benchmark file. You cannot specify a comparison status
   qualifier with a result description name parameter. A result
   description expression is required.

1.7    /OUTPUT

   /OUTPUT[=file-specification]

   Sends the requested output to the specified file. The default is
   SYS$OUTPUT.

1.8    /RESULT

   Displays the result file. The default is to state whether output
   files (benchmark, difference, and result files) exist.

   For a noninteractive test, Digital Test Manager displays the result
   file. If the benchmark file exists, its file specification is
   displayed.

   For an interactive test, Digital Test Manager displays the result file
   screen by screen and provides you with a keypad for manipulating
   the file.

   If you include a comparison status qualifier with the /RESULT
   qualifier, Digital Test Manager displays the result file for result
   descriptions with the specified comparison status.

1.9    /SUCCESSFUL

   States whether output files (benchmark, difference, and result
   files) exist for result descriptions with the successful
   comparison status. The default is to display information for the
   current result description. If the benchmark file exists, its file
   specification is displayed.

   If you include an output file qualifier with the /SUCCESSFUL
   qualifier, the specified output files are displayed for result
   descriptions with the successful comparison status. If a test
   is successful, it has a benchmark file. Its result file was
   deleted and no difference file was created. You cannot specify
   a comparison status qualifier with a result description name
   parameter; a result description expression is required.

1.10    /SUMMARY

   Displays the Collection Summary Information (the information
   displayed when you first enter the Review subsystem). The default
   is /FILES. You cannot specify the /SUMMARY and /FILES qualifiers
   with the same command.

   The /SUMMARY qualifier is mutually exclusive with all qualifiers
   except the /OUTPUT qualifier.

1.11    /UNSUCCESSFUL

   States whether output files (benchmark, difference, and result
   files) exist for result descriptions with the unsuccessful
   comparison status. The default is to display information for the
   current result description. If the benchmark file exists, its file
   specification is displayed.

   If you include an output file qualifier with the /UNSUCCESSFUL
   qualifier, the specified output files are displayed for result
   descriptions with the unsuccessful comparison status. (If a test
   is unsuccessful, it has benchmark, result, and difference files.)
   You cannot specify a comparison status qualifier with a result
   description name parameter; a result description expression is
   required.

1.12    /UPDATED

   States whether output files (benchmark, difference, and result
   files) exist for result descriptions with the updated comparison
   status. The default is to display information for the current
   result description. If the benchmark file exists, its file
   specification is displayed.

   If you include an output file qualifier with the /UPDATED
   qualifier, the specified output files are displayed for result
   descriptions with the updated comparison status. An updated test
   is a test whose benchmark file was created from its result file
   since the time when the test was last executed. An updated test
   does not have a result or difference file. You cannot specify
   a comparison status qualifier with a result description name
   parameter; a result description expression is required.

2  –  Example

   DTM_REVIEW> SHOW/UNSUCCESSFUL
   Result Description YYY  Comparison Status :  Unsuccessful

     Benchmark File is DUA1:[USER01.DTM.DTMLIB]YYY.BMK
     Result file is present
     Difference file is present

   DTM_REVIEW>

     This example displays all the unsuccessful result descriptions
     in a collection.
Close Help