Google
 

Trailing-Edge - PDP-10 Archives - AP-4172F-BM - 3a-documentation/gal3-20.doc
There are 2 other files named gal3-20.doc in the archive. Click here to see a list.


GALAXY.DOC -- Changes from V2 to V3
September 1978






























COPYRIGHT (C) 1976,1977,1978 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
GAL3.DOC                                                        Page 2


GALAXY.DOC -- Changes from V2 to V3
September 1978



1.0  SUMMARY

GALAXY is the Batch and Spooling subsystem for  the  DECsystem-10  and
DECSYSTEM-20.   GALAXY comprises all the software (excluding operating
systems software) necessary to  do  batch  processing  and  input  and
output  spooling and all queue management and task scheduling required
for those functions.

GALAXY Release 3A consists of the following programs:

Program      Version     What it does
-------      -------     ------------

QUASAR          3      Central  queue  manager,  task  scheduler,  and
                       GALAXY system controller.

BATCON         103     Batch job processor.

LPTSPL         103     Lineprinter output spooler (unspooler).

SPRINT         103     Card reader input stacker/spooler.

QUENCH          3      Timesharing  users'  interface  to  the  GALAXY
                       system.

QMANGR         103     Interface module for FOROTS, BASIC, etc.

Release 3A has two primary goals:

     1.  Support  USAGE  file  accounting  for  printer   and   reader
         spooling.

     2.  Provide some hooks for the DN64 project.

In  addition  a  number  of  maintainance  edits  were  merged  in  to
development versions which resolved a number of problems.


1.1  Monitor Dependence

Release 3A of GALAXY will run under the following monitors:

     1.  TOPS20 Release 3A and later
GAL3.DOC                                                        Page 3


2.0  EXTERNAL CHANGES

There are two major external changes  in  Release  3A  of  the  GALAXY
system.   The  first  is  that the queue manipulation commands (PRINT,
SUBMIT etc.) are now  processed  by  the  EXEC.   This  provides  full
compatibility   with   the  TOPS20  command  language  as  well  as  a
significant improvement  in  response  time  for  these  commands.   A
complete  description  is  provided  in the EXEC DOC file.  The QUENCH
program is still being shipped with GALAXY primarily for compatibility
purposes.  The EXEC also has the

     @SET OLD-QUEUE-COMMANDS
     @SET NEW-QUEUE-COMMANDS

commands added.  Typing the first of the above commands will cause the
PRINT and SUBMIT commands to work as in previous versions.

The other major external change in Release 3A is the addition  of  the
/ACCOUNT switch on the $JOB card.  The format of this switch is:

                       /ACCOUNT:account-string

During $JOB card processing, SPRINT will  verify  the  user's  account
specification.   If  a  /ACCOUNT switch is not found on the $JOB card,
SPRINT  will  look  for  a   default   account   for   the   directory
PS:<user-name>.  If there is no default account for the directory, the
account under which SPRINT itself is running will be used.   The  last
option  is  included  in  order  to let installations phase into using
account strings.  Initially, the system administrator can cause SPRINT
to  be  logged-in  under  a  universally  allowed  account and after a
specific date cause SPRINT to be logged in under a universally illegal
account.

In all cases, SPRINT will verify the account string it decides to  use
(from   any   of  the  three  sources  described  above)  and  if  the
verification fails will produce the following error and abort the job:

     ?SPTIAS Illegal Account Specified

One additional implication of  this  change  to  SPRINT  is  that  the
specified  account  is  now passed on to BATCON and is used to log the
batch job in.
GAL3.DOC                                                        Page 4


3.0  KNOWN BUGS AND DEFICIENCIES

     1.  Any file created by SPRINT or  BATCON  is  created  with  the
         account  string  of  SPRINT  or  BATCON (e.g.  LOG files from
         BATCON, or $CREATE in SPRINT).

     2.  The message %Problem on device PCDR0:  is typed  on  the  CTY
         whenever the hopper goes empty on the card-reader.  It can be
         ignored.

     3.  There is no mechanism for putting parameters (e.g.   /COPIES)
         on spooled files.

     4.  If a batch job does a  "@OPERATOR  $"  (the  dollar  sign  is
         default)  and  the  batch  job  then  enables  itself (or was
         enabled already) then any time the EXEC prompts the job (i.e.
         with a $) the job is put into OPERATOR wait.

     5.  There are two problems which will causes a  job  to  get  the
         error message:

             ?SPTIDP Incorrect Directory or Password

         a)  If the previous job forgets a $EOJ card
         b)  If there is no space following the user name on the $JOB
             card

                                 NOTE

               There are a number of valid reasons  for
               receiving  this  message.   The two most
               common are a  misspelled  user  name  or
               password  and  specifying  a  files-only
               directory instead of a user name.

     6.  If a $JOB card contains a  /JOBNAME  switch  which  does  not
         include  a value (e.g.  $JOB user /JOBNAME) SPRINT will crash
         with the error message

             ?SPTCCC Can't create CTL or LOG File - File Not Found
             ?SPTCCC Can't create CTL or LOG File - File Not Found
             ?PA1050:  ERROR IN