Trailing-Edge
-
PDP-10 Archives
-
cuspbinsrc_1of2_bb-x128c-sb
-
10,7/galaxy/catlog/catlog.rnh
There are no other files named catlog.rnh in the archive.
.FILL
.JUSTIFY
.NOPAGING
.PAGE SIZE 55,72
.LEFT MARGIN 0
.TAB STOPS 8,16,24,32,40,48,56,64,72
.CENTER
.;COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1988. ALL RIGHTS RESERVED.
Operator interface program help file
.CENTER
for the
.CENTER
DECsystem-10 Mountable Device Catalog Daemon
.SKIP 1
The Mountable Device Catalog daemon, the CATLOG program, is an
integral part the the GALAXY/MDA system. It's purpose is to
maintain the system catalog files and provide QUASAR and the
operator with information pertaining to the volume-sets stored
in those files. The operator interface to the catalog daemon
is the CATALOG application in the OPR program. Help for a specific
command may be obtained by typing the following to the CATALOG
prompt:
.SKIP 1
.CENTER
CATALOG>HELP command-name
.SKIP 1
For instance, if you wish additional information about the SHOW
command you would type "HELP SHOW".
.SKIP 2
_*DELETE
.BREAK
The DELETE command will remove the specified volume-set from a
catalog. Due to the destructive nature of this command, the
target volume-set name must be specified in full. That is,
unique abbreviations are not allowed. Attempts to provide such
a volume-set name will result in an error message being displayed
on the terminal. This command takes no options. Its only arguments
are the catalog type (DECtape, magtape, or structure) and the
volume-set name to be deleted from the catalog.
.LITERAL
Command syntax:
-- DECTAPE --
/ \
CATALOG>DELETE ---- MAGTAPE ---- volume-set-name
\ /
- STRUCTURE -
.END LITERAL
.LITERAL
Example:
CATALOG>DELETE STRUCTURE DSKD
CATALOG>
9:24:27 -- Structure DSKD deleted --
CATALOG>
.END LITERAL
.SKIP 2
_*DISABLE
.BREAK
The DISABLE command is one of two commands that control automatic
catalog updates. When discrepancies between mounted media and cataloged
information arise, QUASAR may elect to update the catalog. The DISABLE
command turns on this feature.
.LITERAL
Command syntax:
-- DECTAPE
/
DISABLE ---- MAGTAPE
\
- STRUCTURE
Example:
CATALOG>DISABLE STRUCTURE (catalog updates by MDA)
CATALOG>
9:24:27 -- Structure catalog updates disabled --
CATALOG>
.END LITERAL
.SKIP 2
_*ENABLE
.BREAK
The ENABLE command is one of two commands that control automatic
catalog updates. When discrepancies between mounted media and cataloged
information arise, QUASAR may elect to update the catalog. The ENABLE
command turns on this feature.
.LITERAL
Command syntax:
-- DECTAPE
/
ENABLE ---- MAGTAPE
\
- STRUCTURE
Example:
CATALOG>ENABLE STRUCTURE (catalog updates by MDA)
CATALOG>
9:24:27 -- Structure catalog updates enabled --
CATALOG>
.END LITERAL
.SKIP 2
_*HELP
.BREAK
The HELP command will display the description, syntax, and one or more
examples of any command available for use in managing the catalog files.
.LITERAL
Command syntax:
HELP command-name
Example:
CATALOG>HELP (with) SHOW
The SHOW command causes information about ...
.END LITERAL
.SKIP 2
_*INSERT
.BREAK
The INSERT command provides the means for an operator to create volume-sets,
entering owner and media storage location data, as well as volume specific
data if applicable.
.LITERAL
Command syntax:
-- DECTAPE --
/ \
INSERT ---- MAGTAPE ---- new-volume-set /switch1 /switch2
\ /
- STRUCTURE -
sub-command1
sub-command2
.
.
.
.END LITERAL
In the above syntax description, "new-volume-set" must not already
exist in the specified catalog. Attempts to insert an already existing
volume-set into a catalog will cause an error message to be displayed
on the terminal. Optionally, "new-volume-set" may be replaced by:
.SKIP 1
.CENTER
new-volume-set = old-volume-set
.SKIP 1
Doing this causes new volume-set to be created using the parameters
from the existing "old-volume-set".
.SKIP 1
The switches are:
.LEFT MARGIN 16
.SKIP 1
.INDENT -10
/DENSITY:keyword
.BREAK
Sets tape density. Keywords are: 200, 556, 800, 1600, and 6250. A
density switch must be given. /DENSITY is only valid for magtape
volume-sets and is always required.
.SKIP 1
.INDENT -10
/EXPIRATION:date
.BREAK
Sets the expiration date. This is useful for sites that maintain
media libraries and wish to control on a timely basis, the DECtapes,
magtapes, and structures stored in that library. An expired catalog
date does not prohibit access to a given volume-set, either by the
operator or a user. It merely provides an indication when a volume-set
will be removed from the library. Failure to include /EXPIRATION will
result in a volume-set with no expiration date set. /EXPIRATION is an
optional switch.
.SKIP 1
.INDENT -10
/LOCATION:text
.BREAK
"text" specifies a string describing the storage location of the
volume-set. It may be up to 19 characters in length containing
8-bit ASCII data. The string must be quoted if it is to contain
any characters besides A-Z, a-Z, or -. /LOCATION is an optional
switch.
.SKIP 1
.INDENT -10
/NAME:text
.BREAK
Sets the name associated with the volume-set. It may be up to 39
characters in length containing 8-bit ASCII data. This name does
not have to be the same as the name associated with the PPN in
ACCT.SYS, the system accounting file. The name must be quoted if
it is to contain any characters outside the range of A-Z, a-z, or -.
/NAME is an optional switch.
.SKIP 1
.INDENT -10
/TRACKS:keyword
.BREAK
Sets the number of tracks. Keywords are 7 or 9. If a density of
1600 or 6250 BPI was specified, then 9 tracks are assumed. No
assumption is made for densities of 200, 556, or 800 BPI as 7 or 9
tracks can apply in these cases. /TRACKS is only valid for magtape
volume-sets and is only required if the track type cannot be determined
from the specified density.
.SKIP 1
.INDENT -10
/USER:[project_#,programmer_#]
.BREAK
Sets the owner PPN of the volume-set. A wildcarded PPN may be used
as long as it conforms to the definition of an owner PPN in the
TOPS-10 monitor. Optionally, the project number, programmer number,
or both may be wild. For example [10,*], [*,56] are valid but [1?,56]
or [10,5?] are not. /USER is an optional switch.
.LEFT MARGIN 6
.SKIP 1
Sub-commands control the addition or removal of volumes in a volume-set.
There are four sub-commands available:
.LEFT MARGIN 16
.SKIP 1
.INDENT -10
ADD
.BREAK
The ADD sub-command is used to append volumes to a volume-set. Depending
on the catalog type, the arguments to the sub-command vary. The syntax
for magtapes is:
.SKIP 1
.CENTER
ADD reelid
.SKIP 1
and the structure syntax is:
.SKIP 1
.CENTER
ADD unit-id drive-type class
.SKIP 1
.INDENT -10
DONE
.BREAK
This indicates the insertion is complete. The DONE sub-command takes
no arguments.
.SKIP 1
.INDENT -10
QUIT
.BREAK
QUIT may be given any time the operator decides not to complete the
INSERT command.
.SKIP 1
.INDENT -10
REMOVE
.BREAK
This sub-command causes an existing volume in a volume-set to be
removed from the catalog. During an insertion, if the operator
accidentally enters some wrong data on an ADD command, the volume
in question may be taken back out of the volume-set using REMOVE.
REMOVE takes no arguments.
.LEFT MARGIN 0
.LITERAL
Example:
CATALOG>INSERT STRUCTURE DSKD/LOCATION:1026/NAME:DPM/USER:[10,56]
ADD (unit) DSKD0 (type) RP06 (class) 1
ADD (unit) DSKD1 (type) RP06 (class) 1
DONE
CATALOG>
9:24:27 -- Structure DSKD inserted --
.END LITERAL
.SKIP 2
_*LIST
.BREAK
The LIST command will generate a text file containing all volume-sets
in a catalog file. Its only arguments are the catalog type (DECtape,
magtape, or structure) and the optional listing filespec. The filespec
is a standard TOPS-10 filespec of the form:
.SKIP 1
.CENTER
dev:file.ext[path]
.SKIP 1
where:
.SKIP 1
dev defaults to DSK
.BREAK
file defaults to the catalog file name
.BREAK
ext defaults to LST
.BREAK
path defaults to the current path
.BREAK
.LITERAL
Command syntax:
-- DECTAPE --
/ \
LIST ---- MAGTAPE ---- listing-filespec
\ /
- STRUCTURE -
Example:
CATALOG>LIST STRUCTURE (entries)
CATALOG>
9:24:27 -- Structures listed to file DSKB:STRLST.LST[1,2] --
CATALOG>
.END LITERAL
.SKIP 2
_*MODIFY
.BREAK
The MODIFY command allows an operator to change the volume-set attributes
and volume specific information for an already existing catalog entry.
Due to the destructive nature of this command, the target volume-set name
must be specified in full. That is, unique abbreviations are not allowed.
Attempts to provide such a volume-set name will result in an error message
being displayed on the terminal. The command syntax is:
.LITERAL
Command syntax:
-- DECTAPE --
/ \
MODIFY ---- MAGTAPE ---- volume-set /switch1 /switch2
\ /
- STRUCTURE -
sub-command1
sub-command2
.
.
.
.END LITERAL
The syntax is nearly identical to the INSERT command. Refer to
the description of the INSERT command for details on the MODIFY
command.
.SKIP 2
_*SHOW
.BREAK
The SHOW command causes information about a specific volume-set
to be displayed on the terminal. Unique abbreviations for a
volume-set name are allowed. This command takes no options.
Its only arguments are the catalog type (DECtape, magtape, or
structure) and the volume-set name to be displayed on the terminal.
.LITERAL
Command syntax:
-- DECTAPE --
/ \
SHOW ---- MAGTAPE ---- volume-set
\ /
- STRUCTURE -
Example:
CATALOG>SHOW STRUCTURE DSKD
CATALOG>
9:24:27 -- Structure catalog --
Structure DSKD
Owned by [10,56] DPM
Location: DPM's office
Unit Type Class
------ ------ ------
DSKD0 RP06 1
DSKD1 RP04 1
DSKD2 RP06 1
CATALOG>
.END LITERAL