This SHOW MODULE command displays the names and remark strings of all 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„

This example illustrates the brief form of the SHOW MODULE output. It displays the names of all modules named FOO in the default facility. Both source modules and derived modules are listed.

VDE„ SHOW MODULE [CODE]MOD1.FOR/FULL
Module [CODE]MOD1.FOR
   Module added to database on  4-APR-1989 14:58:39.66
   Module added to database by user SMITH (Jane Smith)
   Module is a source module
   Module cannot be deleted
   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„
      

This example illustrates the output of the /FULL qualifier to the SHOW MODULE command. The module name is fully specified on the command in this case, including the facility name, the module name, and the type name.

VDE„ SHOW MODULE/TOTAL/SOURCE [RMS]*
Number of modules matching name [RMS]*.*: 7
VDE„
      

In this example, the /TOTAL qualifier shows the total number of source modules in facility RMS.

Displays your VDE privileges.

Format

SHOW PRIVILEGES

Parameters

None.

Description

The VDE privileges you have in your current VDE session determine the VDE commands (and in some cases the command qualifiers) you are allowed to use. The SHOW PRIVILEGES command displays the privileges you have in the current session. Optionally, the command also shows your default privileges and your authorized privileges.

For a list of all privilege names and their meanings, see the SET PRIVILEGES command.

Qualifiers

/BRIEF (default)

/FULL

Specifies whether to show all privileges or only those set for the current session. The /BRIEF qualifier shows the privileges set for your current session. The /FULL qualifier shows the privileges set for your current session as well as your default privileges (the privileges you get automatically at the start of each VDE session) and your authorized privileges (the privileges you are allowed to set using the SET PRIVILEGES command). If you do not specify a qualifier with the SHOW PRIVILEGES command, you receive the information displayed by the /BRIEF qualifier.

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

Examples

VDE„ SHOW PRIVILEGES
Currently set privileges:
      BUILD CREFAC CREGRP CREMOD CRESTEP RESREP
VDE„
      

This example shows the brief form of the SHOW PRIVILEGES output.

VDE„ SHOW PRIVILEGES/FULL
Currently set privileges:
      BUILD CREFAC CREGRP CREMOD CRESTEP RESREP
Default privileges:
      BUILD CRECTX CREFAC CREGRP CREMOD CRESTEP CREUSR CRESTRM RESREP
Authorized privileges:
      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.

Displays the names and attributes of one or more specified queued replacements.

Format

SHOW REPLACEMENT [rep-name [, rep-name...]]

Parameter

rep-name

The name of a queued replacement whose attributes are to be displayed. You can display more than one replacement using wildcard characters in the replacement name. The percent sign (%) in a replacement name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. Those replacements whose names match the wildcard pattern are displayed.

Do not specify the rep-name parameter if you use the /IDENTIFICATION qualifier.

If you specify neither a replacement name nor the /IDENTIFICATION qualifier, VDE displays all replacements in the VDE database.

Description

Depending on the qualifiers you select, the SHOW REPLACEMENT command displays either a one-line summary for each specified queued replacement or all database information for each replacement. The command can also show the total number of replacements that match a specified replacement name.

Qualifiers

/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 displays those replacements rejected by at least one reviewer. The /IN_REVIEW qualifier displays those replacements that are accepted by at least one reviewer but are not yet accepted or rejected by all reviewers. The /NOT_REVIEWED qualifier displays those replacements not accepted or rejected by any reviewers.

If one or more of these qualifiers are specified, those replacements that have one of the specified status values are displayed. These 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

Displays only those replacements queued 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

/MODULE

Determines the information that is displayed about each replacement. The /BRIEF qualifier displays a one-line summary for each replacement. The /FULL qualifier displays all available database information for each replacement. The /MODULE qualifier displays the replacement name, the staging directory, the module list, and the remark string for each replacement.

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

/HISTORY

Specifies that replacement history be displayed. Replacement history consists of all past replacements, both immediate and queued, that have already been performed; it does not include currently queued replacements. Replacement history allows you to see a historical record of all past modifications to your software system. This information complements the historical information available from the SHOW 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

Displays all modules comprising the replacement.

/IDENTIFICATION=id-range

Specifies that the replacements with the unique Replacement Ids given by the id-range parameter be displayed. Do not specify the rep-name parameter when you use this qualifier.

VDE assigns a unique Replacement Id to each immediate or queued replacement into the VDE library. VDE assigns Replacement Ids in chronological order so that the first replacement into the library has Id value 1, the next has Id value 2, and so on. When you use this qualifier, all replacements that fit your other selection criteria and that have Id values in the range given by the id-range parameter are displayed in ascending order by Replacement Id. This is the same as chronological order.

The id-range parameter can be a single integer value, a range of integers, or a wildcard character. If the parameter is a single integer (for example, /IDENT=5), VDE displays the 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 range. Finally, if the id-range parameter is the asterisk wildcard character (as in /IDENT=*), VDE displays all replacements. To be displayed, each replacement must also fit all selection criteria that you specify with other qualifiers.

If you specify a zero or negative number in the id-range parameter, that number is relative to the largest Replacement Id value for the VDE library (the latest replacement). For example, if the latest replacement has Replacement Id 250, then /IDENT=0 is equivalent to /IDENT=250 and /IDENT=--1 is equivalent to /IDENT=249.

The /IDENTIFICATION qualifier is especially useful when used with the /HISTORY qualifier because then it displays all past replacements in chronological order.

/IN_REVIEW

Displays all replacement component modules presently undergoing review.

/NOT_REVIEWED

Displays all replacement component modules presently unreviewed.

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

/REJECTED

Displays all modules comprising the replacement that have been rejected.

/REVIEWER[=username]

Specifies that only those replacements for which a given user is a reviewer be displayed. The username parameter gives the OpenVMS username of that reviewer. If you omit the username parameter, only those replacements for which you are a reviewer are displayed. If you omit the whole qualifier, replacements for all reviewers are displayed.

/SINCE=date-time

Displays only those replacements queued at or 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 that only those queued replacements that are for the development stream given by the stream-name parameter be displayed. If the stream-name parameter is omitted, replacements for the default development stream are displayed. If the whole qualifier is omitted, replacements for all streams are displayed.

/TOTAL

Shows the total number of replacements that match each parameter. Other information about the individual replacements is not shown. A separate count is provided for each rep-name parameter. Wildcard characters are usually used in the parameter when using this qualifier.

/USERNAME[=username]

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 username parameter, only your own replacements are displayed. If you omit the whole qualifier, replacements queued by all users are displayed.

Examples

VDE„ SHOW REPLACEMENT
Replacement ANDERSON-1      BIRCH       26-JUN-1990 ANDERSON     Accepted
Replacement ANDERSON-2      BIRCH       27-JUN-1990 ANDERSON     Not reviewed
Replacement SORT_BUG        V2.0-UPD    27-JUN-1990 CHURCHILL    Accepted
Replacement SMITH-1         V2.0        27-JUN-1990 SMITH        Rejected
VDE„
      

This example shows the brief output of the SHOW REPLACEMENT command. This output shows the replacement name, the stream name, the date the replacement was queued, the username of the user who queued it, and its status.

VDE„ SHOW REPLACEMENT/FULL SMITH-1
Queued replacement SMITH-1
   Replacement queued by user SMITH (Jane Smith)
   Replacement queued on 27-JUN-1990 15:10:27.20
   Replacement is for stream V2.0
   Unique replacement number is 16
   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„
      

This example shows the full output of the SHOW REPLACEMENT command, which includes all available information about the replacement.

VDE„ SHOW REPLACEMENT SMITH-1/MODULE
Queued replacement SMITH-1
   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.

VDE„ SHOW REPLACEMENT/TOTAL
Number of replacements matching name *: 4
VDE„
      

This example shows that the /TOTAL qualifier can display the total number of queued replacements in the database.

Displays module reservations.

Format

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

Parameter

mod-name

The name of a source module whose reservation is to be displayed. A module name consists of an optional facility name enclosed in square brackets, a module name, and an optional type name preceded by a period (for example, [FACIL]MOD1.MAR). If the facility name is omitted, the default facility is assumed. If the type name is omitted, reservations for all modules with the specified name in the given facility are displayed.

You can display reservations for more than one module 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. Reservations for the source modules whose names match the wildcard pattern are displayed.

You can also display reservations for multiple modules by specifying the name of a source group instead of a module name. Source groups are 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.

If you omit the mod-name parameter, VDE displays all module reservations for the default facility.

Description

The SHOW RESERVATION command displays all existing reservations and queued reservation requests for a specified set of modules or for all modules in the default facility. A module reservation is created with the RESERVE command and gives you the exclusive right to modify that module. A reservation is terminated with the REPLACE or UNRESERVE command.

By default, the SHOW RESERVATION command shows reservations for all development streams, but the /STREAM qualifier lets you see only those reservations for a certain stream. Likewise, by default, the command shows reservations for all users, but the /USERNAME qualifier lets you see only those reservations that belong to a specific user, such as yourself. Other qualifiers, such as /BEFORE and /SINCE, lets you additionally restrict the set of reservations displayed.

Qualifiers

/BEFORE=date-time

Displays only those reservations 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 type of information displayed about each reservation. The /BRIEF qualifier displays the reservation identifier, the name of the reserved module, the reserving user, the date of the reservation, and the stream in which the module is reserved. This display normally fits on one line. The /FULL qualifier displays all database information about the reservation; this display requires several lines per reservation.

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

/SESSION=session-name

Sessions are used to logically group a set of module reservations together, typically to group all modules related to a particular source code alteration or enhancement together. It allows all component modules reserved to be treated as a single entity for subsequent replacement operations. A session also allows additional modules to be reserved and incorporated into an existing session at a later time.

Displays only those reservations that are members of the reservation session given by the session-name parameter. If you specify this qualifier, do not specify mod-name parameters on the SHOW RESERVATION command.

Sessions can be manipulated via the REPLACE, RESERVE, UNRESERVE, MODIFY SESSION, MODIFY RESERVATION, CREATE MODULE, and CANCEL SESSION commands. And modules created by CREATE MODULE (on a queued-replacement stream) and reserved via RESERVE can be combined into the same session.

/SINCE=date-time

Displays only those reservations 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]

Displays only those reservations that were created for the development stream given by the stream-name parameter. If you omit the stream-name parameter, VDE only displays reservations created for your current default stream. If you omit the whole qualifier, VDE displays reservations for all streams.

/TOTAL

Shows the total number of reservations that match the specified module names and usernames. Other information about the individual 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 reservations are shown. If the username parameter is omitted, only your own reservations are shown. If the whole qualifier is omitted, reservations for all users are shown.

Examples

VDE„ SHOW RESERVATION FOO.MAR
Reservation 1 of [FACIL]FOO.MAR             SMITH        23-MAR-1989 V5.4
Reservation 1 of [FACIL]FOO.MAR             JONES        24-MAR-1989 V5.5
VDE„
      

This command diplays the reservations for module FOO.MAR in the current default facility, FACIL. The output shows that users SMITH and JONES have reserved module FOO.MAR in streams V5.4 and V5.5, respectively.

VDE„ SHOW RESERVATION/FULL
Reservation 1 of [FACIL]FOO.MAR
   Reservation created on 23-MAR-1989 18:09:51.80
   Reservation created by user SMITH (Jane Smith)
   Generation 29 (27B2) reserved from stream V5.4
   Expected generation expression at replacement is 27B3
   Concurrent reservations are allowed
   Remark: Fix QAR 23 again
 
Reservation 1 of [FACIL]MOD1.PAS
   Reservation created on 24-MAR-1989 18:50:33.18
   Reservation created by user JONES (John Jones)
   Generation 15 (15) reserved from stream V5.5
   Expected generation expression at replacement is 16
   Concurrent reservations are allowed
   Remark: Implement whistle feature
 
VDE„
      

This example shows the output of the /FULL qualifier. Because no module-name parameter is specified, the command displays reservations for all modules in the current default facility.

VDE„ SHOW RESERVATION/USERNAME=SMITH FOO
Reservation 1 of [FACIL]FOO.MAR             SMITH        23-MAR-1989 V5.4
VDE„
      

In this example, only reservations of module FOO.MAR for user SMITH are displayed. User SMITH has one outstanding reservation (reservation 1) of this module.