Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

COMMON

CONF

M

OCC

About

Conf box

CXL pb

msg box

Not Yet Implemented

OK pb

OK pb cust

Overview

Use help

W i p

DECwindows basics

About Release Notes

Using Libraries

Using Elements

Using Groups

Using Classes

Ref copy def

Exiting from CMS

SVN scroll bars

Step arrows

Scroll region

Slider

Creating Libraries

Element attrs

Group attrs

Class attrs

cms$dw_help — VMS CMS_3.2

Additional information available:

COMMONCONFMOCC

AboutConf boxCXL pbmsg boxNot Yet ImplementedOK pb
OK pb custOverviewUse helpW i p

About

=TITLE About CMS
=INCLUDE Overview Exiting_from_CMS
            VAX DEC/Code Management System
       Copyright Digital Equipment Corporation
               All Rights Reserved
                      1989

 Operating System and Version:  VAX/VMS Version 5.1
 Software Version:  VAX DEC/Code Management System
                    Version 3.2

 For more information about CMS, double click on
 the Overview... menu item in the Help menu above.

Conf box

=TITLE Confirm Box
 CMS displays the Confirm Box to prompt you for
 confirmation prior to executing the transaction.

 Choose one of the following responses:

 o Yes to execute the transaction and remove the
   dialog box.
 o No to cancel the transaction.
 o All to confirm all confirmation prompts associated
   with the transaction.
 o Quit to cancel the transaction and exit the
   confirmation box.

CXL pb

=TITLE Cancel Button
 Click on the Cancel button to remove the dialog box
 without performing any action.

msg box

=TITLE Message Box
=INCLUDE M C_m Ml_mi
=INCLUDE M C_m Ml_mi Ml_wipb
=INCLUDE M C_m Ml_mi Ml_cmwb
=INCLUDE M C_m Ml_mi Ml_cm_ifv
=INCLUDE M C_m Ml_mi Ml_nne
 The Message Box displays informational messages
 to notify you of current status as CMS executes
 transactions.

 You can customize the Message Box to display
 certain options; for more information, click on
 the Message Logging... menu item below.

Not Yet Implemented

=TITLE Not Yet Implemented
 This feature has not been implemented into CMS Version
 3.2. Please submit an SPR detailing the conditions in
 which you received this message.

 Thank you,

 DEC/CMS Development

OK pb

=TITLE OK Button
 Click on the OK button to apply the current settings
 in the dialog box and then remove the dialog box.

OK pb cust

=TITLE OK Button
=INCLUDE M C_m Cu_sa_mi
 Click on the OK button to apply the specified
 customizations and then remove the dialog box.

 Note that some customizations take effect immediately,
 others take effect the next time you invoke the
 associated view, and some take effect the next time
 you invoke the CMS DECwindows interface (for example,
 the Initial Library menu item).

 To save attributes, choose the Save Attributes menu item
 from the Customize menu.

Overview

=TITLE Overview of CMS
=INCLUDE M
=INCLUDE M C_m Vw_mi Vw_text
 The VAX DEC/Code Management System (CMS) is a library
 system for software development and maintenance.

 During development, team members continually make changes
 to project files. CMS stores, tracks, and records user
 access and modifications to these files (called
 elements).  Elements are stored in one or more central
 libraries where they are available to all project
 members.

 For information about using CMS, double click on an
 item from the list of additional topics below.

 If you see a topic that lists no additional topics,
 click on the Go Back button or choose Overview...
 from above.

 For information on using help, choose Help from the
 Help menu above.

Additional information available:

DECwindows basicsAbout Release NotesUsing LibrariesUsing Elements
Using GroupsUsing ClassesRef copy defExiting from CMS

DECwindows basics

=TITLE DECwindows Basics
 Information about using DECwindows, such as how to manage
 windows, how to use dialog boxes, and how to use scroll
 bars is available from Session Manager help, which also
 explains many DECwindows terms.

  To get Session Manager help, perform the following steps:

  o  Pull down the Help menu on the session manager window.

  o  Choose the Overview menu item. The Overview help topic
     provides details about using DECwindows.

Additional information available:

SVN scroll bars

SVN scroll bars

=TITLE Using Scroll Bars
 You can use scroll bars to display data outside the
 borders of a window. A scroll bar has stepping arrows at
 each end of the scroll region and a slider within the
 scroll region.

 For more information about using a scroll bar, double
 click on one of the additional topics.

Additional information available:

Step arrowsScroll regionSlider

Step arrows

=TITLE Using Stepping Arrows
 Stepping arrows are the triangles that appear at each
 end of a scroll bar.

 To move the window one line in the direction of the
 stepping arrow, move the pointer to a stepping arrow and
 click on MB1.  This allows you to move through the data
 in the window at a pace that is easier to view.

Scroll region

=TITLE Using the Scroll Region
 The scroll region is the area between the stepping arrows
 that is not highlighted.

 To move the data in the window by one window length, move
 the pointer to the scroll region and click on MB1.

Slider

=TITLE Using the Slider
 The slider is the highlighted rectangle that appears in
 the scroll bar. The size of the slider indicates how much
 of the data appears on the screen. For example, if the
 slider takes up 10% of the scrolling region, only 10% of
 the data is displayed in the window.

 To move quickly through the data, move the pointer to the
 slider. Press MB1, and drag the slider through the
 scrolling region. When you release MB1, the information
 from the position in the data indicated by the slider is
 displayed in the window.

About Release Notes

=TITLE Release Notes
 You can find CMS release notes in
 SYS$HELP:CMS$vvu.RELEASE_NOTES, where vv is the major
 version number, and u is the update number.  For example,
 the release notes for Version 3.2 would be located in
 SYS$HELP:CMS$032.RELEASE_NOTES.  (Note the addition of
 the dollar sign ($) in the Version 3.2 file specification
 CMS$*.RELEASE_NOTES.  In previous versions of CMS, the
 release notes were located in CMS*.RELEASE_NOTES.)
 To list all the CMS release notes available, at DCL level
 type:

     $ DIRECTORY SYS$HELP:CMS*.RELEASE_NOTES.

Using Libraries

=TITLE Using Libraries
=INCLUDE Overview Ref_copy_def
=INCLUDE Occ O_d
=INCLUDE M C_m Vw_mi Vw_text
 A CMS library consists of a VMS directory and
 subdirectories containing specially
 formatted files that CMS uses.  The library serves as a
 repository for CMS elements and control files.

 When you invoke CMS, you must set up (or open) a library
 environment to tell CMS which library (or libraries) you
 want to use.  The library or libraries you specify
 become the library search list.  Even opening one
 library means that you are setting the library search
 list; in this case, the library search list contains
 one library.

 When you specify multiple libraries, CMS accesses them
 in the order that you specified.

 A library search list can be set in two ways:

   o  By pulling down the Library menu, then
      choosing the Open... menu item to
      open an existing library or libraries

   o  By creating a new library or libraries
      (this automatically sets the library
      search list--you do not need to then
      specifically open it)

 Libraries can be viewed in any CMS view.  Use the
 following steps to display a library's attributes:

   1.  Click on the library.
   2.  Pull down the View menu.
   3.  Pull down the Expand submenu.
   4.  Choose the Attributes menu item.

Additional information available:

Creating Libraries

Creating Libraries

=TITLE Creating a Library
 You must create an empty VMS directory (by using the DCL
 CREATE/DIRECTORY command) to contain the CMS library
 before you create the library.  After you create the VMS
 directory (which must be empty), you then create the
 library in that directory by following these steps:

        1.  Pull down the Library menu.
        2.  Choose the Create... menu item.

 The Create Library dialog box appears, allowing you to
 specify the directory and options for the newly-created
 library.

                        NOTE:
        Once you have created a library, you must
        access the library exclusively with CMS
        commands.  If a library is accessed by means
        other than CMS, unrecoverable library corruption
        may result.

Using Elements

=TITLE Using Elements
 An element is the basic structural unit in a library. An
 element consists of a file and all its versions
 (generations).  When you create an element and place it
 in a CMS library for the first time, CMS creates
 generation 1 of that element.   Each time you replace an
 element in the library, CMS creates a new generation of
 that file.  Thus, a generation represents a specific
 version of an element.

 CMS can store any type of VMS file except a directory
 file.

You can perform the following functions on elements:

   o  Create and delete elements
   o  Reserve elements
   o  Fetch a readonly copy of an element
   o  Insert elements into and remove elements from
      groups
   o  Set or change the attributes of an element
   o  View elements, their generations, and their
      attributes

Additional information available:

Element attrs

Element attrs

=TITLE Types of Attributes You Can Set for Elements
 You can display and set the following types of element
 attributes:

   o  Whether concurrent reservations are allowed
   o  Whether reference copies are maintained for
      elements
   o  Whether new element generations are marked
      for review
   o  Whether history information is included when the
      element is retrieved
   o  Whether notes are included when the element is
      retrieved

 Use the following steps to display an element's
 attributes:

   1.  Display an Element view.
   2.  Choose the desired element.
   3.  Pull down the View menu.
   4.  Pull down the Expand submenu.
   5.  Choose the Attributes menu item.

 Use the following steps to set or change an element's
 attributes:

   1.  Pull down the Maintenance menu.
   2.  Pull down the Modify submenu.
   3.  Choose the Element... menu item.

 A dialog box appears, allowing you to modify the element.

Using Groups

=TITLE Using Groups
 A group is a set of elements or other groups (or both)
 that you combine and can manipulate as a unit.

 For example, you might create a group that contains all
 the elements that process error messages; or you might
 create a group that contains all the chapters in a book.

 A group name is a string of 39 or fewer characters that
 consists of letters, digits, underlines, hyphens, or
 dollar signs.  Periods are not allowed in group names.

 You can perform the following functions on groups:

   o  Create and delete groups
   o  Reserve the contents of a group
   o  Insert elements (and other groups) into a group
   o  Retrieve and remove elements (and other groups)
      from a group
   o  Set or change the attributes of a group
   o  View the contents and attributes of a group

Additional information available:

Group attrs

Group attrs

=TITLE Types of Attributes You Can Set for Groups
 You can change the following types of group attributes:

   o  The name of the group
   o  The creation remark associated with the group
   o  The readonly attribute of the group

 Use the following steps to display a group's attributes:

   1.  Display a Group view.
   2.  Choose the desired group.
   3.  Pull down the View menu.
   4.  Pull down the Expand submenu.
   5.  Choose the Attributes menu item.

 Use the following steps to set or change a group's
 attributes:

   1.  Pull down the Maintenance menu.
   2.  Pull down the Modify submenu.
   3.  Choose the Group... menu item.

 A dialog box appears, allowing you to change the desired
 attributes.

Using Classes

=TITLE Using Classes
 A class is a set of particular generations of elements.
 You typically combine generations into classes to
 represent the state of elements at a particular time or
 stage.

 For example, you might create a class containing only
 those generations of elements that were used to produce
 the first draft of a manual in base level 1.

 A class name is a string of 39 or fewer characters that
 consists of letters, digits, underlines, hyphens, dollar
 signs, and periods.  Class names must begin with a letter.

 You can perform the following functions on classes:

   o  Create and delete classes
   o  Reserve the contents of a class
   o  Insert generations into a class
   o  Remove generations from a class
   o  Set or change the attributes of a class
   o  View the contents and attributes of a class

Additional information available:

Class attrs

Class attrs

=TITLE Types of Attributes You Can Set for Classes
 You can change the following types of class attributes:

   o  The name of the class
   o  The creation remark associated with the class
   o  The readonly attribute of the class

 Use the following steps to display a class's
 attributes:

   1.  Display a Class view.
   2.  Choose the desired class.
   3.  Pull down the View menu.
   4.  Pull down the Expand submenu.
   5.  Choose the Attributes menu item.

 Use the following steps to set or change a class's
 attributes:

   1.  Pull down the Maintenance menu.
   2.  Pull down the Modify submenu.
   3.  Choose the Class... menu item.

 A dialog box appears, allowing you to change the
 desired attributes.

Ref copy def

=TITLE About Reference Copy Directories
 A reference copy directory is a directory in which CMS
 stores a copy of the latest generation on the main
 line of descent of each element in a library. (The main
 line of descent of an element consists of generation 1
 of the element and all its direct descendants; that is,
 generation 2, 3, 4, and so on.)

 The reference copy directory is not a CMS library; it is
 a VMS directory associated with a CMS library. You cannot
 assign a CMS library as a reference copy directory, nor
 should it be a subdirectory of a CMS library.

 To establish reference copies, you must:

 1.  Create a VMS directory at DCL level (with the DCL
     CREATE/DIRECTORY command).

 2.  Associate the reference copy directory with the CMS
     library:

     o For new libraries: supply the name of the reference
       copy directory in the Create Library dialog box.

     o For existing libraries: supply the name of the
       reference copy directory in the Modify Library
       dialog box.

 3.  Associate the reference copy directory with elements:

     o For new elements: new elements inherit the
       reference copy attribute from the library;
       that is, new elements are automatically
       assigned a reference copy.  (Be sure that
       the Reference Copy Option in the Create Element
       dialog box is activated.)

     o For existing elements: You must set the
       reference copy attribute for existing elements;
       pull down the Modify Element dialog box and
       activate the Reference Copy option.

Exiting from CMS

=TITLE Exiting from CMS
 To exit from CMS, pull down the Library menu and choose
 Exit.

Use help

=TITLE Using CMS Help
=INCLUDE Overview DECwindows_basics
=INCLUDE Overview Exiting_from_CMS
 You can get help in two ways:

   o  Choose Overview from the Help menu.

 The Overview... topic describes the application and lists
 additional topics that explain how to do common tasks.
 Double click on an additional topic for more information.

   o  To get help on screen objects such as menu names,
      menu items, dialog boxes and buttons, press the
      HELP key while you press and hold MB1 on the screen
      object, release MB1, then release the HELP key.
      For example, to get help on a menu item:

      1. Press and hold MB1 on the menu name for which
         you want help.

      2. Press and hold the HELP key, then release MB1.

      3. Release the HELP key.

 Additional topics, if any, are listed.  To get help on
 an additional topic, double click on it.

W i p

=TITLE Work In Progress Box
 CMS displays the Work in Progress Box to notify you
 that the transaction you requested is currently being
 executed.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026