Choose the File menu to perform the following
operations:
o Create a new library or element
o Open (or set) a library
o Fetch a library element
o Reserve an element
o Replace an element
o Unreserve an element
o Close a library
o Specify a default directory
o Close a view window when there are
multiple windows open
o End the CMS session
Choose a menu item from the File menu to perform the
desired action.
1 – New mi
Choose the New item to create either a new library or a new element. The New Library... and New Element... items in the submenu invoke dialog boxes that prompt you for information to create the new objects.
1.1 – Cl mi
Choose the New Library... menu item to create a CMS library. You must create the library in an existing empty OpenVMS directory (or direct CMS to create the directory); you can have only one CMS library in each directory. When you choose New Library..., a dialog box appears allowing you to specify options for the library you are creating. New Library... automatically opens the library for access; you do not have to explicitly open it.
1.1.1 – Cl db
The New Library dialog box allows you to enter information about the library you want to create, such as the library name, the creation remark to be logged in the library history, whether CMS should create the directory for you, the name of the reference copy directory (if any) to be associated with the library, and search list information.
1.1.1.1 – Cl lf
Fill in the Library field with the name of the library to be created. Unless you have told CMS to create the directory for you (via the Automatically Create Directory button), this name must be the name of a valid OpenVMS directory that you created with the DCL CREATE/DIRECTORY command, and the directory must be empty. This library cannot be your current default directory. Wildcards are not allowed.
1.1.1.2 – Cl dr
Fill in the Remark field with text that is associated with the creation of the new library. The text is permanently logged in the library history file. You are not required to surround the Remark field with quotes. You can use any characters; however, the length of the remark cannot exceed 256 characters. If you do not enter a remark, a null remark is logged in the library history file.
1.1.1.3 – Cl rdb
Fill in the Reference Copy Directory field with the name of a reference copy directory (you must have already created the OpenVMS directory). This associates the reference copy directory with the current library. When the Reference Copy Directory button is activated, CMS stores copies of elements in the reference copy directory. For more information, double click on About Reference Copy Directories from the list of additional topics below. The reference copy directory cannot be a CMS library, nor should it be a subdirectory of a CMS library. Wildcards are not allowed.
1.1.1.4 – Cl acd
Click on the Automatically Create Directory button to direct CMS to automatically create the library directory for you.
1.1.1.5 – Cl rev o
The File Revision Time attributes consist of the following
choices:
o Original--specifies that the original revision
time of files placed in a CMS library should
be restored unchanged upon their retrieval.
This is the default behavior.
o Storage Time--specifies that the time when a
file was stored in a CMS library (through a create
element or replace transaction) should be
substituted for its original revision time upon
retrieval.
1.1.1.6 – Cl sl
Click on the Search List Position button to specify:
o Whether the new library (or libraries) will
supersede the existing list, if one exists.
o Whether the new library or libraries will
be inserted into the existing list, and the
position in which they are to be inserted, before
or after other libraries, or last in the list.
1.1.1.7 – Cl nr
Click on the New button to supersede the existing library list with the new library (or libraries) specified in the Library field.
1.1.1.8 – Cl frb
Click on the First button to insert the new library at the beginning of the library list.
1.1.1.9 – Cl da
Click on the After button to insert the new library into the library list immediately following the library specified in the After field. You must then supply a library in the After field.
1.1.1.10 – Cl ar
Fill in the After field with the name of the library that the newly-opened library will follow. The default is to include the newly-opened library after all previously opened libraries.
1.1.1.11 – Cl lr
Click on the Last button to insert the new library at the end of the library list.
1.1.1.12 – Cl cur
This flag indicates whether or not elements created in this library will allow concurrent reservations by default.
1.1.1.13 – Cl kep
This flag indicates whether all versions of the file used to create an element or generation are deleted during that operation.
1.1.1.14 – Cl ext
This flag indicates whether extended filename are allowed in the library. Extended filenames are only available on OpenVMS V7.2 and later.
1.1.1.15 – Cl var
This flag indicates whether long variant names are allowed in the library.
1.2 – Ct emi
Choose the New Element... menu item to bring up a dialog box, enabling you to input attributes and other options for the element you are creating. The new element transaction creates the first generation of a new element. It does this by moving the input file from an OpenVMS directory into a CMS library. By default, CMS searches for the file in your current default directory; you can direct CMS to use a file with a different name or in a different directory by choosing the Input File option. After the element is created, CMS deletes all versions of the input file from the specified location unless you turn off the Delete Input Files option or turn on the Reserve New Element option.
1.2.1 – Ct dbx
The New Element dialog box allows you to enter information about the element (or elements) you want to create.
1.2.1.1 – Ct ef
Fill in the Element field with the name of one or more elements to be created. Within a library, all element names must be unique. Do not use the file name 00CMS, because that name is reserved for CMS. You can also specify a list of element names separated by commas, or you can specify a wildcard expression. The name cannot be the same as any existing element name in the library.
1.2.1.2 – Ct r
Fill in the Remark field with text to be associated with the creation remark of the element and logged in the history file with this create transaction. The remark is stored with both the element and its first generation.
1.2.1.3 – Ct inp
Click on the Input File button to specify that the file to be used to create the element is in a different location than your default directory, or is named other than the element name. You must also specify the name of the directory if the file is in a location other than your default directory. After the element is created, CMS deletes all versions of the input file from the specified location unless you turn off the Delete Input Files option or turn on the Reserve New Element option.
1.2.1.4 – Ct del
Click on the Delete Input Files button to direct CMS to delete all versions of the file used to create the new element.
1.2.1.5 – Ct res
Click on the Reserve New Element button to direct CMS to reserve the new element after it is created. When you specify the Reserve New Element option, CMS does not delete the file used to create the element. When you choose Reserve New Element, generation 1 of the newly-created element is automatically reserved. If the Reserve New Element option is turned off and the Delete Input File options is turned on, CMS deletes all versions of the file used to create the element.
1.2.1.6 – Ct bin
Click on the Create Binary File button to direct CMS to create the new element in binary format. When you specify the Create Binary File option, CMS creates the element in binary format irrespective of file properties. If the Create Binary File option is turned off, CMS decides on its own whether to create binary element or text element depending on file properties.
1.2.1.7 – Ct ele a
You can establish different attributes for each element
you create. These attributes include the following:
o Whether to allow reservations of the same element
by more than one user
o Whether elements are assigned a reference copy file
o Whether new element generations are marked
for review
o Whether to include notes and history information
when the element is retrieved
1.2.1.7.1 – Ct all
Click on the Allow Concurrent Reservations button to allow multiple reservations for the element. After you create the element, you grant or deny concurrent access by doing the following: 1. Click on the element. 2. Pull down the Maintenance menu. 3. Pull down the Modify submenu. 4. Choose the Element... menu item. CMS brings up a dialog box, allowing you to specify the desired options.
1.2.1.7.2 – Ct rf
Click on the Reference Copy button to direct CMS to maintain a reference copy of the element. You must have previously created a reference copy directory and enabled the Reference Copy attribute of the library. CMS creates a reference copy for the new element and updates the element's reference copy file in the reference copy directory whenever you create a new main line generation of the element. When CMS places a file in the reference copy directory, it also deletes any earlier versions of that file in the reference copy directory. The reference copy attribute is inherited from the library; that is, if a reference copy directory is established for the library, the attribute is also enabled for new elements by default.
1.2.1.7.3 – Ct mar
Click on the Mark new generations for review button to direct CMS to mark new new generations of the element for review. New generations of that element are marked for review only if the reserved generation was either rejected or has a review pending.
1.2.1.7.4 – Ct no
Click on the Notes button to append notes to the lines of the file when you fetch or reserve the element.
1.2.1.7.4.1 – Ct nof
Fill in the Format field with a format string. The note
for a line consists of the format string.
The format string characters #G indicate that the
generation number of the particular generation in which
the line was inserted or most recently modified should be
appended to the lines of the output file.
You can optionally include other ASCII text in the Notes
Format field. To include a quotation mark in the notes
string, type it twice (""). To include a number sign in
the notes string, type it twice (##).
You must also specify the column number in which to place
the note.
1.2.1.7.4.2 – Ct noc
Fill in the Column field with the column number where the note should begin. This value is required and must be an integer in the range 1 to 511. The note is placed to the right of the text of the line. If the length of the line is less than the column number, the note appears at the column number position. If the length of the line is greater than or equal to the column number, the note is placed at the next tab stop after the end of the line. (Tab stops are at position 9 and every eight characters thereafter.)
1.2.1.7.5 – Ct his
Click on the History button to establish the History attribute for the element. If an element has the History attribute enabled, its history is included in the file when you retrieve it with the fetch or reserve transactions.
1.2.1.7.5.1 – Ct his be
Click on the At Beginning button to direct CMS to include the history for the element at the beginning of the output file. Click on the At End button to direct CMS to include the history for the element at the end of the output file.
1.2.1.7.5.2 – Ct his f
Fill in the Format field with a format string indicating
where the format is to appear in the output file.
The string must contain the characters #H or #B
(lowercase is allowed), and can contain other printing
characters. Use the letter B to include the history at
the beginning of the file. Use the letter H to include
the history at the end of the file.
To include a quotation mark in the history string, type
it twice (""). To include a number sign in the history
string, type it twice (##).
2 – Ol mi
Choose the Open... menu item to establish an existing CMS library as the current library. The library is automatically inserted into the library search list. When you choose Open..., a dialog box appears, allowing you to specify options for the library to be opened. You can specify multiple libraries to be opened by separating each library with a comma.
2.1 – Ol db
The Open Library dialog box allows you to specify information such as the name of the library to be opened, allows you to verify the opened library, and optionally allows you to specify search list information for the library. It also displays any known libraries you have set up using the Known Libraries... menu item under the Options menu.
2.1.1 – Ol db lf
Fill in the Library Directory field with the name of a OpenVMS directory previously defined as a CMS library. The library cannot be your current default directory. The library must already exist. You can specify multiple libraries to be opened by separating each library name with a comma. Wildcards are not allowed.
2.1.2 – Ol klf
The Known Libraries list box contains a list of all the CMS libraries you previously specified (if any) through the Known Libraries... submenu under the Options menu. The Known Libraries list box can contain ten library names. If you click on a library in the list box, the library is placed in the Library Directory field. Double click on the library in the list box to place it in the Library Directory field and open it. If you press the SHIFT key, then click on the library in the list box, the library is appended to any libraries in the Library Directory field. Press the SHIFT key, then double click on the library in the list box to append the library to any libraries in the Library Directory field and open it.
2.1.3 – Ol va tb
When the Verify Added Libraries button is activated, CMS performs a normal locking and verification process as the library is opened. If Verify Added Libraries is not activated, CMS opens the library without performing the locking and verification process. This speeds up the open library operation and allows you to open the library even if it is locked by another user.
2.1.4 – Ol sl pd
Click on the Search List Position button to specify the
position the new library or libraries should have in the
search list, including:
o Whether the new library will supersede the
existing list, if one exists
o Whether the new library (or libraries) will
be inserted into the existing list, and the
position in which they are to be inserted, before
or after other libraries, or last in the list.
2.1.5 – Ol nr b
Click on the New button to supersede the existing library list with the new library (or libraries) specified in the Library Directory field.
2.1.6 – Ol fr b
Click on the First button to insert the new library at the beginning of the library list.
2.1.7 – Ol ar b
Click on the After button to insert the new library into the library list immediately following the library specified in the After field. You must then supply a library in the After field. Fill in the After field with the directory specification of the library that the newly-opened library will follow. The default is to include the newly-opened library after all previously opened libraries.
2.1.8 – Ol db afb
Fill in the After field with the name of the library that the newly-opened library will follow. The default is to include the newly-opened library after all previously opened libraries.
2.1.9 – Ol lr b
Click on the Last button to insert the new library at the end of the library list.
3 – F mi
Choose the Fetch... menu item to retrieve a copy of the specified object or objects from the CMS library. The object can be an element name, a group name (CMS will fetch the most recent generations of elements in the group), a wildcard expression, or a list of these separated by commas. CMS fetches the most recent generation on the main line of descent unless you fill in the Generation field. Fetch delivers a copy of the specified generations to your current default directory. The generation is not reserved, and CMS does not allow you to replace it. CMS allows you to fetch a generation that is already reserved, and notifies you of any current generation reservations for the element. If a version of a file with the same name as the element already exists in your current default directory when you execute the fetch transaction, CMS notifies you. A new version is then created with the next higher version number.
3.1 – F sf
If you click on an object or objects before choosing the Fetch... menu item, the Selected box contains those objects. CMS performs the fetch transaction on the selected objects.
3.2 – F ef
Fill in the Element field with the name of the object or objects you want retrieved. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas. By default, CMS retrieves the most recent generation on the main line of descent of each element. If you want to fetch a specific generation of the element, you must specify the generation number in the Fetch Generation field.
3.3 – F gf
Fill in the Generation field with the number of the generation you want retrieved. For example, 3B2. If you omit this field, CMS by default fetches the most recent generation on the main line of descent.
3.4 – F rf
Fill in the Remark field with text to be associated with the transaction and logged in the history file with this fetch transaction.
3.5 – F opb
Click on the Options button to bring up a dialog box,
allowing you to specify the following options in the
library:
o Whether to write the element out to a differently
named file
o Whether to merge generations of an element
o Whether to include notes and history information
when the element is fetched
3.5.1 – F of
Click on the Output File button to direct CMS to write output to a specified file; you must supply a file specification in the Output File field. If you omit the file specification in the Output File field, CMS creates a file in your default directory with the same name as the element. If you specify multiple elements (by using wildcards, a comma list, or a group name) and you do not specify wildcards in the Output File field, CMS creates successive versions of the file and places the files in your default directory.
3.5.2 – F mg
Click on the Merge Generation button to specify that another generation of the element (called the merge generation) is to be merged with the generation being fetched (called the retrieved generation). Fill in the Merge Generation field with the number of the merge generation. CMS merges the lines of the two generations and delivers a single copy of the file to your default directory. The merge generation cannot be on the same line of descent as the retrieved generation. When there is a conflict between blocks of one or more lines, CMS includes the conflicting lines and flags the conflict.
3.5.3 – F na
The Notes attribute controls the inclusion of notes in the output file when you fetch the element (or generation). Specifying options for the Notes attribute for this fetch transaction temporarily establishes the Notes attribute for the element, regardless of whether the element previously had the Notes attribute enabled. To display the current default notes attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
3.5.3.1 – F nd
Click on the Default button to direct CMS to append notes to the output file as it is retrieved by the fetch transaction, depending on the default you have set up for the element using the New Element... menu item under the File menu, or the Modify Element... menu item under the Maintenance menu.
3.5.3.2 – F nn
Click on the None button to prevent CMS from embedding any notes in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or the Modify Element... menu item under the Maintenance menu.
3.5.3.3 – F nfo
Click on the Format button to direct CMS to append notes
to the lines of the file. You may also specify a format
field string.
If you specify a format field string, CMS temporarily
overrides any default format field string you have set
up for the element using the New Element... menu item
under the File menu, or using the Modify Element... menu
item under the Maintenance menu.
The format string specifies the format of the note. The
string can contain text or the character #G (lowercase is
allowed). To include a quotation mark in the notes
string, type it twice (""). To include a number sign in
the notes string, type it twice (##).
If you click on the Format button and the element you are
fetching was not created or modified with the Notes
attribute on, then you must also specify a number in the
Position field.
3.5.3.4 – F c
Fill in the Position field with the column number in which the note is to be placed. If you specify the Format option, then you must also specify a Position number. The Position number can be any integer in the range 1 to 511. By default, CMS places notes in column 80.
3.5.4 – F hd
Choose the History attribute to control the inclusion of the history records in the output file when you fetch the element (or generation). Specifying options for the History attribute for this fetch transaction temporarily establishes the history attribute for the element, regardless of whether the element previously had the Notes attribute enabled. To display the current default History attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
3.5.4.1 – F hd pb
Click on the Default button to specify that history should be included in the output file as it is retrieved, depending on the default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
3.5.4.2 – F hn tb
Click on the None button to prevent CMS from including the element history in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
3.5.4.3 – F hf f
Click on the Format button to specify that history is to
be included in the output file. You may also specify a
format field string.
If you specify a format field string, CMS temporarily
overrides any default format field string you have set
up for the element using the New Element... menu item
under the File menu, or using the Modify Element... menu
item under the Maintenance menu.
The format string specifies the format of the history.
The string must contain the characters #H or #B
(lowercase is allowed), and can contain other printing
characters. To include a quotation mark in the history
string, type it twice (""). To include a number sign in
the history string, type it twice (##).
4 – R mi
Choose the Reserve... menu item to retrieve a copy of the specified object from the CMS library and mark it as reserved. The object can be an element, group, a wildcard expression, or a list of these separated by commas. Reserve places a copy of the object in your current default directory, and marks the object as reserved. When you choose Reserve, a dialog box appears, allowing you to specify options for the reserve transaction.
4.1 – riel_mnt
A reserved element indicates that a copy of one or more of the element's generations has been retrieved and placed in the users default directory. CMS marks that generation as being reserved. You can then work on the file as necessary before replacing it back into the library.
4.2 – Re dbx
The Reserve dialog box allows you to enter information about an object (or objects) you want to reserve.
4.2.1 – Re sf
If you click on an object or objects before choosing the Reserve... menu item, the Selected box contains those objects. CMS performs the reserve transaction on the selected objects.
4.2.2 – Re ef
Fill in the Element field with the name of the object (or objects) you want to reserve. By default, CMS reserves the most recent generation on the main line of descent of each element. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas. If you want to reserve a specific generation of the element, you must specify the generation number in the Generation field.
4.2.3 – Re gf
Fill in the Generation field with the number of the generation you want reserved; for example, 3B1. If you omit this field, CMS reserves the most recent generation on the main line of descent.
4.2.4 – Re rf
Fill in the Remark field with text to be associated with the reservation and logged in the history file with this reserve transaction.
4.2.5 – Re op pb
Choose the Options button to specify the options for the
reserve transaction, including:
o Whether to allow reservations of the same element
by more than one user
o Whether to write the element out to a differently
named file
o Whether to merge generations of an element
o Whether to include notes and history information
when an object is reserved
4.2.5.1 – Ra cr pb
The Allow Concurrent Reservations button allows you to specify whether another user can reserve an element while you have it reserved. If this button is activated, you must replace or unreserve the element before others can reserve it.
4.2.5.2 – Ro ft b
Click on the Output File button to direct CMS to write output to a specified file; you must supply a file specification in the Output File field. If you omit the file specification in the Output File field, CMS creates a file in your default directory with the same name as the element. If you specify multiple elements (by using wildcards, a comma list, or a group name) and you do not specify wildcards in the Output File field, CMS creates successive versions of the file and places the files in your default directory.
4.2.5.3 – Re me g
Click on the Merge Generation button to specify that another generation of the element (called the merge generation) is to be merged with the generation that is being reserved (called the retrieved generation). Fill in the Merge Generation field with the merge generation number. CMS merges the lines of the two generations and delivers a single copy of the file to your default directory. The file that CMS places in your directory has the current creation and revision times. The merge generation cannot be on the same line of descent as the retrieved generation. When there is a conflict between blocks of one or more lines, CMS includes the conflicting lines and flags the conflict.
4.2.5.4 – R na
The Notes attribute controls the inclusion of notes in the output file when you reserve the element (or generation). Specifying options for the Notes attribute for this reserve transaction temporarily establishes the Notes attribute for the element, regardless of whether the element previously had the Notes attribute enabled. To display the current default Notes attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
4.2.5.4.1 – Nd tb
Click on the Default button to direct CMS to append notes to the output file as it is retrieved by the reserve transaction, depending on the default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
4.2.5.4.2 – Nn tb
Click on the None button to prevent CMS from embedding any notes in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
4.2.5.4.3 – Nf o
Click on the Format button to direct CMS to append notes
to the lines of the file. You may also specify a format
field string.
If you specify a format field string, CMS temporarily
overrides any default format field string you have set
up for the element using the New Element... menu item
under the File menu, or using the Modify Element... menu
item under the Maintenance menu.
The format string specifies the format of the note. The
string can contain text or the character #G (lowercase is
allowed). To include a quotation mark in the notes
string, type it twice (""). To include a number sign in
the notes string, type it twice (##).
If you click on the Format button and the element you are
reserving was not created or modified with the Notes
attribute on, then you must also specify a number in the
column field.
4.2.5.4.4 – R c f
Fill in the Column field with the column number in which the note is to be placed. If you specify the Format option, then you must specify the column number. The column number can be any integer in the range 1 to 511.
4.2.5.5 – Ha
Choose the History attribute to control the inclusion of the history records in the output file when you reserve the element (or generation). Specifying options for the History attribute for this reserve transaction temporarily overrides any defaults you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu. To display the current default History attribute, do the following: 1. Pull down the View menu. 2. Choose the Element menu item. 3. Click on the desired element. 4. Pull down the View menu. 5. Choose the Expand submenu. 6. Choose the Attributes menu item.
4.2.5.5.1 – Hd tb
When the Default button is activated, CMS includes the history in the output file as it is retrieved by the reserve transaction, depending on the default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
4.2.5.5.2 – Hn tb
When the None button is activated, CMS does not include any element history in the output file, regardless of any default you have set up for the element using the New Element... menu item under the File menu, or using the Modify Element... menu item under the Maintenance menu.
4.2.5.5.3 – Hf o
When the Format button is activated, CMS includes the
history in the output file. You may also specify a
format field string.
If you specify a format field string, CMS temporarily
overrides any default format field string you have set
up for the element using the New Element... menu item
under the File menu, or using the Modify Element... menu
item under the Maintenance menu.
The format string specifies the format of the history.
The string must contain the characters #H or #B
(lowercase is allowed), and can contain other printing
characters. To include a quotation mark in the history
string, type it twice (""). To include a number sign in
the history string, type it twice (##).
5 – Rp mi
Choose the Replace... menu item to return an element reservation to the library and create a new generation of the element. The replace transaction transfers a file from your default directory to the current CMS library, thus creating a new generation. The number of the new generation is the number of its predecessor with the rightmost level number increased by 1. For example, if you reserved generation 1A1, CMS would create generation 1A2 when you replaced it. Replace checks for other current reservations and concurrent replacements of the element, and whether you are replacing another user's reservation. If any of these situations occur, CMS prompts whether you want to proceed with the transaction. If you execute the transaction, CMS records it as an unusual occurrence.
5.1 – Rp sf
If you click on an object or objects before choosing the Replace... menu item, the Selected box contains those objects. CMS performs the replace transaction on the selected objects.
5.2 – Rp ef
Fill in the Element field with the name of the reserved object (or objects) you want replaced back into the library. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas.
5.3 – Rp rf
Fill in the Remark field with text to be associated with the newly-created generations, to be logged in the history file with this replace transaction. If you do not enter a remark, the remark from the corresponding reservation is used for the new generation and the replacement transaction in the history file.
5.4 – Rp opb
The Options button brings up a dialog box, allowing you
to specify the following options in the library:
o A generation number for the replacement
o A reservation identification number for
the replacement
o A file other than the one located in your
default directory to be used as the input file
o A variant generation name to be created
o Classes into which new generations are to be
inserted
o Whether CMS should delete the file from your
default directory after the replacement
o Whether CMS should create a new generation only
if the generation has had changes made to it
o Whether the new generation created by the
replacement is reserved.
5.4.1 – Rp go
Fill in the Generation field with the number of the specific generation to be replaced; for example, 3B2. Choose the Generation option when you have more than one reservation of an element or if you are replacing another user's reservation (you can also do this by using the Reservation Identification option). You can use Replace Generation as long as the concurrent reservations are not on the same generation. If you have more than one concurrent reservation for the same generation, you must fill in the Replace Reservation Identification option.
5.4.2 – Rp rio
Choose the Reservation Identification option when you
have multiple reservations of the same element
reservation (you can also do this by choosing the Replace
Generation option).
If you have more than one concurrent reservation for the
same generation, you must identify the specific
reservation to be replaced. If multiple users have
reserved the same generation of an element and you have
BYPASS privilege or have been granted BYPASS access to
the element by an access control list entry, you must
identify the specific reservation to be replaced.
Each reservation is assigned an identification number.
Fill in the Reservation Identification field with the
specific number of the reservation to be replaced; for
example, 2.
To determine the identification number of each
reservation, do the following:
1. Pull down the View menu.
2. Choose the Reservation menu item.
3. Double click on the reserved element to
expand it into individual reserved generations.
The identification number appears in parentheses at the
beginning of each line that lists a reserved generation.
5.4.3 – Rp ifo
Fill in the Input File field with a file name other than the one located in your default directory. After the reserved generation is replaced, CMS deletes the file used to create the new generation (and any earlier versions of the file in the same directory) unless you turn off the Delete files when replaced button, or turn on the Reserve Again button. If you do not supply a file name, CMS searches your current default directory for a file with the same name as the element.
5.4.4 – Rp vgl
Fill in the Variant Generation Name field to create a variant generation. If two or more users have concurrently reserved the same element generation, only one of the replaced generations can be on the same line of descent. Thus, no more than one can be replaced as a main line generation and the rest must be replaced as variants. The Variant Generation Names are limited to alphabetic characters (A through Z) and underscore characters with a maximum length of 255 characters. CMS labels the variant generation by appending the Variant Generation Name and the number 1 to the generation number. For example, if you reserved generation 2 of an element INIT.BAS, you could create a variant 2CHANGE_ABC1, where 2 is the generation number, CHANGE_ABC is the variant name, and 1 is the appended number.
5.4.5 – Rp iic
Fill in the Insert Into Classes field to specify one of more classes into which the newly created generations are to be inserted.
5.4.6 – Rp dfr
Click on the Delete files when replaced button to specify that all versions of the file used to create the new element are deleted from your directory.
5.4.7 – Rp cng o
Click on the Create new generation only if changed button to specify that a new generation is to be created only if the input file is different from the generation that was reserved. After the new generation is created, CMS deletes all versions of the input file from the specified location unless you turn off the Delete files when replaced button or turn on the Reserve Again button.
5.4.8 – Rp atb
Click on the Reserve Again button to control whether the new generation of the element created by the replacement is re-reserved. The element files are not deleted from your current default directory.
6 – Ur mi
Choose the Unreserve... menu item to cancel one or more reservations of a generation of an element. You cannot unreserve a generation held by another user unless you hold BYPASS privilege or unless you are granted BYPASS access to the element by an access control list (ACL). If you have more than one reservation of an element or if you are canceling another user's reservation, you must specify the exact reservation to be canceled. You do this by using either the Generation option or the Reservation Identification button in the Options dialog box (choose the Options button).
6.1 – Ur sf
If you click on an object or objects before choosing the Unreserve... menu item, the Selected box contains those objects. CMS performs the unreserve transaction on the selected objects.
6.2 – Ur ef
Fill in the Element field with the name of the object or objects whose reservations are to be canceled. The object can be an element name, a group name, a wildcard expression, or a list of these separated by commas.
6.3 – Ur rf
Fill in the Remark field with text to be associated with the cancellation and logged in the history file with this unreserve transaction.
6.4 – Ur opb
The Options button brings up a dialog box, allowing
you to specify the following options in the library:
o A generation number for the reserved generation
to be canceled
o A reservation identification number for the
reserved generation to be canceled
o Whether CMS should delete the file from your
default directory after the cancellation, and
optionally, a file name and location other
than your default directory.
6.4.1 – Ur ogf
Fill in the Generation field with the specific generation number of the reservation to be canceled; for example, 3B2. If you have more than one reservation of the same element generation, you must choose the Reservation Identification option to unreserve the reservation.
6.4.2 – Ur rio
Use the Reservation Identification option when you have
multiple reservations of the same element generation.
If you have more than one concurrent reservation for the
same generation, you must identify the specific
reservation to be unreserved. If multiple users have
reserved the same generation of an element and you have
BYPASS privilege or have been granted BYPASS access to
the element by an access control list entry, you must
identify the specific reservation to be unreserved.
Each reservation is assigned an identification number.
Fill in the Reservation Identification field with the
number of the specific reservation to be canceled; for
example, 2.
To determine the identification number of each
reservation, do the following:
1. Pull down the View menu.
2. Choose the Reservation menu item.
3. Double click on the reserved element to
expand it into individual reserved generations.
The identification number appears in parentheses at the
beginning of each line that lists a reserved generation.
6.4.3 – Ur dfu
Click on the Delete files when unreserved button to delete all versions of the unreserved file from your default directory. If you choose this option, you can also use the Delete file specification field to specify a different location or a different file specification (or both) for the file to be deleted.
6.4.4 – Ur dfs
Fill in the Delete file specification field with a different location and/or name of the file to be deleted.
7 – Cm mi
Choose the Close... menu item to remove one or more libraries from the current library search list.
7.1 – Cl olries
The Open Libraries list box contains the current libraries in your library list. Double click on a library to close it.
7.2 – All
Click on the All button to close all the libraries in the current library list, regardless of whether or not they have been currently selected.
8 – Dd mi
Choose the Set Directory... menu item to specify a default device and directory to be automatically used for file input and output. CMS uses the default device and directory you specify for the duration of the current CMS session. Your initial default device and directory are restored when you exit from the CMS session.
8.1 – Dd d
Specify the name of the default directory to use. This directory cannot be your CMS library directory or any of its subdirectories.
9 – Cv mi
Choose the Close View menu item to close the current view window when there are multiple CMS views open. The Close View menu item is located in both the File and View menus, and has the same function in both menus.
10 – E mi
Choose the Exit menu item to end the CMS session.