Google
 

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>