Commodore 128 User manual

COMMODORE cfl T.M .
Programmer’s
Reference Guide
COMMODORE
BUSINESS MACHINES, INC.
BANTAM
COMPUTER
BOOKS A Bantam Computer Book

COMMODORE 128
PROGRAMMER’S
REFERE CE GUIDE

Bantam Computer Books
Ask your bookseller for the books you have missed
THE AMIGADOS MANUAL
by Commodore-Amiga Inc.
THE APPLE //c BOOK
by Bill O’Brien
THE COMMODORE 64 SURVIVAL
MANUAL
by Winn L. Rosch
COMMODORE 128 PROGRAMMER’S
REFERENCE GUIDE
by Commodore Business Machines Inc.
EXPLORING ARTIFICIAL INTELLIGENCE
ON YOUR APPLE II
by Tim Hartnell
EXPLORING ARTIFICIAL INTELLIGENCE
ON YOUR COMMODORE 64
by Tim Hartnell
EXPLORING THE UNIX ENVIRONMENT
by The Waite Group/Irene Pasternack
FRAMEWORK FROM THE GROUND UP
by The Waite Group/Cynthia Spoor and
Robert Warren
HOW TO GET THE MOST OUT OF
COMPUSERVE 2d ed.
by Charles Bowen and David Peyton
HOW TO GET THE MOST OUT OF THE
SOURCE
by Charles Bowen and David Peyton
THE MACINTOSH
by Bill O’Brien
THE NEW jr. A GUIDE TO IBM’S PCjr
by Winn L. Rosch
ORCHESTRATING SYMPHONY
by The Waite Group/Dan Shafer
PC-DOS/MS-DOS
User’s Guide to the Most Popular Operating
System for Personal Computers
by Alan M. Boyd
POWER PAINTING: COMPUTER GRAPHICS
ON THE MACINTOSH
by Verne Bauman and Ronald Kidd/
illustrated by Gasper Vaccaro
SMARTER TELECOMMUNICATIONS
Hands On Guide to On Line Computer Services
by Charles Bowen and Stewart Schneider
SWING WITH JAZZ: LOTUS JAZZ ON THE
MACINTOSH
by Datatech Publications Corp./Michael McCarty
USER’S GUIDE TO THE AT&T PC 6300
PERSONAL COMPUTER
by David B. Peatroy Ricardo A. Anzaldua
H. A. Wohlwend and Datatech Publications
Corp.

COMMODORE 128
PROGRAMMER’S
REFERE CE GUIDE
COMMODORE BUSI ESS MACHI ES, I C.
BANTAM BOOKS
TORONTO • NEW YORK • LONDON • SYDNEY • AUCKLAND

COMMODORE 128 PROGRAMMER S REFERENCE GUIDE
A Bantam Book / February 1986
Commodore 64 and Commodore 128 are registered trademarks of Commodore
Electronics. Ltd.
CPIM and CPIM Plus Version 3.0 are registered trademarks of Digital Research
Inc.
Perfect is a registered trademark of Perfect Software.
TouchTone is a registered trademark of AT&T.
WordStar is a registered trademark of MicroPro International Corporation.
Grateful acknowledgment is made for permission to reprint two bars o f Invention
13 (Inventio 13) by Johann Sebastian Bach. Sheet music copyright © C. F. Peters,
Corp., New York.
Book design by Ann Gold.
Cover design by Jo Ellen Temple.
All rights reserved.
Copyright © 1986 by Commodore Capital, Inc.
This book may not be reproduced in whole or in part, by
mimeograph or any other means, without permission.
For information address: Bantam Books, Inc.
ISBN 0-553-34292-4
Published simultaneously in the United States and Canada
Bantam Books are published by Bantam Books, Inc. Its trademark, consisting of
the words “Bantam Books" and the portrayal o f a rooster, is Registered in U.S.
Patent and Trademark Office and in other countries. Marca Registrada. Bantam
Books, Inc., 666 Fifth Avenue, New York, New York 10103.
PR IN TE D IN TH E UN ITED ST A TES OF A M ER IC A
HL 0987654321

1
11
91
109
123
181
197
207
265
291
335
371
CO TE TS
Chapter 1
Introduction
Chapter 2
BASIC Building Blocks and BASIC 7.0 Encyclopedia
Chapter 3
One Step Beyond Simple BASIC
Chapter 4
Commodore 128 Graphics Programming
Chapter 5
Machine Language
Chapter 6
How to Enter Machine Language Programs Into the
Commodore 128
Chapter 7
Mixing Machine Language and BASIC
Chapter 8
The Power Behind Commodore 128 Graphics
Chapter 9
Sprites
Chapter 10
Programming the 80-Column (8563) Chip
Chapter 11
Sound and Music on the Commodore 128
Chapter 12
Input/Output Guide

Chapter 13
The Commodore 128 Operating System 401
Chapter 14
CP/M 3.0 on the Commodore 128 A ll
Chapter 15
The Commodore 128 and Commodore 64 Memory Maps 501
Chapter 16
C l28 Hardware Specifications 555
Appendixes 643
Glossary 731
Index 739

ACK OWLEDGME TS
Written by Larry Greenley
and
Fred Bowen
Bil Herd
Dave Haynie
Terry Ryan
Von Ertwine
Kim Eckert
Mario Eisenbacher
Norman McVey
The authors are deeply indebted to the many people who have contributed to the
preparation of this book. Special thanks go to Jim Gracely of Commodore Publications
who reviewed the entire manuscript for technical accuracy and provided important
corrections clarifications and user-oriented suggestions and to Steve Beats and Dave
Middleton of Commodore Software Engineering for their programming assistance and
expertise.
We also want to recognize the contributions of Frank Palaia of Commodore Hardware
Design who provided expertise in the operation of the Z80 hardware and of Dave
DiOrio of Commodore Integrated Circuit Design who provided insight into the design
of the Memory Management Unit and the C l28 VIC chip enhancements.
For their extensive technical reviews of the manuscript we wish to thank Bob Albright
Pete Bowman Steve Lam and Tony Porrazza of Commodore Engineering. We also
thank Dan Baker Dave Street and Carolyn Scheppner of Commodore Software Techni
cal Support for providing an always available source of technical assistance. In addition
we want to acknowledge the valuable contributions of members of Commodore Soft
ware Quality Assurance especially Mike Colligon Karen Mackenzie Pat McAllister
Greg Rapp Dave Resavy and Stacy English.
We also thank Carol Sullivan and Donald Bein for carefully proofreading various
sections of the text Michelle Dreisbach for typing the manuscript Marion Dooley for
preparing the art Jo-Ellen Temple for the cover design and Nancy Zwack for overall
coordination assistance.
Finally we would like to acknowledge the unflagging support and guidance provided by
senior Commodore executives Paul Goheen Harry McCabe and Bob Kenney.

p