HELPLIB.HLB  —  CMS  SHOW  ARCHIVE
    Displays information about one or more archive files.

       Format:

          SHOW ARCHIVE  file-expression

1  –  Command Parameters

 file-expression

    Specifies the name of the archive file. The file expression can be
    a file-name.type specification, a wildcard expression, or a list
    of these separated by commas.

2  –  Description

    The SHOW ARCHIVE command displays information about the contents
    of one or more specified archive files.

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

    The /BRIEF qualifier displays the name of the element, the
    generations archived into this file, the name of the person
    who archived the file, the date and time, the remark entered on
    the DELETE GENERATION command, and the name of the library in
    which the original element resided.

3.3    /FULL

    The /FULL qualifier displays complete generation file information
    for each archived generation.

3.4    /INTERMEDIATE

    The /INTERMEDIATE qualifier displays the generation history for
    the archived generations.

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

4  –  Examples

    (1) CMS> SHOW ARCHIVE/BRIEF SAMPLE.CMS_ARCHIVE

        25-JAN-1988 17:08:47 JONES DISKX:[WORK.CMSLIB]
        SAMPLE.PAS(2A1--2A3) "delete the variant range and archive
        the deleted generations"

      This command displays information about the archive file,
      consisting of the date and time entered with the DELETE
      GENERATION command, the name of the person who archived the
      file, the library in which the original element resided, the
      generations that were archived into the file, and the remark
      entered on the DELETE GENERATION command.

    (2) CMS> SHOW ARCHIVE/FULL SAMPLE.CMS_ARCHIVE

        25-JAN-1988 17:08:47 JONES DISKX:[WORK.CMSLIB] SAMPLE.PAS(2A1--2A3)
        "delete the variant range and archive the deleted generations"
            2A1    22-JAN-1988 14:27:41 JONES "reserved concurrently
                   to add routines"
                File creation:      22-JAN-1988 14:27
                File revision:      24-JAN-1988 17:12 (1)
                Record format:      Variable length
                Record attributes:  Carriage return carriage control
                Review status:      None

            2A2    22-JAN-1988 14:36:56 JONES "another routine added"
                File creation:      22-JAN-1988 14:36
                File revision:      22-JAN-1988 18:01 (1)
                Record format:      Variable length
                Record attributes:  Carriage return carriage control
                Review status:      None

            2A3    22-JAN-1988 14:45:12 JONES "last one I promise"
                File creation:      22-JAN-1988 14:45
                File revision:      27-JAN-1988 08:30 (1)
                Record format:      Variable length
                Record attributes:  Carriage return carriage control
                Review status:      None

      This command displays complete generation file information for
      each archived generation in the archive file.
Close Help