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.
1 – MenuBar 1
The Menu bar contains some standard pull-down menus of other
DECset tools: File, View, Settings, Options and Help.
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.
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.
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.
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.
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.
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.
1.3.4 – logNames Btn
The Logical Names... menu item brings up a dialog box for defining
logical names and their equivalence strings.
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
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.
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.
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.
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.
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.
1.3.5.5 – mmsMacros Btn
The MMS Macros... menu item from the MMS Options... menu brings
up the Macro Definitions dialog box.
1.3.5.6 – objlib Btn
Sets the directory specification for the Library to be used that contains
the object files
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.
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.
1.3.8 – symbols Btn
The Symbols... menu item brings up the Symbol Definitions dialog
box.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.