PVDE5

VDE
Guide to Using
VDE

]

3.3 Displaying Generation Histories

>The SHOW GENERATION command lists historical and differential @information about the module generations present in the current library. For example:

"
&VSC> SHOW GENERATION [FACIL]MOD.TYP

HThis example displays information about the latest generation of module H[FACIL]MOD.TYP in your default development stream. If the facility name His omitted, your default facility is assumed. If the whole parameter is Comitted, the most recent generations for the default stream of all *modules in the default facility are shown.

CWith the SHOW GENERATION command, you can specify a list of module Hnames separated by commas, and you can use the asterisk (*) and percent Fsign (%) wildcard characters in the module names. The SHOW GENERATION Ecommand displays generations for all modules that match the wildcard patterns.

EEach generation for a given module is named in two ways. One name is <the generation number that VSC assigns and Athe other is the generation expression that CMS Fassigns. You can use either name to specify the generation to display.

:VSC assigns generation numbers in sequential order to the Hgenerations for each development stream. Generation 1 is thus the first Egeneration for the stream, generation 2 is its successor, and so on. EGeneration 2 of stream A can be the same as generation 2 of stream B D(if the streams have not yet diverged) or they can be two different +generations (if the streams have diverged).

GWhen you refer to a generation by its generation number, you specify a Hsemicolon and the generation number after the module name. For example, GMOD.TYP;5 refers to generation 5 for the default stream (or the stream Dspecified by the /STREAM qualifier). You can also specify a zero or Hnegative generation number; such a generation number is relative to the Flatest generation for the stream. MOD.TYP;0 thus refers to the latest Fgeneration and MOD.TYP;--1 refers to the next most recent generation. CIf you specify the asterisk (*) wildcard character in place of the Ageneration number (as in MOD.TYP;*), the SHOW GENERATION command Fdisplays all generations for the stream starting with the most recent generation.

CCMS generation expressions are assigned a different way. The first Ageneration for a module has generation expression 1. It can have Hmultiple successors (for different streams) with generation expressions H2, 1A1, 1B1, 1C1, and so on. Generation 1B1 can in turn have successors @1B2, 1B1A1, 1B1B1, and so on. Each generation thus has a unique Egeneration expression that encodes its genealogy. This expression is Aindependent of stream. To specify a generation by its generation Aexpression, you must use the /GENERATION qualifier. For example, GMOD.TYP/GENERATION=1B1 refers to the generation of module MOD.TYP that has generation expression 1B1.

FIf you omit both the generation number and the /GENERATION qualifier, 5VSC displays the latest generation in the default or specified stream.

EThe SHOW GENERATION command also accepts a number of qualifiers that Bselect subsets of the specified generations. For example, you can Hselect all generations created before or since a certain date and time, Fyou can select the generations created by a certain user, and you can 9select those generations that differ between two streams.

sTable 3-3 lists the qualifiers for the SHOW GENERATION command and describes their functions.

v
Table 3-3 Qualifiers to the SHOW GENERATION command
( /BEFORE=date-time
L Displays only those generation created before the specified date and time.
/BRIEF
/FULL
O Determine the type of information displayed for each generation. /BRIEF K displays the module name, generation number, generation expression, I creating user, and creation date and time of each generation that K matches the generation-specification parameters. /FULL displays all 0 database information for each generation.
+ /GENERATION=gen-expr
O Specifies that the module generation with the CMS generation expression given by the7 gen-expr parameter be displayed.
+ /IF_SAME=stream-name
0 /IF_DIFFERENT=stream-name
O Displays only those generations that are the same (or different) in two F streams. These qualifiers select the latest generation of each N specified module in the stream given by the /STREAM qualifier (or your M default stream). The /IF_SAME qualifier displays this generation only M if it is also the latest generation of the module in the stream given by theJ stream-name parameter. The /IF_DIFFERENT qualifier M displays this generation only if it differs from the latest generation . of the module in the stream given by theM stream-name parameter. These qualifiers thus show for L what modules two developments streams are still the same and for what ! modules the streams differ.
K The latest generations of two streams are considered to be the same J only if they are the identical generation with the same generation @ expression. VSC determines this from the contents of the E source control database, not by comparing the text of the two generations.
' /OUTPUT=filespec
J Directs the printed output of this command to a specified file. TheJ filespec parameter specifies the name of the file. C VSC creates a new file with that name, directs the command's N 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
M Displays only those generation created on or after the specified date and time.
; /STATISTICS=(keyword [, keyword...])
D Computes and displays certains statistics about the selected generations. TheM keyword parameters specify what statistics to display H and how to sort them. The qualifier accepts the following keyword parameters:
L
ALPHABETICALLY---Sort the display alphabetically by facility name > or type name. If this keyword is omitted, VSC sorts the 6 display in descending order by generation count.K
FACILITY---Compute and display the number of generations in each facility.J
TYPES---Compute and display the number of generations that have each module type.
M
If you specify only one of these keywords, the surrounding * parentheses can be omitted.
K When this qualifier is used, other information about the individual G generations is not shown. Use selection qualifiers and wildcard K characters in the generation specification parameters to select the ; generation population for which you want statistics.
* /STREAM=stream-name
H Specifies that the generation numbers you specify on the command 5 parameters are for the stream specified by theL stream-name parameter. If this qualifier is omitted, = generation numbers are relative to your default stream.
/TOTAL
F Shows the total number of generations that match the specified K generation-specification parameters. Only the total count is shown; G other information about the individual generations is not shown.
/TREE
H Displays the full generation tree for each specified module. The M generations are ordered by creation date (the most recent generations N are shown first). For each generation that is the latest generation of K some development stream, the name of that stream is displayed. This I display is equivalent to the display that the CMS SHOW GENERATION * /DESCENDANTS /MEMBER command gives.
+ /USERNAME[=username]
K Displays only those generations created by the user specified by the1 username parameter. If theC username parameter is omitted, VSC displays I only those generations that you created. If the whole qualifier is < omitted, VSC displays generations created by any user.

**Table 3-3 Qualifiers to the SHOW GENERATION command**
( /BEFORE=date-time
	L Displays only those generation created before the specified date and time.
/BRIEF /FULL
	O Determine the type of information displayed for each generation. /BRIEF K displays the module name, generation number, generation expression, I creating user, and creation date and time of each generation that K matches the generation-specification parameters. /FULL displays all 0 database information for each generation.
+ /GENERATION=gen-expr
	O Specifies that the module generation with the CMS generation expression given by the7 gen-expr parameter be displayed.
+ /IF_SAME=stream-name 0 /IF_DIFFERENT=stream-name
	O Displays only those generations that are the same (or different) in two F streams. These qualifiers select the latest generation of each N specified module in the stream given by the /STREAM qualifier (or your M default stream). The /IF_SAME qualifier displays this generation only M if it is also the latest generation of the module in the stream given by theJ stream-name parameter. The /IF_DIFFERENT qualifier M displays this generation only if it differs from the latest generation . of the module in the stream given by theM stream-name parameter. These qualifiers thus show for L what modules two developments streams are still the same and for what ! modules the streams differ.
	K The latest generations of two streams are considered to be the same J only if they are the identical generation with the same generation @ expression. VSC determines this from the contents of the E source control database, not by comparing the text of the two generations.
' /OUTPUT=filespec
	J Directs the printed output of this command to a specified file. TheJ filespec parameter specifies the name of the file. C VSC creates a new file with that name, directs the command's N 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
	M Displays only those generation created on or after the specified date and time.
; /STATISTICS=(keyword [, keyword...])
	D Computes and displays certains statistics about the selected generations. TheM keyword parameters specify what statistics to display H and how to sort them. The qualifier accepts the following keyword parameters: L ALPHABETICALLY---Sort the display alphabetically by facility name > or type name. If this keyword is omitted, VSC sorts the 6 display in descending order by generation count.K FACILITY---Compute and display the number of generations in each facility.J TYPES---Compute and display the number of generations that have each module type. M If you specify only one of these keywords, the surrounding * parentheses can be omitted.
	K When this qualifier is used, other information about the individual G generations is not shown. Use selection qualifiers and wildcard K characters in the generation specification parameters to select the ; generation population for which you want statistics.
* /STREAM=stream-name
	H Specifies that the generation numbers you specify on the command 5 parameters are for the stream specified by theL stream-name parameter. If this qualifier is omitted, = generation numbers are relative to your default stream.
/TOTAL
	F Shows the total number of generations that match the specified K generation-specification parameters. Only the total count is shown; G other information about the individual generations is not shown.
/TREE
	H Displays the full generation tree for each specified module. The M generations are ordered by creation date (the most recent generations N are shown first). For each generation that is the latest generation of K some development stream, the name of that stream is displayed. This I display is equivalent to the display that the CMS SHOW GENERATION * /DESCENDANTS /MEMBER command gives.
+ /USERNAME[=username]
	K Displays only those generations created by the user specified by the1 username parameter. If theC username parameter is omitted, VSC displays I only those generations that you created. If the whole qualifier is < omitted, VSC displays generations created by any user.

9Examples

DThis example shows the brief output of the SHOW GENERATION command. EEach generation's module name is followed by a semicolon and the VCS Bgeneration number which in turn is followed by the CMS generation Dexpression (audit trail identifier) in parentheses. The output also 9shows who created the generation and when it was created:

"
VSC> SHOW GENERATION *.*,Generations for development stream MUSHROOM:OGeneration [RMS]MODULE_A.REQ;2(2) SMITH 12-DEC-1989 08:44:12OGeneration [RMS]MODULE_B.REQ;25(10A12B3) JONES 9-DEC-1989 20:34:00OGeneration [RMS]MODULE_C.B32;14(9H5) BROWN 9-DEC-1989 20:34:45OGeneration [RMS]MODULE_D.B32;1(1) MURGATROID 9-DEC-1989 20:34:57OGeneration [RMS]MODULE_E.B32;8(6A2) JONES 29-DEC-1989 13:12:32VSC>

BThis next example shows how to display all generations of a given Fmodule that gave rise to the latest generation in your default stream:

"
&VSC> SHOW GENERATION MODULE_E.B32;*,Generations for development stream MUSHROOM:OGeneration [RMS]MODULE_E.B32;8(6A2) JONES 29-DEC-1989 13:12:32OGeneration [RMS]MODULE_E.B32;7(6A1) JONES 26-DEC-1989 14:00:00OGeneration [RMS]MODULE_E.B32;6(6) SMITH 19-DEC-1989 15:37:12OGeneration [RMS]MODULE_E.B32;5(5) PORTER 12-DEC-1989 13:10:01OGeneration [RMS]MODULE_E.B32;4(4) DINGDONG 12-DEC-1989 08:43:27OGeneration [RMS]MODULE_E.B32;3(3) SMITH 12-DEC-1989 08:37:31OGeneration [RMS]MODULE_E.B32;2(2) JONES 12-DEC-1989 08:35:54OGeneration [RMS]MODULE_E.B32;1(1) JONES 9-DEC-1989 20:34:02VSC>

CThe following example shows the full output of the SHOW GENERATION "command for a specific generation:

"
0VSC> SHOW GENERATION [RMS]MODULE_E.B32;8/FULLGeneration [RMS]MODULE_E.B32;80 Generation created on 29-DEC-1989 13:12:32.25/ Generation created by user JONES (Jim Jones) Module is a source module% CMS generation expression is "6A2" Delta letters in use: None$ Generation created in stream V5.4: Latest generation for stream MUSHROOM, X4PM_BIRCH, V5.4( Module is current for stream MUSHROOM' Remark: Add the mumble-fratz feature VSC>

5This example shows the output of the /TREE qualifier:

"
/VSC> SHOW GENERATION/TREE [EXEC]MODULE_X.MAR.Generation tree for module [EXEC]MODULE_X.MAR:L (5B2) 19-DEC-1989 15:37:12.37 SMITH "This time it will work for sure!"C Latest generation for stream MUSHROOM, X4PS_MUSHROOMF (5B1) 19-DEC-1989 15:37:12.11 SMITH "Fix whizbang feature again"9 Latest generation for stream X4PR_MUSHROOM@ (5A1) 19-DEC-1989 15:37:12.00 SMITH "Fix whizbang feature"9 Latest generation for stream X4PQ_MUSHROOMA (5) 12-DEC-1989 13:10:01.45 PORTER "Add whizbang feature"A Latest generation for stream PHOENIX, X4PP_PHOENIXI (4) 12-DEC-1989 08:43:27.29 DINGDONG "Implement look-aside lists"B (3A2) 12-DEC-1989 13:10:01.00 PORTER "Fix some bad comments"< Latest generation for stream X4PM, X4PN, X4PO9 (3A1) 12-DEC-1989 13:10:01.56 PORTER "Add comments"I (3) 12-DEC-1989 08:37:31.18 SMITH "Implement look-down algorithm"6 Latest generation for stream X4PK, X4PLK (2) 12-DEC-1989 08:35:54.47 JONES "Implement new look-up algorithm"H Latest generation for stream V5.2, V5.3, V5.4, X4PJ_BIRCHG (1) 9-DEC-1989 20:34:02.13 JONES "Initial generation of module" VSC>

h

3.4 Displaying Differences between Generations

7VSC provides a DIFFERENCES command that determines and =displays the differences between the texts of any two module Ggenerations. This is in addition to the ability to display differences Ebetween module generations through the REVIEW REPLACEMENT subsystem. AThe DIFFERENCES command fetches two specified generations into a Gscratch directory and runs the DCL DIFFERENCES command in a subprocess ?to display the differences between the two generations on your Aterminal. The following example shows how to use the DIFFERENCES command:

"
5VSC> DIFFERENCES [FACIL]MOD.TYP;5 [FACIL]MOD.TYP;2

FThis example fetches generation 5 of module MOD.TYP in facility FACIL Fand generation 2 of the same module, computes the differences between Ethose two files, and displays the differences. These generations are Afor your default development stream. The second parameter can be Gabbreviated to just a semicolon and the generation number (such as ;2) Cif the module name is the same for both generations. If the second Dparameter is omitted entirely, the specified generation is compared Bwith the immediately preceding generation in the same development Dstream. If the second parameter is omitted in the previous example, Cgeneration 5 is thus compared with generation 4. Zero and negative Bgeneration numbers are also allowed; these generation numbers are Grelative to the latest generation of the module for the stream. If the Fgeneration number is omitted, generation 0 (the latest generation) is assumed by default.

?The generations can also be identified by their CMS generation Cexpressions (such as 10A2) with the /GENERATION qualifier. If both Fgenerations are generations of the same module (the usual case), this !form of the qualifier is allowed:

"
9VSC> DIFFERENCES [FACIL]MOD.TYP/GENERATION=(10A2,11B1)

FThis command compares the generations of [FACIL]MOD.TYP identified by -the CMS generation expressions 10A2 and 11B1.

>If you do not specify the /GENERATION qualifier, VSC uses the Especified (or default) generation numbers and assumes the generation Cnumbers to be relative to your default development stream. You can Especify that you want to compare generations from other streams with the /STREAM qualifier:

"
1VSC> DIFFERENCES [FACIL]MOD.TYP/STREAM=PHOENIX

GThis command compares the two most recent generations of the specified @module in stream PHOENIX. To compare generations from different Fstreams, you can either specify the /STREAM qualifier on both command Gparameters or you can use this special form of the qualifier with just one parameter:

"
8VSC> DIFFERENCES [FACIL]MOD.TYP/STREAM=(V5.4,PHOENIX)

>This command computes the differences between the most recent 7generations of the module for streams V5.4 and PHOENIX.

AThe DIFFERENCES command also accepts all qualifiers that the DCL HDIFFERENCES command accepts. These qualifiers are simply passed through <to the subprocess that runs the OpenVMS DIFFERENCES utility.

ETo perform its action, the DIFFERENCES command fetches the specified Ggenerations into a scratch directory. If you have defined logical name :VDE$SCRATCH, VSC uses the directory given by that logical Dname as the scratch directory. If this logical name is not defined, =VSC creates a subdirectory VDE$SCRATCH.DIR (unless it exists ?already) in directory SYS$SCRATCH and stores the files in that Asubdirectory. (By default, SYS$SCRATCH is your login directory.) 8VSC then spawns a subprocess to run the DCL DIFFERENCES =command and display the differences. VSC deletes the fetched Hfiles at the end of the command unless you specify the /KEEP qualifier. DThe difference output goes to your terminal by default, but you can /direct it to a file with the /OUTPUT qualifier.

mTable 3-4 lists the qualifiers for the DIFFERENCES command and describes their functions.

p
Table 3-4 Qualifiers to the DIFFERENCES command
+ /GENERATION=gen-expr
H Specifies that the module generation that has the CMS generation expression given by theL gen-expr parameter be compared. If this qualifier is N omitted, the command uses the generation given by the generation number N on the module-name parameter. If both this qualifier and the generation H number are omitted, the command uses the latest generation of the 2 module for the specified development stream.
/KEEP
N Specifies that the fetched and compared module generations be retained L after the command completes. If this qualifier is omitted, the files J containing those generations are deleted after the differences are computed.
* /STREAM=stream-name
M Specifies that the generation to be compared should be taken from the & development stream given by theL stream-name parameter. If this qualifier is omitted, J the generation is taken from your default stream unless you use the /GENERATION qualifier.
" /CHANGE_BAR
) /COMMENT_DELIMITER
/IGNORE
+ /MAXIMUM_DIFFERENCES
/MATCH
/MERGED
/MODE
/NUMBER
/NONUMBER
/OUTPUT
/PARALLEL
! /SEPARATED
/SLP
/WIDTH
/WINDOW
B These qualifiers are passed through to the spawned OpenVMS F DIFFERENCES command without change. See the description of the ! DIFFERENCES command in theH OpenVMS DCL Dictionary manual for a description of these & qualifiers and their parameters.
_

**Table 3-4 Qualifiers to the DIFFERENCES command**
+ /GENERATION=gen-expr
	H Specifies that the module generation that has the CMS generation expression given by theL gen-expr parameter be compared. If this qualifier is N omitted, the command uses the generation given by the generation number N on the module-name parameter. If both this qualifier and the generation H number are omitted, the command uses the latest generation of the 2 module for the specified development stream.
/KEEP
	N Specifies that the fetched and compared module generations be retained L after the command completes. If this qualifier is omitted, the files J containing those generations are deleted after the differences are computed.
* /STREAM=stream-name
	M Specifies that the generation to be compared should be taken from the & development stream given by theL stream-name parameter. If this qualifier is omitted, J the generation is taken from your default stream unless you use the /GENERATION qualifier.
" /CHANGE_BAR ) /COMMENT_DELIMITER /IGNORE + /MAXIMUM_DIFFERENCES /MATCH /MERGED /MODE /NUMBER /NONUMBER /OUTPUT /PARALLEL ! /SEPARATED /SLP /WIDTH /WINDOW
	B These qualifiers are passed through to the spawned OpenVMS F DIFFERENCES command without change. See the description of the ! DIFFERENCES command in theH OpenVMS DCL Dictionary manual for a description of these & qualifiers and their parameters.

3.5 Displaying Development Streams

HThe SHOW STREAM command lists information about the development streams Fdefined in the source control database. Streams include past versions =of OpenVMS, versions currently under development, build base Glevels, and off-to-the-side development streams. The following example 2illustrates the syntax of the SHOW STREAM command:

"
VSC> SHOW STREAM PHOENIX

FThis example displays information about stream PHOENIX. If the stream Aname is omitted, the command shows information about all streams Fdefined in the database. With this command, you can specify a list of Gstream names separated by commas, and you can use the asterisk (*) and Fpercent sign (%) wildcard characters in the stream names. All streams /that match the wildcard patterns are displayed.

pTable 3-5 lists the qualifiers for the SHOW STREAM command and describes their functions.

s
Table 3-5 Qualifiers to the SHOW STREAM command
/BRIEF
/NORMAL
/FULL
K Determine the type of information displayed for each stream. /BRIEF E displays the name of each stream that matches the stream-name H parameters. /NORMAL displays the name and remark string for each L stream; this is the default output. /FULL displays all attributes of O each stream, including its name, creation date and time, reviewers, and remark string.
/OPEN
/FROZEN
/CLOSED
M Displays only those streams with the specified status. /OPEN displays K only those streams that are open for replacements. /FROZEN displays O only those streams that are "frozen" so that replacements are L not currently possible. /CLOSED displays only those streams that are I permanently closed against replacements. If you omit all of these A qualifiers, VSC displays all streams regardless of status.
' /OUTPUT=filespec
J Directs the printed output of this command to a specified file. TheJ filespec parameter specifies the name of the file. C VSC creates a new file with that name, directs the command's N print output to that file, and prints nothing on your terminal. If this ? qualifier is omitted, all output appears on the terminal.
! /SUCCESSOR
L Shows the full stream successor chain for each displayed development F stream. This information shows to what streams changes will be & propagated from a given stream.
/TOTAL
N Shows the total number of streams that match the specified stream-name N parameters. Only the total count is shown; other information about the ' individual streams is not shown.

**Table 3-5 Qualifiers to the SHOW STREAM command**
/BRIEF /NORMAL /FULL
	K Determine the type of information displayed for each stream. /BRIEF E displays the name of each stream that matches the stream-name H parameters. /NORMAL displays the name and remark string for each L stream; this is the default output. /FULL displays all attributes of O each stream, including its name, creation date and time, reviewers, and remark string.
/OPEN /FROZEN /CLOSED
	M Displays only those streams with the specified status. /OPEN displays K only those streams that are open for replacements. /FROZEN displays O only those streams that are "frozen" so that replacements are L not currently possible. /CLOSED displays only those streams that are I permanently closed against replacements. If you omit all of these A qualifiers, VSC displays all streams regardless of status.
' /OUTPUT=filespec
	J Directs the printed output of this command to a specified file. TheJ filespec parameter specifies the name of the file. C VSC creates a new file with that name, directs the command's N print output to that file, and prints nothing on your terminal. If this ? qualifier is omitted, all output appears on the terminal.
! /SUCCESSOR
	L Shows the full stream successor chain for each displayed development F stream. This information shows to what streams changes will be & propagated from a given stream.
/TOTAL
	N Shows the total number of streams that match the specified stream-name N parameters. Only the total count is shown; other information about the ' individual streams is not shown.

<Examples

CThis is an example of the normal output of the SHOW STREAM command:

"
VSC> SHOW STREAM>Stream MUSHROOM "Maintenance stream, formerly V5.4-1"KStream PHOENIX "V6.0 (?) release stream (née Thunderbolt)"2Stream V4.4 "SDC release of VMS V4.4"2Stream V5.0 "SDC release of VMS V5.0"2Stream V5.2 "SDC release of VMS V5.2"2Stream V5.4 "SDC release of VMS V5.4"VSC>

CThe following is an example of the brief output of the SHOW STREAM command:

"
VSC> SHOW STREAM/BRIEF *Stream MUSHROOMStream PHOENIXStream V4.4Stream V5.0Stream V5.2Stream V5.4VSC>

GThe following example shows the full output of the SHOW STREAM command for one stream:

"
!VSC> SHOW STREAM/FULL MUSHROOMStream MUSHROOM, Stream created on 19-OCT-1990 10:37:00.77, Stream created by user SMITH (Jane Smith). Stream owner is user SNURD (Mortimer Snurd) Parent stream is V5.4 Successor streams: PHOENIX0 Stream is part of the main development thread Stream cannot be deleted% CMS class is maintained for stream% Replacements are queued for stream Stream is open for checkins Remark: V5.4-1 release class VSC>

:This example shows the effect of the /SUCCESSOR qualifier:

"
#VSC> SHOW STREAM V5.3 /SUCCESSORStream V5.3 Successor chains:L V5.3 -> V5.3-1 -> V5.3-2 -> V5.4 -> MUSHROOM -> PHOENIX VSC>

PreviousW

NextZ

Contents\

Index

VDEGuide to Using VDE

3.3 Displaying Generation Histories

3.4 Displaying Differences between Generations

3.5 Displaying Development Streams

VDE
Guide to Using
VDE