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.
The /NOCONFIRM qualifier does not override the confirmation prompt
issued when you make a concurrent replacement or when you replace
another user's reservation.
2 /GENERATION=generation-expression
Specifies which reserved generation of the element is to be
replaced. If you have more than one reservation of the same
element generation, you must use the /IDENTIFICATION_NUMBER
qualifier to replace the reservation.
3 /IDENTIFICATION_NUMBER=n
Specifies which reservation is to be replaced. This qualifier
is required when you have multiple reservations of the same
generation of an element. This qualifier is also required
when 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.
/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 in
parentheses at the beginning of each line.
4 /IF_CHANGED
Specifies that a new generation is to be created only if the
input file is different from the generation that was reserved.
If this qualifier is omitted, a new generation is always created.
5 /INPUT[=file-specification]
Specifies a file to be used as input for the replacement
transaction. If you use the /INPUT qualifier but you do not supply
a file specification, CMS searches your current default directory
for a file with the same name as the element specified on the
command line. When you specify /INPUT, CMS deletes the input file
from the specified location after the new generation is created
(unless you specify the /KEEP or /RESERVE qualifier).
CMS must be able to match the input element list with the list of
elements indicated by the element expression parameter. Thus, if
you use wildcards in the /INPUT file specification to generate
more than one input file, you must also use wildcards in the
element expression parameter.
6 /INSERT_INTO_CLASS=(class_expression)
Specifies one or more classes into which newly created generations
are to be inserted. The class expression can be a class name, a
wildcard expression, or a list of these separated by commas. If a
list is not used, the parentheses can be omitted.
The new generation of each element replaced is inserted into the
specified classes. If no new generation is created, no insertion
takes place.
This qualifier effectively combines the REPLACE and INSERT
GENERATION commands. It ensures that the new generation is inserted
into the specified class of classes, avoiding the potential problem
of other users updating the library between a REPLACE command and a
subsequent INSERT GENERATION command. It also deals effectively with
variants.
For each of the specified classes, provided there is INSERT access
to the class and it is not set to READ_ONLY, new generations are
always inserted, irrespective of whether or not the class already
contains a generation of the element. Any old generation is removed
from the class before the new generation is inserted. This is like
using the /ALWAYS qualifier in an INSERT GENERATION command.
If other insertion modes, for example /SUPERSEDE, are required,
create a temporary class and use that in the REPLACE command. Then
use the temporary class as the value of the /GENERATION qualifier in
an INSERT GENERATION command with the required mode.
The insert operation takes place in the library where the new
generation was created, so class occlusion does not apply to
classes specified in this qualifier (class occlusion applies to a
class specified in the /GENERATION qualifier).
Any actions specified in access control entries associated with the
INSERT GENERATION command, or with the classes into which
generations are inserted, will be executed after any actions
associated with the REPLACE command or with elements being replaced.
Use of this qualifier requires execute access to the INSERT
GENERATION command.
7 /KEEP
Controls whether the file used to create the new element
generation is deleted from your directory. If you omit both /KEEP
and /RESERVE, the files are deleted.
8 /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.
9 /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.
10 /RESERVE
Controls whether the new generation of the element created by the
replacement is reserved. If you specify the /RESERVE qualifier,
the generation is reserved and the element files are not deleted
from your current default directory. The list of concurrent
replacements is updated as if /RESERVE had been omitted.
11 /VARIANT=variant-name
Controls whether a variant generation is created. If you specify
the /VARIANT=variant-name qualifier, the number of the created
generation is the predecessor's number, followed by the variant
name, followed by the number 1.
The Variant Generation Names are limited to
alphabetic characters (A through Z) and underscore
characters with a maximum length of 255 characters.
If two or more users have concurrently reserved the same element
generation, the replaced generations cannot be on the same line of
descent. Thus, one can be replaced as a main line generation and
the rest must be replaced as variants.