Trailing-Edge
-
PDP-10 Archives
-
BB-H311B-RM
-
rsx20f-swskit/documentation/building-rsx20f.mem
There are no other files named building-rsx20f.mem in the archive.
+---------------+
| d i g i t a l | I n t e r o f f i c e M e m o r a n d u m
+---------------+
Subj: RSX-20F Source Pack Documentation
Attached is a document that describes the contents of the RSX-20F
source pack for TOPS-20 release 4.0 and TOPS-10 release 7.00/7.01
that will be shipped to customers. For the most part the document
is applicable to past RSX-20F releases when dealing with the source
and command file areas. The .TSK/.OBJ, .MAP/.LST, and system areas
have changed since the last release in that the system dependent
generated files now reside on the individual system areas instead
of where they were generated. The source pack effectively has
three different system releases bundled into a single front end
release. The different system areas consist of:
1. TOPS-20/2040/2050/2060
2. TOPS-10/1090
3. TOPS-10/1091
This document is subject to change for future releases of RSX-20F.
RSX-20F SOURCE PACK
TOPS-20 Version 4.0
TOPS-10 Version 7.00/7.01
INTRODUCTION
The RSX-20F source pack contains all the files necessary to
assemble and build a RSX-20F executive and all available utility
tasks. In addition the pack has on it already built a complete
RSX-20F system with utility task images(TOPS-20/2040/2050/2060,
TOPS-10/1090, and TOPS-10/1091 in different areas). While the pack
as received does not have a bootable image and boot block it can be
easily converted to a bootable disk by using the applicable
supplied system.
The files on the source pack are divided into user file
directories(UFD). The user file directories are assigned in such a
way as to group together certain sources and their associated
files. The source pack contains system UFD's and task UFD's.
System UFD's contain RSX-20F system files such as completely built
systems, configuration parameter files, system libraries, and the
default system area. Task UFD's contain the sources, listings,
objects, maps, task images, and command files necessary to generate
a certain task.
--NOTE--
A RSX-20F source pack is a RP04/RP06 disk formatted in 18 bit mode
and containing a Files-11 ODS-1 file structure as defined by
RSX-11M/RSX-11D. As a result of the Files-11 file structure the
pack cannot be directly read by standard TOPS-10/TOPS-20 operating
system software, and as a result of the 18 bit format it cannot be
read by a standard RSX-11M/RSX-11D operating system because they
understand only 16 bit formatted packs. Therefore the pack can
only be read by a RSX-20F front end processor. Both
TOPS-10/TOPS-20 and RSX-11M/RSX-11D can be made to understand the
pack but this requires new or modified software.
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 2
TASK UFD'S
Task UFD's have the format [N,M] where N is the number
corresponding to a certain task group and M is the number
corresponding to a sub-group within the task group.
Currently defined N task groups are:
N CONTENTS
40 Files-11 Ancillary Control Processor(FCP)
41 System Library File Control Routines(FCS)
42 Librarian(LBR)
43 Peripheral Interchange Program(PIP)
PIP Utility Routines(UTL)
44 Task Builder(TKB)
45 Macro Assembler(MAC)
46 System Library Utility Routines(TKU)
47 Task Termination Notifier(TKT)
TKTN Utility Routines(RDT)
KL Transfer Program(KLX)
Terminal Set Speed Program(SET)
Device Redirect Program(RED)
Device Redirect Ignoring Protocals(REX)
50 KL Initialization Program(KLI)
51 Command Parser(PAR)
52 Virgin System Bootstrap(BOO)
System Save(SAV)
Disk To Disk Copy(COP)
53 Utility Routines(SUB)
TOPS-10/20 Ancillary Control Processor(T20)
Device Bad Block Locator(BAD)
Device File Structure Initializer(INI)
User File Directory Creator(UFD)
Mount Processor(MOU)
Dismount Processor(DMO)
54 KLINICK Ring Processor(KLR)
KLINICK Disconnect Processor(KLD)
Midnight Task(MID)
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 3
56 MOS Memory Boot(MBT)
57 KL Error Snapshot Program(KLE)
61 Source Language Input Program(SLP)
62 Task Image Patch Program(ZAP)
63 PIP With /UF Switch(PIX)
64 File Dump Utility(DMP)
65 File Structure Verification Program(VFY)
100 RSX-20F Executive(EXE)
Currently defined M sub-groups are:
M CONTENTS
10 object modules(*.OBJ), object libraries(xxxLIB.OLB)
- assembled task sources
task images(.TSK)
- built tasks
20 list files(*.LST)
- assembled task listings
map files(*.MAP)
- built task memory allocation maps
30 source files(*.MAC)
- task MACRO sources
40 command files(*.CMD)
- assembly command file(xxxASM.CMD)
- PIP concatonation command file(xxxPIP.CMD)
- library command file(xxxLBR.CMD)
- task build command file(xxxBLD.CMD)
- xxx is 3 letter task identifier
overlay descriptors(*.ODL)
- overlay description file(xxxBLD.ODL)
Exceptions:
1. Where there exists an .OLB file for a task there will not
be any .OBJ files for that task since they have been
inserted into the object library xxxLIB.OLB where xxx is
the 3 letter task identifier. The task groups affected
are:
[40,*]FCP
[41,*]FCS
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 4
[42,*]LBR
[43,*]UTL
[43,*]PIP
[44,*]TKB
[45,*]MAC
[50,*]KLI
[51,*]PAR
[61,*]SLP
[62,*]ZAP
[63,*]PIX
[64,*]DMP
[65,*]VFY
[100,*]EXE
2. In some cases .OBJ/.OLB and .LST files will not exist
because they contain system dependent assembly parameters.
These files can be found on the individual system areas.
The files affected are:
[47,10]TKTN.OBJ,[47,20]TKTN.LST
[54,10]KLRING.OBJ,[54,20]KLRING.LST
[50,10]KLILIB.OLB,[50,20]*.LST
[100,10]EXELIB.OLB,[100,20]*.LST
3. In some cases .TSK and .MAP files will not exist because
they are priviledged tasks and their task build is
dependent on the executive symbol table. These files can
be found on the system areas. The files affected are:
[40,10]F11ACP.TSK,[40,20]F11ACP.MAP
[47,10]KLXFER.TSK,[47,20]KLXFR.MAP
[47,10]SETSPD.TSK,[47,20]SETSPD.MAP
[47,10]RED.TSK,[47,20]RED.MAP
[47,10]REX.TSK,[47,20]REX.MAP
[51,10]PARSER.TSK,[51,20]PARSER.MAP
[52,10]BOO.TSK,[52,20]BOOT.MAP
[53,10]BAD.TSK,[53,20]BAD.MAP
[53,10]INI.TSK,[53,20]INIT.MAP
[53,10]UFD.TSK,[53,20]UFD.MAP
[53,10]DMO.TSK,[53,20]DMO.MAP
[53,10]MOU.TSK,[53,20]MOU.MAP
[53,10]T20ACP.TSK,[53,20]T20ACP.MAP
[54,10]KLDISC.TSK,[54,20]KLDISC.MAP
[54,10]MIDNIT.TSK,[54,20]MIDNIT.MAP
[57,10]KLE.TSK,[57,20]KLERR.MAP
4. The executive task image does not have the extension .TSK
but .SYS.
5. Some tasks have no .TSK or .MAP files because they are
utility routines that are linked into other tasks. These
same tasks will not have a xxxBLD.CMD command file. The
affected task groups are:
[41,*]FCS
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 5
[43,*]UTL
[46,*]TKU
[47,*]RDT
[53,*]SUB
[56,*]MBT
6. Not all tasks have their .OBJ files concatonated and put
into object libraries so these tasks will not have
xxxPIP.CMD and xxxLBR.CMD command files. The affected
tasks are:
[47,*]RDT
[47,*]TKT
[47,*]KLX
[47,*]SET
[47,*]RED
[47,*]REX
[52,*]BOO
[52,*]COP
[52,*]SAV
[53,*]SUB
[53,*]T20
[53,*]BAD
[53,*]INI
[53,*]MOU
[53,*]DMO
[53,*]UFD
[54,*]KLR
[54,*]KLD
[54,*]MID
[57,*]KLE
7. The DMO task does not have a DMOASM.CMD command file
because it is built from the MOU task with a different
name.
8. The assembled TKU objects are concatonated with the
assembled FCS objects to form SYSLIB.OLB.
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 6
SYSTEM UFD'S
System UFD's contain global information that is used by all tasks,
either during assembly, task build, or while running. Currently
defined [N,M] system UFD's are:
N M CONTENTS
1 1 RSXMAC.SML
- default macro library
SYSLIB.OLB
- default routine library
5 5 RSX-20F default task area
SYSTEM.DIR
- sorted source pack directory
10 5 TOPS-10/1090 pre-built system
- task images
- system dependent files
15 5 TOPS-10/1091 pre-built system
- task images
- system dependent files
20 5 TOPS-20/2040/2050/2060 pre-built system
- task images
- system dependent files
20 30 System configuration files
20 40 System generation command files
30 10 RSXMAC.SML
- RSX-20F macro library
30 20 RSX-20F macro library listing
30 30 RSX-20F macro library sources
30 40 RSX-20F macro library command file
The pre-built system areas are UFD's which contain all the
necessary task images to install a RSX-20F system. The three
pre-built systems are:
1. [10,5]TOPS-10/1090
2. [15,5]TOPS-10/1091
3. [20,5]TOPS-20/2040/2050/2060
These areas also contain system dependent object files, object
libraries, listings, maps, and configuration files. Monolithic
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 7
listings of the executive and KLINIT with cross references are
included. The exact contents of the pre-built system areas are:
1. MOS memory timer
- *.A11
2. System symbol table
- EXEC.STB
3. RSX-20F system
- RSX20F.SYS
- RSX20F.MAP
4. Configuration files
- RSXFC.MAC
- EXEBLD.CMD
5. System dependent list files
- TKTN.LST
- KLRING.LST
6. System dependent object files/libraries
- TKTN.OBJ
- KLRING.OBJ
- KLILIB.OLB
- EXELIB.OLB
7. System dependent tasks/map
- TKTN.TSK,TKTN.MAP
- KLRING.TSK,KLRING.MAP
- KLI.TSK,KLINIT.MAP
8. Priviledged system tasks/maps
- F11ACP.TSK,F11ACP.MAP
- KLXFER.TSK,KLXFR.MAP
- SETSPD.TSK,SETSPD.MAP
- RED.TSK,RED.MAP
- REX.TSK,REX.MAP
- PARSER.TSK,PARSER.MAP
- BOO.TSK,BOOT.MAP
- SAV.TSK,SAVE.MAP
- T20ACP.TSK,T20ACP.MAP
- BAD.TSK,BAD.MAP
- INI.TSK,INIT.MAP
- UFD.TSK,UFD.MAP
- MOU.TSK,MOUNT.MAP
- DMO.TSK,DMOUNT.MAP
- KLDISC.TSK,KLDISC.MAP
- MIDNIT.TSK,MIDNIT.MAP
- KLE.TSK,KLERR.MAP
9. Non-priviledged tasks/maps
- LBR.TSK,LBR.MAP
- PIP.TSK,PIP.MAP
- TKB.TSK,TKB.MAP
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 8
- MAC.TSK,MAC.MAP
- COP.TSK,COPY.MAP
- SLP.TSK,SLP.MAP
- ZAP.TSK,ZAP.MAP
- PIX.TSK,PIX.MAP
- DMP.TSK,DMP.MAP
- VFY.TSK,VFY.MAP
10. Monolitic listings
- [10,5]RSXTOPS10.LST
- [15,5]RSXT1091.LST
- [20,5]RSXTOPS20.LST
- KLIMON.LST
RSX-20F SOURCE PACK FOR TOPS-20/4.0 AND TOPS-10/7.00/7.01 Page 9
CONCLUSION
In an attempt to make RSX-20F easier to use future documents are
planned. These documents include:
1. Command file documentation
2. Creating a bootable pack from source pack
3. RSX-20F system generation