DTM, SHOW
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help DTM, SHOW *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
| 1 - ALL |
Displays a summary describing the current library.
Format
SHOW ALL [/qualifier]
1.1 - Command Qualifier
1. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the SHOW ALL information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
1.2 - Example
DTM> SHOW ALL Description of Digital Test Manager Library DBA1$:[project.dsrlib] Default template directory: DUA0:[USER01.TEMP] "Default template library" Default benchmark directory: DUA0:[USER01.BMK] "Default benchmark library" Default collection prologue: DUA0:[USER01.PROEPILIB]PROLOGUE_1.COM Default collection epilogue: DUA0:[USER01.PROEPILIB]EPILOGUE_1.COM Number of collections: 25 Number of test descriptions: 48 Number of groups: 8 Number of variables: 7 DTM> This example describes the current Digital Test Manager library.
| 2 - BENCHMARK_DIRECTORY |
Displays the directory specification for the current default
benchmark directory.
Format
SHOW BENCHMARK_DIRECTORY [/qualifier]
2.1 - Command Qualifier
2. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to a specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
2.2 - Example
DTM> SHOW BENCHMARK_DIRECTORY
DUA0:[USER01.BMK] "Default benchmark library"
DTM>
This command displays the directory specification for the
current default benchmark directory.
| 3 - COLLECTION |
Displays information about collections in the current Digital Test
Manager library.
Format
SHOW COLLECTION collection-expression [/qualifier...]
3.1 - Command Qualifiers
3. 1.1 - /BENCHMARK_DIRECTORY
Displays the directory specification of the benchmark directory used by this collection.
3. 1.2 - /BRIEF
Displays the collection name. The default is /INTERMEDIATE.
3. 1.3 - /CLASS
/CLASS=(keyword=class-name,...) Specifies the optional CMS class for benchmark files and template files stored in CMS libraries. The keywords, BENCHMARK and TEMPLATE, designate the name of the specific set of generations of elements. If you do not specify a class and the file is stored in a CMS library, the latest generation on the main line of descent is used. You can specify the same class names for your benchmark and template files. If you specify both keywords, separate them with a comma and enclose the list in parentheses. If you specify only one keyword, omit the parentheses.
3. 1.4 - /FULL
Displays the following output:
Collections in the Digital Test Manager Library library-name
COLLECTION_NAME NUMBER tests DATE TIME "remark"
Command: COMMAND-LINE
Status: RUN, COMPARISON, AND REVIEW STATUS
Successful count: NUMBER Unsuccessful count: NUMBER
New test count: NUMBER Updated test count: NUMBER
Test not run count: NUMBER Comparisons aborted: NUMBER
Default template directory: DIRECTORY_SPECIFICATION
Template class: CLASS_NAME
Default benchmark directory: DIRECTORY_SPECIFICATION
Benchmark class: CLASS_NAME
Prologue: FILE_SPECIFICATION
Epilogue: FILE_SPECIFICATION
Last Review: DATE TIME
Result Description COLLECTION_NAME Comparison Status: Successful
Benchmark file is device:[username]COLLECTION_NAME.BMK
Result file does not exist
Difference file does not exist
A result description for each test in the collection follows
this display. A result description lists the test name and its
comparison status and the file specifications for the benchmark,
result, and difference files. The default is /INTERMEDIATE.
3. 1.5 - /INTERMEDIATE
Displays the following output:
Collections in the Digital Test Manager Library library-name
COLLECTION NAME NUMBER tests DATE TIME "remark"
Command: COMMAND-LINE
Status: RUN, COMPARISON, AND REVIEW STATUS
Successful count: NUMBER Unsuccessful count: NUMBER
New test count: NUMBER Updated test count: NUMBER
Test not run count: NUMBER Comparisons aborted: NUMBER
3. 1.6 - /OUTPUT
/OUTPUT[=file-specification] Sends the SHOW COLLECTION information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
3. 1.7 - /TEMPLATE_DIRECTORY
Displays the directory specification of the template directory used by this collection. Displays the directory specification of the default directory for the current library.
3.2 - Example
DTM> SHOW COLLECTION/BRIEF Collections in Digital Test Manager Library DUA0:[USER01.DTMLIB] MAIL_COLL MAIL_SEND_COLL MAIL_SHOW_COLL DTM> This command lists the names of all collections in the current library.
| 4 - EPILOGUE |
Displays the file specification for the default epilogue file for
collections.
Format
SHOW EPILOGUE [/qualifier]
4.1 - Command Qualifier
4. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
4.2 - Example
DTM> SHOW EPILOGUE
DUA0:[USER01.PROEPILIB]EPILOGUE_1.COM "Default collection epilogue file"
DTM>
This example displays the file specification for the default
collection epilogue file.
| 5 - GROUP |
Displays the contents of one or more groups.
Format
SHOW GROUP group-expression [/qualifier...]
5.1 - Command Qualifiers
5. 1.1 - /BRIEF
Lists the group name only. You cannot specify both the /CONTENTS and /BRIEF qualifiers with the same command.
5. 1.2 - /CONTENTS
/CONTENTS[=n] /CONTENTS[=ALL] /NOCONTENTS Displays the name of each group and the names of all test descriptions and groups that are contained in the specified groups. The default is /CONTENTS=1. The /CONTENTS=n qualifier displays this information for n levels of groups within each specified group. If n is greater than one, all nested groups for n levels are expanded and displayed. The /CONTENTS=ALL qualifier displays this information for all groups within each group. The /NOCONTENTS qualifier displays the group names only.
5. 1.3 - /FULL
Displays the same output as the /CONTENTS=ALL qualifier.
5. 1.4 - /INTERMEDIATE
Lists the group name and any remark added during the creation, modification, or copying of the group. This is the default.
5. 1.5 - /MEMBER
Lists the groups of which the specified groups are members.
5. 1.6 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
5.2 - Example
DTM> SHOW GROUP/CONTENTS=ALL MARGINS
Groups in Digital Test Manager Library DISK$USER01:[PROJECT.DTMLIB]
MARGINS "test of margin commands"
LEFTMARGINS/GROUP
LMTEST1
LMTEST2
RIGHTMARGINS/GROUP
RMTEST1
RMTEST2
TEST1
DTM>
This example displays the contents of the MARGINS group.
Because /CONTENTS=ALL is specified, each group, test
description, and remark is listed.
| 6 - HISTORY |
Displays a chronological list of the transactions performed on
your Digital Test Manager library.
Format
SHOW HISTORY [object-expression] [/qualifier...]
6.1 - Command Qualifiers
6. 1.1 - /BEFORE
/BEFORE=time Lists all history information prior to a specified date. The time is the current date and time, and the information displayed is whatever was logged prior to the SHOW HISTORY command. The time value can be an absolute, delta, or combination time value, or one of the following keywords: TODAY, TOMORROW, or YESTERDAY.
6. 1.2 - /OUTPUT
/OUTPUT=file-specification Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
6. 1.3 - /SINCE
/SINCE=time Specifies that only those history entries dated on or after the given time are to be displayed. All transactions recorded since the library was created are displayed. The time value can be an absolute, delta, or combination time value, or one of the following keywords: TODAY, TOMORROW, or YESTERDAY. If you specify the /SINCE qualifier but do not specify a value, Digital Test Manager defaults to /SINCE=TODAY.
6. 1.4 - /TRANSACTION
/TRANSACTION=(keyword,...)
/NOTRANSACTION=(keyword,...)
Displays all transaction records generated by the commands
associated with the keywords you specify. The default is to list
transaction records for all transactions in the Digital Test Manager
library. The valid keyword values are as follows:
Keyword Meaning
ALL Displays all transactions recorded in the history file
COPY Displays all COPY commands
CREATE Displays all CREATE commands
DELETE Displays all DELETE commands
INSERT Displays all INSERT commands
MODIFY Displays all MODIFY commands
RECORD Displays all RECORD commands
RECREATE Displays all RECREATE commands
REMARK Displays all REMARK commands
REMOVE Displays all REMOVE commands
REVIEW Displays all REVIEW commands
RUN Displays all RUN commands
SET Displays all SET commands
STOP Displays all STOP commands
SUBMIT Displays all SUBMIT commands
UPDATE Displays all Review UPDATE commands
VERIFY Displays all VERIFY commands
If you specify more than one command, you must enclose the list of
commands in parentheses and separate them with commas.
The /TRANSACTION qualifier directs Digital Test Manager to list
transaction records only for the listed commands.
The /NOTRANSACTION qualifier directs Digital Test Manager to list
transaction records for all commands except the listed commands.
6. 1.5 - /USER
/USER=user-name Lists in chronological order the library transactions performed by the specified user. You cannot use wildcards in user names.
6.2 - Example
DTM> SHOW HISTORY
History in Digital Test Manager Library DUA0:[USER01.DTMLIB]
08-JAN-86 15:33:59 SMITH CREATE LIBRARY DUA1:[USER01.DTMLIB] "New
Digital Test Manager library"
08-JAN-86 15:55:45 SMITH CREATE TEST_DESCRIPTION RMTEST "Run MAIL test"
08-JAN-86 16:15:35 SMITH CREATE TEST_DESCRIPTION MEMO_TEST "First
interactive test of memo template"
.
.
.
DTM>
This command displays the history file for the current library.
| 7 - LIBRARY |
Displays the directory specification of the current Digital Test
Manager library.
Format
SHOW LIBRARY [/qualifier]
7.1 - Command Qualifier
7. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
7.2 - Example
DTM> SHOW LIBRARY Your Digital Test Manager library is DUA0:[USER01.DTMLIB] DTM> This example displays your current Digital Test Manager library.
| 8 - PROLOGUE |
Displays the file specification of the default prologue file for
collections.
Format
SHOW PROLOGUE [/qualifier]
8.1 - Command Qualifier
8. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
8.2 - Example
DTM> SHOW PROLOGUE
DUA0:[USER01.PROEPILIB]PROLOGUE_1.COM "Default collection prologue file"
DTM>
This example displays the file specification for the default
collection prologue file.
| 9 - TEMPLATE_DIRECTORY |
Displays the directory specification for the default directory
that contains the template files.
Format
SHOW TEMPLATE_DIRECTORY [/qualifier]
9.1 - Command Qualifier
9. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to a specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
9.2 - Example
DTM> SHOW TEMPLATE_DIRECTORY
DUA0:[USER01.TEMPLATE] "Default template library"
DTM>
This example displays the directory specification for the
current default template directory.
| 10 - TEST_DESCRIPTION |
Displays the files and groups associated with one or more test
descriptions.
Format
SHOW TEST_DESCRIPTION [test-group-expression] [/qualifier...]
10.1 - Restrictions
o The /COMMAND qualifier applies to DECwindows tests only.
o The /FILTER qualifier applies to noninteractive and terminal
tests only.
10.2 - Command Qualifiers
10. 2.1 - /BENCHMARK
Displays the file specification for the benchmark file associated with the specified test description. If you use the default benchmark when you create the test description, the benchmark file specification is displayed in the following format: test-name.BMK
10. 2.2 - /BRIEF
Displays the test name.
10. 2.3 - /COMMAND
Displays the command that is used to begin recording and executing of the test. This qualifier applies to DECwindows tests only.
10. 2.4 - /COMPARISON_TYPE
Displays the comparison type associated with the specified test description.
10. 2.5 - /EPILOGUE
Displays the file specification for the epilogue file associated with the specified test description.
10. 2.6 - /FILTER
Displays the names for all filters associated with the specified test description.
10. 2.7 - /FULL
Displays the contents of all test description fields. The format
is as follows:
Test descriptions in Digital Test Manager library library-name
Test_name "remark"
Template = file-name
Benchmark = file-name
Prologue = file-name
Epilogue = file-name
Variables = variable-name(s)[=value]
Groups = group-name(s)
Type = type-name
Command = command
Filters = filter-type(s)
Comparison Type = comparison-type
10. 2.8 - /GROUPS
Displays the names of the groups with which the test is affiliated. Because of the existence of the /GROUP parameter qualifier for this command, you cannot abbreviate the /GROUPS qualifier.
10. 2.9 - /INTERMEDIATE
Displays the contents of the benchmark, template, prologue, and
epilogue test description fields. The format is as follows:
Test descriptions in Digital Test Manager library library-name
Test_name "remark"
Template = file-name
Benchmark = file-name
Prologue = file-name
Epilogue = file-name
This is the default.
10. 2.10 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to a specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. By default, the output is sent to SYS$OUTPUT.
10. 2.11 - /PROLOGUE
Displays the file specification for the prologue file associated with the specified test description.
10. 2.12 - /REMARK
Displays the remark associated with the test description.
10. 2.13 - /TEMPLATE
Displays the file specification for the template associated with the specified test description.
10. 2.14 - /TYPE
Displays the type of the specified test description-NONINTERACTIVE, INTERACTIVE, or DECWINDOWS.
10. 2.15 - /VARIABLE
Displays the names and values for all variables associated with the test description.
10.3 - Parameter Qualifiers
10. 3.1 - /GROUP
Identifies the immediately preceding item in the parameter as a group expression. If a test group expression comprises a list, use this qualifier after each item that designates a group. Because of the existence of the /GROUPS qualifier for this command, you cannot abbreviate the /GROUP qualifier.
10. 3.2 - /TEST_DESCRIPTION
Identifies the immediately preceding item in the parameter as a test expression. This is the default.
10.4 - Example
DTM> SHOW TEST_DESCRIPTION SEND_MAIL_TEST
Test descriptions in Digital Test Manager Library DUA0:[USER01.DTMLIB]
SEND_MAIL_TEST "MAIL SEND command test"
Template = SEND_MAIL_TEST.COM
Benchmark = SEND_MAIL_TEST.BMK
Prologue = None Specified
Epilogue = None Specified
DTM>
This example displays the contents of the test description
SEND_MAIL_TEST.
| 11 - VARIABLE |
Displays information about the specified variables.
Format
SHOW VARIABLE variable-expression [/qualifier...]
11.1 - Command Qualifiers
11. 1.1 - /BRIEF
Displays the variable name only.
11. 1.2 - /FULL
Displays the name, value, scope, usage, and remark for the variable and lists the tests with which the variable is associated.
11. 1.3 - /INTERMEDIATE
Displays the name, value, and remark for the variable. This is the default.
11. 1.4 - /OUTPUT
/OUTPUT[=file-specification] Sends the requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
11. 1.5 - /REMARK
Displays the remark associated with the variable.
11. 1.6 - /SCOPE
Displays the scope of the variable. The scope can be either global or local.
11. 1.7 - /TEST_DESCRIPTION
Lists the test descriptions with which the variable is associated.
11. 1.8 - /TYPE
Displays the type of variable-STRING or NUMERIC.
11. 1.9 - /USAGE
Displays the use of the variable. The use can be either as a symbol or as a logical.
11. 1.10 - /VALUE
Displays the variable's default value. If no value has been supplied, the null value is displayed.
11.2 - Example
DTM> SHOW VARIABLE /VALUE INPUT_FILE
Variables in the Digital Test Manager library DUA0:[USER01.PROJECT]
INPUT_FILE "input file for DSR tests"
Value = INPUT.RNO
DTM>
This example displays the value of the variable INPUT_FILE.
| 12 - VERSION |
Displays the version number for Digital Test Manager currently in use
on the system.
Format
SHOW VERSION [/qualifier]
12.1 - Command Qualifier
12. 1.1 - /OUTPUT
/OUTPUT[=file-specification] Sends requested information to the specified file. If you specify the file name but omit the file type, the file type defaults to .LIS. The output is sent to SYS$OUTPUT.
12.2 - Example
DTM> SHOW VERSION Compaq Digital Test Manager Version 4.0 DTM> This example displays the version number of Digital Test Manager.
|
|
