| Previous | Contents | Index |
Establishes the default facility for the current VDE session. The default facility is the facility to which a module is assumed to belong when no facility is specified in the module name. The default facility also can be assigned with the SET CONTEXT command.
SET FACILITY facil-name
facil-name
Specifies the name of the facility that becomes the default facility for the current VDE session.
None.
| #1 |
|---|
VDE„ SET FACILITY RMS
VDE„ SHOW MODULE MOD1.MAR
Module [RMS]MOD1.MAR
VDE„ SHOW DEFAULTS
Library LIBNAME in root directory DEV$:[PROJDIR]
Default directory is DEV$:[SMITH]
Current session context:
Default stream is MAIN
Default facility is RMS
VDE„
|
The SET FACILITY command makes facility RMS the default facility for the current VDE session. The SHOW MODULE command then specifies a module name without a facility name. The module is thus assumed to belong to facility RMS. The SHOW DEFAULTS command also shows that RMS has been established as the default facility in the current session.
Sets and locks the key-definition state for keys defined with the DEFINE/KEY command.
SET KEY
Using the DEFINE/KEY command you can create as many definitions for a key as you want. However, each definition of the key must be assigned a separate context or state. For example, if you create five definitions for the PF4 key you must create five different states, one for each definition of the key. If you do not specify its state before you process a definition, the definition does not take effect.The SET KEY command lets you switch from the current state to any other state; you then can use the key definitions created for that state.
/LOG (default)
/NOLOG
Controls whether the system displays a message indicating that the key state has been set. /LOG causes such a message to be displayed and /NOLOG suppresses it./STATE=state-name
/NOSTATE (default)
Specifies the name of the state to be set. The state name can be any alphanumeric string. If you omit the /STATE qualifier or use /NOSTATE, the current state is left unchanged.
| #1 |
|---|
VDE„ SET KEY/STATE=GOLD
|
The 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.
Connects 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 directory 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 the contents of various logical names, and the list of libraries and the 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.To connect to the specified library, the SET LIBRARY command first defines logical name VDE$LIBRARY to point to the specified directory. It then connects to the library you specified and reads its database.
Based on the information contained in the VDE library database, VDE checks to see if you are authorized to use the new library. If you are presently listed as an authorized user of the library, if the library is set to allow the automatic addition of users, or if you should possess the OpenVMS BYPASS privilege, VDE permits 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.
Should the filename, file extension and/or file version number be erroneously specified in the parameter, the SET LIBRARY command will silently ignore them. Only the device and directory specifications are germane to the command; the appropriate filename and file extension will be appended to the device and directory specification.
For further information on mnemonics, see the VDE$LIBRARY_DEFAULTS, VDE$LIBRARY_DEFAULTS_LABELS, and VDE$LIBRARY_DEFAULTS_MNEMONICS logical names. To see the list of mnemonics available, and the translations associated with each, use the following DCL commands:
If the VDE$LIBRARY_DEFAULTS_MNEMONICS logical name is defined, SET LIBRARY commands are available via keyboard [F17], [F18], [F19] and [F20] keys. Up to twelve keyboard definitions can be present, depending on the number of translations of VDE$LIBRARY_DEFAULTS_MNEMONICS present; the first four mnemonics are available in the default keypad state, the second four in the gold state, and the third four in the blue state.
$ $! These logical names can be (re)defined in the site- $! specific VDE system startup command procedure, or on $! a process-, job-, group- or system-specific basis. $ $! Each logical name is a search list, and the first $! entry in VDE$LIBRARY_DEFAULTS corresponds to the $! first entry in VDE$LIBRARY_DEFAULTS_MNEMONICS, and $! in VDE$LIBRARY_DEFAULTS_LABELS, etc. $! $! 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.
| #1 |
|---|
VDE„ SET LIBRARY DEV$:[PROJDIR]
VDE„
|
This 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 input and output is recorded in this file until logging is disabled. File-spec is any valid OpenVMS file specification. The default file extension is LOG. If the file specification is omitted, the default file name is VDELOGFILE.LOG.
The SET LOG command records all VDE input and output in the specified log file. Input is recorded as entered. Output is recorded with a leading exclamation point (!). Because the exclamation point is the VDE comment character, you can use the log file as a command procedure to rerun the logged VDE session. Use the CANCEL LOG command to disable input and output logging.
None.
| #1 |
|---|
VDE„ SET LOG MYLOG
VDE„ SHOW LOG
Output logging on file: DEV$:[MYDIR]MYLOG.LOG;1
VDE„
|
The SET LOG command creates the VDE log file [MYDIR]MYLOG.LOG. All subsequent commands and their outputs are recorded 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.
The SET NOVERIFY command disables the display of command input to the terminal. It cancels the effect of the SET VERIFY command. The SET NOVERIFY and CANCEL VERIFY commands are equivalent.
None.
| #1 |
|---|
VDE„ SET VERIFY
VDE„ SHOW MODULE MOD1.FOR
SHOW MODULE MOD1.FOR
Module [FACIL]MOD1.FOR
VDE„ SET NOVERIFY
SET NOVERIFY
VDE„ SHOW FACILITY FACIL
Facility FACIL
VDE„
|
The SET VERIFY command enables command echoing. Therefore, the SHOW MODULE command is displayed on the terminal before the output of the command is displayed. The SET NOVERIFY command is also echoed but the command disables the display of subsequent commands. The SHOW FACILITY command 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. You can enable only those privileges for which you have authorization. To list the privileges for which you are authorized, use the SHOW PRIVILEGES/FULL command. Table 3-5 contains a list of VDE privileges.
The project administrator privileges are those that a project administrator needs to add users to the library; to create facilities, modules, 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 Allows the creation and modification of facilities. CREGRP Permits the creation, modification, and the deletion of groups. CREMOD Allows the creation and modification of modules. CRESCRP Required for the creation, modification, and deletion of scripts. CRESTEP Allows the creation, modification, and the deletion of build steps. CRESTRM Permits the creation and modification of streams. CREUSR 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 Allows the user to peplace modules into streams marked frozen. MODLIB Allows the user to modify attributes associated with this library. MODSTRM Allows the modification of streams. PERFREP Allows the user to dequeue queued replacements. RESREP Allows the user to reserve and replace modules, and to manipulate fold records. UNCLOSE 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 The privileges usually associated with a project administrator 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) you are allowed to use. For example, you must have the CREFAC privilege to use the CREATE FACILITY and MODIFY FACILITY commands. Likewise, you must have the USERNAME privilege to replace modules for another user using the /USERNAME qualifier of the REPLACE command.When you start a VDE session, the default privileges listed in your user table record in the database become the initial privileges for your session. After that, you can set additional privileges for the current session using the SET PRIVILEGES command if you are authorized to set those privileges. You can also cancel privileges for the current session using the CANCEL PRIVILEGES command and you can display your current privileges using the SHOW PRIVILEGES command.
Users holding the OpenVMS privilege BYPASS are allowed to /OVERRIDE the VDE privileges.
Use 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 username/DEF_PRIVILEGES or MODIFY USER username/AUTH_PRIVILEGES command.
/ALL
Enables all authorized VDE privileges. To alter the library-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 current user---the default settings can be displayed using the SHOW USER username/FULL command. To alter the library-specific default privileges for a user, use the MODIFY USER username /DEF_PRIVILEGES command./OVERRIDE
If the user has the OpenVMS privilege BYPASS enabled, this qualifer overrides all VDE privilege restrictions and enables all VDE privileges.Use of a privilege override is audited, and an informational message will be displayed.
| #1 |
|---|
VDE„ SET PRIVILEGES CREFAC, CREMOD
VDE„ SHOW PRIVILEGES
Currently set privileges:
BUILD CREFAC CREGRP CREMOD CRESTEP RESREP
VDE„ SET PRIVILEGES/ALL
VDE„
|
The SET PRIVILEGES command sets the CREFAC and CREMOD privileges. The CREFAC privilege allows the user to create and modify facilities in the current library and the CREMOD privilege allows the user to create and modify modules in the library. The SHOW PRIVILEGES command (see SHOW 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
Specifies the string that is to become the new prompt. If the string contains 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.
| #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 VDE session. Specifying a stream determines the group definitions and module-dependency data VDE uses for the current session: group definitions and module-dependency data are stream-specific. Establishing the default stream also determines what stream commands such as CREATE GROUP, SHOW GROUP, COMPILE, and BUILD operate on; those commands execute only in the default stream.The 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.
| #1 |
|---|
VDE„ SET STREAM V5.3-FT2
VDE„ SHOW DEFAULTS
Library LIBNAME in root directory DEV$:[PROJDIR]
Default directory is DEV$:[SMITH]
Current session context:
Default stream is V5.3-FT2
Default facility is RMS
VDE„
|
The SET STREAM command establishes stream V5.3-FT2 as the current stream for the VDE session. The SHOW DEFAULTS command shows that 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.
The SET TERMINAL command sets the number of characters per line and the number of lines per page that VDE uses to format output. It does not change the settings of your terminal. The default line width and page size are determined by your device type or by the last SET TERMINAL command you entered at the DCL level.
/PAGE=n
Specifies the number of lines on a page. Normally n is 24 or the 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 n is 80 or 132 but you can use any value from 20 to 255.
| #1 |
|---|
VDE„ SET TERMINAL/WIDTH=132
|
This 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.
The SET VERIFY command enables the display of command input to the terminal. This display is useful when you want to see the commands issued by a command procedure before they are executed. You can disable the display with the CANCEL VERIFY or SET NOVERIFY command.
None.
| #1 |
|---|
VDE„ SET VERIFY
VDE„ @X.VDE
@X.VDE
SET FACILITY COPY
SHOW MODULE FOO
Module [FACIL]FOO.MAR
VDE„
|
The SET VERIFY command enables command echoing. Therefore, the next command (@X.VDE) is displayed on the terminal. Then a SET FACILITY and a SHOW MODULE command are read from the command procedure X.VDE. Both commands are displayed on the terminal. The output of the SHOW MODULE command follows the echoed command line.
| Previous | Next | Contents | Index |