DECSET$ENVMGR.HLB  —  cgui
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.
Close Help