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.