Displays the type, attributes, and text of one or more specified VDE scripts from the VDE database.

Format

SHOW SCRIPT

Description

Scripts are used to tailor the processing of VDE to local requirements. The description of the Script Commands (see Script Keywords, and the description of the CREATE SCRIPT command provide more complete explanations of the uses and types of scripts available, and how particular scripts are selected using the script-type qualifiers.

The SHOW SCRIPT command can be used to display the type, the script text, and various other attributes of the specified VDE script, or to display a list of of all scripts that match a particular module specification.

The /BRIEF, /FULL, and /TEXT qualifiers determine how much information is displayed by the command. The command only displays scripts that belongs to the default development stream. The /BRIEF and /FULL qaulifiers display information about the specified script, and the /TEXT qualifier is used to display the contents of the specified script.

Scripts are specified by their types and, for most types, by their module-name or facility-name templates. A compile script with the selection template [CODE]*.FOR, for example, is used to compile all modules of type FOR in facility CODE. However, if there is also a compile script with the template [CODE]X.FOR, then that more specific script is used to compile module X.FOR in facility CODE while the more generically specified script is used for all other Fortran modules in the facility.

When you specify a module-name or facility-name parameter on a script-selection qualifier, the SHOW SCRIPT command interprets wildcard characters in that parameter in one of two ways to select scripts for display. If the command uses exact matching to select scripts from the database, each wildcard character in the parameter must exactly match a wildcard character in a script's template for the script to be displayed. If the command uses wildcard matching, each wildcard character in the parameter matches any characters in a script's template.

With exact matching, the qualifier /COMPILE=[CODE]*.FOR thus only displays the one compile script with the module-name template [CODE]*.FOR. However, with wildcard matching, the same qualifier displays the two compile scripts with templates [CODE]*.FOR and [CODE]X.FOR because the wildcard character (*) in the qualifier matches both the asterisk (*) and the X in the script templates. As this example shows, exact matching can at most display one script while wildcard matching can display many scripts. Use the /EXACT_MATCH qualifier to request exact matching or the /WILDCARD_MATCH qualifier to request wildcard matching; wildcard matching is the default.

When you use exact matching, you must specify a script-type qualifier to select the script you want displayed. You must also specify the script segment number unless the default value applies.

Commands used within scripts are documented in Script Keywords, while script functions are in Script Functions, and script types are in Script Types. For other script-related commands, also see CREATE SCRIPT, DELETE SCRIPT, EXTRACT SCRIPT, INVOKE SCRIPT, and MODIFY SCRIPT.

Qualifiers

/ALL

Specifies that all scripts of all types for the default stream be displayed. This qualifier may only be used if wildcard matching is specified (that is, if you do not specify the /EXACT_MATCH qualifier). If no other script selection qualifier is specified, this qualifier is used by default.

/BRIEF (default)

/FULL

Determines the information that is displayed for each script. The /BRIEF qualifier displays the type of each script and the module-name or facility-name specification that the script is associated with. In addition to the information provided by the /BRIEF qualifier, the /FULL qualifier also lists the creation date of the script, the name of the user who created the script, and the script's remark string.

The /TEXT qualifier is used to display the contents of the specified script.

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

/BUILD

Specifies that the default stream's BUILD script be displayed.

/COMPILE=mod-name

Specifies that the default stream's COMPILE scripts matching the specified mod-name specification be displayed.

/COPY=mod-name

Specifies that the default stream's COPY scripts matching the specified mod-name specification be displayed.

/CREATE_FACILITY

Specifies that the default stream's CREATE_FACILITY scripts be displayed.

/DELETE_GENERATION=mod-name

Specifies that the default stream's DELETE_GENERATION scripts matching the specified mod-name specification be displayed.

/DIFFERENCES=mod-name

Specifies that the default stream's DIFFERENCES scripts matching the specified mod-name specification be displayed.

/EXACT_MATCH

/WILDCARD_MATCH (default)

Specifies the matching mode to use to select scripts for display. The /EXACT_MATCH qualifier specifies that exact matching be used between the mod-name or fac-name parameter to your script-type qualifier and the selection template associated with each script. The /WILDCARD_MATCH qualifier specifies that wildcard matching be used to select scripts. With exact matching, the SHOW SCRIPT command will display at most one script. With wildcard matching, it may display many scripts.

Of /EXACT_MATCH and /WILDCARD_MATCH, the latter is the default.

/FETCH=mod-name

Specifies that the default stream's FETCH scripts matching the specified mod-name specification be displayed.

/INSERT_GENERATION=mod-name

Specifies that the default stream's INSERT_GENERATION scripts matching the specified mod-name specification be displayed.

/LINK=mod-name

Specifies that the default stream's LINK scripts matching the specified mod-name specification be displayed.

/NEW_STREAM=fac-name

Specifies that the default stream's NEW_STREAM scripts matching the specified fac-name specification be displayed.

/NOKEEP=mod-name

Specifies that the default stream's NOKEEP scripts matching the specified mod-name specification be displayed.

/REPLACE=mod-name

Specifies that the default stream's REPLACE scripts matching the specified mod-name specification be displayed.

/RESERVE=mod-name

Specifies that the default stream's RESERVE scripts matching the specified mod-name specification be displayed.

/SEGMENT=seg-num

Specifies the segment number of the script to display. The seg-num parameter specifies the integer segment number. If you omit this qualifier and request exact matching, VDE displays the script with segment number 10. If you omit this qualifier and request wildcard matching, VDE displays scripts with all segment numbers.

/SET_FACILITY=fac-name

Specifies that the default stream's SET_FACILITY scripts matching the specified fac-name specification be displayed.

/SET_STREAM

Specifies that the default stream's SET_STREAM script be displayed.

/STAGING=mod-name

Specifies that the default stream's STAGING scripts matching the specified mod-name specification be displayed.

/TEXT

Specifies that the text of the specified script be displayed.

/TOTAL

Shows the total number of scripts that match the specified script type and module-name or facility-name templates. This is the number of scripts that would be displayed if you omit the /TOTAL qualifier but leave all other qualifiers the same on the command. Other information about the individual scripts is not shown.

/UNRESERVE=mod-name

Specifies that the default stream's UNRESERVE scripts matching the specified mod-name specification be displayed.

Examples

VDE„ SHOW SCRIPT/COMPILE=[*]*.FOR
Script to compile module [*]*.FOR (segment 10)
Script to compile module [CODE]*.FOR (segment 10)
Script to compile module [CODE]X.FOR (segment 10)
Script to compile module [ACCTNG]*.FOR (segment 9)
Script to compile module [ACCTNG]*.FOR (segment 10)
Script to compile module [ACCTNG]*.FOR (segment 20)
VDE„
      

This example shows the brief output of the SHOW SCRIPT command. Because this command uses wildcard matching by default, it displays all compile scripts whose module-name templates match the wildcarded string [*]*.FOR, including scripts with all segment numbers. In this example, there are six scripts that match these criteria.

VDE„ SHOW SCRIPT/EXACT_MATCH/FULL/COMPILE=[CODE]*.FOR
Script to compile module [CODE]*.FOR (segment 10)
   Script added to database on  9-DEC-1989 20:34:25.44
   Script added to database by user JONES (John Jones)
   Remark: SCRIPT REMARK STRING
 
VDE„
      

This example shows the full output of the SHOW SCRIPT command. The script to compile Fortran modules in facility CODE was created by user Jones on the shown date and time. The output includes the script's remark string. Because the /EXACT_MATCH qualifier is specified, only the compile script with the exact module-name template [CODE]*.FOR is displayed.

VDE„ SHOW SCRIPT/EXACT_MATCH/TEXT/NEW_STREAM=*
Script to create new stream for facility * (segment 5)
   Text of script:
     1: ! VDE script to populate the directories for a facility
     2: ! when a new stream is created.
     3: !
     4: EMIT "$ DEFINE/NOLOG OLDOBJ ", $DIR(OBJ,%CURRENT,%PARENT)
     5: EMIT "$ DEFINE/NOLOG NEWOBJ ", $DIR(OBJ,%CURRENT,%CURRENT)
     6: EMIT "$ COPY OLDOBJ:*.OLB NEWOBJ:"
     7: EMIT "$ COPY ",$DIR(SRC,%CURRENT,%PARENT),"*.H -"
     8: EMIT "       ",$DIR(SRC,%CURRENT,%CURRENT)
     9: EXIT
 
VDE„
      

This example displays a NEW_STREAM script for the default development stream. The script applies to all facilities (facility *) and its segment number is 5. The /TEXT qualifier displays the actual text of the script on the terminal.

VDE„ SHOW SCRIPT/TOTAL
Number of scripts matching specifications: 17
VDE„
      

In this example, the /TOTAL qualifier displays the total number of scripts for the default stream. Because no script type is specified, this count includes all scripts of all types.

Displays the names and attributes of one or more specified reservation sessions.

Format

SHOW SESSION [session-name [, session-name...]]

Parameter

session-name

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

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

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

If you do not specify a session name, VDE displays all sessions in the VDE database.

Description

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

Sessions are used to group a set of module reservations together, typically to group all modules related to a particular source code alteration or enhancement together.

Qualifiers

/BEFORE=date-time

Displays only those sessions 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 information that is displayed about each session. The /BRIEF qualifier displays a one-line summary for each session. The /FULL qualifier displays all available database information for each session.

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

/IDENTIFICATION=id-range

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

VDE assigns a unique Session Id to each reservation session for the VDE library. VDE assigns Session Ids in chronological order so that the first session for the library has Id value 1, the next has Id value 2, and so on. Session Ids share the same number space as Replacement Ids, so you should expect gaps in the Session Ids. When you use this qualifier, all sessions 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 Session 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 session with that Session 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 sessions with Ids in that range. Finally, if the id-range parameter is the asterisk wildcard character (as in /IDENT=*), VDE displays all sessions. To be displayed, each session 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 Session Id or Replacement Id value for the VDE library (the latest session or replacement). For example, if the latest session or replacement has Id 250, then /IDENT=0 is equivalent to /IDENT=250 and /IDENT=--1 is equivalent to /IDENT=249.

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

/SINCE=date-time

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

/TOTAL

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

/USERNAME[=username]

Specifies that only those reservation sessions created 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 sessions are displayed. If you omit the whole qualifier, sessions for all users are displayed.

Examples

VDE„ SHOW SESSION
Reservation session FIX-SORT-BUG     28-JUN-1990 ANDERSON
Reservation session SMITH-1          25-JUN-1990 SMITH
Reservation session SMITH-2          27-JUN-1990 SMITH
VDE„
      

This example shows the brief output of the SHOW SESSION command. This output shows the session name, the date the session was created, and the username of the user to whom it belongs.

VDE„ SHOW SESSION/FULL FIX-SORT-BUG
Reservation session FIX-SORT-BUG
   Session created by user ANDERSON (Andy Anderson)
   Session created on 28-JUN-1990 17:49:40.71
   Session is for stream V2.0
   Unique session number is 26
   Reservations in session:
      Reservation 1 of [SYS]SORT.PAS
   Session contains 1 reservations
   Remark: Fix bug in sort routine
 
VDE„
      

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

VDE„ SHOW SESSION/TOTAL
Number of sessions matching name *: 4
VDE„
      

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

Displays build-step dependency information for the specified build steps. Build-step dependency information consists of the kind of each build step (compile, copy, or link), the name of the module that is compiled, copied, or linked by the step, and the names of the modules that are inputs to and outputs from the build step.

Format

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

Parameter

mod-name

The name of the module that is compiled, copied, or linked by the build step to be displayed. This 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, [FACNAM]MOD1.PAS). If no facility name is specified, the default facility is assumed. If no type name is specified, all build steps with the specified module name in the stated facility are displayed.

You can display more than one build step at a time 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 build steps that compile, copy, or link modules whose names match the wildcard pattern are displayed.

If no module-name parameter is specified, VDE displays all build steps that compile, copy, or link modules in the default facility.

Description

The SHOW STEP command displays build dependency information for the specified build steps. The command shows the kind (compile, copy, or link) of each step, the name of the module that is compiled, copied, or linked, and optionally the names of all modules that are inputs or outputs of the step. This is the build dependency information that the BUILD command uses to perform minimal system builds and to determine sequencing constraints between build steps. The SHOW STEP command always displays build-step information for the default development stream.

Qualifiers

/ALL (default)

/COMPILE

/COPY

/LINK

Displays compile steps, copy steps, link steps, or all steps for the specified modules. The /COMPILE qualifier displays only compile steps; the /COPY qualifier displays only copy steps; the /LINK qualifier displays only link steps; and the /ALL qualifier displays all three kinds of steps.

Of /ALL, /COMPILE, /COPY and /LINK, the former is the default.

/BRIEF (default)

/FULL

Determines the type of information that is displayed about each specified build step. The /BRIEF qualifier displays only the type of the build step (compile, copy, or link step) and the name of the module that is compiled, copied, or linked by the step. The /FULL qualifier displays the same information as the /BRIEF qualifier and also lists the names of all input and output modules for the build step. It also shows the total number of input and output modules for the step.

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

/CHANGE_LEVEL

Displays "change level" values for the inputs and outputs of each build step if used with the /FULL qualifier. The change level of a module is an integer value that indicates how recently the module has been updated for the default stream. Source modules are updated by the REPLACE command and certain other commands that affect the latest generation of the module for the stream. (INSERT GENERATION is an example of such a command.) Derived modules are updated when rebuilt with the BUILD, COMPILE, or LINK command. Modules that have been updated more recently have higher change level values than modules that have been updated less recently.

You can use the change level values to determine whether the output modules of a build step are up-to-date with respect to the input modules. If the output modules are up-to-date, they have the same change level value as the largest change level value among the input modules. If some input module has a higher change level value than the output modules, those output modules are not up-to-date with respect to that input module. As a result, the build step needs to be performed to propagate the changes to the input module to the output modules. VDE uses this information to determine what build steps to perform for minimal system builds.

/TOTAL

Shows the total number of build steps that match each specified mod-name parameter. Other information about the steps is not shown. Wildcard characters are usually used in the mod-name parameters when using this qualifier.

Examples

VDE„ SHOW STEP
Compile Step for module [CODE]FOO.MAR
Link Step for module [CODE]FOO.EXE
Link Step for module [CODE]MOD1.EXE
Compile Step for module [CODE]MOD1.FOR
Compile Step for module [CODE]MOD2.FOR
Link Step for module [CODE]MOD4.EXE
Compile Step for module [CODE]MOD4.FOR
Link Step for module [CODE]MOD6.EXE
VDE„
      

This example illustrates the SHOW STEP command without parameters or qualifiers. Because no parameter is specified, the command displays the default form of its output: all build steps for modules in the default facility (facility CODE) are displayed.

VDE„ SHOW STEP/FULL FOO/COMPILE, MOD1/LINK
Compile Step for module [CODE]FOO.MAR
   Dependency links for stream V2.1 follow
   Inputs to the build step:
      Module [CODE]FOO.MAR
   Outputs from the build step:
      Module [CODE]FOO.OBJ
   Build step has 1 inputs and 1 outputs
 
Link Step for module [CODE]MOD1.EXE
   Dependency links for stream V2.1 follow
   Inputs to the build step:
      Module [CODE]MOD1.OBJ
      Module [CODE]MOD2.OBJ
   Outputs from the build step:
      Module [CODE]MOD1.EXE
      Module [CODE]MOD1.MAP
   Build step has 2 inputs and 2 outputs
 
VDE„
      

This command displays the compile step for module FOO.MAR and the link step for module MOD1.EXE, both in the current default facility (facility CODE). Because the /FULL qualifier is specified, the command displays all dependency links for these build steps in the default stream, showing which modules are inputs to and outputs from each build step.

VDE„ SHOW STEP/FULL/CHANGE_LEVEL A.REQ, D.B32
Copy Step for module [FACIL]A.REQ
   Dependency links for stream MAIN follow
   Inputs to the build step:
      Module [FACIL]A.REQ with change level 30
   Outputs from the build step:
      Module [FACIL]A.REQ with change level 30 (up-to-date)
   Build step has 1 inputs and 1 outputs
 
Compile Step for module [FACIL]D.B32
   Dependency links for stream MAIN follow
   Inputs to the build step:
      Module [FACIL]A.REQ with change level 30
      Module [FACIL]D.B32 with change level 20
      Module [FACIL]B.L32 with change level 39
   Outputs from the build step:
      Module [FACIL]D.$OBJ with change level 39
      Module [FACIL]D.ANA with change level 39
   Build step has 3 inputs and 2 outputs
 
VDE„
      

This example shows the output of the /CHANGE_LEVEL qualifier. The change level value for module A.REQ is 30, and the "up-to-date" tag shows that the copy step has been performed since the last time module A.REQ was modified for stream MAIN. From the perspective of the VDE builder, A.REQ is thus up-to-date for the stream and the copy step is not needed for a minimal system build. The change level values for module D.B32 shows that the outputs of the compile step (with change level value 39) are up-to-date with respect to all the inputs to the step because the inputs have change level values that are less or equal to 39. In other words, no input module has changed since the last time the step was performed for stream MAIN.