cms$dw_help — VMS CMS_3.2
Additional information available:
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
=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
=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
=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
=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
=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.