| Previous[ | Contents] | Index |
5Establishes the default facility for the current VDE Csession. The default facility is the facility to which a module is Hassumed to belong when no facility is specified in the module name. The Cdefault facility also can be assigned with the SET CONTEXT command.
!SET FACILITY facil-name
facil-name
ESpecifies the name of the facility that becomes the default facility for the current VDE session.
None.
6
| #1 |
|---|
VDEä SET FACILITY RMSVDEä SHOW MODULE MOD1.MARModule [RMS]MOD1.MARVDEä SHOW DEFAULTS0Library LIBNAME in root directory DEV$:[PROJDIR]!Default directory is DEV$:[SMITH]Current session context: Default stream is MAIN Default facility is RMSVDEä |
EThe SET FACILITY command makes facility RMS the default facility for 6the current VDE session. The SHOW MODULE command then Dspecifies a module name without a facility name. The module is thus Hassumed to belong to facility RMS. The SHOW DEFAULTS command also shows Ethat RMS has been established as the default facility in the current session.
BSets and locks the key-definition state for keys defined with the DEFINE/KEY command.
SET KEY
FUsing the DEFINE/KEY command you can create as many definitions for a Hkey as you want. However, each definition of the key must be assigned a Gseparate context or state. For example, if you create Hfive definitions for the PF4 key you must create five different states, Done for each definition of the key. If you do not specify its state Ebefore you process a definition, the definition does not take effect.HThe SET KEY command lets you switch from the current state to any other Cstate; you then can use the key definitions created for that state.
/LOG (default)
/NOLOG
GControls whether the system displays a message indicating that the key Cstate has been set. /LOG causes such a message to be displayed and /NOLOG suppresses it./STATE=state-name
/NOSTATE (default)
ESpecifies the name of the state to be set. The state name can be any Galphanumeric string. If you omit the /STATE qualifier or use /NOSTATE, $the current state is left unchanged.
6
| #1 |
|---|
VDEä SET KEY/STATE=GOLD |
HThe SET KEY command in this example sets the key state to GOLD. You can @now use the key definitions that are defined for the GOLD state.
0Connects the current VDE session to a specified VDE library.
SET LIBRARY dir-spec
dir-spec
:The name of the root directory of a VDE library. The root Fdirectory is the disk directory that contains the library's database. ,VDE connects the current VDE session to the ;specified library. Use the OpenVMS directory specification !format to specify this parameter.<VDE also accepts mnemonic names for the libraries, based on Ethe contents of various logical names, and the list of libraries and Cthe particular mnemonics can be tailored for individual users, for =groups of users, and can be defaulted on a system-wide basis.
:The SET LIBRARY command disconnects your VDE session from /the current VDE library and connects it to the :VDE library whose root directory or mnemonic you specify. :Subsequent VDE commands then act on the specified library.CTo connect to the specified library, the SET LIBRARY command first Edefines logical name VDE$LIBRARY to point to the specified directory.EIt then connects to the library you specified and reads its database.
6Based on the information contained in the VDE library =database, VDE checks to see if you are authorized to use the Fnew library. If you are presently listed as an authorized user of the Blibrary, if the library is set to allow the automatic addition of >users, or if you should possess the OpenVMS BYPASS privilege, VDE6permits access, and you can continue your VDE session normally.
=Use of the OpenVMS privilege override is audited, and an -informational message will be displayed.
;VSC also supports the SET LIBRARY command, but it defaults to the OpenVMS VAX library.
/I BShould the filename, file extension and/or file version number be Eerroneously specified in the parameter, the SET LIBRARY command will Gsilently ignore them. Only the device and directory specifications are Dgermane to the command; the appropriate filename and file extension ;will be appended to the device and directory specification.
DFor further information on mnemonics, see the VDE$LIBRARY_DEFAULTS, HVDE$LIBRARY_DEFAULTS_LABELS, and VDE$LIBRARY_DEFAULTS_MNEMONICS logical names.HTo see the list of mnemonics available, and the translations associated *with each, use the following DCL commands:
CIf the VDE$LIBRARY_DEFAULTS_MNEMONICS logical name is defined, SET >LIBRARY commands are available via keyboard [F17], D[F18], [F19] and [F20] keys. Up to Gtwelve keyboard definitions can be present, depending on the number of Gtranslations of VDE$LIBRARY_DEFAULTS_MNEMONICS present; the first four Bmnemonics are available in the default keypad state, the Bsecond four in the gold state, and the third four in the blue state.
"$ 7$! These logical names can be (re)defined in the site- 8$! specific VDE system startup command procedure, or on 6$! a process-, job-, group- or system-specific basis. $ 5$! Each logical name is a search list, and the first 4$! entry in VDE$LIBRARY_DEFAULTS corresponds to the 6$! first entry in VDE$LIBRARY_DEFAULTS_MNEMONICS, and ($! in VDE$LIBRARY_DEFAULTS_LABELS, etc. $! 3$! Display the list of known/predefined libraries: $$ SHOW LOGICAL VDE$LIBRARY_DEFAULTS $ -$! Display the mnemonic name of each library .$ SHOW LOGICAL VDE$LIBRARY_DEFAULTS_MNEMONICS $ ,$! Display the textual name of each library +$ SHOW LOGICAL VDE$LIBRARY_DEFAULTS_LABELS $
None.
6
| #1 |
|---|
VDEä SET LIBRARY DEV$:[PROJDIR]VDEä |
1This example connects the VDE session to the VDE ?library whose root directory is DEV$:[PROJDIR]. All subsequent ;VDE commands act on that library until the current library is again changed.
+Records VDE input and output in a log file.
SET LOG [file-spec]
file-spec
;The name of the log file to be created. All subsequent VDE Einput and output is recorded in this file until logging is disabled. 5File-spec is any valid OpenVMS file >specification. The default file extension is LOG. If the file Bspecification is omitted, the default file name is VDELOGFILE.LOG.
<The SET LOG command records all VDE input and output in the Especified log file. Input is recorded as entered. Output is recorded Gwith a leading exclamation point (!). Because the exclamation point is 9the VDE comment character, you can use the log file as a ;command procedure to rerun the logged VDE session. Use the 7CANCEL LOG command to disable input and output logging.
None.
6
| #1 |
|---|
VDEä SET LOG MYLOG VDEä SHOW LOG/Output logging on file: DEV$:[MYDIR]MYLOG.LOG;1VDEä |
-The SET LOG command creates the VDE log file @[MYDIR]MYLOG.LOG. All subsequent commands and their outputs are Drecorded in this file. The SHOW LOG command confirms that output is being logged to this file.
@Disables the display (or echo) of command input to the terminal.
SET NOVERIFY
None.
FThe SET NOVERIFY command disables the display of command input to the Cterminal. It cancels the effect of the SET VERIFY command. The SET 3NOVERIFY and CANCEL VERIFY commands are equivalent.
None.
6
| #1 |
|---|
VDEä SET VERIFYVDEä SHOW MODULE MOD1.FORSHOW MODULE MOD1.FORModule [FACIL]MOD1.FORVDEä SET NOVERIFY SET NOVERIFYVDEä SHOW FACILITY FACILFacility FACILVDEä |
DThe SET VERIFY command enables command echoing. Therefore, the SHOW EMODULE command is displayed on the terminal before the output of the Fcommand is displayed. The SET NOVERIFY command is also echoed but the Gcommand disables the display of subsequent commands. The SHOW FACILITY Gcommand that follows is not echoed on the terminal; only its output is displayed.
+Enables VDE privileges for the current VDE session.
)SET PRIVILEGES priv [, priv...]
priv
=The name of a privilege enabled for the current VDE session. GYou can enable only those privileges for which you have authorization. BTo list the privileges for which you are authorized, use the SHOW gPRIVILEGES/FULL command. Table 3-5 contains a list of VDE privileges.W $ &
>The project administrator privileges are those that a project Gadministrator needs to add users to the library; to create facilities, Gmodules, and streams; to run build jobs; and to administer the project.
Table 3-5 Privileges Privilege Description BUILD : Permits a user to create build jobs in this library. CRECTX ; Allows a user to create, modify, and delete contexts. CREFAC 9 Allows the creation and modification of facilities. CREGRP E Permits the creation, modification, and the deletion of groups. CREMOD 6 Allows the creation and modification of modules. CRESCRP G Required for the creation, modification, and deletion of scripts. CRESTEP I Allows the creation, modification, and the deletion of build steps. CRESTRM 7 Permits the creation and modification of streams. CREUSR D Permits the creation, modification, and the deletion of users. DELFAC ( Allows the deletion of facilities. DELMOD % Allows the deletion of modules. DELREP + Permits the deletion of replacements. DELSTRM $ Permits streams to be deleted. FROZEN D Allows the user to peplace modules into streams marked frozen. MODLIB H Allows the user to modify attributes associated with this library. MODSTRM ) Allows the modification of streams. PERFREP 5 Allows the user to dequeue queued replacements. RESREP M Allows the user to reserve and replace modules, and to manipulate fold records. UNCLOSE C Permits the user to open a stream currently marked as closed. USERNAME = Allows the user to reserve and replace for other users. # Aggregate Privilege Keywords: ADMIN E The privileges usually associated with a project administrator L privileges; all of the above-listed privileges except DELFAC, DELMOD, + DELREP, DELSTRM, FROZEN, and UNCLOSE. ALL All privileges. NONE No privileges.
=The VDE privileges enabled for the current session determine :the VDE commands (and, in some cases, command qualifiers) Hyou are allowed to use. For example, you must have the CREFAC privilege Gto use the CREATE FACILITY and MODIFY FACILITY commands. Likewise, you Emust have the USERNAME privilege to replace modules for another user 5using the /USERNAME qualifier of the REPLACE command.<When you start a VDE session, the default privileges listed Hin your user table record in the database become the initial privileges Hfor your session. After that, you can set additional privileges for the Gcurrent session using the SET PRIVILEGES command if you are authorized Hto set those privileges. You can also cancel privileges for the current Esession using the CANCEL PRIVILEGES command and you can display your 5current privileges using the SHOW PRIVILEGES command.
:Users holding the OpenVMS privilege BYPASS are allowed to /OVERRIDE the VDE privileges.
AUse of a privilege override is audited, and an informational message will be displayed.
@To alter the default or authorized privileges associated with a @particular username in the current library, use the MODIFY USER Husername/DEF_PRIVILEGES or MODIFY USER username/AUTH_PRIVILEGES command.
/ALL
4Enables all authorized VDE privileges. To alter the Glibrary-specific authorized privileges for a user, use the MODIFY USER !username/AUTH_PRIVILEGES command./DEFAULT
=Resets the VDE privilege mask to the default setting for the Dcurrent user---the default settings can be displayed using the SHOW BUSER username/FULL command. To alter the library-specific default Dprivileges for a user, use the MODIFY USER username /DEF_PRIVILEGES command./OVERRIDE
;If the user has the OpenVMS privilege BYPASS enabled, this 6qualifer overrides all VDE privilege restrictions and enables all VDE privileges.AUse of a privilege override is audited, and an informational message will be displayed.
6
| #1 |
|---|
"VDEä SET PRIVILEGES CREFAC, CREMODVDEä SHOW PRIVILEGESCurrently set privileges:/ BUILD CREFAC CREGRP CREMOD CRESTEP RESREPVDEä SET PRIVILEGES/ALLVDEä |
FThe SET PRIVILEGES command sets the CREFAC and CREMOD privileges. The HCREFAC privilege allows the user to create and modify facilities in the Gcurrent library and the CREMOD privilege allows the user to create and @modify modules in the library. The SHOW PRIVILEGES command (see ySHOW PRIVILEGES) confirms that the privileges have been added to the current privilege mask.
-Changes the VDE prompt string from VDEä to a string of your choice.
"SET PROMPT prompt-string
prompt-string
ESpecifies the string that is to become the new prompt. If the string Dcontains blanks, special characters, or lowercase letters, you must 'enclose it in quotation marks (").
<The SET PROMPT command lets you to change the VDE prompt to one of your choosing.
6
| #1 |
|---|
VDEä SET PROMPT "Hello Dolly: " Hello Dolly: |
:In this example, the VDE prompt is changed to "Hello :Dolly:". VDE uses this string to prompt for the next command.
;Establishes the default development stream for the current 6VDE session. Specifying a stream determines the group 8definitions and module-dependency data VDE uses for the Bcurrent session: group definitions and module-dependency data are Fstream-specific. Establishing the default stream also determines what Estream commands such as CREATE GROUP, SHOW GROUP, COMPILE, and BUILD >operate on; those commands execute only in the default stream.FThe default stream also can be specified with the SET CONTEXT command.
SET STREAM stream-name
stream-name
=Specifies the name of the default stream for the VDE session.
None.
6
| #1 |
|---|
VDEä SET STREAM V5.3-FT2VDEä SHOW DEFAULTS0Library LIBNAME in root directory DEV$:[PROJDIR]!Default directory is DEV$:[SMITH]Current session context: Default stream is V5.3-FT2 Default facility is RMSVDEä |
BThe SET STREAM command establishes stream V5.3-FT2 as the current <stream for the VDE session. The SHOW DEFAULTS command shows Athat V5.3-FT2 has been set as the default stream for the session.
=Changes the line width and page size that VDE uses to format output.
SET TERMINAL
None.
HThe SET TERMINAL command sets the number of characters per line and the <number of lines per page that VDE uses to format output. It Fdoes not change the settings of your terminal. The default line width Dand page size are determined by your device type or by the last SET .TERMINAL command you entered at the DCL level.
/PAGE=n
FSpecifies the number of lines on a page. Normally n is 24 or Hthe page size of your workstation, but you can use any value from 11 to 100./WIDTH=n
@Specifies the maximum number of characters on a line. Typically An is 80 or 132 but you can use any value from 20 to 255.
6
| #1 |
|---|
VDEä SET TERMINAL/WIDTH=132 |
CThis command specifies that the length of a line is 132 characters.
?Enables the display (or echo) of command input to the terminal.
SET VERIFY
None.
CThe SET VERIFY command enables the display of command input to the Cterminal. This display is useful when you want to see the commands Hissued by a command procedure before they are executed. You can disable ;the display with the CANCEL VERIFY or SET NOVERIFY command.
None.
6
| #1 |
|---|
VDEä SET VERIFY VDEä @X.VDE@X.VDESET FACILITY COPYSHOW MODULE FOOModule [FACIL]FOO.MARVDEä |
DThe SET VERIFY command enables command echoing. Therefore, the next Gcommand (@X.VDE) is displayed on the terminal. Then a SET FACILITY and Fa SHOW MODULE command are read from the command procedure X.VDE. Both Fcommands are displayed on the terminal. The output of the SHOW MODULE (command follows the echoed command line.
| PreviousX | Next[ | Contents] | Index |