Copyright Digital Equipment Corp. All rights reserved.

Qualifiers

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

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

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

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

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

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

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

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

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

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

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