| Previous[ | Contents] | Index |
:Establishes the context of the current VDE session or the :default context for future VDE sessions. A context can be Eused to specify the default development stream, default architecture 'and default facility for a VDE session.
SET CONTEXT ctx-name
ctx-name
9Specifies the context for the current VDE session or the <default context for future VDE sessions. The parameter must <be the name of an existing public or private context in the VDE database.
7This command establishes a context for the current VDE Bsession or establishes the default context for future sessions. A (context sets the following two defaults:9
BUsing a SET CONTEXT command is equivalent to using individual SET @STREAM and SET FACILITY commands to establish the same settings.- the default development stream for the VDE session+
- the default facility for the session
GIf you specify the /DEFAULT qualifier, the context becomes the default -for future VDE sessions and VDE records that Esetting in the database. The context of the current session does not Bchange. If you do not specify the /DEFAULT qualifier, the command 4establishes the context for the current VDE session.
2To display contexts, use the SHOW CONTEXT command.
/DEFAULT
DEstablishes the specified context as the default context for future 8VDE sessions. The context of the current session is not changed.DIf you do not use this qualifier, the specified context becomes the !context for your current session.
/PRIVATE (default)
/PUBLIC
ESpecifies whether the context to set is a private or public context. AThe /PRIVATE qualifier specifies that the context is an existing Hprivate context. The /PUBLIC qualifier specifies that the context is an ;existing public context. If neither qualifier is not used, 9VDE assumes that the specified context is private to you.1Of /PRIVATE and /PUBLIC, /PRIVATE is the default.
6
| #1 |
|---|
VDEä SET CONTEXT BUGFIXESVDEä SHOW DEFAULTS0Library LIBNAME in root directory DEV$:[PROJDIR]!Default directory is DEV$:[SMITH](Context BUGFIXES (private to user SMITH) Default stream is V2.2-BL1 Default facility is RMS VDEä |
6;The SET CONTEXT command takes the defaults for the current =VDE session from context BUGFIXES. The SHOW DEFAULTS command Cconfirms that those defaults have been established for the session.
| #2 |
|---|
VDEä SET CONTEXT/DEFAULT FOOVDEä |
CThis command makes context FOO the default context for the current user's future VDE sessions.
=Sets or modifies the current settings of the developer flags.HUse this command only under the explicit direction of, and with ,the assistance of, a VDE developer.
!SET DEVELOPER dev-flags
vUnder Construction... Table 3-4 contains various parameters.Z $ &
Table 3-4 Parameters Parameter Description LOCK NOMAIL SHOW SYNCH NONOTES
6
| #1 |
|---|
VDEä SET DEVELOPER&Under Construction...VDEä SET DEVELOPER SCRIPTVDEä |
<Creates a directory template in the VDE database. Directory ;templates determine what disk directories VDE creates when Ccreating new streams and facilities and various disk storage areas.
SET DIRECTORY dir-spec
dir-spec
8Specifies a OpenVMS directory specification for the new @directory template. This parameter may specify an absolute or a Frelative directory specification. An absolute directory specification <is a fully specified OpenVMS directory name and follows the <normal syntax for such names. You use an absolute directory Dspecification when you want to decide the exact disk location for a ;directory in the VDE library. For example, you may want to ?locate a new stream's root directory on a specific disk before 7VDE creates the stream's directory tree. The parameter FDEV:[DIRNAM.FOO] is an example of an absolute directory specification.DA relative directory specification begins with a left bracket and a Gperiod ([.), then contains one or more subdirectory names separated by ;periods, and ends with a right bracket (]). This directory Bspecification is concatenated to the name of the appropriate root Edirectory to form a full directory specification. You use a relative <directory specification to specify a subdirectory name that 4VDE should use relative to some root directory. The Ddirectory specification [.SRC], for example, can be used to specify Ethat a facility subdirectory named SRC should be created within each facility's root directory.
GThe SET DIRECTORY command creates a new "directory template" =in the VDE database. A directory template specifies the name ;that VDE should assign to each disk directory of a certain Fkind when creating directories for new streams or facilities. You can Fcreate directory templates for stream root directories, facility root Ddirectories, facility subdirectories, the library's delta-file root Ddirectory, and the library's staging-area root directory for queued replacements.G(The library root directory is created when you create the library and cannot be changed thereafter.)EThe SET DIRECTORY command does not itself create new directories; it <only stores the new directory template in the VDE database. =VDE does not use the template to create new disk directories Huntil a subsequent CREATE STREAM or CREATE FACILITY command creates the Gdirectory tree for a new stream or facility. The CREATE DIRECTORY_TREE Gcommand uses directory templates to create directories for an existing stream or facility.
HUnless the new template is for the library's delta files or its staging Farea, it is only defined for the default development stream. However, Edirectory templates are inherited by the stream's future descendants Hand are used to create the disk directories for those descendants. They Bare also used to create directory trees for new facilities in the default stream.
DIf you want to create directory templates for a new stream, you can Dspecify the templates for the parent stream, in which case they are Hautomatically applied to all child streams. You must then enter the SET EDIRECTORY command before you enter the CREATE STREAM command for the Bnew stream. Alternatively, you can create the new stream with the >/DEFER qualifier on the CREATE STREAM command. This qualifier Hsuppresses directory-tree creation for the new stream. You can then use Ethe SET STREAM command to make the new stream the default stream and Duse the SET DIRECTORY command to create the directory templates you Hwant. A subsequent CREATE DIRECTORY_TREE command uses the new templates H(and any applicable default rules) to create the directory tree for the Hnew stream. The /DEFER qualifier thus defers directory-tree creation so Bthat you can enter SET DIRECTORY commands before creating the new directory tree.
GYou may also want to create directory templates for a new facility. If Fthe templates should apply to that facility only, you must create the Gnew facility with the /DEFER qualifier on the CREATE FACILITY command. HThis qualifier suppresses directory-tree creation for the new facility. GYou then use the SET DIRECTORY command with the /FACILITY qualifier to Hcreate the directory templates you want for that facility. A subsequent CCREATE DIRECTORY_TREE command uses the new templates to create the directory tree for the facility.
CFor additional information on directory creation, and on directory Csymbols (dir-symbol) and directory symbol processing, see ╙CANCEL DIRECTORY, SHOW DIRECTORY, and Script Functions.
/DEFER
/NODEFER (default)
DThe /DEFER qualifier specifies that directory tree creation for new Estreams be deferred when those streams are created. This action only Happlies to new streams for which the default stream is the parent. This Hqualifier should be used when you always want an opportunity to alter a @new stream's directory templates before you actually create its Edirectory tree. The /NODEFER qualifier specifies that directory tree Dcreation not be deferred for new streams unless the user explicitly 9uses the /DEFER qualifier with the CREATE STREAM command./DELTA_FILES
/STAGING
/STREAM (default)
<Specifies whether the new directory template is for the VDE Hlibrary's delta files, for its staging area, or for the default stream. HThe /DELTA_FILES qualifier specifies that the new directory template is Ffor directories that store the library's delta files (CMS libraries). TheH/STAGING qualifier specifies that the new directory template is for the Elibrary's staging-area root directory. (Staging areas hold files for Bqueued replacements.) The /STREAM qualifier specifies that the newGdirectory template is for directories that store files for the current Gdefault stream. Because streams inherit directory templates from their Dparents, the /STREAM qualifier causes the new directory template to 8apply to all of the default stream's future descendants.>Of /DELTA_FILES, /STAGING and /STREAM, /STREAM is the default.
/FACILITY=fac-name
GSpecifies that the new directory template only applies to the facility Egiven by the fac-name parameter. This parameter may @not contain wildcard characters. If both this qualifier and the 5/SUBDIRECTORY qualifier are specified, VDE creates a Cdirectory template for the specified facility subdirectory. If the D/FACILITY qualifier is specified and the /SUBDIRECTORY qualifier is =omitted, VDE creates a template for the specified facility's root directory.FIf the /FACILITY qualifier is omitted and the /SUBDIRECTORY qualifier 7is specified, VDE creates a directory template for the Afacility subdirectory for all facilities that are not explicitly Fspecified in other templates. If both the /FACILITY qualifier and the </SUBDIRECTORY qualifier are omitted, VDE creates a template ,for the stream or delta-file root directory.
/LOG (default)
/NOLOG
GControls whether log messages are printed after the directory template Fis created. The /LOG qualifier causes such messages to be printed and Gthe /NOLOG qualifier suppresses them. These messages indicate that the Hdirectory template has been added to the database and that the database 'transaction has completed successfully./PROMPT
/NOPROMPT (default)
FThe /PROMPT qualifier specifies that users who create new streams for Gwhich the default stream is the parent be prompted for the name of the Gnew stream's root directory. This qualifier should be used when you do Enot want to use the default root directory name for new streams, but Dwant the user to explicitly select the location of the new stream's Bdirectory tree each time (perhaps to select a different disk each Ftime). The /NOPROMPT qualifier specifies that a new stream should get <the root directory determined by VDE's default rules unless Ethe user explicitly specifies otherwise on the CREATE STREAM command./REMARK="string"
GSpecifies a remark string to be stored for the new directory template. FThe quoted remark string, which can be up to 132 characters long, may Econtain any explanatory remark about the new directory template that $you want stored in the VDE database.!/SUBDIRECTORY=dir-symbol
<Specifies that the new directory template is for a facility Fsubdirectory. The dir-symbol parameter specifies the directory symbolH that you want to associate with the subdirectory. The directory symbol ; must follow normal VDE name syntax. You use the directory > symbol in VDE scripts to reference the subdirectory; see the @ description of the CREATE SCRIPT command for an explanation of 9 VDE scripts. If the /SUBDIRECTORY qualifier is omitted, = VDE creates a directory template for a facility, stream, or H delta-file root directory. (The description of the /FACILITY qualifier H explains how the qualifiers interact to select the template to create.)HWhen you specify facility subdirectories for delta-files, the directory ;symbol may have a special meaning to VDE. If you specify a 'delta-file subdirectory with the symbol+ VDE$CMS, VDE puts the CMS library for the>facility in that subdirectory instead of in the facility root Cdirectory. If you specify a delta-file subdirectory with the symbol: VDE$MARKER, VDE puts the actual source files for modules D that use "marker files" in that subdirectory. If you use C marker files, you must have both a marker-file subdirectory and a H CMS-library subdirectory. (The description of the /MARKER qualifier to B the CREATE MODULE command discusses marker files in more detail.)
6
| #1 |
|---|
4VDEä SET DIRECTORY/STREAM/SUBDIRECTORY=ANASYM [.ANA]E%VDE-I-DIRADDED, directory specification [.ANA] added to the database>%VDE-I-COMMIT, database transaction has successfully committedVDEä SHOW DIRECTORY/Directory-creation templates for stream V2.1-1: Directory creation flags:< Do not defer creation of directory tree for substreams5 Do not prompt for root directory for substreams 0 Stream root directory is [.V2_1-1] by default1 Subdirectory: [.VDE$BLD] (symbol VDE$BLD) 2 Directory templates for unspecified facilities:, Subdirectory: [.ANA] (symbol ANASYM)) Subdirectory: [.OBJ] (symbol OBJ)) Subdirectory: [.SRC] (symbol SRC)1 Subdirectory: [.VDE$COM] (symbol VDE$COM)1 Subdirectory: [.VDE$LOG] (symbol VDE$LOG) 4 All other directories created using default rules VDEä |
6=This example creates a directory template for a new facility Gsubdirectory. The directory specification is [.ANA], which says that a Fsubdirectory called ANA should be created within each facility's root Edirectory. The directory symbol associated with that subdirectory is ANASYM. This symbol; is used in VDE scripts to reference the subdirectory. The H SHOW DIRECTORY command shows that the new directory template is stored in the database.
| #2 |
|---|
+VDEä SET DIRECTORY/FACILITY=RMS [MYDIR.RMS]J%VDE-I-DIRADDED, directory specification [MYDIR.RMS] added to the database>%VDE-I-COMMIT, database transaction has successfully committedVDEä SHOW DIRECTORY/Directory-creation templates for stream V2.1-1: Directory creation flags:< Do not defer creation of directory tree for substreams5 Do not prompt for root directory for substreams 0 Stream root directory is [.V2_1-1] by default1 Subdirectory: [.VDE$BLD] (symbol VDE$BLD) 2 Directory templates for unspecified facilities:) Subdirectory: [.OBJ] (symbol OBJ)) Subdirectory: [.SRC] (symbol SRC)1 Subdirectory: [.VDE$COM] (symbol VDE$COM)1 Subdirectory: [.VDE$LOG] (symbol VDE$LOG) ( Directory templates for facility RMS:! Root directory: [MYDIR.RMS] 4 All other directories created using default rules VDEä |
DThis example creates a directory template for the root directory of Ffacility RMS. The directory specification is [MYDIR.RMS], an absolute 9directory specification for the root directory. VDE will @create this directory for facility RMS when a subsequent CREATE GDIRECTORY_TREE command is entered for that facility or a new stream is Gcreated from the default stream. The SHOW DIRECTORY command shows that 5the new directory template is stored in the database.
8The following example shows an example of a VDE library ;creation, including a number of directory-related commands.
"$ G$! Locate and delete previous incarnations of the test facility files, 8$! then unpack the saveset containing the test files... $ P$ if f$search("sys$scratch:A.REQ") .nes. "" Then Delete sys$scratch:A.REQ;*/log P$ if f$search("sys$scratch:B.REQ") .nes. "" Then Delete sys$scratch:B.REQ;*/log P$ if f$search("sys$scratch:C.B32") .nes. "" Then Delete sys$scratch:C.B32;*/log P$ if f$search("sys$scratch:D.B32") .nes. "" Then Delete sys$scratch:D.B32;*/log P$ if f$search("sys$scratch:E.B32") .nes. "" Then Delete sys$scratch:E.B32;*/log P$ if f$search("sys$scratch:F.B32") .nes. "" Then Delete sys$scratch:F.B32;*/log $ *$ Backup VDE$CREATE.BCK/SAVE Sys$Scratch: $ 8$! Create the core directory -- this must be present... $ 4$ Create/Directory STAR$DATA:[QTV.WWW.VDE$DATABASE] $ VDE ! >! create the WWW library in STAR$DATA:[QTV.WWW...], using the >! mnemonic WWW, placing all Rdb-related library components in $! STAR$DATA:[QTV.WWW.VDE$DATABASE]. ! 9create librar STAR$DATA:[QTV.WWW.VDE$DATABASE] /DEFER - /NAME=WWW - $ /REMARK="QTV WWW Source Library" - 8 /NOAUTO_CONVERT /AUTO_ADD_USER=VMS_SOURCE /AUTO_MAIL - = /ASK_INFO_FILE /ASK_REPL_CAUSE /SHOW_GEN_EXPR /NOSTATISTI - 4 /NOHISTORY_NOTES /NOALLOW_DELETE /NOWILD_INS_GEN - / /NOCMS_ELEM_HIST /CREATOR="Stephen Hoffman" - * /DEF_PRIVILEGES=(CREMOD,RESREP,CREFAC) - + /AUTH_PRIVILEGES=(CREMOD,RESREP,CREFAC) - * /data=STAR$DATA:[QTV.WWW.VDE$DATABASE] - + /journ=STAR$DATA:[QTV.WWW.VDE$DATABASE] - ( /snap=STAR$DATA:[QTV.WWW.VDE$DATABASE] ! SHOW DEFAULTS SHOW LIBRARY/FULL 2MODIFY CONTEXT/PUBLIC DEFAULT/NOSTREAM/NOFACILITY ! ,CREATE USER SYSTEM /NAME="System Manager" - 2 /DEF_P=ALL/AUTH_P=ALL/REMARK="System Manager" ! 8! Create the CMS ("delta") library directory structure. >! Configure the CMS libraries to use the directory structure: 5! STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.CMS]. ?! Configure the "marker" files to use the directory structure: 7! STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.SRC]... ! ;SET DIRECTORY/DELTA_FILES STAR$DATA:[QTV.WWW.CMS$DATABASE] 6SET DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$CMS [.CMS] 9SET DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$MARKER [.SRC] "CREATE DIRECTORY_TREE/DELTA_FILES SHOW DIRECTORY/DELTA_FILES ! ! Create the staging area... ! 6SET DIRECTORY/STAGING STAR$DATA:[QTV.WWW.VDE$STAGING] CREATE DIRECTORY_TREE/STAGING ! &! Create the stream/build directories ! 5SET DIRECTORY/STAGING STAR$DATA:[QTV.WWW.VDE$STREAM] CREATE DIRECTORY_TREE/STREAM ! )! create and load the VDE test facility. ! CREATE FACILITY AAA_VDE_TEST - / /REMARK="Test facility for VDE developers" SET FACILITY AAA_VDE_TEST" 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: A.REQ 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: B.REQ 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: C.B32 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: D.B32 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: E.B32 7CREATE MODULE/NODELETE/REMARK="VDE self-test module" - /INPUT=SYS$SCRATCH: F.B32 ! EXIT $ $ Exit
3Specifies the editor that VDE should use for those #VDE commands that invoke an editor.
$SET EDITOR "editor-string"
editor-string
<The DCL command that VDE should spawn to invoke the desired Ceditor. This string should include the editor name and any desired <qualifiers. VDE will append the name of the file to edit to %this string when invoking the editor.
<The SET EDITOR command specifies the editor that VDE should <use when a subsequent VDE command must invoke an editor for =you. VDE can invoke an editor for you when you review queued replacements, for example, orEwhen you create a comment file with the ACCEPT or REJECT REPLACEMENT :command. In such cases, VDE spawns a DCL command to place @you in an editing session. The spawned DCL command is formed by Gconcatenating your editor string, a space, and the name of the file to Eedit. The editor string that you specify with the SET EDITOR command Eshould thus give the DCL command that invokes your preferred editor, 9along with any qualifiers that you want for that command.;VDE maintains two editor strings in memory for the current ;VDE session. One string is used for read-write editing and Athe other for read-only editing. Use the /READ_ONLY qualifier to Gspecify the read-only editor string. If you do not specify a read-only Aeditor string (or if you specify the null string for this case), 3VDE assumes that the editor you specified with the Dread-write editor string will accept the /READ_ONLY qualifier (most 3Digital editors do). In this case, VDE appends the B/READ_ONLY qualifier to your read-write editor string to form the @read-only editor string. For example, if you specify TPU as the ;read-write editor string but no read-only editor, then VDE 4uses the string TPU/READ_ONLY for read-only editing.
CThe SET EDITOR command always modifies the read-write or read-only :editor string for the current VDE session. If you specify Dthe /DEFAULT qualifier, the command in addition writes your current 6editor settings to the VDE database to establish your 0default editor strings for future VDE sessions. <VDE retrieves these editor strings each time you connect to the VDE database.
CIf you do not use the SET EDITOR command to declare your preferred 0editor, VDE uses the system default text editor.
/DEFAULT
<Specifies that VDE should write the editor strings for your ;current session to the VDE database and that those strings 5should be your default editor strings for future VDE sessions./LOG (default)
/NOLOG
HControls whether log messages are printed after your editor strings are <written to the VDE database. The /LOG qualifier causes such Gmessages to be printed and the /NOLOG qualifier suppresses them. These Cmessages, which only appear if you specify the /DEFAULT qualifier, Gindicate that the editor strings have been updated in the database and 9that the database transaction has successfully committed./READ_ONLY
ASpecifies that you are establishing the editor string to use for 5read-only editing. If this qualifier is omitted, VDE <establishes the editor string to use for read-write editing.
6
| #1 |
|---|
VDEä SET EDITOR "LSEDIT"VDEä SHOW EDITORCurrent editor strings:# Read-write editor string: LSEDIT- Read-only editor string: LSEDIT/READ_ONLYVDEä |
6FThis example establishes LSEDIT (which invokes the Language-Sensitive BEditor) as your read-write editor string. The SHOW EDITOR command Hconfirms that this is now your current read-write editor string, and it <shows that VDE will append the /READ_ONLY qualifier to this string for read-only editing.
| #2 |
|---|
)VDEä SET EDITOR/READ_ONLY "EDIT/EDT/READ"VDEä SHOW EDITORCurrent editor strings:# Read-write editor string: LSEDIT* Read-only editor string: EDIT/EDT/READVDEä |
6DThis example defines the editor string to use for read-only editing.
| #3 |
|---|
VDEä SET EDITOR/DEFAULT "TPU"H%VDE-I-EDITUPDATE, default editor definition updated in the VDE database>%VDE-I-COMMIT, database transaction has successfully committedVDEäVDEä SHOW EDITOR/FULLCurrent editor strings: Read-write editor string: TPU* Read-only editor string: TPU/READ_ONLYDefault editor strings: Read-write editor string: TPU* Read-only editor string: TPU/READ_ONLYVDEä |
BThis example establishes TPU as your editor. Because the /DEFAULT <qualifier is specified, VDE then writes your current editor 1strings to the VDE database to be used in future 7VDE sessions. The SHOW EDITOR command shows that these Gsettings have been established both for the current session and as the default for future sessions.
| PreviousX | Next[ | Contents] | Index |