Google
 

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