Heath HB-17 User manual

SOFTWARE REFERENCE
MANUAL
Copyright @ 1979
Heath Company
All Rights Reserved
Heath Disk Operating System
Model HB-17
HEATH COMPANY
BENTON HARBOR, MICHIGAN 49022
595-2340
Printed in the United
States of America

II
Contents
NOTE: An individual Table of Contents is included at the beginning of each of
the following chapters
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 0
Operating System (HDOS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 1
Console Debugger (DBUG) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 2
Heath Text Editor (EDIT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 3
Heath Assembly Language (ASM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 4
Extended Benton Harbor BASIC ................................ Chapter 5
SPECIAL DISCLAIMER
Heath cannot provide consultation on user-developed programs or modified
versions of Heath Software products.
Some ofthese software products were developed for the Heath Company by the
Wintek Corporation. Software copyrights for these products reside with Wintek
Corporation.

YOUR HEATH HB-17 SOFTWARE
ONE YEAR LIMITED WARRANTY
For a period of one year after yourpurchase, Heath Companywill supply to you free ofcharge any changes
that have been incorporated into the latest program offered for sale.
You willreceivefree consultation on any problemyou might encounter in verifying proper operationofthis
software system. We are not able to evaluate or debug individual customer programs. Sorry ... we cannot
accept collect calls.
Our warranty does not cover, and we are not responsible for, damage caused by misuse or unauthorized
modificationsto, oruses of, our productsfor purposes other than advertised. Ourwarranty does not include
reimbursement for customer time involved in any software system application.
Thiswarrantycovers only the original purchaser ofHeathproducts, and is not extended toallied equipment
or components used in conjunction with these products. We are not responsible for incidental or conse-
quential damages. Some states do not allow the exclusionorlimitation of incidental damages, so the above
limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may
also have other rights which vary from state to state.
If you have any questions regarding our service -warranty or otherwise, write directly to our Director of
Customer Services, Heath Company, Benton Harbor, Michigan 49022. He will make certain you receive
immediate, personal attention.
HEATH COMPANY
BENTON HARBOR, MI. 49022
(CUT ALONG DOTTED LINE)
IMPORTANT
PURCHASE REGISTRATION INFORMATION
In order to automatically receive system program changes, please complete the following information and
return it to the Heath Company, Benton Harbor, Michigan 49022.
H8-17 PURCHASE REGISTRATION
NAME DATE OF PURCHASE
ADDRESS LOCATION OF PURCHASE
INVOICE NUMBER
Ill

IV

SOFTWARE REFERENCE
MANUAL
HDOS SYSTEM
Chapter 0
Configuration
for the
HB-17

o-2 I 1ntroduction
Table of Contents
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-3
SYSTEM CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-3
THEORY OF OPERATION ........................................... 0-7
SYSTEM SET-UP PROCEDURE ..................................... 0-14
Power-Up ..................................................... 0-15
Bootstrap ...................................................... 0-16
INITIALIZATION (INIT) ............................................ 0-19
DIAGNOSTIC (TEST) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-22
Drive Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-24
General Checkout .............................................. 0-25
Media Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-2 7
Seek Time ... ·. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-28
Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-29
Exit ........................................................... 0-29
SYSTEM GENERATION ............................................ 0-30
SYSGEN ...................................................... 0-30
ONECOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . 0-32
Power-Down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-34
APPENDIX A
Memory Layout ................................................ 0-35
APPENDIX B
Stand Alone Program Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 0-38
INDEX ............................................................ 0-45

INTRODUCTION
The heart of your HB-17 Heath Disk Operating System, HDOS, is a sophisticated
library of programs which control and facilitate the operations you will soon be
performing. Before you use HDOS, be sure to read the parts of this section
entitled "Configuration" and "Theory of Operation." You will then have to
perform the "System Start-Up Procedure" in order to get your system up and
running. From there, you can proceed to Chapter 1, the HDOS Manual, which
will instruct you in the everyday use of HDOS.
The H8-17 system and HDOS have set a new standard in the hobby computer
industry. This is the first hobby system to offer many of the functions of large
commercial computer systems. The enjoyment and rewards you will derivefrom
using the system are limited only by your own imagination.
SYSTEM CONFIGURATION
The following paragraphs describe the minimum requirements of your operat-
ing system. It is impossible to list all the different combinations that you may
want to use. But this information will let you configure the operating system so
you can begin using your H8 computer system.
This section only contains the information about the software configuration.
Refer to the "System Configuration" section of your "Assembly Manual" for
instructions on how to configure your hardware.
You must have an H8 computer system with a minimum 16K bytes of memory.
Moreover, this memory must operate continuously from decimal location 8192
(i.e., 040.000A) to the available upper memory limit of your computer. Note that
the lower 8191 bytes of memory are reserved.
The Heath Disk Operating System, HDOS, requires that you use a console
terminal. This console can be interfaced with either an H8-4 or H8-5 Serial
Interface Card. These cards let you communicate at standard baud rates(i.e., 110,
150, 300, 600, ... , 9600). The serial communication may be wired for either 20
mA or RS-232 communication levels.
Someinterface cards use a fixed interrupt and port allocation scheme and cannot
be adjusted, such as the controller card for the floppy disk. This information is
supplied in the "System Configuration" section of your H17 Manuals.
Introduction I 0-3

0-4 Iintroduction
Table 0-1 outlines the port allocation scheme on the H8 computer system. It lists
the device and the device name used in the software. For instance, the console
terminal is referenced by the software as TT: and the line printer as LP:.
All port addresses are given in octal, indicated by a "Q". Thus, 350Q is port 350
octal.
TABLE 0-1
DEVICE INTERFACE
DEVICE NAME CARD
PORT ADDRESS INTERRUPTS
Console Terminal TT: H8-5 Serial
372-373Q
3
H8-4 Serial
350-357Q
3
Cassette
--
* HB-5 Serial
370-371Q
Line Printer
LP: HB-4 Serial
340-347Q
Alt. Terminal
AT: HB-5 Serial 374-375Q
HB-4 Serial
300-307Q
Front Panel
--
*
--
*
360-361Q
Floppy Disk
SY: Special
174-177Q
Reserved
170-173Q
Reserved
376-377Q
* -
None is used.
NOTE: If you are using an H36 DECWRITER as a Line Printer, you must connect
it as the device AT: In addition, an H14 Line Printer must be connected as the
device LP:.

The table also shows the interface card normally used with each device and the
port address(s) assigned for the device. You will have to install jumpers on the
interface card to select the appropriate address.
Also, the console terminal requires the use of interrupts, and you will have to
jumperits interface card for the proper level interrupt. With either an HB-4 or an
HB-5 Card, you must jumper the circuit board for a level 3 interrupt.
The device and the interface card must be using the same baud rate. The baud
rate is hardware selectable on all cards except the HB-4. The HB-4 Card is
softwareprogrammable and lets you selecta standard baud ratefor each channel.
You must correctly jumper the system co_nsole terminal interface card. If your
systemconsole is interfaced via an H8-5 Serial 1/0 Card, the serial port should be
addressed at port 3 72Q and the baud rate jumpered to match your console
terminal. Since an H8-4 port addressed at port 350Q will take precedence over
any HB-5 port addressed at port 372Q, it is also imperative that no active HB-4
ports be addressed at port 350Q.
Alternatively, if your system consoleis interfaced with an HB-4 Multi port Serial
1/0 Card, the systemconsole port should be addressed at port 350Q, and the Card
should be jumpered to generate level 3 interrupts on the channel addressed at
port 350Q.
All system software assumes that your system console interface card will be
jumpered at oneof these two ports. If the interface cardis not properly jumpered,
HDOS will not communicate with your system console. The cards need only be
rejumpered when the system console interface board is to be changed.
The HB operating system does not use any port address below 100 octal. These
ports are available for your use.
Introduction I 0-5

0-6 I 1ntroduction
The HB-17 system is initially configured with a single 5.25" disk drive unit. The
system also includes a disk controller card, which plugs into the H8 bus.
The initial drive is mounted in the left-hand side of the H17 cabinet, and is
connected to the disk controller by means of a 34-conductor flat ribbon cable.
The first drive will hereafter be referred to as SYyf :. * The second drive is referred
to as SYl:, and can be installed using the same cable and controller.
SY~: is the "system" drive unit. You were provided with one 5.25" "distribu-
tion" diskette. When you have generateda "system" diskette, asdescribed in the
"System Set-Up Procedure," starting on Page0-14, it will always be mounted in
SY0: for normal operation. And since you can easilydamage ordestroya diskette
by misuse or improper handling, always follow the instructions vary carefully
until you are thoroughly familiar with HDOS operating procedures.
WARNING: You should only use the distribution diskette to transfer files (see
Page 0-9) to the volumes in your system. Therefore, do not run any programs
other than those specified in this Software Reference Manual. If you try to run
other programs, such as BASIC (with the distribution diskette in SY0:), you will
cause unpredictable results.
Note that the distribution diskette is supplied with a write-protection tab in
place. This is done to guarantee that you will always have an accurate copy of the
operating system. Never remove this tab. Heath may refuseto support a system if
the write-protection tab is removed from the distribution diskette.
Under normal conditions, you will need extra diskettes for storage of data and
programs. It is also advantageous to have a dual-drive system to facilitate copy-
ing data and to allow more "on-line" working storage. We recommend that you
have at least two copies of the system diskette on hand, as well as a spare copy of
any important information. The "System Set-Up Procedure" will include a
section called "System Generation," which will tell you how to make system
diskettes. The HDOS Manual will tell you how to make copies of other inf orma-
tion.
*NOTE: "SY~" means system unit zero. Where the notation may be confusing, zeros will be
slashed, to distinguish them from the letter 0.