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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.