| Previous | Contents | Index |
This example shows the full output of the SHOW DIRECTORY command. For each directory template, the full output shows the date and time the template was created, the username and full name of the creator, and the template's remark string. For templates that VDE supplies by default, the template creator is simply the user who created the VDE library.
Display what editor VDE uses for those VDE commands that invoke an editor.
SHOW EDITOR
None.
The SHOW EDITOR command displays the editor strings that various VDE commands use to invoke your preferred editor, either to create new files or to display existing files. When VDE invokes an editor, it spawns a DCL editing command in a subprocess. VDE forms the editing command by concatenating your read-write or read-only editor string, a space, and the name of the file to edit. The SHOW EDITOR command displays the current read-write and read-only editor strings for your VDE session. The command can also display your default editor strings for future VDE sessions.
/BRIEF (default)
/FULL
Control whether VDE displays the default editor strings stored in the VDE database. The /BRIEF qualifier only displays the two editor strings for your current VDE session. The /FULL qualifier diplays the editor strings for your current VDE session and your default editor strings for future VDE sessions.Of /FULL and /BRIEF, /BRIEF is the default.
| #1 |
|---|
VDE„ SHOW EDITOR
Current editor strings:
Read-write editor string: TPU
Read-only editor string: TPU/READ_ONLY
VDE„
|
This example illustrates the brief output of the SHOW EDITOR command.
| #2 |
|---|
VDE„ SHOW EDITOR/FULL
Current editor strings:
Read-write editor string: TPU
Read-only editor string: TPU/READ_ONLY
Default editor strings:
Read-write editor string: EDIT/EDT
Read-only editor string: EDIT/EDT/READ_ONLY
VDE„
|
This example illustrates the full output of the SHOW EDITOR command. In this case, the editor strings for the current VDE session specify the TPU editor, but the default editor strings for future sessions specify the EDT editor.
Displays the names and attributes of one or more specified facilities.
SHOW FACILITY [facil-name [, facil-name...]]
facil-name
The name of a facility whose attributes are to be displayed.You can display more than one facility using wildcard characters. The percent sign (%) in a facility name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. Those facilities whose names match the wildcard pattern are displayed.
If you do not specify a facility name or use the /CURRENT qualifier, VDE displays all facilities in the current library.
Depending on the qualifiers you select, the SHOW FACILITY command displays either the name of each selected facility, the name and remark string of each facility, or the name and all other attributes of each facility. The command can also show the total number of facilities that match a specified facility name.
/BRIEF
/NORMAL (default)
/FULL
Determines the information that is displayed about each facility. The /BRIEF qualifier displays the name of each facility that matches the facility name parameters. The /NORMAL qualifier displays the name and remark string of each facility. The /FULL qualifier lists all information about each facility, including its name, its creation date, its remark string, and the name of the user who created the facility.Of /BRIEF, /NORMAL and /FULL, /NORMAL is the default.
/CURRENT
Displays information for the default facility. Do not specify the facil-name parameter if you use this qualifier./OUTPUT=file-spec
Directs the printed output of this command to a specified file. The file-spec parameter specifies the name of the file. VDE creates a new file with that name, directs the command's print output to that file, and prints nothing on your terminal. If this qualifier is omitted, all output appears on the terminal./TOTAL
Shows the total number of facilities that match each parameter. Other information about the individual facilities is not shown. A separate count is provided for each facil-name parameter. Wildcard characters are usually used in the parameter when using this qualifier.
| #1 |
|---|
VDE„ SHOW FACILITY
Facility CODE "Code modules"
Facility DELETE "Code for DELETE command"
Facility EXEC "VMS Executive routines"
Facility RMS "Record Management Services"
Facility SMG "Screen Management Package"
VDE„
|
This example lists all facilities in the current VDE library, which is the default when no facility name parameter is present. The normal form of the output gives the name and remark string of each facility.
| #2 |
|---|
VDE„ SHOW FACILITY/BRIEF
Facility CODE
Facility DELETE
Facility EXEC
Facility RMS
Facility SMG
VDE„
|
This example illustrates the brief form of the SHOW FACILITY output, which shows only the name of each facility.
| #3 |
|---|
VDE„ SHOW FACILITY/FULL RMS
Facility RMS
Facility added to database on 4-APR-1989 14:57:14.12
Facility added to database by user SMITH (Jane Smith)
Facility can be deleted
Remark: Record Management Services
VDE„
|
This example shows the full output of the SHOW FACILITY command.
| #4 |
|---|
VDE„ SHOW FACILITY/TOTAL %M*
Number of facilities matching name %M*: 2
VDE„
|
The /TOTAL qualifier displays the number of facilities that match the specified parameter. The parameter (%M*) matches all facility names that have an M in the second character position. Using the library in the previous example, the command finds two such facilities, RMS and SMG.
| #5 |
|---|
VDE„ SHOW FACILITY/CURRENT
Facility CODE "Code modules"
VDE„
|
The /CURRENT qualifier displays the name of the default facility.
Displays the attributes of one or more specified fold records.
SHOW FOLD [mod-name [, mod-name...]]
mod-name
Specifies a module for which fold records are to be displayed. The module name consists of an optional facility name enclosed in square brackets, a module name, and an optional type name preceded by a period (such as [FACIL]MOD1.MAR). If the facility name is omitted, the module is assumed to belong to the default facility. If the type name is omitted, VDE displays fold records for all source modules with the specified module name in the given facility.You can display fold records for more than one module by using wildcard characters in any of the three components of the module name. The percent sign (%) in a name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. VDE displays fold records for all source modules whose names match the wildcard pattern.
If you omit the mod-name parameter, VDE displays fold records for all modules in the default facility.
Depending on the qualifiers you select, the SHOW FOLD command displays either a one-line summary for each fold record or all attributes of each fold record. The command can also show the total number of fold records that match a specified module name. You can select the fold records to be displayed or counted with qualifiers that specify various selection criteria. These criteria include the fold record's creation date and time, its fold identifier, its associated development stream, and the user to whom it belongs. Only those fold records that satisfy all specified selection criteria are displayed or counted.
/BEFORE=date-time
Displays only those fold records created before the specified date and time. The date and time can be stated in the standard OpenVMS date-time format or can be one of the following keywords: YESTERDAY, TODAY, or TOMORROW. If you use a space to separate the date from the time, remember to enclose the entire date-time string in double quotes. For further information about specifying OpenVMS date-time format, see the OpenVMS DCL Concepts./BRIEF (default)
/FULL
Determines the information that is displayed about each fold record. The /BRIEF qualifier displays a one-line summary for each fold record that matches the module name parameters and the other selection criteria. The /FULL qualifier lists all database information for each fold record./OUTPUT=file-spec
Directs the printed output of this command to a specified file. The file-spec parameter specifies the name of the file. VDE creates a new file with that name, directs the command's print output to that file, and prints nothing on your terminal. If this qualifier is omitted, all output appears on the terminal./IDENTIFICATION=fold-ident
Displays only those fold records with the fold identifier given by the fold-ident parameter. The fold identifier is the identifier you specified or VDE assigned when you created the fold record, usually a small integer value. If this qualifier is omitted, VDE displays fold records with all fold identifiers./SINCE=date-time
Displays only those fold records created after the specified date and time. The date and time can be stated in the standard OpenVMS date-time format or can be one of the following keywords: YESTERDAY, TODAY, or TOMORROW. If you use a space to separate the date from the time, remember to enclose the entire date-time string in double quotes. For further information about specifying OpenVMS date-time format, see the OpenVMS DCL Concepts./STREAM=stream-name
Specifies the development stream for which fold records should be displayed. The stream-name parameter gives the name of the stream. If this qualifier is omitted, VDE displays fold records for all development streams./TOTAL
Shows the total number of fold records that match each module-name parameter and satisfy the other selection criteria. Other information about the individual fold records is not shown. A separate count is provided for each mod-name parameter. Wildcard characters are usually used in the parameter when using this qualifier./USERNAME[=username]
Specifies the OpenVMS username of a user whose fold records are to be shown. If this qualifier is specified, only that user's fold records are shown. If the username parameter is omitted, only your own fold records are shown. If the whole qualifier is omitted, fold records for all users are shown.
| #1 |
|---|
VDE„ SHOW FOLD
Fold 1 of [CODE]X.FOR;2(2) into stream V1.0 26-JUN-1990 JONES
VDE„
|
This example shows the brief output of the SHOW FOLD command. This output gives the fold identifier, the module name, the development stream the change should be folded into, the date the fold record was created, and the username of the fold record's owner.
| #2 |
|---|
VDE„ SHOW FOLD/FULL
Fold 1 of [CODE]X.FOR;2(2)
Module to be folded from stream MAIN into stream V1.0
Fold record created by user JONES (Jon Jones)
Fold record created on 26-JUN-1990 12:40:21.90
Remark: Fix access violation in sort routine
VDE„
|
This example shows the full output of the SHOW FOLD command. This output gives all database information for the fold record.
Displays current, differential or historical information about one or more specified module generations.
SHOW GENERATION [gen-spec [, gen-spec...]]
gen-spec
Specifies a module generation to be displayed. A generation specification consists of the following in order:An example of a generation specification is [RMS]MOD1.MAR;5.
- an optional facility name enclosed in square brackets
- a module name
- an optional type name preceded by a period
- an optional generation number preceded by a semicolon
If you omit the facility name, module generations from the default facility are displayed. If you omit the type name, generations for all modules with the specified module name in the specified facility are displayed. If you omit the generation number, the most recent generation of the module in the specified (or default) stream is displayed.
If you specify a zero or negative generation number, that number is relative to the most recent generation of the module in the stream specified by the /STREAM qualifier (or the default stream if that qualifier is omitted). For example, if the most recent generation is generation 5, then generation 0 is the same as generation 5 and generation --1 is the same as generation 4.
If you specify the /GENERATION qualifier, VDE displays the generation with the given CMS generation expression and ignores the generation number on the gen-spec parameter.
You can display more than one generation by using wildcard characters in the facility name, module name, or type name, or by specifying a wildcard on the /GENERATION qualifier. The percent sign (%) in a name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. An asterisk (*) in place of the generation number matches all generations of a module. Those module generations whose names match the wildcard pattern are displayed.
If you omit the gen-spec parameter, VDE displays the most recent generation of each module in the default facility.
The SHOW GENERATION command displays part or all of the historical information stored in the VDE database for each selected generation. Unless you use the /GENERATION or /TREE qualifier, VDE only displays generation histories for a specified (or the default) development stream. The command can also show the total number of generations that match a generation specification or certain statistics about the generations that match a generation specification.
/ALL
/SOURCE (default)
/DERIVED
Controls whether generations for source modules, derived modules, or all modules are displayed. The /SOURCE qualifier causes VDE to display only source module generations that match the gen-spec parameters. The /DERIVED qualifier causes VDE to display only derived module generations that match the parameters. The /ALL qualifier causes VDE to display both source module and derived module generations that match the parameters.Of /ALL, /SOURCE and /DERIVED, /SOURCE is the default.
/BEFORE=date-time
Displays only those generations created before the specified date and time. The date and time can be stated in the standard OpenVMS date-time format or can be one of the following keywords: YESTERDAY, TODAY, or TOMORROW. If you use a space to separate the date from the time, remember to enclose the entire date-time string in double quotes. For further information about specifying OpenVMS date-time format, see the OpenVMS DCL Concepts./BRIEF (default)
/FULL
Determines the information that is displayed for each generation. The /BRIEF qualifier displays the module name, generation number, creating user, and creation date and time of each generation that matches the gen-spec parameter. The /FULL qualifier displays all attributes of each generation, including its name, generation number, creation date, creating user, CMS generation expression, and remark string.Of /BRIEF and /FULL, /BRIEF is the default.
/GENERATION=gen-expr
Specifies that the generation with the CMS generation expression given by the gen-expr parameter be diplayed. When this qualifier is specified, the generation number specified on the gen-spec parameter is ignored./IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive qualifiers. They also cause VDE to ignore any generation number you specify because they always reference the latest module generations in the specified streams.
/IF_SAME=stream-name
/IF_DIFFERENT=stream-name
Displays only those generations that are the same (or different) in two streams. These qualifiers select the latest generation of each specified module in the stream given by the /STREAM qualifier (or your default stream).The /IF_SAME qualifier displays this generation only if it is also the latest generation of the module in the stream given by the stream-name parameter.
The /IF_DIFFERENT qualifier displays this generation only if it differs from the latest generation of the module in the stream given by the stream-name parameter. These qualifiers thus show for what modules two developments streams are still the same and for what modules the streams differ.
The latest generations of two streams are considered to be the same only if they are the identical generation with the same generation expression. VDE determines this from the contents of the VDE database, not by comparing the text of the two generations.
/IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive qualifiers. They also cause VDE to ignore any generation number you specify because they always reference the latest module generations in the specified streams.
/OUTPUT=file-spec
Directs the printed output of this command to a specified file. The file-spec parameter specifies the name of the file. VDE creates a new file with that name, directs the command's print output to that file, and prints nothing on your terminal. If this qualifier is omitted, all output appears on the terminal./SINCE=date-time
Displays only those generations created after the specified date and time. The date and time can be stated in the standard OpenVMS date-time format or can be one of the following keywords: YESTERDAY, TODAY, or TOMORROW. If you use a space to separate the date from the time, remember to enclose the entire date-time string in double quotes. For further information about specifying OpenVMS date-time format, see the OpenVMS DCL Concepts./STATISTICS=(keyword [, keyword...])
Computes and displays certains statistics about the module generations that match the generation specification parameters and any selection qualifiers (such as /SINCE, /BEFORE, or /USERNAME) that you specify. The keyword parameters specify what statistics to display and how to sort them. The qualifier accepts the following keyword parameters:If you specify only one of these keywords, the surrounding parentheses may be omitted.
- ALPHABETICALLY---Sort the display alphabetically by facility name, module name, or type name. If this keyword is omitted, VDE sorts the display in descending order by generation count.
- FACILITY---Compute and display the number of generations in each facility.
- MODULE---Compute and display the number of generations for each module.
- TYPES---Compute and display the number of generations that have each module type.
When this qualifier is used, other information about the individual generations is not shown. Use selection qualifiers and wildcard characters in the generation specification parameters to select the generation population for which you want statistics.
/STREAM=stream-name
Specifies that generations for the development stream given by the stream-name parameter be displayed. This qualifier thus affects the interpretation of generation numbers on the command's gen-spec parameter. If this qualifier is omitted, VDE displays generations for the default development stream./TOTAL
Shows the total number of generations that match the gen-spec parameters. Other information about the individual generations is not shown. A separate count is provided for each gen-spec parameter. Wildcard characters are usually used in the parameters when using this qualifier./TREE
Shows the whole generation tree for each specified module. This display shows the CMS generation expression for each generation, the date it was created, who created it, and the generation remark. It also shows for what streams the generation is the latest generation. This is the only display that shows all generations of a module regardless of what streams they belong to./IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive qualifiers. They also cause VDE to ignore any generation number you specify because they always reference the latest module generations in the specified streams.
/USERNAME[=username]
Displays only those generations created by a specified user. The username parameter gives the OpenVMS username of the user whose generations should be displayed. If the username parameter is omitted, only generations that you created are shown. If the whole qualifier is omitted, generations created by all users are shown.
| #1 |
|---|
VDE„ SHOW GENERATION/STREAM=BIRCH
Generation [RMS]MODULE_A.REQ;2(2) by user SMITH on 12-DEC-1989 08:44
Generation [RMS]MODULE_B.REQ;25(23A2) by user JONES on 9-DEC-1989 20:34
Generation [RMS]MODULE_C.B32;14(14) by user BROWN on 9-DEC-1989 20:34
Generation [RMS]MODULE_D.B32;1(1) by user MORELIKERED on 9-DEC-1989 20:34
Generation [RMS]MODULE_E.B32;8(7E1) by user JONES on 29-DEC-1989 13:12
VDE„
|
This example shows the brief output of the SHOW GENERATION command. The command displays one line per generation. The /STREAM qualifier says to display generations for stream BIRCH. Because no generation specification parameter is specified, the command shows the latest generation for that stream of each module in the default facility.
| #2 |
|---|
VDE„ SHOW GENERATION MODULE_E.B32;*
Generation [RMS]MODULE_E.B32;8(8) by user JONES on 29-DEC-1989 13:12
Generation [RMS]MODULE_E.B32;7(7) by user JONES on 26-DEC-1989 14:00
Generation [RMS]MODULE_E.B32;6(6) by user SMITH on 19-DEC-1989 15:37
Generation [RMS]MODULE_E.B32;5(5) by user PORTER on 12-DEC-1989 13:10
Generation [RMS]MODULE_E.B32;4(4) by user DINGDONG on 12-DEC-1989 08:43
Generation [RMS]MODULE_E.B32;3(3) by user SMITH on 12-DEC-1989 08:37
Generation [RMS]MODULE_E.B32;2(2) by user JONES on 12-DEC-1989 08:35
Generation [RMS]MODULE_E.B32;1(1) by user JONES on 9-DEC-1989 20:34
VDE„
|
This example displays generations for module MODULE_E.B32 in facility RMS. It uses the asterisk wildcard character (*) in place of the generation number. As a result, VDE displays the latest generation of the module in the current default stream and all previous generations leading up to that generation of the module. This display thus summarizes the historical development of that module for the default stream.
| #3 |
|---|
VDE„ SHOW GENERATION [RMS]MODULE_E.B32;8/FULL
Generation [RMS]MODULE_E.B32;8(8)
Generation created on 29-DEC-1989 13:12:51.55
Generation created by user JONES (John Jones)
Module is a source module
CMS generation expression is "8"
Delta letters in use: None
Generation created in stream HICKORY
Latest generation for stream HICKORY, BIRCH
Module is current for stream HICKORY
Main thread belongs to stream HICKORY
Remark: Add the mumble-fratz feature
VDE„
|
This example illustrates the full output of the SHOW GENERATION command. VDE displays all attributes of the specified module generation. The generation shown is generation 8 relative to the default stream.
| #4 |
|---|
VDE„ SHOW GENERATION/TREE [RMS]E.B32
Generation tree for module [RMS]E.B32:
(4) 28-JUN-1990 16:15:13.95 JONES "Make comments meaningful"
Latest generation for stream MAIN
(3) 27-JUN-1990 14:14:21.71 BROWN "Convert to new QCB format"
(1A1) 22-JUN-1990 14:56:28.43 ANDERSON "Fix timing bug"
Latest generation for stream HICKORY
(2) 22-JUN-1990 14:55:01.29 SMITH "Add widget feature"
(1) 18-JUN-1990 17:46:47.60 SMITH "Initial generation"
VDE„
|
This example shows the whole generation tree for module E.B32 in facility RMS. Generation 4 is the latest generation in stream MAIN and generation 1A1 is the latest generation in stream HICKORY.
| #5 |
|---|
VDE„ SHOW GENERATION/TOTAL/SOURCE [RMS]*;*
Number of generations matching name [RMS]*.*;*: 237
VDE„
|
Previous Next Contents Index