HELPLIB.HLB  —  CMS  SHOW  RESERVATIONS
    Displays all current reservations and concurrent replacements in
    effect at the time the command is issued.

       Format:

          SHOW RESERVATIONS  [element-expression]

1  –  Command Parameters

 element-expression

    Specifies one or more elements for which CMS displays current
    reservation and concurrent replacement information. If you do
    not specify an element expression, information is displayed for
    all elements. An element expression can be an element name, a
    group name, a wildcard expression, or a list of these separated by
    commas.

2  –  Description

    The SHOW RESERVATIONS command provides information about current
    reservations and concurrent replacements. For each element that
    has one or more generations reserved, the output consists of the
    element name and the following:

    o  For each reservation--identification number, user, reserved
       generation number, date, time, and remark

    o  For each concurrent replacement--user, replaced generation
       number, date, time, and remark

    The elements are listed in alphabetical order.

3  –  Qualifiers

3.1    /APPEND

    Controls whether CMS appends the command output to an existing
    file, or creates a new file. If you specify /APPEND and the output
    file does not exist, CMS creates a new file. If you do not provide
    an output file specification (see the description for /OUTPUT),
    the output is appended to SYS$OUTPUT.

3.2    /BEFORE=date-time

    Lists current reservations that were executed prior to the
    specified time. The date value can be an absolute, delta, or
    combination time value, or one of the following keywords: TODAY,
    TOMORROW, or YESTERDAY. By default, CMS displays all existing
    reservations.

3.3    /CONCURRENT

    Lists only concurrent reservations and concurrent replacements.

3.4    /GENERATION[=generation-expression]

    Lists reservations for a specific generation or set of generations
    in a class.

3.5    /NOREPLACEMENTS

    Indicates that concurrent replacements are not to be displayed.

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.

3.7    /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file, except for any
    warning and error messages, which are written to SYS$OUTPUT and
    SYS$ERROR. CMS creates a new file if you do not specify /APPEND.
    If you omit the /OUTPUT qualifier (or if you specify /OUTPUT
    but do not provide a file specification), CMS directs output to
    the default output device (SYS$OUTPUT). If you omit either the
    file name or the file type component, CMS supplies the missing
    component from the default specification.

3.8    /SINCE=date-time

    Lists current reservations that were executed after the specified
    time. The time value can be an absolute, delta, or combination
    time value, or one of the following keywords: TODAY, TOMORROW, or
    YESTERDAY.

3.9    /USER=username

    Lists current reservations that were executed by the specified
    user. If you do not specify this qualifier, CMS lists reservations
    held by all users.

4  –  Example

    CMS> SHOW RESERVATIONS

    Reservations in CMS Library DISKX:[PROJECT.CMSLIB]

    AUDIT.FOR
        (2)    STEVEW     8      25-APR-1988 09:46:38 "add checks for
        file attributes"
      Concurrent replacements
               STEVEM     9      16-MAY-1988 16:01:30 "change %ascid
        & non-picrefs to pic"
    GETCMD.FOR
        (1)    STEVEM     15     17-MAY-1988 21:28:34 "fix access
        violation"
    INIT.FOR
        (1)    SMITH      13     15-MAY-1988 15:09:33 "context
        reference--add_field"
    LSTUTL.FOR
        (1)    STEVEM     5      17-MAY-1988 21:43:10 "bug fixes"

      This command lists the element name, the identification
      number of the reservation, the user who has it reserved, the
      generation number, and the date, time, and remark associated
      with the reservation for each element. In addition, CMS reports
      that the element AUDIT.FOR has been concurrently replaced,
      creating generation 9. As a result, user STEVEW must create a
      variant when he replaces the element.
Close Help