V'0)8VDE

VDE

VDE
Reference Manual

Order Number: ??--?????--??

December 1997

NThis is a reference for the OpenVMS Development Environment (VDE) source code Acontrol and source code builder package. This reference provides _details of the OpenVMS Development Environment and the OpenVMS Source Control utilities; these Dutilities are used within various Digital engineering organizations including the OpenVMS group.

-Revision/Update Information:?This manual supersedes the VDE Reference Manual, Version 1.5-0.

"Software Version:VDE Version 1.5-0

*Operating System Version:1OpenVMS Alpha Version 6.2 OpenVMS VAX Version 6.2

EDigital Equipment Corporation Maynard, Massachusetts

11-DEC-1998 17:50:16.050

Copyright ©11-DEC-1998 17:50:16.05

?The following are trademarks of Digital Equipment Corporation: EBookreader, DEC Notes, DECdirect, Digital, OpenVMS, OpenVMS Cluster, 9VAX, VAX Document, VMScluster, VMS, and the DIGITAL logo.

)The following are third-party trademarks:

?Motif, OSF, OSF/1, OSF/Motif, and Open Software Foundation are ;registered trademarks of the Open Software Foundation, Inc.

CAll other trademarks and registered trademarks are the property of their respective holders.

, 4
DContents >Index

Preface

Intended Audience

BThis manual is intended for users who want to know how to use the OpenVMS Development Environment.5

Document Structure

VThis document contains a reference description of the OpenVMS Development Environment =(VDE) source code control and source code build environment. ?It provides users with reference information related to module Ereservations and replacements, replacement reviews, library creation +and various library maintenance operations.

/This manual contains the following information:

Chapter 1 provides a full description of the VDE Utility.i
Chapter 2 outlines the following VDE information:
- Invoking the utility
- Exiting from the utility
- Directing output0
- Restrictions and VDE privileges required
e
Chapter 3 contains the command reference for VDE I commands. This section includes the command format, command qualifiers and parameters, and examples.x
Appendix B contains information useful for working directly with 2 the VDE dependency recording callable interface.z
Appendix C contains information useful for working with the - unsupported VDE calling interface.l
Appendix E includes a list of error messages that can be displayed by VDE.

Associated Documents

Guide to Using VDE-
VDE Installation and New Features Guide

Conventions

CIn this manual, every use of OpenVMS Alpha means the OpenVMS Alpha Aoperating system, every use of OpenVMS VAX means the OpenVMS VAX Hoperating system, and every use of OpenVMS means both the OpenVMS Alpha 6operating system and the OpenVMS VAX operating system.

2The following conventions are used in this manual:
Ctrl/ x A sequence such as Ctrl/N x indicates that you must hold down the key labeled Ctrl while 8 you press another key or a pointing device button.
PF1 x A sequence such as PF1I x indicates that you must first press and release the key K labeled PF1, then press and release another key or a pointing device button.
GOLD x A sequence such as GOLDI x indicates that you must first press and release the key K defined GOLD, then press and release another key. GOLD key sequences L can also have a slash (/), dash (-), or underscore (_) as a delimiter in EVE commands.
[Return] K In examples, a key name enclosed in a box indicates that you press a J key on the keyboard. (In text, a key name is not enclosed in a box.)
... G A horizontal ellipsis in examples indicates one of the following possibilities:
I
Additional optional arguments in a statement have been omitted.H
The preceding item or items can be repeated one or more times.M
Additional parameters, values, or other information can be entered.

.
.
. N A vertical ellipsis indicates the omission of items from a code example N or command format; the items are omitted because they are not important # to the topic being discussed.
( ) L In format descriptions, parentheses indicate that, if you choose more C than one option, you must enclose the choices in parentheses.
[ ] K In format descriptions, brackets indicate optional elements. You can K choose one, none, or all of the options. (Brackets are not optional, D however, in the syntax of a directory name in an OpenVMS file I specification, or in the syntax of a substring specification in an assignment statement.)
{ } L In format descriptions, braces surround a required choice of options; 0 you must choose one of the options listed.
$ boldface text M Boldface text represents the introduction of a new term or the name of - an argument, an attribute, or a reason.F
Boldface text is also used to show user input in Bookreader versions of the manual.
italic text M Italic text emphasizes important information, indicates variables, and H indicates complete titles of manuals. Italic text also represents J information that can vary in system messages (for example, Internal error> number), command lines (for example, /PRODUCER=5 name), and command parameters in text.
UPPERCASE TEXT M Uppercase text indicates a command, the name of a routine, the name of 9 a file, or the abbreviation for a system privilege.
- K A hyphen in code examples indicates that additional arguments to the 4 request are provided on the line that follows.
numbers M All numbers in text are assumed to be decimal, unless otherwise noted. J Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.
mouse The termM mouse refers to any pointing device, such as a mouse, a puck, or a stylus.
MB1, MB2, MB3 J MB1 indicates the left mouse button, MB2 indicates the middle mouse L button, and MB3 indicates the right mouse button. (The buttons can be redefined by the user.)
PB1, PB2, PB3, PB4 : PB1, PB2, PB3, and PB4 indicate buttons on the puck.
SB, SB / SB and SB indicate buttons on the stylus.

Chapter 1
Introduction to VDE

MThe OpenVMS Development Environment (VDE) utilities assist OpenVMS engineers -in managing the software development process.

?This is the VDE reference manual. For a complete introduction, =overview of the VDE package, and for information on commonly @performed VDE tasks, please see the Guide to Using VDE.

5VDE commands enable OpenVMS engineers to perform the following tasks:

Create, modify, display, and delete information in a VDE C database such as that used by OpenVMS. This information includes I the users, facilities, modules, development streams, groups, and other G entities that define the software system that you want to manage and build.A
Define, set, and show current context and default settings.A
Build a software system. VDE can perform both complete and J minimal system builds. In a complete build, all modules in the software E system are compiled, linked, and otherwise processed. In a minimal I system build, only those modules that have been changed since the last 3 system build are compiled, linked, and processed.?
Reserve source modules from the VDE library and replace % them after they have been modified.:
Collect and report software development statistics.>
Transfer control to another process while still in VDE. A Users typically interact with the VDE package using either the 2 VDE or the VSC DCL commands. Both commands have 7 equivilent capabilities, though the VSC defaults are C specifically tailored to the requirements of OpenVMS engineering.

7VDE is implemented as a set of images, and several DCL commands.F

1.1 Using VDE

HThis section describes how to enter commands from within the utility or <from the DCL command line. It also describes how to use the VDE help facility.D

1.1.1 Entering VDE and VSC Commands

>You can enter VDE commands in either of two ways: by invoking Ethe utility and allowing it to prompt for input, or by including the )command directly on the DCL command line.

6There are two VDE interfaces supported within the VDE 3package: the VDE interface, and the VSC interface. BBoth interfaces support the same command verbs, and both function similarly.

AThe only salient differences between the two interfaces involves >differences in the invocation defaults and the prompt string: 5VDE is a general interface and does not default to a :particular source code library, while VSC is specifically Ctailored for users accessing the OpenVMS source code libraries and 'sets its library default appropriately.

FSave for the default options and cosmetic aspects such as the command 4prompt string, the VDE and VSC interfaces are fully )compatible and are fully interchangeable.

?Note that certain qualifiers present on the VDE utility---such Eas VDE/READ_UAF and VDE/STATUS---may invoke utilities other than the 5VDE utility. There may be no VSC equivilents to some of these VDE utilities.6

1.1.1.1 Invoking VDE

1 To invoke the VDE utility, enter the VDE or the 4 VSC command at the OpenVMS DCL prompt ($). OpenVMS 6 responds with the appropriate prompt for the utility.

"
$ VDEVDE> EXIT$ VSCVSC> EXIT$

FOnce the command has been invoked, you then can enter commands at the 4VDE prompt. For example, to display the default VDE (library, enter the SHOW LIBRARY command:

"
VDE> SHOW LIBRARY5Main library LIBNAME in root directory DEV$:[PROJDIR]VDE>

9 You are returned to the VDE prompt when the command has 5 executed and you then can enter another VDE command.

;Ending a Session

0To exit from VDE, enter the VDE command EXIT or press CTRL/Z.G

1.1.1.2 Entering Commands from DCL

7To enter a VDE command from the DCL command line, type 2VDE at the DCL prompt ($) then type a VDE command Aon the same DCL command line. The following example shows how to ,display the name of the default VDE library:

"
$ VDE SHOW LIBRARY5Main library LIBNAME in root directory DEV$:[PROJDIR]$

B You are returned to the DCL prompt ($) when the command has been H executed. For this reason, this form is most appropriate when you only $ need to enter a single VDE command.

6Multiple commands can be specified on a single VDE or 9VSC DCL command line by using a semicolon as a delimiter.

"
"VDE> SHOW LIBRARY; SHOW VERSION7Library VMS in root directory VSC$ROOTDISK:[VMS.DBROOT].Executing VDE for OpenVMS Alpha Version V1.5-0VDE>

9

1.1.1.3 Using Abbreviations

;All command and qualifier keywords for VDE commands can be Eabbreviated to the shortest unique abbreviation. The DELETE command, <for example, can be abbreviated to DEL because no other VDE Fcommand begins with those three letters. The DELETE command cannot be Aabbreviated to DE, however, because the DEFINE command makes the "two-letter abbreviation ambiguous.

Note

;The number of letters needed to reference a particular VDE 8command is subject to change in future releases of VDE. 0DIGITAL strongly recommends that all VDE or VSC Fcommands imbedded within command procedures specify the full command. 5This avoids errors should any particular VDE command Cabbreviation become ambiguous in a potential future release of the VDE package.

1.1.2 Using HELP

;The VDE interfaces contain a HELP command and an extensive Eonline HELP facility. To obtain help on a particular command, append the command to the HELP command.

"
VDE> HELP SHOW VERSION SHOW VERSION E Displays the VDE version string for the version of VDE you are running. Format SHOW VERSION % Additional information available:" Parameters Qualifiers Examples SHOW VERSION Subtopic?

EThe help library also contains a complete list of all error messages 'and the associated recovery procedures.M

1.2 Command Summary

<The following table lists all the available VDE commands by functional category: 8 9
Creating Database Information Modifying Database Information
CREATE CONTEXT MODIFY CONTEXT
CREATE DEPENDENCY MODIFY DEPENDENCY
CREATE FACILITY MODIFY FACILITY
CREATE GROUP MODIFY GROUP
CREATE LIBRARY MODIFY LIBRARY
CREATE MODULE MODIFY MODULE
CREATE SESSION MODIFY SESSION
CREATE STREAM MODIFY STREAM
CREATE USER MODIFY USER
: 8
Displaying Database Information Deleting Database Information
SHOW CONTEXT DELETE CONTEXT
SHOW DEPENDENCY DELETE DEPENDENCY
SHOW FACILITY DELETE FACILITY
SHOW GROUP DELETE GROUP
SHOW LIBRARY DELETE LIBRARY
SHOW MODULE DELETE MODULE
SHOW SESSION UNRESERVE/SESSION
SHOW STREAM DELETE STREAM
SHOW USER DELETE USER
:
Setting the Development Context
SHOW DEFAULTS SET STREAM
SET LIBRARY SET PRIVILEGES
SHOW LIBRARY CANCEL PRIVILEGES
SET CONTEXT SHOW PRIVILEGES
SET FACILITY RESERVE/SESSION
CREATE CONTEXT MODIFY CONTEXT
SHOW CONTEXT DELETE CONTEXT
SHOW SESSION UNRESERVE/SESSION
, .
Reserving Modules Building the System
RESERVE BUILD
REPLACE COMPILE
UNRESERVE LINK
FETCH TEST
8
Defining Directory Structures
SET DIRECTORY CANCEL DIRECTORY
SHOW DIRECTORY CREATE DIRECTORY_TREE
(
Mode Settings
SHOW ALL SET VERIFY
SET LOG SET NOVERIFY
CANCEL LOG CANCEL VERIFY
SHOW LOG SHOW VERIFY
SET TERMINAL
SHOW TERMINAL
( :
Tailoring VDE Exiting or Transferring Control
DEFINE/COMMAND HELP
DELETE/COMMAND @ file-name
SHOW SYMBOL SPAWN
DEFINE/KEY ATTACH
DELETE/KEY EXIT
SET KEY
SHOW KEY
SET PROMPT

Creating Database Information	Modifying Database Information
CREATE CONTEXT	MODIFY CONTEXT
CREATE DEPENDENCY	MODIFY DEPENDENCY
CREATE FACILITY	MODIFY FACILITY
CREATE GROUP	MODIFY GROUP
CREATE LIBRARY	MODIFY LIBRARY
CREATE MODULE	MODIFY MODULE
CREATE SESSION	MODIFY SESSION
CREATE STREAM	MODIFY STREAM
CREATE USER	MODIFY USER

Displaying Database Information	Deleting Database Information
SHOW CONTEXT	DELETE CONTEXT
SHOW DEPENDENCY	DELETE DEPENDENCY
SHOW FACILITY	DELETE FACILITY
SHOW GROUP	DELETE GROUP
SHOW LIBRARY	DELETE LIBRARY
SHOW MODULE	DELETE MODULE
SHOW SESSION	UNRESERVE/SESSION
SHOW STREAM	DELETE STREAM
SHOW USER	DELETE USER

Setting the Development Context
SHOW DEFAULTS	SET STREAM
SET LIBRARY	SET PRIVILEGES
SHOW LIBRARY	CANCEL PRIVILEGES
SET CONTEXT	SHOW PRIVILEGES
SET FACILITY	RESERVE/SESSION
CREATE CONTEXT	MODIFY CONTEXT
SHOW CONTEXT	DELETE CONTEXT
SHOW SESSION	UNRESERVE/SESSION

Reserving Modules	Building the System
RESERVE	BUILD
REPLACE	COMPILE
UNRESERVE	LINK
FETCH	TEST

Defining Directory Structures
SET DIRECTORY	CANCEL DIRECTORY
SHOW DIRECTORY	CREATE DIRECTORY_TREE

Mode Settings
SHOW ALL	SET VERIFY
SET LOG	SET NOVERIFY
CANCEL LOG	CANCEL VERIFY
SHOW LOG	SHOW VERIFY
SET TERMINAL
SHOW TERMINAL

Tailoring VDE	Exiting or Transferring Control
DEFINE/COMMAND	HELP
DELETE/COMMAND	@ file-name
SHOW SYMBOL	SPAWN
DEFINE/KEY	ATTACH
DELETE/KEY	EXIT
SET KEY
SHOW KEY
SET PROMPT

Next[

Contents]

Index

Ctrl/ x	A sequence such as Ctrl/N x indicates that you must hold down the key labeled Ctrl while 8 you press another key or a pointing device button.
PF1 x	A sequence such as PF1I x indicates that you must first press and release the key K labeled PF1, then press and release another key or a pointing device button.
GOLD x	A sequence such as GOLDI x indicates that you must first press and release the key K defined GOLD, then press and release another key. GOLD key sequences L can also have a slash (/), dash (-), or underscore (_) as a delimiter in EVE commands.
`[Return]`	K In examples, a key name enclosed in a box indicates that you press a J key on the keyboard. (In text, a key name is not enclosed in a box.)
...	G A horizontal ellipsis in examples indicates one of the following possibilities: I Additional optional arguments in a statement have been omitted.H The preceding item or items can be repeated one or more times.M Additional parameters, values, or other information can be entered.
. . .	N A vertical ellipsis indicates the omission of items from a code example N or command format; the items are omitted because they are not important # to the topic being discussed.
( )	L In format descriptions, parentheses indicate that, if you choose more C than one option, you must enclose the choices in parentheses.
[ ]	K In format descriptions, brackets indicate optional elements. You can K choose one, none, or all of the options. (Brackets are not optional, D however, in the syntax of a directory name in an OpenVMS file I specification, or in the syntax of a substring specification in an assignment statement.)
{ }	L In format descriptions, braces surround a required choice of options; 0 you must choose one of the options listed.
$ boldface text	M Boldface text represents the introduction of a new term or the name of - an argument, an attribute, or a reason.F Boldface text is also used to show user input in Bookreader versions of the manual.
italic text	M Italic text emphasizes important information, indicates variables, and H indicates complete titles of manuals. Italic text also represents J information that can vary in system messages (for example, Internal error> number), command lines (for example, /PRODUCER=5 name), and command parameters in text.
UPPERCASE TEXT	M Uppercase text indicates a command, the name of a routine, the name of 9 a file, or the abbreviation for a system privilege.
-	K A hyphen in code examples indicates that additional arguments to the 4 request are provided on the line that follows.
numbers	M All numbers in text are assumed to be decimal, unless otherwise noted. J Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.
mouse	The termM mouse refers to any pointing device, such as a mouse, a puck, or a stylus.
MB1, MB2, MB3	J MB1 indicates the left mouse button, MB2 indicates the middle mouse L button, and MB3 indicates the right mouse button. (The buttons can be redefined by the user.)
PB1, PB2, PB3, PB4	: PB1, PB2, PB3, and PB4 indicate buttons on the puck.
SB, SB	/ SB and SB indicate buttons on the stylus.

VDE

VDE Reference Manual