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.