reserve
Reserves a line of descent and creates an editable copy of the latest version.
Format
reserve element_name[/branch_path] [-into pathname] [-r]
Description
The reserve command reserves an element's main line of descent or one of its
branch paths, and places an editable copy of the latest version in that line of
descent in your working directory or in the file or directory specified by the
-into pathname option. Use the -r option if the target file already exists and
you want to overwrite it.
If the element you want to reserve is not in the current library and you have a
current system model setting, the DSEE facility searches the current model for
an Element of the given name. If it finds a single Element block with the same
name, the DSEE facility resets your current library setting to the library
containing that Element's primary dependency and then performs the specified
operation.
After reserving an element, you can modify the copy the DSEE facility supplied,
and when you're ready, replace it in the library (with the replace command)
where it becomes the next generation in the specified line of descent.
A reservation gives you, as the reserver, the exclusive right to add the next
version in a line of descent. Other users may fetch or read earlier versions or
create alternate branch paths, but they may not reserve that line of descent.
If they try to, the DSEE facility informs them that the line of descent is
already reserved.
The DSEE facility also checks to see if the element has a monitor before
performing a reserve. If there is a monitor, the DSEE facility informs you of
that fact, in case you want to talk to the user who created the monitor before
modifying the element.
By default, the DSEE facility opens an edit pad and asks you to describe why
you're reserving the element. The DSEE facility seeds the reserve operation's
edit pad with the name of the current task, if there is one. When you
eventually replace the element, the DSEE facility notes the replace operation in
the current task's transcript.
The DSEE facility stores your comments in the element's history file, and seeds
the element's replace edit pad with them.
Options:
-into pathname Places the copy in an alternate file or directory.
-r If the target file exists, overwrite it.
-comment "text" Allows you to enter comments without generating
an edit pad.
-nq Suppresses comment queries; associates seeded comments
(if available) with the operation.