VMS Help CMS, REPLACE, Qualifiers  *Conan The Librarian (sorry for the slow response - running on an old VAX)

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. /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.
    By default, a new generation is always created, regardless of the
    existence of any differences.

    CMS deletes the input file from the specified location after
    the new generation is created (unless you specify the /KEEP or
    /RESERVE qualifier).

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

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

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

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

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