This is the primary help frame for the incredible DECset Environment Manager.
1 – ok Btn
Push the OK button to dismiss the dialog box and write changes
made to the current context.
The current changes are not written to the context file until
after you either Apply or Save these changes. Changes are
written to the current context in memory only.
2 – cancel Btn
Push the Cancel button to dismiss the dialog box, discarding
current changes made.
3 – context help Btn
Push the Help button to display overall help about the current
dialog box.
4 – file selection Box
A file selection box is used to traverse through directories,
display the files and subdirectories in them, and then to select
either a file or subdirectory for the value to return from the
box.
File Selection Boxes have five main areas:
o A text field for specifying and editing a directory filter
mask to select the files or subdirectories to be displayed.
o A scrollable list of subdirectory names.
o A scrollable list of file or subdirectory names that match
filter value.
o A text input field for displaying and editing the selection
value to be return from the box.
o A group of buttons labeled OK, Filter, Cancel and Help.
- The OK button is used to accept the value in the
selection text field and to return that value from
the file selection box.
- The Filter button is used to filter the directory and
file mask specified in the filter text field.
- The Cancel button is used to dismiss the file selection
box without returning a selected value.
- The Help button is used to display this help text.
5 – Overview frame
The DECset Environment Manager for OpenVMS provides a single
mechanism for tailoring the execution environment for a set of
DECset tools. The tailoring factor is known simply as a context.
Using the DECwindows user interface, a context may be applied
to all tools displaying on a particular DECwindows display.
Using the command line interface, a context may be applied to
a particular process and all subprocesses subsequently created by
that process.
Context
A context is defined as a named set of values that tailors the
DECset tools to a specific software development activity (for
example, fixing bugs or implementing enhancements). The supported
attributes for which these values are supplied are: logical name
definitions; symbol definitions; MMS macro definitions; MMS build
options; linker options file specifications; library settings; a
source directory specification; output directory specifications;
and a default directory specification.
Each context has a unique name. The context name is limited to
a length of 16 characters. There can be only one context in a
particular context database with that name.
At any given time, the named context most recently applied to a
tool is known as the tool's current context. If no context has
been applied, the tool has no current context.
A tool's execution environment is not fully defined by the values
associated with a named context. Rather, a tool's execution
environment is constructed from the following sources:
1. the parent process
2. the X Windows resource file (if applicable)
3. the named context (if applicable)
4. the command line qualifiers used to invoke the tool
A specification retrieved from a higher-numbered source always
supersedes any specification of the same object retrieved from a
lower-numbered source.
Context Hierarchy
A project context is one that is associated with a development
project. A project context is typically used by all persons
working on the particular project.
A user-specific context may be based upon a project context,
thereby tailoring the project context to a particular user. In
this case, the project context becomes a parent context.
A context that is based upon another context is said to be a
child context. Each child context inherits all the information
associated with its parent context. If the same attribute in both
a child and its parent have different values, the child's value
overrides that of the parent.
Any context may be based upon another context, which (in turn)
may itself be based upon yet another context. A child context
inherits information from its entire `chain' of parent contexts.
The term context object refers to a context that includes all of
this inherited information.
Context File
A context file is used to store information that is specific
to a particular named context. The context file is specified by
an OpenVMS file specification, which is stored in the context
database entry associated with the named context. The default
context file type is .DECSET_CONTEXT.
The context file is a sequential ASCII text file. In a context
file, a continuation line must be terminated by a hyphen
character. Trailing comments are not allowed on a continuation
line. The context file specification must exist in the format:
disk:[directory.subdirectory]*.decset_context. If you specify a
node name in the File menu New Context... Context File field-
even if the node name is part of a local cluster-the node
specification is invalid at the time of context file retrieval
from the context database.
Context Database
A context is defined in a context database. This database is
stored as a sequential ASCII text file. Each record of this file
has the following format:
context-name context-file-spec [parent-context] ["context-description"]
A context database entry must include a complete file
specification; for example, DISK12:[USER.DIRECTORY]context_
database_file.DECSET_CONTEXT_DB.
For more information about managing windows, or using the mouse,
double click on an item from the list of additional topics below.
For information about using help, choose Help from the
Help menu above.
6 – DECbasics frame
Information about using DECwindows, such as how to use
windows, dialog boxes, and scroll bars, is available from
Session Manager help. A glossary of DECwindows terms is
also available. To get Session Manager help:
1. Move the pointer to the Session Manager icon (the
icon with your user name and the name of your system)
in the Icon Box.
2. Press mouse button 1 (MB1) twice quickly to display
the Session Manager window.
3. Move the pointer to the Help menu; press and
hold MB1 to pull down this menu.
4. Move the pointer to the Overview menu item and
release MB1 to display information about
using DECwindows.
7 – mwin MnWind
The DECset Context window is the main window of the Environment
Manager's graphical user interface. Select the Context option
from the DECset tool selection pull-down menu to bring up the
DECset Context window.
The DECset context window consists of the following working
areas:
o menu bar
o context specification area
o dialog buttons area
By default, the DECset Environment Manager tries to load a
context database. The default context database is specified
by the translation of the DECSET$CONTEXT_DB logical name;
if this logical name is undefined, SYS$LOGIN:DECSET$KNOWN_
CONTEXTS.DECSET_CONTEXT_DB is used as the default database if
that file exists.
The default context is specified by the translation of the
DECSET$CONTEXT logical name; if this logical name is undefined,
SAMPLE is used as the default context if a database entry exists
for the SAMPLE context.
7.1 – MenuBar 1
The Menu bar contains some standard pull-down menus of other
DECset tools: File, View, Settings, Options and Help.
7.1.1 – File Casc
The menu items in this pull-down are used to control the contents
of the DECset Context, Context File, and Context Database fields.
o Apply Context - used to apply the context shown in the DECset
Context field. This menu item has the same function as the
Apply button.
o Delete - used to delete the context entry, the context file,
or the context database.
Click on Context Entry to delete the context entry shown in
the Context field from the Context Database Entries field
and to delete the selected context entry from the context
database. The DECset Environment Manager checks to ensure that
the context to be deleted is not a parent of another context.
Click on Context File... to delete the context file shown in
the Context File field. The DECset Environment Manager updates
the window to reflect the deletion.
Click on Database... to delete the currently-opened context
database.
o Modify Database Entry... - to modify any of the fields in a
selected database entry.
The DECset Environment Manager brings up a dialog box with
fields filled in with information from the selected context.
o New - to create a context or database.
o Open Database - to select a context database file to open
o Print - to print the context, the context file, the context
including attributes from the parents, or the context
database.
Click on Context to print the information associated with the
context that would that would be the result of applying the
select context.
Click on Context File to print the context file.
Click on Context Including Inheritance to print the
information associated with the context that would be the
result of applying the selected context and its inherited
context.
Click on Database to print the contents of the context
database.
o Save Context File - to save the contents of the selected
context file. The Save Context File menu item performs the
same operation as the Save button.
o Exit - to exit the DECset Context window.
7.1.2 – View Casc
View menu - the menu items in this pull-down are used to review the
contents of the context, the context file, and the context including
inheritance.
Click on Context to bring up in a scrollable window the information
associated with the current selected context, without its inherited
information but including any modifications made to the context that
may not have been saved to the associated context file.
Click on Context File to bring up the context file associated with the
current selected context in a scrollable window. This context file may
or may not be the same as the result of View Context depending on
whether you have made modifications to the current selected context
and have saved the modifications to the associated context file.
Click on Context Including Inheritance to display the current context in
a scrollable window. This is the context that would be the result of
applying the selected context with its inherited information.
7.1.3 – Settings Casc
The Settings pull-down menu items are used to specify and/or
modify the definitions and settings that define a particular
context. The Settings menu is disabled until a context has
been selected.
The Settings pull-down menu items include
o CMS Library... - a directory search list to specify a CMS
library.
o Default Directory... - to specify a default directory
associated with the current context.
o DTM Library... - to specify a directory as the DTM library.
o Logical Names... - to specify logical name definitions that
are specific to the current context.
o MMS Options... - to specify the following MMS build command
options
- Linker Object Libraries... - a directory search list to
specify the object library to be included as input to the
linking operation.
- Linker Options... - a directory search list to specify
user-written options files to be included in the LINK
command in the MMS description file.
- Input/Output... - to set the input and output qualifiers
that could go on the MMS command line.
- Definition/Directive... - to specify definitions and
directives for the MMS build command.
- MMS Macros... - to direct MMS to add to or to override the
macro definitions in the MMS description file.
- Generate Options... - to set qualifiers for MMS to add to
the creation of the MMS description file.
- Object Library... - to specify into which library the
object files from the compilations are to be inserted.
o SCA Library... - a directory search list to specify an SCA
library.
o Source Directory... - a directory search list to specify a
directory from which source files will be retrieved.
o Symbols... - to add DCL symbol definitions to the specified
context.
7.1.3.1 – cmsLib Btn
The CMS Library... menu item brings up a dialog box.
Enter a directory specification into the Library field and
click on either of the Append or Add Before Selected buttons
to add the directory in the appropriate place in the Library
List field. The Library List field contains a search list of
directory specifications, one directory specification per line.
If CMS library information exists for the current context,
that information is shown in the Library List field when the
dialog box is displayed. Delete items from the Library list by
selecting the appropriate item(s) in the Library List field and
clicking on the Delete Selected button. The OK button accepts the
Library list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the CMS library.
Click on the Select... button to browse for a particular directory.
7.1.3.2 – defDir Btn
The Default Directory... menu item brings up a file selection
widget that allows you to specify a default directory associated
with the current context. If the default directory specification
is available for the currently-selected context, the input fields
of the file selection widget are filled in with the appropriate
file specification.
7.1.3.3 – dtmLib Btn
The DTM Library... menu item brings up a file selection
widget that allows you to specify a DTM library (directory
specification) to be associated with the current context. If
the currently-selected context already includes a DTM library
specification, the input fields of the file selection widget are
filled in with the appropriate file specification.
7.1.3.4 – logNames Btn
The Logical Names... menu item brings up a dialog box for defining
logical names and their equivalence strings.
7.1.3.5 – mmsOptions Casc
The MMS Options allows for selecting options that are to be used
when MMS is invoked. These options are:
o Input/Output - This selection sets options for the MMS command
and these options correspond to MMS command line
qualifiers.
o Definition/Directive - This selection sets options for the MMS
command and these options correspond to
MMS command line qualifiers.
o MMS Macros - This selection sets options that direct MMS to add
to or override definitions in the description file.
o Generator Options - This selection sets options for the MMS
Generate command and these options correspond
to MMS Generate command line qualifiers.
o Linker Object Library - Allows for setting of a Link object library
o Linker Options - Allows for setting of a Link Options File
o Object Library - Allows for setting of a Object library
7.1.3.5.1 – lnklib Btn
The Linker Object Libraries... menu item brings up a dialog box.
Enter a directory specification into the Directory field and
click on either of the Append or Add Before Selected buttons
to add the directory in the appropriate place in the Directory
List field. The Directory List field contains a search list of
directory specifications, one directory specification per line.
If Linker Object library information exists for the current context,
that information is shown in the Directory List field when the
dialog box is managed. Delete items from the directory list by
selecting the appropriate item(s) in the Directory List field and
clicking on the Delete Selected button. The OK button accepts the
directory list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the linker object library.
Click on the Select... button to specify the directory.
7.1.3.5.2 – lnkOptions Btn
The MMS Linker Options... menu item from the MMS Options... menu
brings up a dialog box.
Click on the Select... button to bring up a file selection widget
that allows you to choose an options file.
Enter a linker options file specification into the Options File
field and clicks on either of the Append or Add Before Selected
buttons to add the options file specification in the appropriate
place in the Options File List field.
The Options File List field contains an ordered list of options
file specifications, one file specification per line. Delete
items from the options file list by selecting the appropriate
item(s) in the Options File List field and clicking on the Delete
Selected button. The OK button accepts the options file list and
dismisses the dialog box. The Cancel button dismisses the dialog
box without changing the current options file list.
Press Select... to specify the options file.
7.1.3.5.3 – gen options Btn
The MMS Generator Options... menu item from the MMS Options... menu
brings up a dialog box.
Click on the Scan_Include button to enable or disable the use of
C include file during the creation of an MMS description file.
Click on the Builtin_Rules to enable or disable the use of the
built-in rules during the creation of an MMS description file.
The Additional Compile Switches allows for entering of additional
compiler switches to be addwd to the command Line when creating a
an MMS description file.
The Additional Linker Switches allows for entering of additional
Link switches to be addwd to the command Line when creating a
an MMS description file.
7.1.3.5.4 – mmsBldOptions Casc
The Input/Output... menu item from the MMS Options... menu brings
up a dialog box.
Use this dialog box to set options for the MMS command-these
options correspond to MMS command line qualifiers. If the
currently-selected context already includes any of these MMS
option settings, this dialog box reflects that information;
otherwise, the default settings are represented.
The effects of clicking on the dialog buttons are as follows:
o Input label - Click on the buttons and use the text fields
following this label to specify input files for any subsequent
build.
- Description File push button-click on this button to
bring up a file selection dialog box to specify the MMS
description file.
+ Description file toggle button-click on this button
to specify an MMS description file for any subsequent
build.
+ Description file text field-enter the file specification
of the MMS description file. If the file selection box
is used, this field will be filled in with the selected
file.
- Regard as Changed toggle button-click on this button to
direct MMS to treat only the specified sources as having
been changed, regardless of their actual modification
times. No date checking is performed at all; that is MMS
simply rebuilds any targets that depend on one or more of
the specified sources.
+ Changed Source text field-enter the file specifications
of the source files to be regarded as changed. If more
than one source is indicated, use a comma-separated
list. If the file selection box is used, this field will
be filled in with the selected file.
o Output label - The buttons and text fields following this
label are implemented as toggle buttons, although some require
additional information. If an additional file specification
needs to be specified, a file selection widget is used.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
7.1.3.5.4.1 – cg dd options Btn
The Definition/Directive... menu item from the MMS Options...
menu brings up a dialog box.
Use this dialog box to set options for the MMS command-these
options correspond to MMS command line qualifiers. If the
currently-selected context already includes any of these MMS
settings, this dialog box reflects that information; otherwise,
the default settings are represented.
The effects of clicking on the dialog buttons are as follows:
o Definitions label - Click on the buttons and use the text
fields following this label to specify definition files for
any subsequent build.
- Macro Definitions toggle button-click on this button to
direct MMS to add to or override the macro definitions in
the description file.
+ Macro Definitions file push button-click on this button
to bring up a file selection dialog box to specify the
Macro definitions file.
+ Macro Definitions file text field-enter the file
specification of the Macro definitions file. If the
file selection box is used, this field will be filled in
with the selected file.
- Rules toggle button-click on this button to direct MMS to
apply user-defined built-in rules and a suffixes precedence
list when it builds a system.
+ Rules file push button-click on this button to bring up
a file selection dialog box to specify the Rules file.
+ Rules file text field-enter the file specification of
the Rules file. If the file selection box is used, this
field will be filled in with the selected file.
- Override Macros toggle button-click on this button to
control the order in which MMS applies definitions when
it processes macros.
o Directives label - The buttons and text fields following this
label are implemented as toggle buttons, although some require
additional information. If an additional file specification
needs to be specified, a file selection widget is used.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
7.1.3.5.5 – mmsMacros Btn
The MMS Macros... menu item from the MMS Options... menu brings
up the Macro Definitions dialog box.
7.1.3.5.6 – objlib Btn
Sets the directory specification for the Library to be used that contains
the object files
7.1.3.6 – scaLib Btn
The SCA Library... menu item brings up a dialog box indicating
that an SCA library is being set.
Enter a directory specification into the Directory field and
click on either of the Append or Add Before Selected buttons
to add the directory in the appropriate place in the Directory
List field. The Directory List field contains a search list of
directory specifications, one directory specification per line.
If SCA library information exists for the current context,
that information is shown in the Directory List field when the
dialog box is managed. Delete items from the directory list by
selecting the appropriate item(s) in the Directory List field and
clicking on the Delete Selected button. The OK button accepts the
directory list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the SCA library.
Click on the Select... button to specify the directory.
7.1.3.7 – srcDir Btn
The Source Directory... menu item brings up a dialog box
indicating that a source directory is being set.
Enter a directory specification into the Directory field and
click on either of the Append or Add Before Selected buttons
to add the directory in the appropriate place in the Directory
List field. The Directory List field contains a search list of
directory specifications, one directory specification per line.
If Source Directory information exists for the current context,
that information is shown in the Directory List field when the
dialog box is managed. Delete items from the directory list by
selecting the appropriate item(s) in the Directory List field and
clicking on the Delete Selected button. The OK button accepts the
directory list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the source directory.
Click on the Select... button to specify the directory.
7.1.3.8 – symbols Btn
The Symbols... menu item brings up the Symbol Definitions dialog
box.
7.1.4 – Options Casc
The menu items in this pull-down are used to apply, save, or
confirm context entry information.
o Apply Context on Save - to automatically apply the selected
context (i.e., that context shown in the Context field). The
Apply Context on Save toggle button, when turned on, applies
the context object after saving the context. By default, the
Apply Context on Save toggle button is turned off.
o Save Context on Apply - to automatically save the context
shown in the Context File field. The Save Context on Apply
toggle button, when turned on, saves the context file prior to
applying the context. A context must be saved before it can be
applied. By default, the Save Context on Apply toggle button
is turned off.
o Confirm Apply - to bring up a Yes/No confirmation message box
as part of the apply operation. By default, the Confirm Apply
toggle button is turned on.
o Confirm Delete Context Entry - to bring up a Yes/No
confirmation message box on the Delete Context Entry
operation. By default, the Confirm Delete Context Entry toggle
button is turned on.
o Confirm Delete Context File - to bring up a Yes/No
confirmation message box on the Delete Context File operation.
By default, the Confirm Delete Context File toggle button is
turned on.
o Confirm Delete Database - to bring up a Yes/No confirmation
message box on the Delete Database operation. By default, the
Confirm Delete Database toggle button is turned on.
o Confirm Save - to bring up a Yes/No confirmation message box
on the Save Context File operation. By default, the Confirm
Save toggle button item is turned on.
Save Options writes the current options settings to a user-
profile file. If this file exists, the settings in the user-
profile file override the default settings.
7.1.5 – Help Casc
This menu provides access to help screens. It contains the items
that are usually present in DECset tool Help pull-down menus:
- On Context - to bring up information about an object in a
window or dialog box.
- On Window - to display an overview.
- On Help - to bring up information on how to use the help
system.
- On Version - to display copyright and version information.
7.1.5.1 – onContext Btn
When you click on On Context in the Help menu, the Environment Manager provides a fast way to obtain context-sensitive help on any object you click on in the DECset Environment Manager window. Note that when you click on On Context, the arrow pointer converts to a question mark, indicating you are in Context-Sensitive Help mode. After the Help Widget is displayed for the window object you clicked on, the arrow pointer reappears.
7.1.5.2 – onHelp Btn
To get help on using the Environment Manager, you can use one of two methods:
o Choose On Context from the Help menu. Then click on any object
in the Environment Manager window on which you want help.
o Press and hold MB1 on any object in the MMS main window on
which you want help, and press the Help key on your keyboard.
7.1.5.3 – onWind Btn
The DECset Environment Manager provides a single mechanism for tailoring the execution environment for a set of DECset tools. For more information about the DECset Environment Manager, double click on Overview of the DECset Environment Manager from the additional topics below.
7.1.5.4 – OnVers Btn
HP CONFIDENTIAL. This software is confidential proprietary software licensed by Hewlett-Packard Development Company, L.P., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of HP. © 2015 Copyright Hewlett-Packard Development Company, L.P. VMS SOFTWARE, INC. CONFIDENTIAL. This software is confidential proprietary software licensed by VMS Software, Inc., and is not authorized to be used, duplicated or disclosed to anyone without the prior written permission of VMS Software, Inc. © 2015 Copyright VMS Software, Inc. Software Version: DECset Environment Manager for OpenVMS, version V1.9 For more information about the DECset Environment Manager for OpenVMS, double click on Overview of the DECset Environment Manager from the additional topics below.
7.2 – wkarea Form
The context specification area is used to display information
about contexts, and consists of the following fields:
o context
o parent
o context file
o context database entries
The context specification area consists of read-only fields. Use
the menu bar functions to make changes to any of these fields.
Context Field
You can display a context name in the Context field by single-
clicking on a line in the Context Database Entries field or by
selecting the New menu item from the File menu.
Parent Field
The DECset Environment Manager does not allow a circular
ancestral chain. If a circular chain is detected, the DECset
Environment Manager displays an error message dialog box, and
aborts the operation on that context.
Context File Field
If you select an existing context file from the Context Database
Entries field, the name of the context and the associated
information is displayed in the read-only Context, Parent, and
Context File fields.
For a new context, or one for which you are modifying the
associated context file specification, you may use the Modify
Database Entry... menu item from the File menu to bring up a file
selection widget.
If any part of the file specification is not supplied; for
example, the disk name, the corresponding component of your
current default directory specification is used. If the name
or the file type is not specified, the name of the currently-
specified context is used as the file name and .DECSET_CONTEXT is
used as the file type.
Context Database Entries Field
The context names (and some associated information) are retrieved
from the context database listed in the Context Database Entries
field of the DECset context window.
7.2.1 – ctxt TxtF
You can display a context name in the Context field by single-
clicking on a line in the Context Database Entries field or by
selecting the New menu item from the File menu.
7.2.2 – parnt TxtF
The DECset Environment Manager does not allow a circular
ancestral chain. If a circular chain is detected, the DECset
Environment Manager displays an error message dialog box, and
aborts the operation on that context.
7.2.3 – ctxtFil TxtF
If you select an existing context file from the Context Database
Entries field, the name of the context and the associated
information is displayed in the read-only Context, Parent, and
Context File fields.
For a new context, or one for which you are modifying the
associated context file specification, you may use the Modify
Database Entry... menu item from the File menu to bring up a file
selection widget.
If any part of the file specification is not supplied; for
example, the disk name, the corresponding component of your
current default directory specification is used. If the name
or the file type is not specified, the name of the currently-
specified context is used as the file name and .DECSET_CONTEXT is
used as the file type.
7.2.4 – knownCtxts Form
The context names (and some associated information) are retrieved
from the context database listed in the Context Database Entries
field of the DECset context window.
7.2.4.1 – knCtxtsFrm ScrLst
The context names (and some associated information) are retrieved
from the context database listed in the Context Database Entries
field of the DECset context window.
7.2.5 – apply Btn
The Apply button causes the selected context object to be applied
to any DECset tools displaying on the same DECwindows display as
is the Context window. You may also double-click on the context
in the Context Database Entries field to apply the context. In
addition to applying this context, any command line qualifiers
that are in effect are then re-applied to the tool.
A named context must be saved before a context apply operation is
initiated.
7.2.6 – save Btn
The Save button saves the context file shown in the Context File
field.
This action saves the current definitions/settings (possibly
modified via the Settings menu) to the context file indicated
in the Context File field of the main window. If the value in
the Context File field has changed since the last Save operation
for the current context, the DECset Environment Manager writes
the new file specification to the context database. For a new
context, the Save menu item ensures that the context is known
by adding the specified context name and associated context file
specification to the context database. The DECset Environment
Manager displays a confirmation dialog box for final approval
before saving new information in an existing context database
entry and/or an existing context file. The saving of a context
will affect other DECset tools displaying on the DECwindows
display only when that context is subsequently applied.
8 – io options PopForm
This dialog box is used to specifiy input/output options for
any subsequent build
8.1 – desc Tgl
Click on the button to specify an MMS description file for any subsequent build.
8.2 – desc file Btn
Click on this button to bring up a file selection dialog box to specify the MMS description file.
8.3 – desc PopForm
Use the Description File selection dialog box to select the Description file.
8.3.1 – desc FilSelB
Enter the name of the Description file.
8.4 – desc file Txt
Enter the file specification of the MMS description file. If the file selection box is used, this field will be filled in with the chosen file.
8.5 – changed Tgl
Click on the button to direct MMS to treat only the specified sources as having been changed, regardless of their actual modification times. No date checking is performed at all; MMS simply rebuilds any targets that depend on one or more of the specified sources.
8.6 – changed sources Btn
Click on this button to bring up a file selection dialog box to specify the source file to be regarded as changed.
8.7 – changed PopForm
Use the Regard as Changed Source selection dialog box to select a source file to regard as changed.
8.7.1 – changed FilSelB
Enter the name of the source file to regard as changed.
8.8 – changed sources Txt
Enter the file specifications of the source files to be regarded as changed. If more than one source indicated, use comma-separated list. If the file selection box is used, this field will be filled in with the chosen file.
8.9 – list Tgl
Click on the button to direct MMS to write dependencies and action lines to an output file as it processes the description file.
8.10 – list file Btn
Click on this button to bring up a file selection dialog box to specify the list file.
8.11 – list PopForm
Use the List File selection dialog box to select the List file.
8.11.1 – list FilSelB
Enter the name of the List file.
8.12 – list file Txt
Enter the file specification of the List file. If the file selection box is used, this field will be filled in with the chosen file.
8.13 – output Tgl
Click on the button to direct MMS to write action lines and output to the specified file.
8.14 – output file Btn
Click on this button to bring up a file selection dialog box to specify the Output file.
8.15 – output PopForm
Use the Output File selection dialog box to select the Output file.
8.15.1 – output FilSelB
Enter the name of the Output file.
8.16 – output file Txt
Enter the file specification of the Output file. If the file selection box is used, this field will be filled in with the chosen file.
8.17 – log Tgl
Click on the button to direct MMS to display intormational messages as it processes the description file.
8.18 – io options help Btn
Use the Input/Output Options dialog box to define options for any subsequent build. The default values of the options will be reflected when the dialog box comes up. If there are Input/Output Options settings defined for the current context, they will be reflected when the dialog box come up, and they will take precedence over the default settings. If qualifiers have been specified when invoking MMS, the Input/Output Options settings will reflect the qualifier values, and they will take precedence over the context settings.
9 – dd options PopForm
This dialog box is used to specifiy definitions and directives for
any subsequent build
9.1 – macro Tgl
Click on the button to direct MMS to add to or override the macro definitions in the decription file.
9.2 – macro file Btn
Click on this button to bring up a file selection dialog box to specify the Macro definitions file.
9.3 – macro PopForm
Use the Macro File selection dialog box to select the Macro Definitions file.
9.3.1 – macro FilSelB
Enter the name of the Macro Definitions file.
9.4 – macro file Txt
Enter the file specification of the Macro definitions file. If the file selection box is used, this field will be filled in with the chosen file.
9.5 – rules Tgl
Click on the button to direct MMS to apply user-defined built-in rules and a suffixes precedence list when it builds a system.
9.6 – rules file Btn
Click on this button to bring up a file selection dialog box to specify the Rules file.
9.7 – rules PopForm
Use the Rules File selection dialog box to select the Rules file.
9.7.1 – rules FilSelB
Enter the name of the Rules Definitions file.
9.8 – rules file Txt
Enter the file specification of the Rules file. If the file selection box is used, this field will be filled in with the chosen file.
9.9 – override Tgl
Click on the button to control the order in which MMS applies definitions when it process macros.
9.10 – sca Tgl
Click on the button to direct MMS to generate an SCA library during the build process.
9.11 – sca library Btn
Click on this button to bring up a file selection dialog box to specify the SCA library directory.
9.12 – sca PopForm
Use the SCA Library selection dialog box to select the SCA library directory.
9.12.1 – sca FilSelB
Enter the directory for the SCA library.
9.13 – sca library Txt
Enter the directory specification of the SCA Library. If the file selection box is used, this field will be filled in with the chosen directory. When you specify a library name, MMS defines the macro $(SCA_LIBRARY) to be that library name.
9.14 – ignore Tgl
Click on the button to indicate that MMS should ignore certain severity levels of errors when it executes action lines. The radio buttons to the right correspond to the DCL severity levels W, E, and F.
9.15 – severity Radio
Click on one of the severity levels in the Severity radio box to specify the severity levels of errors that MMS should ignore when it executes action lines. The radio buttons correspond to the DCL severity levels W, E, and F. You cannot click on more than one severity level at a time.
9.16 – warning Tgl
Click on this button to indicate that errors of the warning level should be ignored by MMS when it executes action lines.
9.17 – error Tgl
Click on this button to indicate that errors of the warning and error levels should be ignored by MMS when it executes action lines.
9.18 – fatal Tgl
Click on this button to indicate that errors of the warning, error and fatal levels should be ignored by MMS when it executes action lines.
9.19 – cms Tgl
Click on the button to direct MMS to look for source files, description files and included files in the current default CMS library as well as the specified directories. When you specify Use CMS, and the source in the CMS library is newer, MMS fetches it from the CMS library. If the source in the CMS library is older, MMS instead used the source in the specified directory. CMS must be installed on your system.
9.20 – cms class Txt
Specify the CMS class to direct MMS to use the macro definition "CMSFLAGS=GENERATION=class-name". By specifying a CMS class, MMS still uses the CMS elements as the sources but it uses the designated class of generations, not necessarily the current generations.
9.21 – display Tgl
Click on the button to direct MMS to display action lines before executing them.
9.22 – execute Tgl
Click on the button to direct MMS to execute the action lines in the description file.
9.23 – fromsources Tgl
Click on the button to direct MMS to build a target from its sources, regardless of whether the target is already up-to-date.
9.24 – force Tgl
Click on the button to direct MMS to execute the action lines necessary to update one specific target.
9.25 – check Tgl
Click on the button to direct MMS to return a value in the symbol MMS$STATUS instead of updating a target. This symbol contains the status of the last action line executed by MMS.
9.26 – revise Tgl
Click on the button to direct MMS to only change the revision dates of all the targets that need updating, instead of performing the update.
9.27 – skip Tgl
Click on the button to indicate that MMS should not build intermediate source/target files.
9.28 – list switch Tgl
Click on the button to direct MMS to use the macro definition "LIST=1". Automatically generated description files will contain the following lines: .IFDEF LIST LST = /LIST .ELSE LST = /NOLIST .ENDIF and every compilation command will include the $(LST) macro. If this toggle button is clicked on, then every compilation in the build will produce a listing file. If this toggle button is off, no listings will be produced. Users can use the same mechanism in their own hand-written description files.
9.29 – debug switch Tgl
Click on the button to direct MMS to use the macro definition "DEBUG=1". Automatically generated description files will contain the following lines: .IFDEF DEBUG DBG = /DEBUG DBGOPT = /NOOPTIMIZE/DEBUG .ELSE DBG = /NODEBUG DBGOPT = /OPTIMIZE/NODEBUG .ENDIF and every compilation command will include the $(DBG) or the $(DBGOPT) macro. If this toggle button is clicked on, then every compilation in the build will be compiled with information to be included in the object module for use with the VAX Symbolic Debugger. Also the linker will be directed to generate a debugger symbol table and to give the debugger control when the image is run. Users can use the same mechanism in their own hand-written description files.
9.30 – diag switch Tgl
Click on the button to direct MMS to use the macro definition "DIAG=1". Automatically generated description files will contain the following lines: .IFDEF DIAG DIA = /DIAGNOSTICS .ELSE DIA = /NODIAGNOSTICS .ENDIF and every compilation command will include the $(DIA) macro. If this toggle button is clicked on, then every compilation in the build will produce an diagnostics file. If diagnostics files are produced during a build, and LSE is running, the user is able to do a REVIEW of each compilation from MMS. If this toggle button is off, no diagnostics files will be produced. Users can use the same mechanism in their own hand-written description files.
9.31 – dd options help Btn
Use the Definitions/Directives Options dialog box to define options for any subsequent build. The default values of the options will be reflected when the dialog box comes up. If there are Definitions/Directives Options settings defined for the current context, they will be reflected when the dialog box come up, and they will take precedence over the default settings. If qualifiers have been specified when invoking MMS, the Definitions/Directives Options settings will reflect the qualifier values, and they will take precedence over the context settings.
10 – gen options PopForm
The MMS Generate Options ... menu item from the MMS Options...
menu brings up a dialog box.
Use this dialog box to set options for the MMS Generate command-these
options correspond to the MMS Generate command line qualifiers. If the
currently-selected context already includes any of these MMS
settings, this dialog box reflects that information; otherwise,
the default settings are represented.
The effects of clicking on the dialog buttons are as follows:
10.1 – scan Tgl
Click on the button to set the options for the MMS command to indicate that C include files should be scanned for dependencies when generating the description file.
10.2 – built rules Tgl
Click on the button to indicate to MMS that built-in rules are to be used; no compilation action lines will be included when generating the description file.
10.3 – compiler switches TxtF
Enter any compilation switches that should be added to every compile command in the generated description file. These must be exactly what would be added to the command; i. e. they should include the slash (/) character. No checking is done to ensure the proper command
10.4 – linker switches TxtF
Enter any switches that should be added to the LINK command in the generated
description file. These must be exactly what would be added to the command;
i. e. they should include the slash (/) character. No checking is done to
Ensure the proper command is created.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
10.5 – gen options help Btn
Use the Generate Options dialog box to define options for the MMS command- Create MMS file The default values of the options will be reflected when the dialog box comes up. If there are Generate Options settings defined for the current context, they will be reflected when the dialog box come up, and they will take precedence over the default settings. If the Additional Link or Compile settings have been specified when invoking MMS, these Generate Options settings will reflect the current values and they will take precedence over the context settings.
11 – lndlg PopForm
The logical name definitions retrieved from the context file
specified in the Context File field of the main window are
displayed in the Logical Names/Equivalence Strings field of this
dialog box.
The effects of clicking on the dialog buttons are as follows:
o Conceal Translation - to specify that the translation(s) of
the logical name are `concealed'.
o Enter Definition - to add the logical name and corresponding
equivalence strings specified in the Logical Name and
Equivalences fields to the Logical Names/Equivalence Strings
list shown in the dialog box.
Use this feature to supersede a definition from a parent
context.
o Enter Deassign - to enter a deassign logical name specified
in the logical name field to the Logical Names/Equivalence
Strings list. The contents of the Equivalence string field are
ignored.
Use this feature in a context to supersede a definition from a
parent context.
The DECset Environment Manager does not allow duplicate
definitions of a logical name in the Logical Names/Equivalence
Strings field.
o Remove - to remove the selected logical name definition or the
DEASSIGN from the Logical Names/Equivalence Strings list.
o Add Table - to specify an option menu containing the options
system, group, job, the default setting, process, or other
user defined tables.
The value indicates the logical name table into which the
logical name is inserted or from which the logical name is
deassigned.
o OK - to dismiss the dialog box and write changes made to the
current context.
The current changes are not written to the context file until
after you either Apply or Save these changes. Changes are
written to the current context in memory only.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
The Logical Names/Equivalence Strings field places equivalence
strings on separate lines in order to distinguish between
logicals defined; for example:
DEFINE FOO BAR
DEFINE MOO A,B,C
DEASSIGN ZOO
The Environment Manager does not accept logical name
specifications that include quotation marks.
11.1 – lnequiv ScrLst
Use Enter Definition button to add the logical name and corresponding
equivalence strings specified in the Logical Name and
Equivalences fields to the Logical Names/Equivalence Strings list.
11.2 – lognam TxtF
Use this text field for specifying the desired logical name.
11.3 – conctrans Tgl
Toggle Conceal Translation button to specify that the translation(s) of
the logical name are `concealed'.
11.4 – equiv TxtF
Use this text field for specifying the equivalence string for
the specified logical name.
11.5 – lnaddtab Bth key
Push the Add Table button to display a dialog box that allows a
user defined table to be added to the logical name table menu
list.
11.6 – table OptMenu
Use this radio button to display an option menu containing
the options system, group, job, the default setting, process,
or other user defined tables.
The value indicates the logical name table into which the
logical name is inserted or from which the logical name is
deassigned.
11.7 – tabnam TxtF
TBS
11.8 – lnentdef Btn
Push the Enter Definition button to add the logical name and corresponding
equivalence strings specified in the Logical Name and
Equivalences fields to the Logical Names/Equivalence Strings
list.
11.9 – lnreplace Btn
Push the Replace button to replace the equivalence string for the
selected logical name.
11.10 – lnentdeas Btn
Push the Enter Deassign button to enter a deassign logical name specified
in the logical name field to the Logical Names/Equivalence
Strings list. The contents of the Equivalence string field are
ignored.
11.11 – lnremove Btn
Push the Remove button to remove the selected logical name definition or the
DEASSIGN from the Logical Names/Equivalence Strings list.
11.12 – lnedt equiv Btn
The Edit Equivalence String... menu item brings up a dialog box indicating
that an equivalence string is being set.
Enter a string into the Equivalence String field and
click on either of the Append or Add Before Selected buttons
to add the string in the appropriate place in the Equivalence String
List field. The Equivalence String List field contains a list of
equivalence strings, one string per line.
If equivalence information exists for the current context,
that information is shown in the Equivalence String List field when the
dialog box is managed. Delete items from the string list by
selecting the appropriate item(s) in the Equivalence String List field and
clicking on the Delete Selected button. The OK button accepts the
string list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the equivalence string.
Click on the Select... button to specify the string.
11.13 – lnshwctxtLogs Btn
Click on this button to display the logical names currently
defined in the context file for the current context.
Only the logical names defined in the context file will be
displayed by this action.
11.14 – lninclInher Tgl
This toggle button specifies if inherited logical names from the
parent contexts are display along with the logical names defined
for the current context.
11.15 – help Btn
The logical name definitions retrieved from the context file
specified in the Context File field of the main window are
displayed in the Logical Names/Equivalence Strings field of this
dialog box.
The effects of clicking on the dialog buttons are as follows:
o Conceal Translation - to specify that the translation(s) of
the logical name are `concealed'.
o Enter Definition - to add the logical name and corresponding
equivalence strings specified in the Logical Name and
Equivalences fields to the Logical Names/Equivalence Strings
list shown in the dialog box.
Use this feature to supersede a definition from a parent
context.
o Enter Deassign - to enter a deassign logical name specified
in the logical name field to the Logical Names/Equivalence
Strings list. The contents of the Equivalence string field are
ignored.
Use this feature in a context to supersede a definition from a
parent context.
The DECset Environment Manager does not allow duplicate
definitions of a logical name in the Logical Names/Equivalence
Strings field.
o Remove - to remove the selected logical name definition or the
DEASSIGN from the Logical Names/Equivalence Strings list.
o Add Table - to specify an option menu containing the options
system, group, job, the default setting, process, or other
user defined tables.
The value indicates the logical name table into which the
logical name is inserted or from which the logical name is
deassigned.
o OK - to dismiss the dialog box and write changes made to the
current context.
The current changes are not written to the context file until
after you either Apply or Save these changes. Changes are
written to the current context in memory only.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
The Logical Names/Equivalence Strings field places equivalence
strings on separate lines in order to distinguish between
logicals defined; for example:
DEFINE FOO BAR
DEFINE MOO A,B,C
DEASSIGN ZOO
The Environment Manager does not accept logical name
specifications that include quotation marks.
12 – cmslib PopForm
This dialog box is used for specified a search list or a string list.
12.1 – cmslb dir TxtF
Enter a string into this field and
click on either of the Append or Add Before Selected buttons
to add the string in the appropriate place in the search list or
string list.
12.2 – cmslb select Btn
Click on the Select... button to specify the directory or file
or string (depending on which dialog box is being used).
12.3 – cmslb dirlst Scrlst
The Search list/string list is the display of the currently
defined ordered list.
12.4 – cmslb upar Arro
Click on the search list up arrow to move the selected
item toward the beginning of the list.
12.5 – cmslb dnar Arro
Click on the search list down arrow to move the selected
item toward the end of the list.
12.6 – cmslb append Btn
Click on the Append button
to add the string to the end of the string list.
12.7 – cmslb addbef Btn
Click on the Add Before Selected button
to add the string before the selected string in the string list.
12.8 – cmslb delsel Btn
Click on the Delete Selected button
to remove the string from the string list.
12.9 – cmslb help Btn
This dialog box is used for specified a search list or a string list.
Enter a string into the String field and
click on either of the Append or Add Before Selected buttons
to add the string in the appropriate place in the String
List field. The String List field contains a list of
strings, one string per line.
Delete items from the string list by
selecting the appropriate item(s) in the String List field and
clicking on the Delete Selected button. The OK button accepts the
string list and dismisses the dialog box. The Cancel button
dismisses the dialog box without changing the string.
Click on the Select... button to specify the string.
13 – editctx PopForm
This dialog box is used to specify information about a context.
Context information is:
o Context Name - The context name can be up to 16 letters long.
o Context Parent - The context parent must be a context in the
current context database.
o Context File - The file that is to contain all context specific
information.
o Comment - Comment to be displayed about the context in the
main window context list.
13.1 – edctx ctxt TxtF
The context name text specifies the name for the context. The context
name can be up to 16 letters long.
13.2 – edctx parnt TxtF
The context parent text specifies the parent for the context. The
parent context must be a context in the current database.
13.3 – edctxSelect Btn
The context parent select button will display a dialog box containing
all the contexts in the current database. A context may be selected
from this dialog box to be used as the context parent.
13.4 – SelCtxtFil Btn
The context file select button will display a file selection box that
may be used to specify the file to contain all the context specific
settings and definitions.
13.5 – edctx ctxtFil TxtF
The context file text specifies the name of the file that will contain
all the settings and definitions for the context.
13.6 – edctx cmnt TxtF
The context comment text specifies the comment to be displayed with a
context in the main window context list.
13.7 – edctxhelp Btn
This dialog box is used to specify information about a context.
Context information is:
o Context Name - The context name can be up to 16 letters long.
o Context Parent - The context parent must be a context in the
current context database.
o Context File - The file that is to contain all context specific
information.
o Comment - Comment to be displayed about the context in the
main window context list.
14 – symdef PopForm
The symbol definitions retrieved from the context file specified
in the Context File field of the main window are displayed in the
Symbol Definitions field of this dialog box.
Use this dialog box to add DCL symbol definitions to the
specified context.
The Environment Manager stores symbols only as global symbols.
The effects of clicking on the dialog buttons are as follows:
o Enter Define - to add a new symbol definition to the Symbol
Definitions list shown in the dialog box.
Use this in a context to supersede a definition from a parent
context.
o Remove - to remove the selected symbol definition or the
DELETE SYMBOL entry from the Symbol Definitions list.
o Enter Delete - to add a DELETE SYMBOL entry to the Symbol
Definitions list shown in the dialog box.
Use this feature in a context to supersede a definition from a
parent context.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
14.1 – symdef ScrLst
The symbol definitions retrieved from the context file specified
in the Context File field of the main window are displayed in this
list.
14.2 – symbol TxtF
Type a new (or edit an existing) symbol name in this field. The
symbol name associated with the selected symbol definition is
displayed in this field. Use this field in conjunction with the
Enter Define and Replace Define buttons to add or change symbol
definitions in the Symbol Definitions list. Use this field in
conjunction with the Enter Delete button to add a symbol deletion
to the Symbol Definitions list.
14.3 – def TxtF
Type a new (or edit an existing) symbol assignment in this field.
The assignment associated with the selected symbol definition is
displayed in this field. Use this field in conjunction with the
Enter Define and Replace Define buttons to add or change symbol
definitions in the Symbol Definitions list.
14.4 – symentdef Btn
This button adds a new symbol definition to the Symbol Definitions
list. The new symbol definition is described in the Symbol and
Definition fields.
14.5 – symreplace Btn
This button replaces the selected symbol definition in the Symbol
Definitions list with a new symbol definition from the Symbol and
Definition fields.
14.6 – symentdel Btn
This button adds a new symbol deletion to the Symbol Definitions
list. The new symbol deletion is named in the Symbol field.
14.7 – symremove Btn
This button removes the selected symbol definition or deletion
from the Symbol Definitions list.
14.8 – symhelp Btn
The symbol definitions retrieved from the context file specified
in the Context File field of the main window are displayed in the
Symbol Definitions field of this dialog box.
Use this dialog box to add DCL symbol definitions to the
specified context.
The Environment Manager stores symbols only as global symbols.
The effects of clicking on the dialog buttons are as follows:
o Enter Define - to add a new symbol definition to the Symbol
Definitions list shown in the dialog box.
Use this in a context to supersede a definition from a parent
context.
o Remove - to remove the selected symbol definition or the
DELETE SYMBOL entry from the Symbol Definitions list.
o Enter Delete - to add a DELETE SYMBOL entry to the Symbol
Definitions list shown in the dialog box.
Use this feature in a context to supersede a definition from a
parent context.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
15 – macdef PopForm
The macro definitions retrieved from the context file specified
in the Context File field of the main window are displayed in the
Macro Definitions field of this dialog box.
The effects of clicking on the dialog buttons are as follows:
o Enter - to add a new macro definition to the Macro Definitions
list shown in the dialog box.
o Replace - to replace the selected macro definition in the
Macro Definitions list.
o Remove - to remove the selected macro definition from the
Macro Definitions list.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
15.1 – macdef ScrLst
The macro definitions retrieved from the context file specified
in the Context File field of the main window are displayed in this
list.
15.2 – macname TxtF
Type a new (or edit an existing) macro name in this field. The
macro name associated with the selected macro definition is
displayed in this field. Use this field in conjunction with the
Enter and Replace buttons to add or change macro definitions in
the Macro Definitions list.
15.3 – macexp TxtF
Type a new (or edit an existing) macro expansion string in this
field. The expansion string associated with the selected macro
definition is displayed in this field. Use this field in
conjunction with the Enter and Replace buttons to add or change
macro definitions in the Macro Definitions list.
15.4 – macentassgn Btn
This button adds a new macro definition to the Macro Definitions
list. The new macro definition is described in the Macro Name
and Expansion fields.
15.5 – macreplace Btn
This button replaces the selected macro definition in the Macro
Definitions list with a new macro definition from the Macro Name
and Expansion fields.
15.6 – macremove Btn
This button removes the selected macro definition from the Macro
Definitions list.
15.7 – machelp Btn
The macro definitions retrieved from the context file specified
in the Context File field of the main window are displayed in the
Macro Definitions field of this dialog box.
The effects of clicking on the dialog buttons are as follows:
o Enter - to add a new macro definition to the Macro Definitions
list shown in the dialog box.
o Replace - to replace the selected macro definition in the
Macro Definitions list.
o Remove - to remove the selected macro definition from the
Macro Definitions list.
o OK - to dismiss the dialog box and write changes made to the
current context.
o Cancel - to dismiss the dialog box, discarding current changes
made.
o Help - to bring up a help window containing text describing
the dialog box.
16 – defdir FileSel
TBS
17 – DelCtxtFil FileSel
TBS
18 – DelDatbs FileSel
TBS
19 – NewDatbs FileSel
TBS
20 – OpenDatbs FileSel
TBS
21 – SelCtxtFil FileSel
TBS
22 – dtmlib FileSel
TBS
23 – objlib FileSel
TBS
24 – selcmslib FileSel
TBS
25 – selscalib FileSel
TBS
26 – sellnklib FileSel
TBS
27 – sellnkopt FileSel
TBS
28 – selsrcdir FileSel
TBS
29 – View PopForm
This window displays a complete description of the specified
context.
o Cancel - to dismiss the window
o Help - to bring up this help window
29.1 – View ScrolledWindow
A complete description of the specified context is displayed in
this window. If the text is too large to fit in the window,
scroll bars will be created to permit scrolling through the
text.
29.1.1 – View Text
A complete description of the specified context is displayed in
this area.
29.2 – View HelpBtn
This window displays a complete description of the specified
context.
o Cancel - to dismiss the window
o Help - to bring up this help window
30 – Glossary frame
Context -
A context is defined as a named set of values that tailors
the DECset tools to a specific software development
activity (for example, fixing bugs or implementing
enhancements). The supported attributes for which these
values are supplied are: logical name definitions; symbol
definitions; MMS macro definitions; MMS build options;
linker options file specifications; library settings;
a source directory specification; output directory
specifications; and a default directory specification.
Each context has a unique name within a particular context
database (see Context Database). The length of the context
name is limited to 16 characters.
Context Database -
A context is defined in a context database. This database
is stored as a sequential ASCII text file. Each record of
this file has the following format:
context-name file-spec [parent-context] ["description"]
A context database entry must include a fully-qualified file
specification (e.g.,DISK:[directory]file.DECSET_CONTEXT_DB).
Context File -
A context file is used to store information that is
specific to a particular named context. The context file
is specified by an OpenVMS file specification, which
is stored in the context database entry (see Context
Database) associated with the named context.
The default context file type is .DECSET_CONTEXT.
The context file is a sequential ASCII text file. In a
context file, a continuation line must be terminated by a
hyphen character. Trailing comments are not allowed on a
continuation line.
Context Including Inheritance -
Any context may be based upon another context, which (in
turn) may itself be based upon yet another context. A
child context inherits information from its entire `chain'
of parent contexts. The term context object refers to a
context that includes all of this inherited information.
DECset Environment Manager -
The DECset Environment Manager provides a single mechanism
for tailoring the execution environment for a set of
DECset tools. The tailoring factor is known simply as
a context.
Using the DECwindows user interface, a context may be
applied to all tools displaying on a particular DECwindows
display.
Parent/Child Context -
A context that is based upon another context is said
to be a child context. Each child context inherits all
the information associated with its parent context. If
the same attribute in both a child and its parent have
different values, the child's value overrides that of the
parent.
31 – listmanager PopForm
31.1 – listmanager help Btn
This dialog box has several uses within the Environment Manager.
In general, it is used to specify and manipulate lists of
directories or file specifications.
Enter a string into the Library/String field and click on
either of the Append or Add Before Selected buttons to add the
string in the appropriate place in the Library/String List
field. The Library/String List field contains a list of
strings, one string per line.
Delete items from the Library/String list by selecting the
appropriate item(s) in the Library/String List field and
clicking on the Delete Selected button. The OK button accepts
the Library/String List and dismisses the dialog box. The
Cancel button dismisses the dialog box without changing the
Library/String.
In some cases a Select... button appears to the right of the
Library/String field. If present it may be used to browse.
When more than one item is shown in the Library/String List,
up and down-arrow buttons are displayed to move the selected
item up or down in the list.
32 – edit context PopForm
32.1 – edit contexthelp Btn
This dialog box is used to specify information about a context.
Context information is:
o Context Name - The context name can be up to 16 letters long.
o Context Parent - The context parent must be a context in the
current context database.
o Context File - The file that is to contain all context specific
information.
o Comment - Comment to be displayed about the context in the
main window context list.