TRS-80 LS-DOS 6.3.1 Level L source files with French and German keyboard drivers, dates support up to 2079
This repository contains the source files to build a working version of LS-DOS 6.3.1 Level L.
The original source files come from the archive Source code for LS-DOS 6.3.1H (19xx)(-)[DSK]
and were made available by Peter W. Cervasio. Here is the text of the HowTo.txt notice included in the archive:
LS-DOS 6.3.1 Source Code
========================
Copyright 1982-1984, 1986, 1990 by MISOSYS, Inc.
The permission statement from Tim Mann's web page says the following
about the MISOSYS software available for download:
=====================================================================
Roy Soltoff holds the copyright to the software and documentation in
the list below; notices that name other authors are outdated. Roy
grants free permission to everyone to download and use this software
and documentation and to redistribute it to others, provided this
notice is retained. All other rights are reserved.
=====================================================================
Typed in (and enhanced) by Pete Cervasio (cervasio@airmail.net)
Changes are copyright 1997-98 Peter W. Cervasio.
Permission to do whatever you want with my changes is granted, as long
as my copyright notice is left intact.
[Minor edits to this file made 1-12-98 by Tim Mann.]
Introduction stuff
==================
The files in this package are the complete source code to the LS-DOS
version 6.3.1 operating system for the TRS-80 Model 4. I started by
typing in the source listings from "The Source". I wound up moving
to LS-DOS 6.3.1 in the middle of the first part of the SYSx/ASM set of
files. I also realized that I should be using MISOSYS' PRO-DUCE to
generate the opcodes, and then massaging the resulting /ASM files until
they have meaningful labels and comments. For the most part, the
comments from "The Source", volumes 1 through 3, are what you will see,
except I may have changed the wording somewhat. When I was doing this
I had NO idea that it would wind up on Tim Mann's web page with the
rest of the MISOSYS software. Because of that, I was not strict in
my typing of the comments, and didn't make sure that every single
line had the exact same wording as "The Source". Where there are
major changes in version 6.3.x, as compared to what was listed for
version 6.2, I have tried to comment the code as well as I can figure
it out.
There may be a few places where a piece of code says isn't commented
and a similar piece somewhere else is fully documented. That's
probably because I decided to actually figure it out later and didn't
update the comments in all locations. Some places have the 6.3.1
sections marked with ";---> 6.3.1 change" and ";<--- 6.3.1 change".
These flag the start and end of code that's different from the code
listed in "The Source". Not every change has this flag, though.
Several files have much more commenting than the original listing had.
This is especially true of the SYSINFO sector in SYSRES/ASM where I
have documented how backup-limited diskettes work. This was done
for informational purposes only, by the way.
In addition, I have included the new logo which I use on my own system.
If you look in SYSRES/ASM and change the equate as documented there,
you can try out my changes. They don't adversely affect the operation
of the system in any way, as far as I have been able to tell. It just
makes the bootup look a little nicer. Some may have flashbacks to the
boot screen of DOSPLUS, but that's their problem.
But wait, there's more! As an extra added bonus for downloading now,
I have included the /JCL files I used to reassemble the operating
system under Jeff Vavasour's wonderful Model 4 emulator (which is
available from Computer News 80). These JCL files can route the
assembler's listing to /PRN files and then export them to MSDOS as
each file is completed, if you choose. You'll probably need to do
some editing of them to reflect your systems directory structure.
Still not convinced? Well, check out the BLDLIBS/CMD file (and source
in BLDLIBS/CCC) and the various /DAT files that go with it. This handy
little utility re-generates the system libraries (SYS6, 7 and 8) from
the individual /CMD files! Yes, that's right. You get all this for
the amazing low price of whatever it cost you to log on and download it.
Send $9.95 for records or $12.95 for 8-track tapes to...
Back to seriousness
===================
As supplied, this set of source will assemble to LS-DOS 6.3.1 as found
on Tim's site. With one exception, all the files come out as byte-for-
byte duplicates of the files on the LD4-631.DSK disk image. That one
exeption is because SYS8/SYS has had a named patch applied to the SETKI
routine.
LATE BREAKING NEWS!
Just before sending this off for the web site, I figured out what I had
to do to get an exact byte-for-byte copy of SYS8 going. After the file
LBSETKI/ASM is assembled, a SETKI1/FIX patch is applied to the resulting
/CMD file before the library overlay is built. This means that once the
three /JCL files have been run, you'll have an exact copy of LS-DOS.
Since "The Source" was published, several files have been added to the
LS-DOS distribution disk. These include BREF/CMD, DATECONV/CMD,
DISKCOPY/CMD and TED/CMD. I have disassembled the DATECONV and
DISKCOPY utilities and included their source. I have also done the
source for HELP/CMD, which is rather confusing in places. One day
I may get around to doing BREF and TED, but it won't be soon.
Distribution files
==================
This source is being distributed in two forms. One is 80 track DSDD
disk images for Jeff Vavasour's Model 4 emulator. These are all set
to plug into drives :1 and :2. The other form is .ZIPs of
the individual files in MSDOS format, with CR/LF as line ends.
Disk Image Distribution:
------------------------
L631UTL.DSK - This disk image contains the /JCL files, as well
as the BLDLIBS program and data files. Also, it
holds the source for the system utilities, such as
BACKUP and FORMAT. Also, my emulator utility to
set the system time from the PC's clock.
The JCL files are set up for this to be in drive :1
L631SYS.DSK - This disk image holds the operating system's /ASM
files. All the source for BOOT/SYS and SYS0/SYS
through SYS13/SYS is on this one disk. This goes
in drive :2 for the /JCL files.
Individual file distribution:
-----------------------------
This distribution has all the files from inside the two .DSK
images, extracted into two subdirectories and converted to the
MS-DOS CR/LF end-of-line convention. This distribution is useful
if you want to read the sources under MS-DOS or Unix; the .DSK
distribution is useful if you want to reassemble them under LS-DOS.
Both distributions contain my JCL files as well as the source code
and data files for the utility I wrote to rebuild the library command
overlays from the individual /CMD files.
Using the Model 4 emulator to assemble the operating system
===========================================================
Put a LS-DOS system disk in drive :0. Make sure it contains MRAS/CMD
and XREF/CMD, from the MISOSYS PRO-MRAS assembler package. It should
also have CD/CMD and EXPORT/CMD from Jeff's utilities, if you're going
to be exporting the /LST files out to MSDOS files.
Set up drives :1, :2 and :3 as follows:
:1 - L631UTL.DSK - JCLs & Utilities & LS-DOS utility source code.
:2 - L631SYS.DSK - System source code files.
:3 - Create a new, blank .DSK file and format it as 80 tracks, DSDD.
From a DOS ready prompt, enter "DO BUILD631". The parameters this
/JCL file can take are:
V="mm:ss" - Set the timestamp of the assembled files
The default is "06:31".
ALL - Assemble the lib commands and utilities also.
The default is not to do this.
LP - Generate the /PRN files and export them to MSDOS
The default is not to do this.
NOSTOP - Keep on going without pause
The default is to wait for a keypress at the
beginning of each JCL file.
If you didn't supply the (ALL) parameter, you'll want to enter the
command "DO BUILDLIB" to assemble the files that make up the SYS6, SYS7
and SYS8 library overlays and generate the ISAM files using my
BLDLIBS/CMD program. There is some documentation on the BLDLIBS
program, if you want to know more about it. See the file BLDLIBS/TXT
for information. You'll also need to "DO BUILDUTL" to assemble all of
the system utilities.
When finished, you need to copy the files to a system disk to check them
out. There are two /JCL files on the L631UTL disk to handle this task
for you. A third is handy to check the assembled files against the ones
on an original LS-DOS 6.3.1 disk.
The first is GETNEW/JCL, which copies the operating system /CMD
files from drive :3 to the appropriate /SYS files on drive :2. If you
do not want to use my drive assignments, the DO file takes (S=x,D=y)
parameters to set the source and destination drives. Omit the colon, if
you use these.
The second JCL file is GETUTILS. It does the same thing for the LS-DOS
utilities, and also has the S= and D= parameters.
The third JCL file is called COMPARE/JCL - it uses COMP/CMD to compare
the files on drive :3 to the appropriate files on drive :2. It pauses
after every compare so you can see that there are no differences (other
than the size of BOOT/SYS compared to LOWCORE/CIM). This hasn't been
fixed to handle the S= and D= parameters, yet.
Finally, move that disk image to drive :0 and reboot the emulator.
Congratulations, you're now running your freshly assembled LS-DOS
version 6.3.1!
Using a real Model 4 to assemble the operating system
=====================================================
Uh... gee.. I haven't done that yet. I imagine you'll want to split
the files up between a bunch of diskettes, and chop up the JCL files
files so they match the disks. If you have a hard disk system, you
would probably copy all the files to your hard disk and massage the
/JCL files to your liking and go from there. Unfortunately, since
my P166 acts like a 22.5 MHz Model 4 using the emulator - I just don't
have much pushing me to test this configuration. :)
That's it.
Best regards,
Pete Cervasio (cervasio@airmail.net)
Pete Cervasio's archive corresponds to the US flavor of LS-DOS 6.3.1H for Models 4 and 4P.
I incorporated the support for the French and German keyboard drivers (KIDVRFG/ASM)
taken from "LS-DOS 6.3.1 Source Code Restoration Project", thanks Frank Durda IV.
(http://nemesis.lonestar.org/computers/tandy/software/os/logical_systems/lsdos6/src631/index.html).
[Copyright 1999,2002,2004 Frank Durda IV, All Rights Reserved.
Mirroring of any material on this page in any form is expressly prohibited.
The official web site for this material is: http://nemesis.lonestar.org
Contact this address for use clearances: clearance at nemesis.lonestar.org
Comments and queries to this address: web_software_2011 at nemesis.lonestar.org]
I also incorporated the changes by Matthew Reed, converting his patch files to Z-80 code with conditional assembly. This corresponds to LS-DOS 6.3.1L, and allows for date support up to 31-12-2079.
To select the version level (H or L) and the keyboard language (US/FR/GE), I added a
configuration file DOSDEFS/ASM where the conditional assembly flags can be configured.
@MOD2 EQU 00 ; Set MOD2 false
@MOD4 EQU -1 ; Set MOD4 true
;
@DOSVER EQU 631 ; Set DOS Version 6.3.1
@DOSLVL EQU 'L' ; Set DOS Level L(-2079) or H(-2011)
;
; Define switches for international or domestic
;
@GERMAN EQU 0 ; -1 to select German keyboard layout
@FRENCH EQU 0 ; -1 to select French keyboard layout
;
END
I also added the missing END statements at the end of the /ASM files. This was causing
errors during assembly when those files were included using *GET statements.
The source files are packaged both in plain ASCII files in the
folder lsdos631 and in DMK disk image files:
L631BOOT.DSK: the LS-DOS 6.3.1 boot disk also containing the MisosysMRASassembler and some other utilities, mounted as:0;L631UTL.DSK: the source files for utilities, mounted as:1at BUILD and GET time;L631SYS.DSK: the source files for utilities, mounted as:2at BUILD time;L631BIN.DSK: the disk that will contain the generated binaries, mounted as:3at BUILD and GET time;L631NEW.DSK: a bootable LS-DOS 6.3.1 disk where the new binaries will be transfered, mounted as:2at GET time.
(tbc)
That's it. Enjoy !
Best regards,
Michel Bernard (michel.bernard@icloud.com)