Google
 

Trailing-Edge - PDP-10 Archives - bb-lw55a-bm - 7-documentation/sysjob.doc
There are 19 other files named sysjob.doc in the archive. Click here to see a list.


SYSJOB.DOC -- Changes from V4(10) to V5(10)
October 1981






























COPYRIGHT (C) 1976,1979,1982 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.
SYJ5.DOC                                                        Page 2


SYSJOB.DOC -- Changes from V4(10) to V5(10)
October 1981



1.0  SUMMARY

SYSJOB is a program for controlling system background programs.  It is
normally  started  only  by job 0, and it creates additional processes
and jobs as necessary.  An operator or other privileged job  may  pass
commands  to  SYSJOB  via an EXEC command (Ctrl-E) SPEAK to affect the
status of the background programs.

SYSJOB Version 5(10) runs on TOPS20 Release 5.

SYSJOB  does  not  require  any  other  software  modules  for  normal
execution.

SYSJOB is  documented  in  the  TOPS-20  Operator's  Guide  under  the
(Ctrl-E)SPEAK command.



2.0  EXTERNAL CHANGES

A new command, "DUMP" has been added to dump a fork's contents.



3.0  KNOWN BUGS AND DEFICIENCIES

None.



4.0  INSTALLATION INSTRUCTIONS

Mount the tape labeled  Installation  Tape  on  MTA0:   and  type  the
following commands:

     SKIP MTA0:5 FILES
     R DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600-BPI
     RESTORE <*>SYSJOB.EXE TO: <SYSTEM>*.*.-1
     REWIND
SYJ5.DOC                                                        Page 3


4.1  Files Needed to Run SYSJOB

The monitor expects to find SYSJOB.EXE in SYSTEM:  at startup.  SYSJOB
in  turn  expects  to  find the file SYSJOB.RUN in SYSTEM:.  This file
contains the initial set of commands to  start  the  usual  background
programs  and  the  operator  job.  If the monitor is started in debug
mode, (DBUGSW=2), SYSJOB  will  look  for  the  file  SYSJOB.DEBUG  in
SYSTEM:   instead  of  SYSJOB.RUN.   This allows a different (possibly
null) set of background programs to be started when debugging.   While
SYSJOB  is running it periodically looks for a file in SYSTEM:  called
SYSJOB.COMMANDS.  If such a file exists, SYSJOB executes the  commands
in the file and deletes the file.


4.2  Instructions for Loading and Installing SYSJOB

SYSJOB.EXE and SYSJOB.RUN are loaded into  SYSTEM:   as  part  of  the
normal  installation  and disk refresh procedure.  New versions may be
installed by copying the .EXE file to SYSTEM:.  The new  version  will
be  used  the  next  time  the monitor is started, or a command may be
given to SYSJOB to cause an immediate reload.


4.3  Files Needed to Build SYSJOB

SYSJOB is built from the following file:

     SYSJOB.MAC

In addition, the following files must be on SYS:

     MACSYM.UNV
     MONSYM.UNV


4.4  Instructions for Building SYSJOB

Mount the tape labeled  Distribution  Tape  on  MTA0:   and  type  the
following commands:

     R DUMPER
     TAPE MTA0:
     REWIND
     DENSITY 1600-BPI
     SKIP 1
     RESTORE <*>*.*.* (TO) <self>*.*.*
     REWIND
     ^C
     SUBMIT SYSJOB.CTL/TIME/UNIQ:0/REST
SYJ5.DOC                                                        Page 4


4.5  Special Considerations

SYSJOB must be available in SYSTEM:.  Copies in other directories  are
not required.  SYSJOB should not be started manually if the job 0 copy
is running normally, since this would  automatically  start  redundant
copies  of  the  background  programs  and conflicts would occur.  For
debugging purposes, an internal flag may be set which causes SYSJOB to
use  an  initial command file other than SYSJOB.RUN.  Consult a source
listing for details.

Commands may be given to SYSJOB during normal system operation by  use
of the (Ctrl-E)SPEAK command.  See the Operator's Guide for details.



5.0  INTERNAL CHANGES

Refer to SYSJOB.TCO for detailed information about changes.



6.0  SUGGESTIONS

None.



[End of SYJ5.DOC]