Trailing-Edge
-
PDP-10 Archives
-
BB-F493Z-DD_1986
-
10,7/initia.mem
There are 3 other files named initia.mem in the archive. Click here to see a list.
INITIA -- SYSTEM INITIALIZATION CUSP
DETAILED DESIGN SPECIFICATION
100-310-039-00
Author: Peter Conklin
Date: 16 August, 1985
File: INITIA.RNO%001
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE.
COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1970,1986.
ALL RIGHTS RESERVED.
INITIA SPECIFICATION 13-OCT-70 100-310-039-00 Page 2
OVERVIEW
1. OVERVIEW
1.1 FUNCTION: INITIA is a CUSP to perform
certain standard job initialization functions when the
PDP-10 monitor is restarted. It may also be invoked by a
monitor command if a terminal needs to be reinitialized.
1.2 RELATION TO OTHER CUSPS: There is no direct
relationship with other CUSPs, however, INITIA calls
other CUSPs to start them for normal operation.
1.3 DESIGN GOALS
1.3.1 To simplify the operator's job of starting up
the system, jobs which are always to be run should be
started automatically.
1.3.2 To initialize certain devices automatically.
For example, TAB stops should be set on the TERMINET-300.
1.4 REFERENCES SCNSER, Functional
Specification (100-150-012-03).
2. GENERAL DESCRIPTION
INITIA is tailored to each installation. Each time
the system is started, INITIA is run automatically on
certain TTYs (as determined by a bit in LINTAB). At
any time later, INITIA may be run on any TTY by
simply typing the monitor command "INITIA".
When INITIA runs, it determines the TTY name and the
APR serial number where it is being run and performs
automatic initialization if needed. This
initialization can include setting up TTY hardware and
running a CUSP. If no CUSP is run, a startup message is
typed out.
3. GLOSSARY
APR serial number -- the DEC assigned serial number of the
PDP-10 arithmetic processor.
TTY -- a physical console. This might be a teletype
or teletype-like device.
TTY name -- the monitor assigned name of the TTY
(eg, CTY or TTY21).
4. COMMAND
4.1 ASTERISK FORMAT: None
INITIA SPECIFICATION 13-OCT-70 100-310-039-00 Page 3
COMMAND
4.2 MONITOR COMMAND FORMAT: There are no
parameters. The only monitor command is ".INITIA". This
may be typed at any time, but destroys the current core
image. First, TTY setup is performed. If the job
is not logged in, or is logged into the correct number, the
proper CUSP is run (logged in if appropriate).
4.3 CCL ENTRY POINT: None
4.4 ALTERNATE ENTRIES: None
4.5 DIALOGUE MODE: None
4.6 HELP: None
5. ASSOCIATED (TTY) MESSAGES
5.1 If the system fails, the message "?Bomb Out"
is issued. The location in INITIA is displayed in
the lights.
5.2 If a CUSP is run, the name is typed to
indicate to the operator what has been done, For
example, if the print package is started,
.R PRINTR
is typed.
5.3 If no CUSP is started, the system startup
message is typed consisting of the system header, the
time of day, and the teletype name. For example,
5S0112C 12:43:26 CTY
6. LISTABLE OUTPUT
None
7. FILE FORMATS
None
8. ENVIRONMENTAL EFFECTS
8.1 The behavior is a function of which teletype
the job is started on. Each installation can tailor
INITIA for its own configuration since INITIA checks
the APR serial number as well as the TTY name in order to
determine its processing. The possible actions are:
INITIA SPECIFICATION 13-OCT-70 100-310-039-00 Page 4
ENVIRONMENTAL EFFECTS
8.1.1 TTY setup:
An optional sequence is provided to
initialize the tabs on a GE TERMINET-300. This
sequence sets carriage return as physical position
4 and tabs at 12, 20, 28, 36, 44, 52, 60, and
68. This allows room for hole punches.
8.1.2 Job setup.
Optionally, one of the following may be
started at each TTY. Additional CUSPS can
easily be added.
PRINTR under [1,2] the print spooler.
CHKPNT under [1,2] to take accounting checkpoints.
OMOUNT under [1,2] to process Mount and File
requests.
FILEX under [1,4] to save crashes (not
recommended).
SYSDPY not logged in to display status on
Datapoint 3300.
8.1.3 Default startup table. If the APR
serial number is not recognized, the following is started:
TTY1 PRINTER under [1,2]
TTY2 OMOUNT under [1,2]
9. CORE LAYOUT
9.1 INITIA is a one segment, non-sharable CUSP since it
should not occupy swapping or table space after its
use. It is coded with a pure section of code and tables
followed by a short impure area. INITIA is 1K.
9.2. INITIA is table driven. First, INITIA
checks the APR serial number against a table (APRTAB).
This gives an index into a list of TTY names and
operations (APRTBV). Each APR has two tables, a list
of TTY names (TTn where n is the serial number), and
Operations (JJn). The operations table gives the
address of an ASCIZ string to be sent to the TTY in image
mode (0 if none), and the address of a routine for
special job processing (0 if none). These tables are
all generated by macros.
10. GENERAL FLOW
[INITIA] Initialize, determine if job logged in,
find APR serial number and TTY name. If special TTY
setup, send it. If special job setup required, go to
specific routine. If none, [KJOB] send signon message
and exit.
[FILEX] log in as [1,4] set DSKB: as search list
and run FILEX.
INITIA SPECIFICATION 13-OCT-70 100-310-039-00 Page 5
GENERAL FLOW
[OMOUNT], [CHKPNT], [PRINTR] log in as [1,2] and run
cusp.
[SYSDPY] run SYSDPY.
11. CRITICAL ALGORITHMS.
None
12. MAINTENANCE AIDS
If INITIA detects a monitor error, it types "?Bomb Out"
and displays the relative location within INITIA in the
console lights.
13. CODING TECHNIQUES
INITIA is coded in MACRO-10 following the 5-series
monitor editting conventions. Most scratch storage is in
the ACs.
14. ASSEMBLY CONSIDERATIONS
14.1 INITIA.MAC should be edited for your
configuration. Two additions are needed. First, add your
APR's serial number to the list in the macro APR (page 4).
Second, add a macro (page 5) SPnn (nn=serial number). Each
line of the macro is Y, space, TTY name, comma, special
processor, comma, TTY setup string, carriage return.
14.2 To load, type
.LOAD INITIA
then to save
.SAVE DSK:INITIA
14.3 Place the file INITIA.SAV on SYS.
14.4 Include the INITIA bit in LINTAB in the
monitor for all TTYs which are to be started.