RVDE7

VDE
VDE
Reference Manual



 q
Previous[ Contents] Index



FThis example shows the full output of the SHOW DIRECTORY command. For Eeach directory template, the full output shows the date and time the Etemplate was created, the username and full name of the creator, and 5the template's remark string. For templates that VDE Asupplies by default, the template creator is simply the user who created the VDE library. 


P

SHOW EDITOR



+Display what editor VDE uses for those VDE commands that invoke an editor.



Format



SHOW EDITOR




Parameters

None.



Description

AThe SHOW EDITOR command displays the editor strings that various <VDE commands use to invoke your preferred editor, either to 8create new files or to display existing files. When VDE Dinvokes an editor, it spawns a DCL editing command in a subprocess. 4VDE forms the editing command by concatenating your Dread-write or read-only editor string, a space, and the name of the Ffile to edit. The SHOW EDITOR command displays the current read-write 7and read-only editor strings for your VDE session. The @command can also display your default editor strings for future VDE sessions.



Qualifiers



/BRIEF (default)



/FULL

8Control whether VDE displays the default editor strings 6stored in the VDE database. The /BRIEF qualifier only 5displays the two editor strings for your current VDE Asession. The /FULL qualifier diplays the editor strings for your 8current VDE session and your default editor strings for future VDE sessions.

+Of /FULL and /BRIEF, /BRIEF is the default.




Examples

 6    
#1

 
VDEä SHOW EDITORCurrent editor strings:    Read-write editor string: TPU*   Read-only editor string:  TPU/READ_ONLYVDEä      


EThis example illustrates the brief output of the SHOW EDITOR command.

 6    
#2

 
VDEä SHOW EDITOR/FULLCurrent editor strings:    Read-write editor string: TPU*   Read-only editor string:  TPU/READ_ONLYDefault editor strings:%   Read-write editor string: EDIT/EDT/   Read-only editor string:  EDIT/EDT/READ_ONLYVDEä      


HThis example illustrates the full output of the SHOW EDITOR command. In :this case, the editor strings for the current VDE session Bspecify the TPU editor, but the default editor strings for future sessions specify the EDT editor.


O

SHOW FACILITY



FDisplays the names and attributes of one or more specified facilities.



Format

6

SHOW FACILITY [facil-name [, facil-name...]]




Parameter



facil-name

<The name of a facility whose attributes are to be displayed.

FYou can display more than one facility using wildcard characters. The Hpercent sign (%) in a facility name matches any single character in the ?position it occupies and the asterisk (*) matches zero or more Echaracters in the position it occupies. Those facilities whose names )match the wildcard pattern are displayed.

EIf you do not specify a facility name or use the /CURRENT qualifier, 3VDE displays all facilities in the current library.




Description

BDepending on the qualifiers you select, the SHOW FACILITY command Hdisplays either the name of each selected facility, the name and remark Fstring of each facility, or the name and all other attributes of each Hfacility. The command can also show the total number of facilities that match a specified facility name.



Qualifiers



/BRIEF



/NORMAL (default)



/FULL

FDetermines the information that is displayed about each facility. The E/BRIEF qualifier displays the name of each facility that matches the Ffacility name parameters. The /NORMAL qualifier displays the name and >remark string of each facility. The /FULL qualifier lists all Hinformation about each facility, including its name, its creation date, Eits remark string, and the name of the user who created the facility.

5Of /BRIEF, /NORMAL and /FULL, /NORMAL is the default.

/CURRENT

BDisplays information for the default facility. Do not specify the @facil-name parameter if you use this qualifier.

/OUTPUT=file-spec

DDirects the printed output of this command to a specified file. The Efile-spec parameter specifies the name of the file. =VDE creates a new file with that name, directs the command's Hprint output to that file, and prints nothing on your terminal. If this 9qualifier is omitted, all output appears on the terminal.

/TOTAL

FShows the total number of facilities that match each parameter. Other Einformation about the individual facilities is not shown. A separate Bcount is provided for each facil-name parameter. FWildcard characters are usually used in the parameter when using this qualifier.



Examples

 6    
#1

 
VDEä SHOW FACILITY'Facility CODE            "Code modules"2Facility DELETE          "Code for DELETE command"1Facility EXEC            "VMS Executive routines"5Facility RMS             "Record Management Services"4Facility SMG             "Screen Management Package"VDEä      


5This example lists all facilities in the current VDE Alibrary, which is the default when no facility name parameter is Hpresent. The normal form of the output gives the name and remark string of each facility.

 6    
#2

 
VDEä SHOW FACILITY/BRIEF
Facility CODEFacility DELETE
Facility EXECFacility RMSFacility SMGVDEä      


EThis example illustrates the brief form of the SHOW FACILITY output, +which shows only the name of each facility.

 6    
#3

 
VDEä SHOW FACILITY/FULL RMSFacility RMS8   Facility added to database on  4-APR-1989 14:57:14.128   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.

 6    
#4

 
VDEä SHOW FACILITY/TOTAL %M*)Number of facilities matching name %M*: 2VDEä      


FThe /TOTAL qualifier displays the number of facilities that match the Dspecified parameter. The parameter (%M*) matches all facility names Fthat have an M in the second character position. Using the library in Ethe previous example, the command finds two such facilities, RMS and SMG.

 6    
#5

 
VDEä SHOW FACILITY/CURRENT'Facility CODE            "Code modules"VDEä      


AThe /CURRENT qualifier displays the name of the default facility.


L

SHOW FOLD



>Displays the attributes of one or more specified fold records.



Format

.

SHOW FOLD [mod-name [, mod-name...]]




Parameter



mod-name

CSpecifies a module for which fold records are to be displayed. The Emodule name consists of an optional facility name enclosed in square Hbrackets, a module name, and an optional type name preceded by a period G(such as [FACIL]MOD1.MAR). If the facility name is omitted, the module Bis assumed to belong to the default facility. If the type name is :omitted, VDE displays fold records for all source modules 5with the specified module name in the given facility.

HYou can display fold records for more than one module by using wildcard Bcharacters in any of the three components of the module name. The Hpercent sign (%) in a name matches any single character in the position Hit occupies and the asterisk (*) matches zero or more characters in the 8position it occupies. VDE displays fold records for all 6source modules whose names match the wildcard pattern.

9If you omit the mod-name parameter, VDE >displays fold records for all modules in the default facility.




Description

GDepending on the qualifiers you select, the SHOW FOLD command displays Deither a one-line summary for each fold record or all attributes of Eeach fold record. The command can also show the total number of fold Drecords that match a specified module name. You can select the fold Hrecords to be displayed or counted with qualifiers that specify various Fselection criteria. These criteria include the fold record's creation Gdate and time, its fold identifier, its associated development stream, Fand the user to whom it belongs. Only those fold records that satisfy :all specified selection criteria are displayed or counted.



Qualifiers



/BEFORE=date-time

GDisplays only those fold records created before the specified date and >time. The date and time can be stated in the standard OpenVMS Edate-time format or can be one of the following keywords: YESTERDAY, ETODAY, or TOMORROW. If you use a space to separate the date from the Htime, 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

EDetermines the information that is displayed about each fold record. FThe /BRIEF qualifier displays a one-line summary for each fold record @that matches the module name parameters and the other selection Fcriteria. The /FULL qualifier lists all database information for each fold record.

/OUTPUT=file-spec

DDirects the printed output of this command to a specified file. The Efile-spec parameter specifies the name of the file. =VDE creates a new file with that name, directs the command's Hprint output to that file, and prints nothing on your terminal. If this 9qualifier is omitted, all output appears on the terminal.#

/IDENTIFICATION=fold-ident

GDisplays only those fold records with the fold identifier given by the Bfold-ident parameter. The fold identifier is the :identifier you specified or VDE assigned when you created Ethe fold record, usually a small integer value. If this qualifier is =omitted, VDE displays fold records with all fold identifiers.

/SINCE=date-time

FDisplays only those fold records created after the specified date and >time. The date and time can be stated in the standard OpenVMS Edate-time format or can be one of the following keywords: YESTERDAY, ETODAY, or TOMORROW. If you use a space to separate the date from the Htime, 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

BSpecifies the development stream for which fold records should be Hdisplayed. The stream-name parameter gives the name of <the stream. If this qualifier is omitted, VDE displays fold $records for all development streams.

/TOTAL

CShows the total number of fold records that match each module-name Fparameter and satisfy the other selection criteria. Other information Dabout the individual fold records is not shown. A separate count is @provided for each mod-name parameter. Wildcard Gcharacters are usually used in the parameter when using this qualifier.

/USERNAME[=username]

@Specifies the OpenVMS username of a user whose fold records are Cto be shown. If this qualifier is specified, only that user's fold Arecords are shown. If the username parameter is Fomitted, only your own fold records are shown. If the whole qualifier 1is omitted, fold records for all users are shown.



Examples

 6    
#1

 
VDEä SHOW FOLDHFold 1 of [CODE]X.FOR;2(2) into stream V1.0            26-JUN-1990 JONESVDEä      


CThis example shows the brief output of the SHOW FOLD command. This Coutput gives the fold identifier, the module name, the development Fstream the change should be folded into, the date the fold record was 5created, and the username of the fold record's owner.

 6    
#2

 
VDEä SHOW FOLD/FULLFold 1 of [CODE]X.FOR;2(2)8   Module to be folded from stream MAIN into stream V1.00   Fold record created by user JONES (Jon Jones)1   Fold record created on 26-JUN-1990 12:40:21.90/   Remark: Fix access violation in sort routine VDEä      


BThis example shows the full output of the SHOW FOLD command. This :output gives all database information for the fold record.


Q

SHOW GENERATION



FDisplays current, differential or historical information about one or "more specified module generations.



Format

4

SHOW GENERATION [gen-spec [, gen-spec...]]




Parameter



gen-spec

<Specifies a module generation to be displayed. A generation 1specification consists of the following in order:<An example of a generation specification is [RMS]MOD1.MAR;5.

CIf you omit the facility name, module generations from the default Gfacility are displayed. If you omit the type name, generations for all Emodules with the specified module name in the specified facility are >displayed. If you omit the generation number, the most recent Ageneration of the module in the specified (or default) stream is displayed.

DIf you specify a zero or negative generation number, that number is Crelative to the most recent generation of the module in the stream Bspecified by the /STREAM qualifier (or the default stream if that Equalifier 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 Dgeneration with the given CMS generation expression and ignores the =generation number on the gen-spec parameter.

FYou can display more than one generation by using wildcard characters Din the facility name, module name, or type name, or by specifying a Fwildcard on the /GENERATION qualifier. The percent sign (%) in a name Amatches any single character in the position it occupies and the @asterisk (*) matches zero or more characters in the position it Hoccupies. An asterisk (*) in place of the generation number matches all Hgenerations of a module. Those module generations whose names match the wildcard pattern are displayed.

9If you omit the gen-spec parameter, VDE Bdisplays the most recent generation of each module in the default facility.




Description

CThe SHOW GENERATION command displays part or all of the historical 9information 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 Ethe default) development stream. The command can also show the total Gnumber of generations that match a generation specification or certain Gstatistics about the generations that match a generation specification.



Qualifiers

/ALL



/SOURCE (default)



/DERIVED

EControls whether generations for source modules, derived modules, or <all modules are displayed. The /SOURCE qualifier causes VDE 9to display only source module generations that match the Dgen-spec parameters. The /DERIVED qualifier causes :VDE to display only derived module generations that match 9the parameters. The /ALL qualifier causes VDE to display Aboth source module and derived module generations that match the parameters.

6Of /ALL, /SOURCE and /DERIVED, /SOURCE is the default.

/BEFORE=date-time

FDisplays only those generations created before the specified date and >time. The date and time can be stated in the standard OpenVMS Edate-time format or can be one of the following keywords: YESTERDAY, ETODAY, or TOMORROW. If you use a space to separate the date from the Htime, 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

FDetermines the information that is displayed for each generation. The G/BRIEF qualifier displays the module name, generation number, creating Euser, and creation date and time of each generation that matches the Fgen-spec parameter. The /FULL qualifier displays all Fattributes of each generation, including its name, generation number, Dcreation date, creating user, CMS generation expression, and remark string.

+Of /BRIEF and /FULL, /BRIEF is the default.

/GENERATION=gen-expr

GSpecifies that the generation with the CMS generation expression given Bby the gen-expr parameter be diplayed. When this ?qualifier is specified, the generation number specified on the /gen-spec parameter is ignored.

F/IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive 9qualifiers. They also cause VDE to ignore any generation Cnumber you specify because they always reference the latest module %generations in the specified streams.

/IF_SAME=stream-name

"

/IF_DIFFERENT=stream-name

HDisplays only those generations that are the same (or different) in two ?streams. These qualifiers select the latest generation of each Gspecified module in the stream given by the /STREAM qualifier (or your default stream).

GThe /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.

HThe /IF_DIFFERENT qualifier displays this generation only if it differs Dfrom the latest generation of the module in the stream given by the Gstream-name parameter. These qualifiers thus show for Fwhat modules two developments streams are still the same and for what modules the streams differ.

DThe latest generations of two streams are considered to be the same Conly if they are the identical generation with the same generation 9expression. VDE determines this from the contents of the 3VDE database, not by comparing the text of the two generations.

F/IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive 9qualifiers. They also cause VDE to ignore any generation Cnumber you specify because they always reference the latest module %generations in the specified streams.

/OUTPUT=file-spec

DDirects the printed output of this command to a specified file. The Efile-spec parameter specifies the name of the file. =VDE creates a new file with that name, directs the command's Hprint output to that file, and prints nothing on your terminal. If this 9qualifier is omitted, all output appears on the terminal.

/SINCE=date-time

EDisplays only those generations created after the specified date and >time. The date and time can be stated in the standard OpenVMS Edate-time format or can be one of the following keywords: YESTERDAY, ETODAY, or TOMORROW. If you use a space to separate the date from the Htime, 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...])

GComputes and displays certains statistics about the module generations Ethat match the generation specification parameters and any selection Equalifiers (such as /SINCE, /BEFORE, or /USERNAME) that you specify. CThe keyword parameters specify what statistics to Bdisplay and how to sort them. The qualifier accepts the following keyword parameters:GIf you specify only one of these keywords, the surrounding parentheses may be omitted.

DWhen this qualifier is used, other information about the individual @generations is not shown. Use selection qualifiers and wildcard Dcharacters in the generation specification parameters to select the 4generation population for which you want statistics.

/STREAM=stream-name

CSpecifies that generations for the development stream given by the Dstream-name parameter be displayed. This qualifier Gthus affects the interpretation of generation numbers on the command's Cgen-spec parameter. If this qualifier is omitted, <VDE displays generations for the default development stream.

/TOTAL

5Shows the total number of generations that match the Bgen-spec parameters. Other information about the Findividual generations is not shown. A separate count is provided for Beach gen-spec parameter. Wildcard characters are 9usually used in the parameters when using this qualifier.

/TREE

HShows the whole generation tree for each specified module. This display Eshows the CMS generation expression for each generation, the date it Fwas created, who created it, and the generation remark. It also shows Ffor what streams the generation is the latest generation. This is the Gonly display that shows all generations of a module regardless of what streams they belong to.

F/IF_SAME, /IF_DIFFERENT, /GENERATION and /TREE are mutually exclusive 9qualifiers. They also cause VDE to ignore any generation Cnumber you specify because they always reference the latest module %generations in the specified streams.

/USERNAME[=username]

ADisplays 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 Fusername parameter is omitted, only generations that Fyou created are shown. If the whole qualifier is omitted, generations created by all users are shown.



Examples

 6    
#1

 
!VDEä SHOW GENERATION/STREAM=BIRCHOGeneration [RMS]MODULE_A.REQ;2(2)     by user SMITH        on 12-DEC-1989 08:44OGeneration [RMS]MODULE_B.REQ;25(23A2) by user JONES        on  9-DEC-1989 20:34OGeneration [RMS]MODULE_C.B32;14(14)   by user BROWN        on  9-DEC-1989 20:34OGeneration [RMS]MODULE_D.B32;1(1)     by user MORELIKERED  on  9-DEC-1989 20:34OGeneration [RMS]MODULE_E.B32;8(7E1)   by user JONES        on 29-DEC-1989 13:12VDEä      


HThis example shows the brief output of the SHOW GENERATION command. The Hcommand displays one line per generation. The /STREAM qualifier says to <display generations for stream BIRCH. Because no generation Cspecification parameter is specified, the command shows the latest Bgeneration for that stream of each module in the default facility.

 6    
#2

 
#VDEä SHOW GENERATION MODULE_E.B32;*OGeneration [RMS]MODULE_E.B32;8(8)     by user JONES        on 29-DEC-1989 13:12OGeneration [RMS]MODULE_E.B32;7(7)     by user JONES        on 26-DEC-1989 14:00OGeneration [RMS]MODULE_E.B32;6(6)     by user SMITH        on 19-DEC-1989 15:37OGeneration [RMS]MODULE_E.B32;5(5)     by user PORTER       on 12-DEC-1989 13:10OGeneration [RMS]MODULE_E.B32;4(4)     by user DINGDONG     on 12-DEC-1989 08:43OGeneration [RMS]MODULE_E.B32;3(3)     by user SMITH        on 12-DEC-1989 08:37OGeneration [RMS]MODULE_E.B32;2(2)     by user JONES        on 12-DEC-1989 08:35OGeneration [RMS]MODULE_E.B32;1(1)     by user JONES        on  9-DEC-1989 20:34VDEä      


FThis example displays generations for module MODULE_E.B32 in facility ARMS. It uses the asterisk wildcard character (*) in place of the 8generation number. As a result, VDE displays the latest Hgeneration of the module in the current default stream and all previous Fgenerations leading up to that generation of the module. This display Bthus summarizes the historical development of that module for the default stream.

 6    
#3

 
-VDEä SHOW GENERATION [RMS]MODULE_E.B32;8/FULL!Generation [RMS]MODULE_E.B32;8(8)0   Generation created on 29-DEC-1989 13:12:51.550   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 Ageneration. The generation shown is generation 8 relative to the default stream.

 6    
#4

 
$VDEä SHOW GENERATION/TREE [RMS]E.B32&Generation tree for module [RMS]E.B32:D   (4)      28-JUN-1990 16:15:13.95 JONES "Make comments meaningful"0               Latest generation for stream MAINE   (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"3               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ä      


AThis example shows the whole generation tree for module E.B32 in Gfacility RMS. Generation 4 is the latest generation in stream MAIN and :generation 1A1 is the latest generation in stream HICKORY.

 6    
#5

 
*VDEä SHOW GENERATION/TOTAL/SOURCE [RMS]*;*3Number of generations matching name [RMS]*.*;*: 237VDEä      





 q
PreviousX Next[ Contents] Index