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

    Cancels one or more reservations of a generation of an element.

       Format:

          UNRESERVE  element-expression "remark"

1 - Command Parameters

 element-expression

    Specifies one or more elements whose reservations are to be
    canceled. 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.

2 - Description

    The UNRESERVE command cancels an existing reservation of a
    generation of an element. You cannot unreserve a generation held
    by another user unless you hold BYPASS privilege or unless you are
    granted BYPASS access to the element by an access control entry.

    If you have more than one reservation of an element, or if
    you are replacing a concurrent reservation made by another user,
    (that is, if there is any ambiguity), you must specify the exact
    reservation to be canceled.  You do this by using either the
    /GENERATION qualifier or the /IDENTIFICATON_NUMBER qualifier.

    You can use /GENERATION as long as the concurrent reservations are
    not on the same generation. If you have more than one concurrent
    reservation for the same generation, you must identify the
    specific reservation to be canceled. Each reservation is assigned
    an identification number. 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 you use the /IDENTIFICATION_NUMBER qualifier, you
    do not need to also use the /GENERATION qualifier; when both are
    used, CMS ignores the /GENERATION qualifier.

3 - Qualifiers

 3.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 unreserve a concurrent reservation or when you
    cancel another user's reservation.

 3.2 - /DELETE[=file-specification]

    Controls whether all versions of the unreserved file are deleted.
    If you omit /DELETE, the files are not deleted. If you specify
    /DELETE without a file specification, all versions of the
    unreserved files are deleted from your current directory. The
    file specification allows you to specify a different location and
    the name of the file to be deleted.

 3.3 - /GENERATION=generation-expression

    Specifies which reserved generation of the element is to be
    unreserved. If you have more than one reservation of the same
    element generation, you must use the /IDENTIFICATION_NUMBER
    qualifier to unreserve the reservation.

 3.4 - /IDENTIFICATION_NUMBER=n

    Specifies which reservation is to be unreserved. 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.

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

 3.6 - /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 - Examples

    (1) CMS> UNRESERVE FILEIO.BLI
        _Remark: problem elsewhere
        %CMS-S-UNRESERVED, element DISKX:[PROJECT.CMSLIB]FILEIO.BLI
        unreserved

      This command cancels the existing reservation of the element
      FILEIO.BLI.

    (2) $ SET PROCESS/PRIVILEGE=BYPASS
        $ CMS UNRESERVE SAMPLE.TXT "unreserving on behalf of SMITH"
        Element A.TXT currently reserved by:
            (1)   SMITH     1      17-FEB-1988 13:43:52 "sample module
            for program"
        Unreserve (1) SAMPLE.TXT generation 1, held by SMITH? [Y/N] (N): Y
        %CMS-S-UNRESERVED, element DISKX:[SMITH.WORK.CMSLIB]SAMPLE.TXT
        unreserved

      This example shows the cancellation of another user's existing
      reservation (through the use of BYPASS privilege) of the latest
      generation of the element SAMPLE.TXT.  If concurrent reservations
      of element SAMPLE.TXT existed, you would need to specify the exact
      reservation to be canceled by using either the /GENERATION or
      /IDENTIFICATION qualifier.