| Previous [ | Contents ] | Index |
F This SHOW MODULE command displays the names and remark strings of all B source modules in the default facility. This is an example of the normal SHOW MODULE output.
| #2 |
|---|
VDE„ SHOW MODULE/BRIEF FOO Module [CODE]FOO.MAR Module [CODE]FOO.EXE Module [CODE]FOO.LIS Module [CODE]FOO.OBJ VDE„ |
F This example illustrates the brief form of the SHOW MODULE output. It E displays the names of all modules named FOO in the default facility. 3 Both source modules and derived modules are listed.
| #3 |
|---|
$ VDE„ SHOW MODULE [CODE]MOD1.FOR/FULL Module [CODE]MOD1.FOR 6 Module added to database on 4-APR-1989 14:58:39.666 Module added to database by user SMITH (Jane Smith) Module is a source module Module cannot be deleted 1 History information is not provided by default History string: C #B/ Notes information is not provided by default Notes string: C #G Note position: 81 Remark: Test module VDE„ |
G This example illustrates the output of the /FULL qualifier to the SHOW E MODULE command. The module name is fully specified on the command in F this case, including the facility name, the module name, and the type name.
| #4 |
|---|
$ VDE„ SHOW MODULE/TOTAL/SOURCE [RMS]*+ Number of modules matching name [RMS]*.*: 7 VDE„ |
G In this example, the /TOTAL qualifier shows the total number of source modules in facility RMS.
Displays your VDE privileges.
SHOW PRIVILEGES
None.
0 The VDE privileges you have in your current VDE : session determine the VDE commands (and in some cases the H command qualifiers) you are allowed to use. The SHOW PRIVILEGES command E displays the privileges you have in the current session. Optionally, C the command also shows your default privileges and your authorized privileges.B For a list of all privilege names and their meanings, see the SET PRIVILEGES command.
/BRIEF (default)
/FULL
C Specifies whether to show all privileges or only those set for the H current session. The /BRIEF qualifier shows the privileges set for your G current session. The /FULL qualifier shows the privileges set for your G current session as well as your default privileges (the privileges you = get automatically at the start of each VDE session) and your G authorized privileges (the privileges you are allowed to set using the D SET PRIVILEGES command). If you do not specify a qualifier with the F SHOW PRIVILEGES command, you receive the information displayed by the /BRIEF qualifier.+ Of /BRIEF and /FULL, /BRIEF is the default.
| #1 |
|---|
VDE„ SHOW PRIVILEGES Currently set privileges: / BUILD CREFAC CREGRP CREMOD CRESTEP RESREP VDE„ |
@ This example shows the brief form of the SHOW PRIVILEGES output.
| #2 |
|---|
VDE„ SHOW PRIVILEGES/FULL Currently set privileges: / BUILD CREFAC CREGRP CREMOD CRESTEP RESREP Default privileges: E BUILD CRECTX CREFAC CREGRP CREMOD CRESTEP CREUSR CRESTRM RESREP Authorized privileges:E BUILD CRECTX CREFAC CREGRP CREMOD CRESTEP CREUSR CRESTRM FROZEN RESREP USERNAME VDE„ |
@ This example shows the use of the /FULL qualifier with the SHOW PRIVILEGES command.
B Displays the names and attributes of one or more specified queued replacements.
5SHOW REPLACEMENT [rep-name [, rep-name...]]
rep-name
G The name of a queued replacement whose attributes are to be displayed. G You can display more than one replacement using wildcard characters in A the replacement name. The percent sign (%) in a replacement name A matches any single character in the position it occupies and the @ asterisk (*) matches zero or more characters in the position it H occupies. Those replacements whose names match the wildcard pattern are displayed.F Do not specify the rep-name parameter if you use the /IDENTIFICATION qualifier.
B If you specify neither a replacement name nor the /IDENTIFICATION 0 qualifier, VDE displays all replacements in the VDE database.
E Depending on the qualifiers you select, the SHOW REPLACEMENT command H displays either a one-line summary for each specified queued replacement G or all database information for each replacement. The command can also = show the total number of replacements that match a specified replacement name.
/ACCEPTED
/REJECTED
/IN_REVIEW
/NOT_REVIEWED
@ Specify that only those queued replacements with certain review > statuses be displayed. The /ACCEPTED qualifier displays those @ replacements accepted by all reviewers. The /REJECTED qualifier C displays those replacements rejected by at least one reviewer. The F /IN_REVIEW qualifier displays those replacements that are accepted by B at least one reviewer but are not yet accepted or rejected by all G reviewers. The /NOT_REVIEWED qualifier displays those replacements not & accepted or rejected by any reviewers.E If one or more of these qualifiers are specified, those replacements B that have one of the specified status values are displayed. These C qualifiers can thus be used in combination to show replacements of @ several different status values. If all of these qualifiers are < omitted, VDE displays all replacements regardless of status.
/BEFORE=date-time
F Displays only those replacements queued before the specified date and > time. The date and time can be stated in the standard OpenVMS E date-time format or can be one of the following keywords: YESTERDAY, E TODAY, or TOMORROW. If you use a space to separate the date from the H 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
/MODULE
E Determines the information that is displayed about each replacement. G The /BRIEF qualifier displays a one-line summary for each replacement. D The /FULL qualifier displays all available database information for G each replacement. The /MODULE qualifier displays the replacement name, G the staging directory, the module list, and the remark string for each replacement.4 Of /BRIEF, /FULL and /MODULE, /BRIEF is the default.
/HISTORY
E Specifies that replacement history be displayed. Replacement history H consists of all past replacements, both immediate and queued, that have = already been performed; it does not include currently queued H replacements. Replacement history allows you to see a historical record D of all past modifications to your software system. This information ? complements the historical information available from the SHOW F GENERATION command. When used with the /IDENTIFICATION qualifier, the ? /HISTORY qualifier displays a list of all past replacements in chronological order.; If you omit the /HISTORY qualifier, VDE displays currently queued replacements only.
/MODULE
0 Displays all modules comprising the replacement.!/IDENTIFICATION=id-range
F Specifies that the replacements with the unique Replacement Ids given H by the id-range parameter be displayed. Do not specify D the rep-name parameter when you use this qualifier.9 VDE assigns a unique Replacement Id to each immediate or - queued replacement into the VDE library. VDE A assigns Replacement Ids in chronological order so that the first F replacement into the library has Id value 1, the next has Id value 2, G and so on. When you use this qualifier, all replacements that fit your G other selection criteria and that have Id values in the range given by C the id-range parameter are displayed in ascending A order by Replacement Id. This is the same as chronological order.
G The id-range parameter can be a single integer value, D a range of integers, or a wildcard character. If the parameter is a 9 single integer (for example, /IDENT=5), VDE displays the E replacement with that Replacement Id. If the parameter is a range of ? integers (specified as two integers separated by a colon as in < /IDENT=3:5), VDE displays the replacements with Ids in that B range. Finally, if the id-range parameter is the ; asterisk wildcard character (as in /IDENT=*), VDE displays F all replacements. To be displayed, each replacement must also fit all : selection criteria that you specify with other qualifiers.
0 If you specify a zero or negative number in the D id-range parameter, that number is relative to the = largest Replacement Id value for the VDE library (the latest H replacement). For example, if the latest replacement has Replacement Id A 250, then /IDENT=0 is equivalent to /IDENT=250 and /IDENT=--1 is equivalent to /IDENT=249.
F The /IDENTIFICATION qualifier is especially useful when used with the E /HISTORY qualifier because then it displays all past replacements in chronological order.
/IN_REVIEW
G Displays all replacement component modules presently undergoing review./NOT_REVIEWED
@ Displays all replacement component modules presently unreviewed./OUTPUT=file-spec
D Directs the printed output of this command to a specified file. The E file-spec parameter specifies the name of the file. = VDE creates a new file with that name, directs the command's H print output to that file, and prints nothing on your terminal. If this 9 qualifier is omitted, all output appears on the terminal./REJECTED
H Displays all modules comprising the replacement that have been rejected./REVIEWER[=username]
C Specifies that only those replacements for which a given user is a E reviewer be displayed. The username parameter gives 7 the OpenVMS username of that reviewer. If you omit the G username parameter, only those replacements for which C you are a reviewer are displayed. If you omit the whole qualifier, - replacements for all reviewers are displayed./SINCE=date-time
G Displays only those replacements queued at or after the specified date : and time. The date and time can be stated in the standard 8 OpenVMS date-time format or can be one of the following H keywords: YESTERDAY, TODAY, or TOMORROW. If you use a space to separate H the date from the time, remember to enclose the entire date-time string ; in double quotes. For further information about specifying 7 OpenVMS date-time format, see the OpenVMS DCL Concepts./STREAM[=stream-name]
? Specifies that only those queued replacements that are for the G development stream given by the stream-name parameter H be displayed. If the stream-name parameter is omitted, F replacements for the default development stream are displayed. If the G whole qualifier is omitted, replacements for all streams are displayed./TOTAL
H Shows the total number of replacements that match each parameter. Other G information about the individual replacements is not shown. A separate @ count is provided for each rep-name parameter. F Wildcard characters are usually used in the parameter when using this qualifier./USERNAME[=username]
A Specifies that only those replacements queued by a given user be = displayed. The username parameter gives the / OpenVMS username of that user. If you omit the D username parameter, only your own replacements are G displayed. If you omit the whole qualifier, replacements queued by all users are displayed.
| #1 |
|---|
VDE„ SHOW REPLACEMENT I Replacement ANDERSON-1 BIRCH 26-JUN-1990 ANDERSON Accepted M Replacement ANDERSON-2 BIRCH 27-JUN-1990 ANDERSON Not reviewed I Replacement SORT_BUG V2.0-UPD 27-JUN-1990 CHURCHILL Accepted I Replacement SMITH-1 V2.0 27-JUN-1990 SMITH Rejected VDE„ |
E This example shows the brief output of the SHOW REPLACEMENT command. F This output shows the replacement name, the stream name, the date the H replacement was queued, the username of the user who queued it, and its status.
| #2 |
|---|
" VDE„ SHOW REPLACEMENT/FULL SMITH-1 Queued replacement SMITH-10 Replacement queued by user SMITH (Jane Smith)0 Replacement queued on 27-JUN-1990 15:10:27.20! Replacement is for stream V2.0 " Unique replacement number is 16Q Replacement staging directory is DEV$:[LIBROOT.VDE$STAGE.VDE$STG_0.VDE$REP_16] Reservations in replacement: ( Reservation 1 of [BUILD_TEST]C.B32( Reservation 1 of [BUILD_TEST]D.B32& Replacement contains 2 reservations& Replacement review status: Rejected# Remark: Add mumble-fratz feature VDE„ |
D This example shows the full output of the SHOW REPLACEMENT command, ? which includes all available information about the replacement.
| #3 |
|---|
$ VDE„ SHOW REPLACEMENT SMITH-1/MODULE Queued replacement SMITH-1Q Replacement staging directory is DEV$:[LIBROOT.VDE$STAGE.VDE$STG_0.VDE$REP_16] Reservations in replacement: ( Reservation 1 of [BUILD_TEST]C.B32( Reservation 1 of [BUILD_TEST]D.B32& Replacement contains 2 reservations# Remark: Add mumble-fratz feature VDE„ |
= This example illustrates the output of the /MODULE qualifier.
| #4 |
|---|
VDE„ SHOW REPLACEMENT/TOTAL ) Number of replacements matching name *: 4 VDE„ |
C This example shows that the /TOTAL qualifier can display the total . number of queued replacements in the database.
Displays module reservations.
5SHOW RESERVATION [mod-name [, mod-name...]]
mod-name
D The name of a source module whose reservation is to be displayed. A E module name consists of an optional facility name enclosed in square H brackets, a module name, and an optional type name preceded by a period E (for example, [FACIL]MOD1.MAR). If the facility name is omitted, the G default facility is assumed. If the type name is omitted, reservations B for all modules with the specified name in the given facility are displayed.E You can display reservations for more than one module using wildcard B characters in any of the three components of the module name. The H percent sign (%) in a name matches any single character in the position H it occupies and the asterisk (*) matches zero or more characters in the F position it occupies. Reservations for the source modules whose names ) match the wildcard pattern are displayed.
E You can also display reservations for multiple modules by specifying G the name of a source group instead of a module name. Source groups are D created with the CREATE GROUP command. If you specify a group name, ? each reservation for a module that is a member of the group is displayed.
9 If you omit the mod-name parameter, VDE : displays all module reservations for the default facility.
D The SHOW RESERVATION command displays all existing reservations and F queued reservation requests for a specified set of modules or for all F modules in the default facility. A module reservation is created with E the RESERVE command and gives you the exclusive right to modify that B module. A reservation is terminated with the REPLACE or UNRESERVE command.D By default, the SHOW RESERVATION command shows reservations for all G development streams, but the /STREAM qualifier lets you see only those E reservations for a certain stream. Likewise, by default, the command G shows reservations for all users, but the /USERNAME qualifier lets you D see only those reservations that belong to a specific user, such as A yourself. Other qualifiers, such as /BEFORE and /SINCE, lets you 8 additionally restrict the set of reservations displayed.
/BEFORE=date-time
G Displays only those reservations created before the specified date and > time. The date and time can be stated in the standard OpenVMS E date-time format or can be one of the following keywords: YESTERDAY, E TODAY, or TOMORROW. If you use a space to separate the date from the H 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
E Determines the type of information displayed about each reservation. F The /BRIEF qualifier displays the reservation identifier, the name of F the reserved module, the reserving user, the date of the reservation, F and the stream in which the module is reserved. This display normally H fits on one line. The /FULL qualifier displays all database information ? about the reservation; this display requires several lines per reservation./OUTPUT=file-spec
D Directs the printed output of this command to a specified file. The E file-spec parameter specifies the name of the file. = VDE creates a new file with that name, directs the command's H print output to that file, and prints nothing on your terminal. If this 9 qualifier is omitted, all output appears on the terminal./SESSION=session-name
B Sessions are used to logically group a set of module reservations H together, typically to group all modules related to a particular source A code alteration or enhancement together. It allows all component A modules reserved to be treated as a single entity for subsequent G replacement operations. A session also allows additional modules to be C reserved and incorporated into an existing session at a later time.E Displays only those reservations that are members of the reservation E session given by the session-name parameter. If you A specify this qualifier, do not specify mod-name + parameters on the SHOW RESERVATION command.
H Sessions can be manipulated via the REPLACE, RESERVE, UNRESERVE, MODIFY ? SESSION, MODIFY RESERVATION, CREATE MODULE, and CANCEL SESSION H commands. And modules created by CREATE MODULE (on a queued-replacement G stream) and reserved via RESERVE can be combined into the same session.
/SINCE=date-time
F Displays only those reservations created after the specified date and > time. The date and time can be stated in the standard OpenVMS E date-time format or can be one of the following keywords: YESTERDAY, E TODAY, or TOMORROW. If you use a space to separate the date from the H 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]
G Displays only those reservations that were created for the development H stream given by the stream-name parameter. If you omit 5 the stream-name parameter, VDE only F displays reservations created for your current default stream. If you < omit the whole qualifier, VDE displays reservations for all streams./TOTAL
G Shows the total number of reservations that match the specified module < names and usernames. Other information about the individual A reservations is not shown. A separate count is provided for each $ mod-name parameter./USERNAME[=username]
@ Specifies the OpenVMS username of a user whose reservations are > to be shown. If this qualifier is specified, only that user's F reservations are shown. If the username parameter is F omitted, only your own reservations are shown. If the whole qualifier 1 is omitted, reservations for all users are shown.
| #1 |
|---|
VDE„ SHOW RESERVATION FOO.MAR I Reservation 1 of [FACIL]FOO.MAR SMITH 23-MAR-1989 V5.4 I Reservation 1 of [FACIL]FOO.MAR JONES 24-MAR-1989 V5.5 VDE„ |
H This command diplays the reservations for module FOO.MAR in the current E default facility, FACIL. The output shows that users SMITH and JONES D have reserved module FOO.MAR in streams V5.4 and V5.5, respectively.
| #2 |
|---|
VDE„ SHOW RESERVATION/FULL Reservation 1 of [FACIL]FOO.MAR 1 Reservation created on 23-MAR-1989 18:09:51.80 1 Reservation created by user SMITH (Jane Smith) 1 Generation 29 (27B2) reserved from stream V5.4 8 Expected generation expression at replacement is 27B3& Concurrent reservations are allowed Remark: Fix QAR 23 again Reservation 1 of [FACIL]MOD1.PAS1 Reservation created on 24-MAR-1989 18:50:33.18 1 Reservation created by user JONES (John Jones) / Generation 15 (15) reserved from stream V5.5 6 Expected generation expression at replacement is 16& Concurrent reservations are allowed$ Remark: Implement whistle feature VDE„ |
A This example shows the output of the /FULL qualifier. Because no F module-name parameter is specified, the command displays reservations 0 for all modules in the current default facility.
| #3 |
|---|
( VDE„ SHOW RESERVATION/USERNAME=SMITH FOOI Reservation 1 of [FACIL]FOO.MAR SMITH 23-MAR-1989 V5.4 VDE„ |
H In this example, only reservations of module FOO.MAR for user SMITH are F displayed. User SMITH has one outstanding reservation (reservation 1) of this module.
| Previous X | Next[ | Contents ] | Index |