| Previous | Contents | Index |
In this example, the /TOTAL qualifier shows the total number of source-module generations in facility RMS. There are 237 such generations.
Displays the names, members, and other attributes of one or more specified groups.
SHOW GROUP [group-name [, group-name...]]
group-name
The name of a source group or build group in the default development stream whose attributes are to be displayed.You can display more than one group using wildcard characters. The percent sign (%) in a group name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. Those groups whose names match the wildcard pattern are displayed.
If no group name parameter is specified, VDE displays all group definitions for the default stream.
Depending on the qualifiers you select, the SHOW GROUP command displays the names, members, and other attributes of the specified source groups or build groups. The /SOURCE or /BUILD qualifier determines whether the command displayes source groups or build groups. The command can also show the total number of groups that match a group-name specification. This command only displays group definitions for the default development stream.
/BRIEF (default)
/FULL
Determines the type of information that is displayed for a group. The /BRIEF qualifier lists only the names of the groups that match the group-name parameters. The /FULL qualifier lists the name of each group and also its creation date, its remark string, the stream to which it belongs, and the name of the creator of the group definition.Of /BRIEF and /FULL, /BRIEF is the default.
/BUILD
/SOURCE (default)
Specifies whether source groups or build groups are displayed. The /SOURCE qualifier causes VDE to display the source groups with the specified names. The /BUILD qualifier causes VDE to display the build groups with the specified names. If neither qualifier is specified, VDE displays source groups.Of /BUILD and /SOURCE, /SOURCE is the default.
/MEMBERS
/NOMEMBERS (default)
Determines whether the members of the group are listed. The /MEMBERS qualifier prints the name of each module that is a member of the group. If the /FULL qualifier is also used, the /MEMBERS qualifier additionally shows who added the member to the group and the date the member was added. The /NOMEMBERS qualifier suppresses this output./TOTAL
Shows the total number of groups that match the group-name parameters. Other information about the individual groups is not shown. A separate count is provided for each group-name parameter. Wildcard characters are usually used in the group-name parameters when using this qualifier.
| #1 |
|---|
VDE„ SHOW GROUP
Source group ALLMODS
Source group GROUP-2
Source group GRPNAM
Source group GRP_1
Source group GRP_2
Source group GRP_3
Source group GRP_4
VDE„
|
This example illustrates how the SHOW GROUP command without parameters or qualifiers lists the names of all source groups defined in the default development stream.
| #2 |
|---|
VDE„ SHOW GROUP/BUILD BLDGRP, BLDGRP-2
Build group BLDGRP
Build group BLDGRP-2
VDE„ SHOW GROUP/BUILD BLD*
Build group BLDGRP
Build group BLDGRP-2
VDE„
|
In this example, individual build-group names are used as parameters to list two build groups, both defined in the default stream. The second SHOW GROUP command illustrates the use of a wildcard character (*) to list multiple build groups.
| #3 |
|---|
VDE„ SHOW GROUP/SOURCE ALLMODS/FULL
Source group ALLMODS
Group added to database on 4-AUG-1988 15:15:31.49
Group added to database by user DOE (John Doe)
Group defined in stream MAIN
Remark:
VDE„
|
Here the /FULL qualifier shows when source group ALLMODS was added to the database, the name of the user who added it, the name of the development stream in which the group was created, and the remark string associated with the group.
| #4 |
|---|
VDE„ SHOW GROUP/BUILD/MEMBERS SYSGRP
Build group SYSGRP
Members of the group:
Module [BUILD_TEST]X.EXE
Module [BUILD_TEST]Y.EXE
Module [BUILD_TEST]Z.HLB
VDE„
|
Here the /MEMBERS qualifier lists the names of all modules that are members of build group SYSGRP. The facility name, module name, and module type of each member are displayed.
| #5 |
|---|
VDE„ SHOW GROUP/BUILD/FULL/MEMBERS SYSGRP
Build group SYSGRP
Group added to database on 4-AUG-1988 15:15:31.49
Group added to database by user DOE (John Doe)
Group defined in stream MAIN
Remark: All images for conversion program
Members of the group:
Module [BUILD_TEST]X.EXE
Added by user DOE on 4-AUG-1988 15:15:31.49
Module [BUILD_TEST]Y.EXE
Added by user DOE on 4-AUG-1988 15:15:31.49
Module [BUILD_TEST]Z.HLB
Added by user SMITH on 19-OCT-1988 16:10:40.05
VDE„
|
This example shows the output of the /FULL and /MEMBERS qualifiers used together. The output shows all database information about the specified group.
| #6 |
|---|
VDE„ SHOW GROUP/TOTAL *
Number of groups matching name *: 7
VDE„
|
This example shows how the /TOTAL qualifier displays the number of source groups for the default stream that match a given group-name specification. In this case, a wildcard character (*) is specified that matches all source group names. The default stream thus has a total of seven source groups defined.
Displays the key definitions created with the DEFINE/KEY command.
SHOW KEY [key-name]
key-name
The name of the key whose definition is to be displayed. For a list of valid key names, see the DEFINE/KEY command.
The SHOW KEY command lists the key definitions created with DEFINE/KEY command. When used with the /DIRECTORY qualifier, the command lists the states associated with those key definitions. Use the SET KEY command to change key states.
/ALL
Displays all of the key definitions for the current state or for the states specified with the /STATE qualifier. If you use the /ALL qualifier, do not specify a key name./BRIEF (default)
/NOBRIEF
The /BRIEF qualifier displays the key name, key definition, and state associated with the specified key. The /NOBRIEF qualifier displays any qualifiers associated with the key definition. The /BRIEF and /NOFULL qualifiers are equivalent./DIRECTORY
Displays the names of all the states for which keys have been defined. If you have not defined any keys, SHOW KEY/DIRECTORY displays the DEFAULT, GOLD, and BLUE states (the states used by the initial key definitions on the VDE keypad).You cannot use the /DIRECTORY qualifier with any other SHOW KEY qualifiers. The key-name parameter is ignored if you use the /DIRECTORY qualifier.
/FULL
/NOFULL (default)
The /FULL qualifier displays all qualifiers associated with a key definition. By default, only the name, definition, and state of the key are displayed. The /FULL and /NOBRIEF qualifiers are equivalent./STATE=(state-name[,...])
/NOSTATE (default)
Displays the key definitions associated with the specified state or states. If you specify only one state name, you can omit the parentheses. State names can be any alphanumeric string. State names are created with the DEFINE/KEY command.If you omit the /STATE qualifier or use /NOSTATE, key definitions for the current state are displayed.
| #1 |
|---|
VDE„ SHOW KEY KP4/FULL
DEFAULT keypad definitions:
KP4 = "SHOW DEFAULTS" (echo,terminate,nolock)
|
In this example, the SHOW KEY command displays the complete definition of the KP4 key. Using the /FULL qualifier lists the qualifiers (/ECHO, /TERMINATE, and /NOLOCK) entered, either explicitly or by default, with the SHOW DEFAULTS command when the KP4 key was defined.
| #2 |
|---|
VDE„ DEFINE/KEY/TERMINATE COMMA "SHOW LIBRARY"
%VDE-I-DEFKEY, DEFAULT key COMMA has been defined
VDE„ SHOW KEY COMMA
DEFAULT keypad definitions:
COMMA = "SHOW LIBRARY"
VDE„ SHOW KEY/FULL COMMA
DEFAULT keypad definitions:
COMMA = "SHOW LIBRARY" (echo,terminate,nolock)
|
In this example, the first SHOW KEY command is the default version of the command: it displays both the definition of the COMMA key (SHOW LIBRARY) and the state in which it is defined (DEFAULT). The second SHOW KEY command (with the /FULL qualifier) additionally displays all qualifiers associated with the key definition, which in this example are /TERMINATE, /ECHO, and /NOLOCK; the qualifiers either can be explicitly stated when the key is defined (as /TERMINATE) or can be defaults (as /ECHO and /NOLOCK) of the DEFINE/KEY command.
| #3 |
|---|
VDE„ SHOW KEY/ALL
DEFAULT keypad definitions:
PF1 = "" (echo,noterminate,nolock,state=GOLD)
PF2 = "Help" (echo,terminate,nolock)
PF3 = "SET VERIFY" (echo,terminate,nolock)
PF4 = "" (echo,noterminate,nolock,state=BLUE)
KP4 = "SHOW DEFAULTS" (echo,terminate,nolock)
COMMA = "SET CONTEXT BUGFIX" (echo,terminate,nolock)
|
This example the SHOW KEY command displays all of the key definitions that you created with the DEFINE/KEY command.
Displays the attributes of the current VDE library.
SHOW LIBRARY
None.
The SHOW LIBRARY command displays the name and root directory of the current library and optionally shows information from the database-header record of the library. This additional information includes the creation date of the library, a remark string, the name of the user who created the library, and the standard authorized and default privileges for new users of the library.
/BRIEF (default)
/FULL
Determines what information about the library is displayed. The /BRIEF qualifier lists the name and the root directory of the library only. The /FULL qualifier lists the name, the root directory, and all information available from the database-header record of the library.Of /BRIEF and /FULL, /BRIEF is the default.
| #1 |
|---|
VDE„ SHOW LIBRARY
Library LIBNAME in root directory DEV$:[PROJDIR]
VDE„
|
This example illustrates the brief form of the SHOW LIBRARY output.
| #2 |
|---|
VDE„ SHOW LIBRARY/FULL
Library LIBNAME in root directory DEV$:[PROJDIR]
Created by user SMITH on 4-APR-1989 14:52:58.62
Remark: Test library
Created using VDE Version X0.1-1
Automatic library conversion enabled
Initial default privileges for new users:
CREMOD CRESTEP RESREP
Initial authorized privileges for new users:
CREMOD CRESTEP CREUSR RESREP
VDE„
|
This example shows the full form of the SHOW LIBRARY output.
Displays the names of the disk directories that contain either the files of the default development stream, the delta files of the current library, or the staging areas for queued replacements.
SHOW LOCATION
None.
The SHOW LOCATION command displays the locations of the disk directories that contain the modules that make up your software system. You can display the directory locations of all files in the default development stream, of the current library's delta files (stored in the form of CMS libraries), or of the queued replacement "staging area."The directories for the default development stream contain derived files and clear copies of source files. VDE uses these directories when it builds your system. By default, the SHOW LOCATION command displays the names of all directories for the default stream.
Each source module in your software system has a delta file. A delta file is a compact representation for storing all past and present generations of a source module. A delta file is the same as a CMS element. The SHOW LOCATION command can display the names of all delta-file directories.
Each facility has a separate disk directory tree for both the default stream and the delta files. You can specify that you want to display only those directories for a specific facility.
The VDE library also has a root directory for queued-replacement staging areas. Each time a user queues modules for replacement, VDE creates a new subdirectory (called a staging area) for that queued replacement and copies the modules to be replaced to the staging area. The SHOW LOCATION command can show the root directory for these staging areas.
/DELTA_FILES
/STAGING
/STREAM (default)
Specifies whether to display directory locations for the VDE library's delta-files, the library's staging area, or the default development stream. The /DELTA_FILES qualifier displays directory locations of the library's delta-files (its CMS libraries). The /STAGING qualifier displays the root directory of the library's staging areas for queued replacements. The /STREAM qualifier displays directory locations for the default development stream.Of /DELTA_FILES, /STAGING and /STREAM, /STREAM is the default.
/FACILITY=facil-name
Specifies that only those directory locations that hold modules for the indicated facility be displayed. If this qualifier is omitted, directory locations for all facilities are displayed.
| #1 |
|---|
VDE„ SHOW LOCATION/FACILITY=RMS
Directory locations for stream V2.0:
Stream root directory: DEV$:[PROJDIR.V2_0]
Subdirectory: DEV$:[PROJDIR.V2_0.VDE$BLD] (symbol VDE$BLD)
Directory locations for facility RMS:
Root directory: DEV$:[PROJDIR.V2_0.RMS]
Subdirectory: DEV$:[PROJDIR.V2_0.RMS.OBJ] (symbol OBJ)
Subdirectory: DEV$:[PROJDIR.V2_0.RMS.SRC] (symbol SRC)
Subdirectory: DEV$:[PROJDIR.V2_0.RMS.VDE$COM] (symbol VDE$COM)
Subdirectory: DEV$:[PROJDIR.V2_0.RMS.VDE$LOG] (symbol VDE$LOG)
VDE„
|
This example displays the disk directory locations for facility RMS in the default stream (stream V2.0).
| #2 |
|---|
VDE„ SHOW LOCATION/FACILITY=RMS/DELTA_FILES
Directory locations for delta files:
Delta-file root directory: DEV$:[PROJDIR.VDE$CMS]
Directory locations for facility RMS:
Root directory: DEV$:[PROJDIR.VDE$CMS.RMS]
VDE„
|
This example displays the disk directory locations for the delta-files for facility RMS.
Shows whether VDE input and output is recorded in a log file. If logging is enabled, the name of the log file is displayed. To enable logging, use the SET LOG command.
SHOW LOG
None.
None.
| #1 |
|---|
VDE„ SHOW LOG
Output logging on file: DEV$:[MYDIR]VDELOGFILE.LOG;1
VDE„
|
This command shows that output logging is enabled and gives the name of the log file.
| #2 |
|---|
VDE„ SHOW LOG
No output logging
VDE„
|
This command shows that output logging is disabled.
Displays information about VDE's memory usage.
SHOW MEMORY
None.
The SHOW MEMORY command displays information about the memory pools that VDE uses. It displays information about the following memory areas:
- VDE's internal memory pool. VDE uses this memory pool for its own dynamic memory needs. VDE allocates memory in this pool primarily for command processing, but also uses it for more permanent storage, such as storing the names of the default stream and facility. The information displayed includes the total size of this memory pool, the amount of memory allocated, the amount of free memory, and other information.
- The size of the LIB$GET_VM and LIB$GET_VM_PAGE memory pools. These memory pools are managed by Run-Time Library routines and are used by CMS, Rdb, and system components such as RMS. CMS, in particular, uses substantial amounts of LIB$GET_VM_PAGE memory.
- The size of the VDE utility's address space and the amount of virtual memory by which the address space can be expanded.
If you run out of virtual memory when running VDE, the SHOW MEMORY command can be helpful in determining where memory is being consumed. It is of course also helpful to VDE developers in identifying how memory is used.
None.
| #1 |
|---|
VDE„ SHOW MEMORY
Memory usage statistics:
Number of bytes in VDE memory pool: 65536
Number of areas in VDE memory pool: 1
Number of allocated bytes in VDE pool: 1960
Number of allocated blocks in VDE pool: 33
Number of free bytes in VDE pool: 63564
Number of free blocks in VDE pool: 17
Number of bytes in VDE pool free list: 63548
Number of blocks in VDE pool free list: 16
Number of bytes of temporary memory: 1264
Number of blocks of temporary memory: 12
Number of successful LIB$GET_VM calls: 275
Number of successful LIB$FREE_VM calls: 141
Number of LIB$GET_VM bytes now allocated: 567120
Number successful LIB$GET_VM_PAGE calls: 13
Number successful LIB$FREE_VM_PAGE calls: 0
Number of LIB$GET_VM_PAGE pages allocated: 1836
Number of LIB$GET_VM_PAGE bytes allocated: 940032
First free address at end of P0 space: 0063EE00
First free address at end of P1 space: 7FDD6200
Number of pages available for expansion: 182835
VDE„
|
This example shows the output of the SHOW MEMORY command. The first part of the output contains information about VDE's internal memory pool. This includes the total size of the pool, the amount of memory that is allocated, the amount that is free, the length of the free list (which should be the same as the amount of free memory except for a 16-byte list head), and the amount of "temporary memory" allocated. Temporary memory is allocated memory that is automatically released at the end of the current command.
The middle section of the output displays information about the LIB$GET_VM and LIB$GET_VM_PAGE memory pools. This information comes from library routine LIB$STAT_VM. Finally, the last few lines give the sizes of the VDE utility's P0 and P1 address spaces and the number of pages by which the virtual address space can still be expanded before reaching the virtual page limit for the process.
Displays the attributes of one or more specified modules.
SHOW MODULE [mod-name [, mod-name...]]
mod-name
The name of a module whose attributes 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. An example is [FACIL]MOD1.PAS. If no facility name is specified, the default facility is assumed. If no type name is specified, all modules with the specified module name in the given facility are displayed.You can display 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. Those modules whose names match the wildcard pattern are displayed.
If you omit the mod-name parameter, VDE displays all modules in the default facility.
Depending on the qualifiers you select, the SHOW MODULE command displays the name of each selected module, the name and remark string of each module, or the name and all other attributes of each module. The command can also show the total number of modules that match a module name specification or certain statistics about the modules that match a module name specification.To obtain generation-related information on one or more modules, use the SHOW GENERATION command. See SHOW GENERATION for further information.
/ALL
/SOURCE (default)
/DERIVED
Controls whether source modules, derived modules, or all modules are displayed. The /SOURCE qualifier causes VDE to display only source modules that match the module-name parameters. The /DERIVED qualifier causes VDE to display only derived modules that match the parameters. The /ALL qualifier causes VDE to display both source and derived modules that match the parameters.Of /ALL, /SOURCE and /DERIVED, /SOURCE is the default.
/BRIEF
/NORMAL (default)
/FULL
Determines the information that is displayed for each module. The /BRIEF qualifier displays the name of each module that matches the module-name parameter. The /NORMAL qualifier displays the name and remark string of each module. The /FULL qualifier displays all attributes of each module, including its name, creation date, history and notes attributes, and remark string. It also indicates whether the module is a source module or a derived module.Of /BRIEF, /NORMAL and /FULL, /NORMAL is the default.
/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./STATISTICS=(keyword [, keyword...])
Computes and displays certains statistics about the modules that match the module-name parameters. 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 or type name. If this keyword is omitted, VDE sorts the display in descending order by module count.
- FACILITY---Compute and display the number of modules in each facility.
- TYPES---Compute and display the number of modules that have each module type.
When this qualifier is used, other information about the individual modules is not shown. Use wildcard characters in the module-name parameters to select the module population for which you want statistics.
/TOTAL
Shows the total number of modules that match the module-name parameters. Other information about the individual modules is not shown. A separate count is provided for each mod-name parameter. Wildcard characters are usually used in the module-name parameters when using this qualifier.
| #1 |
|---|
VDE„ SHOW MODULE/SOURCE *.*
Module [CODE]FOO.BAR "Nonsense module"
Module [CODE]MOD1.FOR "First Fortran module"
Module [CODE]MOD2.FOR "Second Fortran module"
Module [CODE]MOD3.FOR "Third Fortran module"
Module [CODE]MOD4.FOR "Sorting routines"
Module [CODE]MOD5.FOR "Random scrambling algorithm"
Module [CODE]MOD6.FOR "Destabilization routines"
VDE„
|
Previous Next Contents Index