CCS System 300 Instructions and recipes

System 300
CP/M
SUPPLEMENTARY MANUAl;
It-. CaUfomia COlDpater SystelDs

Copyright 1981 by California Computer Systems
All rights reserved. No part of this publication may be
reproduced in any form or by any means without express
·permission of California Computer Systems.
The information contained in this manual is believed to be
correct at the time of pUblication. However, CCS assumes no
liability resulting from the use of this manual.
Publication History:
Preliminary version print March 1981
Revision A printed June 1981
Revision B printed September 1981
CP/M is a trademark of Digital Research, Inc.

SYSTEM 300
CP/M SUPPLEMENTARY MANUAL
MANUAL 89008-02603 REV. B
COPYRIGHT 1981
CALIFORNIA COMPUTER SYSTEMS
250 CARIBBEAN DRIVE
SUNNYVALE CA 94086

TABLE OF CONTENTS
CHAPTER 1INTRODUCTION
CHAPTER 2 SYSTEM 300 CP/M DESCRIPTION
2.1 System Memory Configuration .•.....•. L .• L .•• 2-1
2.2 Reserved Page 0 RAM ...•••...........•.•.. 2-1
2.3 CC30BOOT ................•..........•..... 2-3
2.4 CC30BIOS 2-3
2.4.1 Diskette Compatibility .....••..... 2-3
2.4.2 Drive Compatibility .•.....•....... 2-4
2.4.3 Software Compatibility ..•.•...•..• 2-5
2.4.4 Peripheral Compatibility ..•.....•. 2-6
2.4.5 The Primitive Disk Routines ••..... 2-7
2.4.6 The Basic I/O Routines .•......•.•. 2-7
2.4.7 Error Messages ......•••..••.•••.• 2-10
CHAPTER 3 SYSTEM 300 UTITLITY PROGRAMS
CC30GEN .•••••.••••••••••••••••••••••••••
CC30INIT .
Documentation Conventions ..••••..••..••.•.
3.4.1 Description ••.••.....••••••••••••
3.4.2 Requirements/Restrictions ......•..
3 . 4 . 3 Op era t ion .......•.••..•.•••••.•••
3.4.4 Error Messages .•.••..•.•..•.•••.•
CC30COPY ••.•.••..•.••••••••••••••••••.••
...................................
Description .••.••.•.•••.•••••••..
Requirements/Restrictions .....••.
Operation .
Error Messages •..•..••..•.•.•...•
Description ..•••..••.••.••.•••••.•
Requirements/Restrictions ......•...
Operation ..•.•..••..•..••.•..••..••
Error Messages .•..••....••••••••.•
3-1
3-2
3-2
3-2
3-3
3-5 '
3-9
Description .•..•..•....•.•...•••.. 3-9
Operation ..•••.•.•••••. ~ •.••••.••• 3-9
3-10
3-10
3-10
3-10
3-12
3-14
3-14
3-14
3-15
3-16
3.5.1
3.5.2
3.5.3
3.5.4
3.2.1
3.2.2
3.2.3
3.2.4
MOVCPM
3.3.1
3.3.2
3.4
3.5
3.3
3.1
3.2
APPENDIX ACUSTOMIZING THE SYSTEM 300 CP/M
APPENDIX BDOUBLE-SIDED MINI DRIVES
APPENDIX C
EXTENDED-TRACK MINI DRIVES
APPENDIX D
SECTOR SKEW

INTRODUCTION
This manual describes California Computer Systems' System
300 version of CP/M 2.2. It is intended as a supplement to,
not a substitute for, the basic CP/M documentation and covers
only CCS's additions and modications to the standard CP/M
package as received from Digital Research. It assumes a basic
knowledge of CP/M terms and organization on the part of the
reader and is oriented to the systems programmer, although the
system operator may have reason to consult the description of
the utility programs in Chapter 3.
The standard distribution version of CP/M is designed to
work with an Intel Microprocessor Development System. CCS has
made the necessary modifications to the operating system for
it to work with CCS's System 300 and has expanded its drive
handling capabilities. As distributed, the System 300 CP/M
supports the following: .
* Single-sided and double-sided 8" floppy disk drives
* Single-sided 5.25" floppy disk drives
* Single- and double-density diskettes conforming to the IBM
3740 and System 34 formats and containing either 128, 256,
512, or 1024 bytes per sector
*A console device
*A serial printer
*A Centronics-type parallel printer
Simple modifications to the software will enable the System
300 CP/M to support double-sided, instead of single-sided,
5.25" floppy disk drives.
The extensively modified or unique portions of the
software include the system loader, the BIOS, and, to support
the new capabilities of the BIOS, several utility programs.

1-2
Introduction
The BIOS and the system loaders are described in the next
chapter; Chapter 3 describes the utility programs. To aid the
customizing of the software, the appendices describe how to
tailor the software for different applications.

CHAPTER 2
SYSTEM 300 CP 1M DESCRIPTION
2.1 SYSTEM MEMORY CONFIGURATION
The system load in memory is organized as shown in the
Digital Research r-1anual "CP/M 2.2 Interface Guide. II However,
the base of the system load, CBASE, is negatively offset 2K
compared to the normal CP/M load to allow for the enlarged
BIOS. Thus while CBASE in a64K version of Digital Research's
standard CP/M 2.2 is at E400h, it is at DC00H in CCS's 64K
version. For each size memory configuration, then, the space
available for the TPA in CCS's version is 2K less than in a
normal CP/M load. This is true even ·when a transient program
overlays the CCP; the beginning address of the system load in
this case, FBASE, is also negatively offset 2K from the
standard CP/M load. Please note that the entry points into
the BIOS will also be offset by 2K, or 800h.
2.2 RESERVED PAGE 0 RAM
Page 0 (00H-0FFH) in aCP/M sy~tem is reserved for system
parameters. The System 300 CP/M uses some unique parameters
in addition to the standard CP/M parameteTs~ Table 2-1 on the
following page lists the page 0 locations used by the System
300 CP /tv!.

2-2
Address
Contents
----~------------------------------------------------- --------
0000H-0002H
These locations contain a jump instruction to
the warm-start entry point, 4203H + bias (the
bias is equal to the difference, converted
into hex, between the system memory size in
Kbytes and 20K.
--------------------------------------------------------------
0003H
0004H
0005H-0007H
0008H-000AH
00l0H-00l2H
00l8H-001AH
0020H-0022H
0028H-002AH
0030H-003'2H
0038H-003AH
0040H-0053H
005CH-007CH
007DH-007FH
0080H-00FFH
The Intel Standard IOBYTE is stored in this
location. It is set to its default value by
the BIOS during cold-starts and is preserved
during warm-starts.
The current default drive number is stored in
this location.
These locations contain a jump instruction to
the BOOS. The address contained in 0006-0007H
is the beginning address of the BOOS and hence
the lowest address in memory used by CP/M if
the CCP is overlaid.
The first five of the seven Z-80 restart loca-
tions are not u~ed by CP/M. The sixth restart
location (0030H-0032H) is held reserved for
future use. The seventh restart location
0038H-003AH) contains a jump instruction into
the DDT or SID when programmed breakpoints are
used in the debug mode.
These locations contain disk parameters used
by CC30BOOT. Locations 0040-004FH are defined
by CP/M as user scratch pad locations; 0050H-
0053H are held reserved, but are not used by
present versions of CP/M.
The CCP uses these locations as a default file
control block for the transient program.
These locations are the optional default ran-
dom record position.
Locations 080H-0FFH are a temporary buffer for
CC30BOOT when it is loaded into memory from
sector 01 of Track 00 of the system disk.
Table 2-1 Page 0 Parameters

System 300 CP/M Description
2.3 CC30BOOT
2-3
The system loader CC30BOOT is designed to read the system
into memory from floppy disk. During a cold-start entry into
Cpll1,--- CC30BOOT-,--contained--i-nSector0l-, 'I'rack0-0-of -- the- -system
diskette, is loaded into system memory at locations 080H-0FFH
by the ROM-resident bootstrap loader on the disk controller
board. Once loaded, CC30BOOT begins execution and loads into
memory the system tracks (Tracks 00 and 01 on 8
11
system
dlskette and Tracks 00, 01, 02 on a 5.25
11
diskette.) It then
transfers control to the cold-start routine in the BIOS.
2.4 CC30BIOS
CC30BIOS
is California Computer Systems' customized,
expanded BIOS designed for CCS's System 300. It contains the
hardware-dependent console, printer, and disk drivers. To
support both maxi and mini floppy diskettes of varying
formats, it uses a modified version of CP/M's sector
deblocking algorithms. CC30BIOS also implements the Intel MDS
IOBYTE as described in Section 2.4.6 below and in Digital
Research's IICP /r'l 2.2 Al-teration Guide. II
2.4.1 Diskette Compatibility
CC30BIOS is designed to be compatible with 8
11
and 5.25
11
soft-sectored unrecorded diskettes that conform to the IBM
3740 and System 34 standards for diskette format and that have
77 and 35 tracks per diskette, respectively. It supports
double-sided 8
11
diskettes as well. Table 2-2 on the following
page shows the compatible diskette formats. Regardless of the
general diskette format, Track 00 of any diskette must be
formatted in 128-byte, single-density sectors, as specified by
the IBM standards. CCS's floppy disk initialization routine,
CC30INIT, automatically formats Track 00 in 128-byte,
single-density sectors and should be used to initialize any
blank diskettes to ensure their compatibility with CC30BIOS.

2-4
System 300 CP/M Description
==============================================================
IDENSITY I BYTES PER IDISKETTE ISECTORS I USER CAPACITY I
SECTOR I SIZE IPER TRACK I(BYTES)* i
==============================================================
lSi ng 1e1 128 15 .25 II 1 18 1 73 , 728 I
I 1 1 8" I 26 1 249,600 1
1---------1-----------1----------1-----------1---------------1
lSi ng 1eI 256 15 . 25 II 1 10 1 81 , 92 {) 1
1 I 8
11
I 15 1 288,000 1
---------1-----------1----------1-----------1---------------1
Single 1 512 1 5.25
11
151 81,920 1
1 1 8
11
181 307 , 200 1
---------I-----------I----------I--~--------I--------------~I
Single 1 1024 I 5.25
11
121 65,536 I
1 I 8
11
141 307 ,2'10 1
------------------------------------------------------------1
Double 1 128 I 5.25" 1 29 1 118,784 1
1 1 8
II 1 48 1 460,800 1
---------1-----------1----------1-----------1---------------1
Double 1 256 1 5.25" 1 18 I 147,456 1
1 1 8 II 1 26 1 499,200 I
---------1-----------1----------1-----------1---------------1
Daub 1e1 512 15 . 25 II 1 10 1 16 3, 840 I
1 1 1 8" 1 15 1 576,000 1
1---------1-----------1----------1-----------1---------------1
1 Double 1 1024 I 5.25
11
I5i 163,840 i
1 I 1 8" i81 614,400 1
==============================================================
* User capacity figures based on single-sided drives and on
5.25" drives with 35 tracks.
Table 2-2. Compatible Diskette Formats
CC30BIOS has been designed to read recorded diskettes of
the standard 128-byte sector, single-density, single-sided
format that have been formatted by a disk controller chip of
the 179x family. It cannot, however, read diskettes formatted
by a 1771 disk controller chip, nor is it guaranteed that
CC30BIOS can read diskettes in non-standard formats recorded
on other systems.
2.4.2 Drive Compatibility
The software is designed to control single-sided or
double-sided B" floppy disk drives of the Shugart SAEHJ0!8SC
type or single-sided 5.25" drives of the Shugart SA400 type.
If the drives have been purchased from CCS, they are