Trailing-Edge
-
PDP-10 Archives
-
BB-F493Z-DD_1986
-
10,7/catlog.hlp
There are 4 other files named catlog.hlp in the archive. Click here to see a list.
Operator interface program help file
for the
DECsystem-10 Mountable Device Catalog Daemon
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:
CATALOG>HELP command-name
For instance, if you wish additional information about the SHOW command
you would type "HELP SHOW".
*DELETE
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.
Command syntax:
-- DECTAPE --
/ \
CATALOG>DELETE ---- MAGTAPE ---- volume-set-name
\ /
- STRUCTURE -
Example:
CATALOG>DELETE STRUCTURE DSKD
CATALOG>
9:24:27 -- Structure DSKD deleted --
CATALOG>
*DISABLE
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.
Command syntax:
-- DECTAPE
/
DISABLE ---- MAGTAPE
\
- STRUCTURE
Example:
CATALOG>DISABLE STRUCTURE (catalog updates by MDA)
CATALOG>
9:24:27 -- Structure catalog updates disabled --
CATALOG>
*ENABLE
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.
Command syntax:
-- DECTAPE
/
ENABLE ---- MAGTAPE
\
- STRUCTURE
Example:
CATALOG>ENABLE STRUCTURE (catalog updates by MDA)
CATALOG>
9:24:27 -- Structure catalog updates enabled --
CATALOG>
*HELP
The HELP command will display the description, syntax, and one or more
examples of any command available for use in managing the catalog files.
Command syntax:
HELP command-name
Example:
CATALOG>HELP (with) SHOW
The SHOW command causes information about ...
*INSERT
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.
Command syntax:
-- DECTAPE --
/ \
INSERT ---- MAGTAPE ---- new-volume-set /switch1 /switch2
\ /
- STRUCTURE -
sub-command1
sub-command2
.
.
.
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:
new-volume-set = old-volume-set
Doing this causes new volume-set to be created using the parameters from
the existing "old-volume-set".
The switches are:
/DENSITY:keyword
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.
/EXPIRATION:date
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.
/LOCATION:text
"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.
/NAME:text
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.
/TRACKS:keyword
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.
/USER:[project#,programmer#]
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.
Sub-commands control the addition or removal of volumes in a
volume-set. There are four sub-commands available:
ADD
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:
ADD reelid
and the structure syntax is:
ADD unit-id drive-type class
DONE
This indicates the insertion is complete. The DONE
sub-command takes no arguments.
QUIT
QUIT may be given any time the operator decides not to
complete the INSERT command.
REMOVE
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.
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 --
*LIST
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:
dev:file.ext[path]
where:
dev defaults to DSK
file defaults to the catalog file name
ext defaults to LST
path defaults to the current path
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>
*MODIFY
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:
Command syntax:
-- DECTAPE --
/ \
MODIFY ---- MAGTAPE ---- volume-set /switch1 /switch2
\ /
- STRUCTURE -
sub-command1
sub-command2
.
.
.
The syntax is nearly identical to the INSERT command. Refer to the
description of the INSERT command for details on the MODIFY command.
*SHOW
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.
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>