Changes the characteristics of a specified reservation.
Format:
MODIFY RESERVATION element-expression /qualifier "remark"
1 – Restrictions
o You must specify the following qualifier: /REMARK.
2 – Command Parameters
element-expression
Specifies one or more elements whose reservation reservations are
to be modified. An element expression can be an element name, a
group name, a wildcard expression, or a list of these separated by
commas.
remark
Specifies a character string to be logged in the history file with
this command, usually used to explain why the command was entered.
The remark is enclosed in quotation marks. If no remark was
entered, a null remark ("") is logged. Note that this parameter
and the string on the /REMARK qualifier are unrelated.
3 – Description
The MODIFY RESERVATION command changes the remark that is
associated with a particular reservation of one or more
elements. Use the SHOW RESERVATIIONS command to display
reservation characteristics.
4 – Qualifiers
4.1 /CONFIRM
Controls whether CMS prompts you for confirmation before each
transaction.
When you specify /CONFIRM and run CMS in interactive mode, CMS
prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
CMS executes the transaction. If you type NO, QUIT, FALSE, 0,
or press RETURN or CTRL/Z, no action is performed. If you type
any other character, CMS continues to prompt until you type an
acceptable response.
CMS does not prompt for confirmation in batch mode.
4.2 /GENERATION[=generation-expression]
Specifies which reserved generation of the element is to be
modified. If you have more than one reservation of the same
element generation, you must use the /IDENTIFICATION_NUMBER
qualifier to identify the reservation.
4.3 /IDENTIFICATION_NUMBER=n
Specifies which reservation is to be modified. This qualifier
is required when you have multiple reservations of the same
generation of an element. /IDENTIFICATION_NUMBER can be used
instead of /GENERATION when you have multiple reservations. Use
the SHOW RESERVATIONS command to determine the identification
number of each reservation. The identification number appears
before the user name.
4.4 /LOG (D)
Controls whether CMS displays success and informational messages
on the default output device. By default, if the command executes
successfully, CMS displays a success message. If you specify
/NOLOG, success and informational messages are suppressed. Any
warning, error, or fatal error messages are displayed regardless
of whether /LOG or /NOLOG is specified.
4.5 /OCCLUDE[=option,...]
Controls whether CMS selects the first instance of the specified
object, or all instances of the specified object in the library
search list. The options field contains one or more keywords
associated with the name of the object. The options field can
contain the following keywords:
ALL--equivalent to (ELEMENT, GROUP, CLASS)
ELEMENT (D)
NOELEMENT
GROUP (D)
NOGROUP
CLASS (D)
NOCLASS
NONE--equivalent to (NOELEMENT, NOGROUP, NOCLASS)
You can specify either ALL or NONE, or any combination of the
[NO]ELEMENT, [NO]GROUP, and [NO]CLASS keywords.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
4.6 /REMARK="string"
Specifies a new remark to be substituted for the remark that is
associated with the reservation. This qualifier is required.
5 – Example
CMS> MODIFY RESERVATION/GENERATION=5/REMARK="Add new feature"
_Element expression: SPEC.TXT
_Remark: Modify the reservation remark
%CMS-S-MODIFIED, reservation SPEC.TXT modified
This command specifies a new remark to be substituted for the
reservation remark that was specified when generation 5 of
element SPEC.TXT was reserved. You must also specify the element
expression, and its associated remark, which is logged in the
history file.