VDE
VDE
Reference Manual


Previous Contents Index


SHOW ARCHITECTURE

Shows one or more architecture table entries in the VDE database. Each architecture table entry...

ARCHITECTURE support is not fully implemented.


Format

SHOW ARCHITECTURE arch-name [, arch-name...]


Parameter

arch-name

The name of the architecture to be displayed. This name may be up to 39 characters long and must follow VDE name syntax.

Description

Under Construction...

Qualifiers

/BRIEF

Under Construction...

/CURRENT

Under Construction...

/FULL

Under Construction...

/OUTPUT=

Under Construction...

/TOTAL

Under Construction...

Examples

#1

VDE„ SHOW ARCHITECTURE VAXPDP
VDE„
      

Under Construction...


SHOW BUILD_JOB

Displays information about one or more specified build jobs.

Format

SHOW BUILD_JOB [stream-name [, stream-name...]]


Parameter

stream-name

The name of a development stream. Information about one or more build jobs in this stream is displayed. Use the /IDENTIFICATION qualifier to specify the build jobs to be displayed. If you do not specify this qualifier, information about the most recent build job for the stream is displayed.

You can display build jobs for more than one stream by using wildcard characters in the stream 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. Build jobs are displayed for those streams whose names match the wildcard pattern.

If you omit the stream-name parameter, VDE displays information about one or more build jobs for the default stream.


Description

The SHOW BUILD_JOB command displays information about specified build jobs. You can specify build jobs with the stream-name parameter and the /IDENTIFICATION qualifier. By default, the SHOW BUILD_JOB command displays information about the most recent build job belonging to the default stream.

The SHOW BUILD_JOB command displays the following information for each build job:

Optionally, the command can also show all other information available in the VDE database about the build job, including: The command can also display the list of batch queues and process counts used to run the build job, and it can show all build steps that make up the build job.

Qualifiers

/BEFORE=date-time

Displays only those build jobs created before the specified date and time. The date and time can be stated using 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)

/SUMMARY

/FULL

Determines the type of information displayed about each build job.

The /BRIEF qualifier displays the build-job identification number, the stream name, and status of each build job.

The /SUMMARY qualifier displays the information provided by the /BRIEF qualifier, but it also displays the number of build steps currently in each state (that is, the number of steps that are not yet started, are running, have completed with errors, and have completed successfully) so that you can follow the progress of the build job. The /SUMMARY qualifier also prints the total number of steps in the build job.

The /FULL qualifier displays all information in the database about the build job except queue information and build-step information. (To see queue information, use the /QUEUE qualifier; to see step information, use the /STEP qualifier.)

See the Example section of this command for sample output of the /BRIEF, /SUMMARY, and /FULL qualifiers. Of /BRIEF, /SUMMARY and /FULL, /BRIEF is the default.

/IDENTIFICATION=id-range

Specifies the build-job identification numbers of the build jobs to be displayed for the specified stream. 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 build job with that identification number. If the parameter is a range of integers (specified as two build-job identification numbers separated by a colon as in /IDENT=3:5), VDE displays all build jobs with identification numbers in that range. Finally, if the id-range parameter is an asterisk (as in /IDENT=*), VDE displays all build jobs for the specified stream.

If you specify a zero or negative build-job identification number in the id-range parameter, that number is relative to the identification number of the most recent build job for the stream. For example, if the most recent build job is job 5, then /IDENT=0 is equivalent to /IDENT=5 and /IDENT=--1 is equivalent to /IDENT=4.

If you do not use the /IDENTIFICATION qualifier, VDE displays the most recent build job for the specified stream.

/QUEUE

Displays queue information for the specified build jobs. This information includes the name of each batch queue used to run the build job, the process count for each queue, and the total process count for the build job.

/SINCE=date-time

Displays only those build jobs created after the specified date and time. The date and time can be stated using 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.

/STATUS=(status [, status...])

Displays only those build jobs that have one of the specified status values. Each status parameter must be one of the following keywords: NOTQUEUED, QUEUED, RUNNING, SUCCESS, ERRORS, STOPPED, SUSPENDED, and TIMEOUT.

If you specify only one status parameter, the parentheses may be omitted.

/STEP [=(status [, status...])]

Displays build-step information for each specified build job. For each build step in the build job, this qualifier displays the type of the build step (such as compile, copy, or link), the name of the module that the step is applied to, and the status of the step. If the /FULL qualifier is also specified, the /STEP qualifier additionally displays the wait count of each step (the number of steps that must complete before this step can execute) and the names of the steps that must wait for the current step to complete.

If you specify one or more status parameters, the /STEP qualifier displays only those build steps that have one of the specified status values. Each status parameter must be one of the following keywords: NOTSTARTED, RUNNING, SUCCESS, or ERRORS.

If you specify only one status parameter, the parentheses may be omitted. If you omit the status parameters, all build steps in the specified build jobs are displayed.

/TOTAL

Shows the total number of build jobs that match the specified constraints. These constraints are the stream name, the range of build job identification numbers specified by the /IDENTIFICATION qualifier, the build job status values specified by the /STATUS qualifier, and the time constraints specified by the /BEFORE and /SINCE qualifiers. No information about the individual build jobs is shown; only the total count is displayed. A separate count is provided for each stream-name parameter.

Examples

#1

VDE„ SHOW BUILD_JOB
Build job 11 for stream MAIN has completed with errors
VDE„
      

This example shows the brief form of the SHOW BUILD_JOB output. The build job identification number (11) and stream name (BL22) of the build job are displayed, along with the status of the job (suspended). Because no stream name or /IDENTIFICATION qualifier is specified with the command, the most recent build job for the default stream is displayed.

#2

VDE„ SHOW BUILD_JOB/SUMMARY
Build job 11 for stream MAIN has completed with errors
   Number of build steps not yet started:             0
   Number of currently running build steps:           0
   Number of build steps completed with errors:       1
   Number of successfully completed build steps:      4
   Total number of build steps in build job:          5
VDE„
      

This example shows the summary output of the SHOW BUILD_JOB command. In addition to identifying the build job, the output shows how many build steps are in each state and gives the total number of build steps in the job. In this example, one step completed with errors and all other steps completed successfully.

#3

VDE„ SHOW BUILD_JOB/FULL
Build job 11 for stream BL22 has completed with errors
   Number of build steps not yet started:             0
   Number of currently running build steps:           0
   Number of build steps completed with errors:       1
   Number of successfully completed build steps:      4
   Total number of build steps in build job:          5
   Remark: Build base level 22 once again
   Created by user JAMES (Jim James)
   Started by user JAMES (Jim James)
   Created on  9-NOV-1989 09:59:29.71
   Queued on  17-NOV-1858 00:00:00.00
   Started on  9-NOV-1989 10:00:18.72
   Stopped on  9-NOV-1989 10:00:35.15
   Build job is performing a full build
   Build job has been started 1 times
   Number of changed modules scanned for build: 17
   Number of target modules for build: 1
   Build-step delay interval:     0 00:00:05.00
   Build-job timeout interval:    0 01:00:00.00
VDE„
      

This example shows the full output of the SHOW BUILD_JOB command for the build job used in the previous example.

#4

VDE„ SHOW BUILD_JOB/QUEUE V2.0-3/IDENT=2
Build job 2 for stream V2.0-3 is not yet queued for execution
   Batch queues to run 20 processes for this build job:
      Submit 3 processes (scaled from 1) on queue QUE_A
      Submit 7 processes (scaled from 3) on queue QUE_B
      Submit 2 processes (scaled from 1) on queue QUE_C
      Submit 8 processes (scaled from 4) on queue QUE_D
 
VDE„
      

This example displays build job 2 (specified by the /IDENTIFICATION qualifier) for stream V2.0-3. The /QUEUE qualifier displays the names and process counts of the batch queues used to run the build job. A total of 20 processes will run the build job, distributed over four batch queues.

#5

VDE„ SHOW BUILD_JOB BL22/STEP
Build job 11 for stream BL22 is not yet queued for execution
   Build steps that are part of the build job:
      Compile step for [CODE]FOO.MAR is not started
      Link step for [CODE]FOO.EXE is not started
   Number of build steps displayed is 2
 
VDE„
      

This example displays information for the most recent build job in stream BL22. The /STEP qualifier displays build step information. Two steps are part of this build job: a compile step for module FOO.MAR and a link step for module FOO.EXE. The number of build steps is also shown.

#6

VDE„ SHOW BUILD_JOB/TOTAL */IDENTIFICATION=*
Number of build jobs for stream *: 14
VDE„
      

The /TOTAL qualifier displays the number of build jobs that match the selection criteria, in this example, all build jobs for all streams. There are 14 such build jobs in the VDE database.


SHOW CONTEXT

Displays the names and definitions of one or more specified contexts. A context can be used to specify the default development stream, default architecture and default facility for a VDE session.

Format

SHOW CONTEXT [ctx-name [, ctx-name...]]


Parameter

ctx-name

The name of a context whose attributes are to be displayed.

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

If no parameter is specified for the command, VDE displays the definitions of all contexts to which you have access. These include all public contexts and all of your private contexts.


Description

Depending on the qualifiers you select, the SHOW CONTEXT command can display the following: the name only of each selected context; the name and the default settings associated with the context; or all information about the context. The command also can show the total number of contexts that match a context name specification.

Qualifiers

/ALL (default)

/PRIVATE

/PUBLIC

Controls whether public, private, or all contexts are displayed. The /PRIVATE qualifier causes VDE to display only your private contexts that match the context-name parameter. The /PUBLIC qualifier causes VDE to display only the public contexts that match the parameter. The /ALL qualifier causes VDE to display both your private contexts and the public contexts that match the parameter.

Of /ALL, /PRIVATE and /PUBLIC, /ALL is the default.

/BRIEF

/NORMAL (default)

/FULL

Determines the information that is displayed about each context. The /BRIEF qualifier lists only the type (public or private) and name of each context. The /NORMAL qualifier displays the name, type, and default settings associated with each context. The /FULL qualifier lists the same information as the /NORMAL qualifier and also the creation date of the context, a remark string, and the name of the user who created the context.

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

/TOTAL

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

Examples

#1

VDE„ SHOW CONTEXT/BRIEF
Context BAR (public to all users)
Context DEFAULT (private to user SMITH)
Context DEFAULT (public to all users)
Context FOO (private to user SMITH)
Context NEWCTX (private to user SMITH)
Context PUBCTX (public to all users)
VDE„
      

This example shows the brief form of the SHOW CONTEXT output. Only the context names and types (public or private) are displayed.

#2

VDE„ SHOW CONTEXT PUBCTX
Context PUBCTX (public to all users)
   Default stream is V2.0-1
   Default facility is EXEC
 
VDE„
      

This example shows the normal form of the SHOW CONTEXT output. The command displays the name and type of context PUBCTX and it shows the default settings associated with the context.

#3

VDE„ SHOW CONTEXT/FULL/PRIVATE V3RMS
Context V3RMS (private to user SMITH)
   Default stream is V3.1-FT
   Default facility is RMS
   Context added to database on 19-APR-1989 09:08:20.92
   Context added to database by user SMITH (Jane Smith)
   Remark: Version 3.1 of RMS code
 
VDE„
      

The SHOW CONTEXT command displays the full output for private context V3RMS.

#4

VDE„ SHOW CONTEXT/TOTAL *
Number of contexts matching name *: 6
VDE„
      

The /TOTAL qualifier displays the total number of contexts in the database. Because the /ALL qualifier is specified by default, this count includes both all private contexts for the current user and all public contexts.


SHOW DEFAULTS

Displays the defaults for your current VDE session.

Format

SHOW DEFAULTS


Parameters

None.

Description

The SHOW DEFAULTS command displays the name of the current VDE library, the current default directory, the current context, the default stream, and the default facility. You can establish the default stream and facility at one time using the SET CONTEXT /DEFAULT command, you can create multiple default contexts using CREATE CONTEXT and MODIFY CONTEXT, and you can set individual defaults with the commands SET STREAM and SET FACILITY.

Qualifiers

None.

Examples

#1

VDE„ SHOW DEFAULTS
Library LIBNAME in root directory DEV$:[PROJDIR]
Default directory is DEV$:[SMITH]
Context DEFAULT (private to user JONES)
   Default stream is V2.0-1
   Default facility is EXEC
 
VDE„
      

This example shows that the default stream is V2.0-1 and the current default facility is EXEC. These settings come from (and are identical to) context DEFAULT, a context private to the current user. The current VDE library and the current default directory are also displayed.

#2

VDE„ SHOW DEFAULTS
Library LIBNAME in root directory DEV$:[PROJDIR]
Default directory is DEV$:[SMITH]
Current session context:
   Default stream is V2.0-1
   Default facility is RMS
 
VDE„
      

This command shows that the default stream is V2.0-1 and the default facility in the current session is RMS. These settings do not come from a specific named context because individual settings have changed either since the last SET CONTEXT command or since the start of the VDE session.


SHOW DEVELOPER

Shows the current settings of the developer flags.

Use this command only under the explicit direction of, and with the assistance of, a VDE developer.


Format

SHOW DEVELOPER


Description

Under Construction...

Examples

#1

VDE„ SHOW DEVELOPER
Under Construction...
VDE„
      


SHOW DIRECTORY

Displays directory templates for the default stream or for the current VDE library's delta files.

Format

SHOW DIRECTORY


Description

The SHOW DIRECTORY command displays directory templates from the VDE database. Directory templates are defined with the SET DIRECTORY command and specify the names that VDE should assign to disk directories when creating directories for new streams or facilities. The SHOW DIRECTORY command displays the directory creation flags for the default stream, the template for the stream (or delta-file or staging-area) root directory, the template for each stream subdirectory, the template each facility root directory (if any), and the template for each facility subdirectory. You can use the /FACILITY qualifier to limit the display to those templates that apply to a specified facility.

For additional information on directory creation, and on directory symbols (dir-symbol) and directory symbol processing, see CANCEL DIRECTORY, SET DIRECTORY, and Script Functions.


Qualifiers

/BRIEF (default)

/FULL

Determines the information that is displayed for each directory template. The /BRIEF qualifier displays the directory specification and the directory symbol for each template. The /FULL qualifier lists the same information as the /BRIEF qualifier, but also shows the creation date of each directory template, the name of the user who created the template, and the template's remark string.

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

/DELTA_FILES

/STAGING

/STREAM (default)

Determines whether directory templates for the library's delta files, its staging area, or the default stream are displayed. The /DELTA_FILES qualifier specifies that directory templates for the VDE library's delta files (CMS libraries) be displayed. The /STAGING qualifier specifies that the directory template for the library's staging-area root directory be displayed. (Staging areas hold files for queued replacements.) The /STREAM qualifier specifies that directory templates for the default stream be displayed.

Of /DELTA_FILES, /STAGING and /STREAM, /STREAM is the default.

/FACILITY=fac-name

Specifies that only those directory templates that apply to the facility given by the fac-name parameter be displayed. If this qualifier is omitted, VDE displays directory templates for all facilities.

You can display directory templates for multiple facilities by using wildcard characters in the fac-name parameter. 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. Directory templates for those facilities whose names match the wildcard pattern are displayed.


Examples

#1

VDE„ SHOW DIRECTORY
Directory-creation templates for stream V2.1-1:
   Directory creation flags:
      Do not defer creation of directory tree for substreams
      Do not prompt for root directory for substreams
 
   Stream root directory is [.V2_1-1] by default
      Subdirectory:   [.VDE$BLD] (symbol VDE$BLD)
 
   Directory templates for unspecified facilities:
      Subdirectory:   [.OBJ] (symbol OBJ)
      Subdirectory:   [.SRC] (symbol SRC)
      Subdirectory:   [.VDE$COM] (symbol VDE$COM)
      Subdirectory:   [.VDE$LOG] (symbol VDE$LOG)
 
   All other directories created using default rules
 
VDE„
      

This example shows the brief output of the SHOW DIRECTORY command. This command shows the directory templates for the default stream because the /STREAM qualifier is assumed by default.

#2

VDE„ SHOW DIRECTORY/DELTA_FILES
Directory-creation templates for delta files:
   Delta-file root directory is [.VDE$CMS] by default
 
   All other directories created using default rules
 
VDE„
      

This example shows the brief output of the SHOW DIRECTORY command when the /DELTA_FILES qualifier is specified. The command shows the directory templates for the VDE library's delta files (its CMS libraries).

#3

VDE„ SHOW DIRECTORY/FACILITY=RMS
Directory-creation templates for stream V2.1-1:
   Directory creation flags:
      Do not defer creation of directory tree for substreams
      Do not prompt for root directory for substreams
 
   Stream root directory is [.V2_1-1] by default
      Subdirectory:   [.VDE$BLD] (symbol VDE$BLD)
 
   Directory templates for unspecified facilities:
      Subdirectory:   [.OBJ] (symbol OBJ)
      Subdirectory:   [.SRC] (symbol SRC)
      Subdirectory:   [.VDE$COM] (symbol VDE$COM)
      Subdirectory:   [.VDE$LOG] (symbol VDE$LOG)
 
   Directory templates for facility RMS:
      Root directory: [MYDIR.RMS]
      Subdirectory:   [.ANA] (symbol ANA_FILES)
      Subdirectory:   [.COM] (symbol COM)
      Subdirectory:   [.SRC] (symbol SRC)
      Subdirectory:   [.VDE$COM] (symbol VDE$COM)
      Subdirectory:   [.VDE$LOG] (symbol VDE$LOG)
 
   All other directories created using default rules
 
VDE„
      

This example shows those directory templates that apply to facility RMS. Note that all generic information is shown, including the templates for the stream root directory and for unspecified facilities, before the templates specific to facility RMS are displayed. Templates specific to facilities other than RMS are not displayed. In this case, facility RMS has templates for an explicitly specified root directory and a different set of subdirectories than other facilities. VDE uses these templates to create the directory tree for facility RMS when you create new development streams.

#4

VDE„ SHOW DIRECTORY/FULL
Directory-creation templates for stream V2.1-1:
   Directory creation flags:
      Do not defer creation of directory tree for substreams
      Do not prompt for root directory for substreams
 
   Stream root directory is [.V2_1-1] by default
      Subdirectory:   [.VDE$BLD] (symbol VDE$BLD)
         Template added to database on  9-DEC-1989 20:27:58.02
         Template added to database by user SMITH (Jane Smith)
         Remark: 
 
   Directory templates for unspecified facilities:
      Subdirectory:   [.OBJ] (symbol OBJ)
         Template added to database on 11-DEC-1989 20:37:30.45
         Template added to database by user JONES (John Jones)
         Remark: Remark string shown here
      Subdirectory:   [.SRC] (symbol SRC)
         Template added to database on 12-DEC-1989 20:45:22.37
         Template added to database by user SMITH (Jane Smith)
         Remark: Another remark string
      Subdirectory:   [.VDE$COM] (symbol VDE$COM)
         Template added to database on  9-DEC-1989 20:27:58.02
         Template added to database by user SMITH (Jane Smith)
         Remark: 
      Subdirectory:   [.VDE$LOG] (symbol VDE$LOG)
         Template added to database on  9-DEC-1989 20:27:58.02
         Template added to database by user SMITH (Jane Smith)
         Remark: 
 
   All other directories created using default rules
 
VDE„
      


Previous Next Contents Index