Commodore 128 Book 8 CPM User's Guide

316
8/6/2019 Commodore 128 Book 8 CPM User's Guide http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 1/316

Transcript of Commodore 128 Book 8 CPM User's Guide

Page 1: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 1/316

Page 2: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 2/316

Page 3: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 3/316

C P / M U S E R ' S G U D Er e v e a l i n g l o o k i n t o C P / M o t h C - 1 2 8

B J o r g S c h i e ba n E l m a r A W e i l e r

D a t a B e c k e r B o o k

P u b l i s h e d b A b a c u s l i B H i s a l S o f t w a r e

Page 4: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 4/316

Page 5: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 5/316

F o r e w o r d i

C h a p t e r T h C o m p u t e r1 . T h k e y b o a r d1 . T h s c r e e n1 . T h p r i n t e r1 . 3 . 1 T h d o t - m a t r i x p r i n t e r1 . 3 . 2 T h D a i s y - w h e e l p r i n t e r1 . 3 . 3 T h i n k - j e t p r i n t e r1 . 3 . 4 T h t h e r m a l p r i n t e r1 . D a t a M e m o r y 1 1 . O n o z e r o 1 1 . C o u n t i n g i b i n a r y 1 1 . M e m o r y v a l u e s 1 1 . M a s s s t o r a g e 1 1 . 8 . 1 T h f l o p p y d i s k e t t e 1 1 . 8 . 2 H a r d d i s k 1 1 . S u m m a r y 1

C h a p t e r T h O p e r a t i n g S y s t e m 1 2 . W h a t i p r o g r a m ? 2 2 . O p e r a t i n g S y s t e m s 2 2 . C P / M ' s t a s k 2 2 . 4 D i f f e r e n t C P / M v e r s i o n s 2 2 . T h C P / M p r o m p t 2 2 . P l a y i n g i s a f e 2 2 . S u m m a r y 2

C h a p t e r 3 W o r k i n g w i t h C P / M 2 3 . T h s y s t e m d i s k e t t e 3 3 . C o p y i n g w i t h a s i n g l e d i s k d r i v e 3 3 . C o p y i n g w i t h t w d i s k d r i v e s 3 3 . D i s p l a y i n g t h e d i r e c t o r y 3 3 . C o p y i n g w i t h I 3 3 . R u l e s f o f i l e n a m e s 3 3 . E x t e n s i o n s 4 3 . F i n d i n g d a t a f i l e 4 3 . S e a r c h i n g w i t h a q u e s t i o n m a r k ( ? 4 3 . 1 0 S u m m a r y 4

i i

Page 6: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 6/316

C h a p t e r T h r e s i d e n t c o m m a n d s 4 4 . 4 . 4 . 4 . 3 . 14 . 4 . 4 . 14 . 4 . 24 . 4 . 34 . 4 . 44 . 4 . 5 . 14 . 4 . 4 .

C o m m a n d s , p a r a m e t e r s , a n o p t i o n sT h r e s i d e n t c o m m a n d sU S E R a n u s e r a r e a sU S E R a r e a s w i t h C P / M 3 . D I D I w i t h p a r a m e t e r sM o r e a b o u t D I D I a n i t o p t i o n sD I R S Y SE R A S EE r a s i n g w i t h E R i C P / M 3 . C h a n g i n g f i l e n a m e s w i t h R E N ( A M E )T Y P ES u m m a r y

5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 1 05 . 1 15 . 1 25 . 1 3

I n t r o d u c t i o nT r a n s i e n t c o m m a n d s u n d e r C P / MS E D i s k d r i v e c h a r a c t e r i s t i c sL a b e l sD i s k e t t e P A S S W O R DF i l e P A S S W O R DT i m e S t a m p i n gS E T D E FS H O WS U B M I TT h H E L P c o m m a n dS u m m a r y

4 4 4 4 5 5 5 5 5 5 5 5 5 5

C h a p t e r 5 T h t r a n s i e n t c o m m a n d s 5 6 6 6 6 6 6 6 6 7 7 7 7 8

I

Page 7: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 7/316

C h a p t e r E v e r y t h i n g a b o u t P I 8 6 . D i s k e t t e c o p y i n g 8 6 . C o p y i n g b e t w e e n u s e r a r e a s 8 6 . T e x t f i l e s a n n o n - t e x t f i l e s 8 6 . M e r g i n g d a t a f i l e s 8 6 . L i n e n u m b e r i n g 9 6 . C o n v e r t i n g b e t w e e n u p p e r c a s e a n l o w e r c a s e 9 6 . S e a r c h i n g f o s t r i n g 9 6 . P r i n t i n g s e v e r a l d a t a f i l e s 9 6 . A u t o m a t i c a l l y b a c k i n g u d a t a f i l e s 9 6 . 1 0 O v e r w r i t i n g w i t h o u t p r o m p t s 9 6 . 1 1 C o p y i n g s y s t e m d a t a f i l e s 9 6 . 1 2 T i d y i n g u t h 8 t b i 9 6 . 1 3 P r a c t i c a l e x a m p l e s 9 6 . 1 4 S u m m a r y 9

C h a p t e r 7 C P / M c o m p o n e n t s 9 7 . C P / M o n t h e C - 1 2 8 1 0 7 . S y s t e m d i s k f o 1 5 7 1 1 0 7 . V i r t u a l d i s k d r i v e E : 1 0 7 . T h C O P Y S Y S c o m m a n d 1 0 7 . T h s t a t u s l i n e 1 0 7 . 1 5 7 1 d i s k f o r m a t s 1 0 7 . T h k e y b o a r d 1 0 7 . K e y b o a r d v a l u e s 1 0 7 . 8 . 1 D i s a b l i n g / e n a b l i n g 8 c o l u m n c o l o r s e l e c t i o n 1 0 7 . 8 . 2 C h a n g i n g k e y ' s A S C I I v a l u e 1 0 7 . 8 . 3 D e f i n i n g t h f u n c t i o n k e y s 1 1 7 . K Y F I G f u n c t i o n s a n u s e s 1 1

C h a p t e r A d d i t i o n a l U t i l i t i e s 1 2 8 . T h A s s e m b l e r s M A a n R M A C 1 2 8 . U s i n g t h M A a s s e m b l e r 1 2 8 . W o r k i n g w i t h S U B M I T 1 3 8 . T h m e m o r y l a y o u t 1 4

Page 8: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 8/316

C h a p t e r T h Z - 8 0 R O l i s t i n g 1 5

C h a p t e r 1 T h C P / M c o m m a n d s 2 2 1 0 . 11 0 . 21 0 . 31 0 . 41 0 . 51 0 . 61 0 . 71 0 . 81 0 . 91 0 . 1 01 0 . 1 11 0 . 1 21 0 . 1 31 0 . 1 41 0 . 1 51 0 . 1 61 0 . 1 71 0 . 1 81 0 . 1 91 0 . 2 01 0 . 2 11 0 . 2 21 0 . 2 31 0 . 2 41 0 . 2 51 0 . 2 61 0 . 2 71 0 . 2 81 0 . 2 91 0 . 3 01 0 . 3 1

C O P Y S Y SD A T ED E V I C ED I D I R S Y SD U M PE E R A S EF O R M A TG E N C O MG E H E L PH E X C O MI N I T D I RK E Y F I GL I L I N KM A P A T C HP I P U R E N A M ER M A CS A V ES E S E T D E FS H O WS I S U B M I TU S E RX R E F

2 2 2 2 2 2 2 3 2 3 2 3 2 3 2 3 2 3 2 4 2 4 2 4 2 4 2 4 2 4 2 4 2 4 2 4 2 4 2 5 2 5 2 5 2 5 2 5 2 5 2 5 2 6 2 6 2 6 2 6 2 6

V

Page 9: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 9/316

A p p e n d i c e s 2 6 A p p e n d i x A A S C I I a n N u m b e r C o n v e r s i o n T a b l e 2 6 A p p e n d i x B C P / M C o n t r o l C o d e s 2 7 A p p e n d i x C p i p ' s p a r a m e t e r s 2 7 A p p e n d i x D S E T ' p a r a m e t e r s 2 7 A p p e n d i x E 8 0 8 0 I n s t r u c t i o n S e 2 8 F O G : T h C P / M E x p e r t 2 8

I n d e x 2 9

v

Page 10: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 10/316

Page 11: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 11/316

F o r e w o r d

T h C o m m o d o r e 1 2 i a e x c i t i n g , u n i q u e c o m p u t e r . I p r o v i d e s t h r e ec o m p l e t e l y i n d e p e n d e n t m o d e s o o p e r a t i o n : t h e 6 4 m o d e , t h 1 2 m o d e ,a n t h C P / M m o d e . E a c h o t h e s e m o d e s h a i t i n t e r e s t i n g a p p l i c a t i o n sa n d e s e r v e s a t t e n t i o n . T h 1 2 8 ' s f o r e r u n n e r , t h C o m m o d o r e C - 6 4 , h a a e n o r m o u s a m o u n t o s o f t w a r e a v a i l a b l e f o i t A l o i c a n r u n o t h 1 2 w i t h c o m p l e t e c o m p a t i b i l i t y t t h 6 m o d e . N e s o f t w a r e w r i t t e n f o t h e n h a n c e d f e a t u r e s f o u n d i 1 2 m o d e a r a p p e a r i n g e v e r y d a y . F i n a l l y , t h 1 2 8 ' s C P / M m o d e , t h o u g h o f t e n o v e r l o o k e d b y o w n e r s a n d s o f t w a r ed e v e l o p e r s a l i k e , h a m a n y v e r y i m p o r t a n t a n e x c i t i n g p o s s i b l i t i e s .

L i k e t h w e a t h e r , e v e r y o n e s e e m s t o t a l k a b o u t t h e 1 2 8 ' s C P / M m o d e , b u n o n d o e s a n y t h i n g a b o u t i t D o e s t h a t m e a n i t C P / M i s n ' t a n g o o d ? O t h e c o n t r a r y . W h i l e t h C P / M f o t h C o m m o d o r e 6 4 C P / M 2 . 2 , h a i t d i f f i c u l t i e s , t h 1 2 K B y t e s R A w i t h t h C - 1 2 8 m a k e s i p o s s i b l e t r u C P / M 3 . ( a l s o k n o w n a C P / M P l u s ) . C P / M 3 . p e r f o r m s m u c h b e t t e rt h a n t h o l C P / M 2 . 2 .

T h C - 1 2 8 a l s o h a o t h e r i n v i t i n g f e a t u r e s . I h a s a f a n t a s t i c k e y b o a r d t h a t ' se s p e c i a l l y s u i t a b l e h e r e f o l o n g h o u r s o p r o g r a m m i n g . S o m e s u b t l e b u v e r y c o n v e n i e n t i d e a s w e n t i n t o i t F o e x a m p l e , t h k e y s a n J a r ep r o v i d e d w i t h a s m a l l d o t i t h m i d d l e , s o t h a t y o c a m o r e e a s i l y p l a c ey o u r f i n g e r s i n t h e c o r r e c t p o s i t i o n o t h k e y b o a r d w i t h o u t l o o k i n g . T h C o m m o d o r e d e v e l o p e r s h a v e h a b i m o r e e x p e r i e n c e d e s i g n i n gc o m p u t e r s t h a n a l o o n e w c o m e r s . S e v e r a l c o m p e t i t o r s h a v e m o u s e t o f f e r , b u h a v e r e a l l y p o o r q u a l i t y k e y b o a r d s — a n d w o r k i n g w i t h b a k e y b o a r d i a b o u t a i n v i t i n g a e a t i n g i d i r t y r e s t a u r a n t .

T h C - 1 2 8 f s c o m p a n i o n , t h 1 5 7 1 d i s k d r i v e , o f f e r s l o o f p e r f o r m a n c ea n v a l u e f o t h m o n e y . T h e o r e t i c a l l y y o c a w o r k w i t h C P / M 3 . o y o u r o l d 1 5 4 1 , b u t t h i s w o u l d g r e a t l y r e d u c e t h e f f i c i e n c y o t h s y t e m . A u p g r a d e t t h 1 5 7 1 w i l l s a v e y o m a n y h o u r s o f w a i t i n g , i t h l o n g r u n .

T h o s e w h p r e d i c t t h d e a t h o C P / M c a u s e d b i t n e r i v a l , G E M , w i l lh a v e t b p a t i e n t f o f e m o r e y e a r s . T h e r e ' s l o o C P / M s o f t w a r e o u t h e r e , a l r e a d i l y a v a i l a b l e t a n c o m p u t e r e q u i p p e d w i t h C P / M . T h e6 8 0 0 0 - c h i p c o m p u t e r s h a v e i p r e t t y t o u g h , b e c a u s e c o m p l e t e l y n e s o f t w a r e m u s t b d e v e l o p e d f o t h e m .

I

Page 12: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 12/316

T h p u r p o s e o t h i s b o o k i t s h o w y o h o t w o r k w i t h C P / M a c o m f o r t a b l y a n q u i c k l y a s p o s s i b l e . A l o t h s t a n d a r d C P / M c o m m a n d s ,a w e l l t h o s e C P / M c o m m a n d s p e c u l i a r t t h C o m m o d o r e 1 2 8 , a r et h o r o u g h l y e x p l a i n e d .W h o p e y o h a v e l o o f u n w i t h C P / M o y o u r C o m m o d o r e 1 2 8 , a n m u c h s u c c e s s a p p l y i n g i t

S i n c e r e l y ,

E A W e i l e rJ S c h i e bD i i s s e l d o r f , W G e r m a n yN o v e m b e r 1 9 8 5

Page 13: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 13/316

C h a p t e r O n

T h C o m p u t e r

1 . T h k e y b o a r d1 . T h s c r e e n1 . T h p r i n t e r1 . 3 . 1 T h d o t - m a t r i x p r i n t e r1 . 3 . 2 T h d a i s y - w h e e l p r i n t e r1 . 3 . 3 T h i n k - j e t p r i n t e r1 . 3 . 4 T h t h e r m a l p r i n t e r1 . D a t a m e m o r y1 . O n o z e r o1 . C o u n t i n g i b i n a r y1 . M e m o r y v a l u e s1 . M a s s s t o r a g e1 . 8 . 1 T h f l o p p y d i s k e t t e1 . 8 . 2 H a r d d i s k1 . S u m m a r y

Page 14: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 14/316

Page 15: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 15/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h C o m p u t e r

W d o n ' t k n o w h o f a m i l i a r y o a r w i t h c o m p u t e r s . U n f o r t u n a t e l y w c a n ' t a s e a c h r e a d e r i n d i v i d u a l l y . S w e l l s t a r t a t h b e g i n n i n g w i t hf u n d a m e n t a l c o m p u t e r c o n c e p t s s w c a a l s t a r t t h i s b o o k o e q u a lf o o t i n g .

F i r s t o a l l , w h a t i c o m p u t e r ? W e ' l l t r t a n s w e r t h i s q u e s t i o ns c i e n t i f i c a l l y .

T h e w o r d i t s e l f , " c o m p u t e r " t e l l s u w h a t i d o e s . c o m p u t e r i c a l c u l a t o r — i t c o m p u t e s . S u c h c o m p u t i n g m a c h i n e c a d g r e a t m a n yt h i n g s , s u c h a p r o c e s s a l o o n u m b e r s i a c c o u n t i n g a n c a l c u l a t e t h t o t a l s o l e d g e r c o l u m n s .

Page 16: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 16/316

Page 17: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 17/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D E L E T I O N O C O R R E C T I O N K E Y S< D E L E T E >D E ( a b b r e v i a t i o n f o r D E L E T E )R U O U

S H I F T / U P P E R C A S E< S H I F T > ( t u r n s o c a p i t a l i z a t i o n )

L O C K< S H I F T L O C K > ( c o n t i n u o u s < S H I F T > )T h a c t u a l f u n c t i o n o t h i s k e d e p e n d s o t h c o m p u t e r . T h i sk e u s u a l l y d o e s n ' t c h a n g e t h w a t h w h o l e k e y b o a r df u n c t i o n s . I m e a n s t h a t o n l y c a p i t a l l e t t e r s a r p r i n t e d w h e nl e t t e r k e i p r e s s e d . I c a m a k e y o u r t y p i n g w o r k l o t e a s i e r .

T h C o m m o d o r e 1 2 8 , o t h o t h e r h a n d , u s e s < S H I F TL O C K > t c h a n g e t h f u n c t i o n o a l k e y s o t h k e y b o a r d . I t ' st h s a m e a h o l d i n g d o w n t h < S H I F T > k e y .

C A P S L O C KN o r m a l l y t h C - 1 2 8 ' s < C A P S L O C K > k e o n l y a f f e c t s t h l e t t e r k e y s , b u i C P / M i i i n o p e r a t i v e .

C O N T R O LT h < C O N T R O L > k e y , i o t h l e f t s i d e o y o u r C - 1 2 8k e y b o a r d . I t i s u s e d f o m a n y c o n t r o l c o m m a n d s i c o n j u c t i o nw i t h l e t t e r o d i g i t k e y s .

Page 18: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 18/316

Page 19: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 19/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 T h P r i n t e r

T h c o m p u t e r c a s e n d i t d a t a t p r i n t e r f o p e r m a n e n t r e c o r d o i t d a t a .T h f i r s t l a r g e c o m p u t e r s , w h i c h p e r f o r m e d q u i t e s l o w l y b t o d a y ' ss t a n d a r d s , u s e d t e l e x m a c h i n e s t o u t p u t f o p e r m a n e n t p a p e r c o p i e s . T h e s et e l e x m a c h i n e s w e r e v e r y l o u d , a n w a s t e d l o o p a p e r .

T h d i s a d v a n t a g e s o p r i n t e r s , n o i s e a n p a p e r w a s t e , a r s t i l l w i t h u s t o d a yi v a r y i n g d e g r e e s . B u m a n y p e o p l e n e e d t h e i r c o m p u t e r i n f o r m a t i o n i p r i n t e d f o r m , s o t h e y n e e d t u s p r i n t e r . S i n c e t h e r e a r s m a n y d i f f e r e n tp r i n t e r s o t h m a r k e t t o d a y , w e l l g i v e y o s h o r t o v e r v i e w .

P r i n t e r p r i c e s a n p e r f o r m a n c e v a r y w i d e l y . T h e y c o s t f r o m $ 5 t $ 8 0 0 0a n u p T h e y c a p r i n t b e t w e e n 1 a n 8 0 c h a r a c t e r s p e s e c o n d ,d e p e n d i n g o t h e i r c o s t .

1 3 . 1 T h D o t - m a t r i x P r i n t e rD o t - m a t r i x p r i n t e r s w o r k e s p e c i a l l y w e l l w i t h m i c r o c o m p u t e r s l i k e t h C - 1 2 8 . T h e y a r e t h e m o s t p o p u l a r , b e s t - s e l l i n g p r i n t e r s , d u t t h f a c t t h a tt h e y a r a m o n g t h l o w e s t p r i c e d p r i n t e r s . I a d d i t i o n , d o t - m a t r i x p r i n t e r sd t h e i r w o r k f a s t e r t h a n m a n y o t h e r t y p e s o p r i n t e r s . D o t - m a t r i x p r i n t e r sp r i n t d o t s v e r y c l o s e l y t o g e t h e r t f o r m l e t t e r s a n c h a r a c t e r s . W i r e n e e d l e ss t r i k e r i b b o n a g a i n s t t h e p a p e r t p r o d u c e t i n y d o t . m i n i m u m o s e v e nd o t s a r r e q u i r e d t p r o d u c e l e t t e r , d i g i t o o t h e r c h a r a c t e r . I t h e a r l yd a y s o p e r s o n a l c o m p u t i n g ( b e f o r e 1 9 8 0 o s o ) , t h e q u a l i t y o t h e s ep r i n t e r s w a v e r y p o o r . I w a q u i t e h a r d t r e a d i t t e x t i t h p r i n t o u t i o a n g r e a t l e n g t h .

B u t h o s e d a y s a r p a s t . T h e r e a r s t i l l v e r y c h e a p m o d e l s o d o t - m a t r i xp r i n t e r s o t h m a r k e t t o d a y t h a t p r i n t 8 t 1 0 c h a r a c t e r s p e s e c o n d . T h e ya r e n ' t g o o d e n o u g h f o c o r r e s p o n d e n c e , b u a r s u f f i c i e n t f o s o m ea p p l i c a t i o n s / A b i a d v a n t a g e o d o t - m a t r i x p r i n t e r s i t h a t y o h a v ec h o i c e o f f o n t s , a n c a e v e n p r o g r a m y o u r o w f o n t s — f o r e x a m p l e , t i n c l u d e f o r e i g n l a n g u a g e c h a r a c t e r s . T h i s m a k e s w r i t t e n c o r r e s p o n d e n c ew i t h G e r m a n y , G r e e c e o J a p a n m u c h e a s i e r .

Page 20: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 20/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

H i g h p e r f o r m a n c e d o t - m a t r i x p r i n t e r s p r i n t u t 8 0 c h a r a c t e r s p e s e c o n dw i t h 1 3 d o t s a c r o s s t h w i d t h o t h c h a r a c t e r . T h e y v a r y i c o s t f r o ma b o u t $ 5 0 0 t $ 3 0 0 0 . T h i s n e b r e e d o f d o t - m a t r i x p r i n t e r s h a v e b e c o m ea v a i l a b l e o n l y r e c e n t l y . T h e y u s u a l l y h a v e 2 p r i n t n e e d l e s , a n c a a p p r o a c h t h q u a l i t y o t y p e w r i t e r p r i n t ( a r e d u c e d s p e e d ) . C u s t o m a r i l yt h e y p r i n t a b o u t 5 c h a r a c t e r s p e s e c o n d f o c o r r e s p o n d e n c e , a n 1 4 t 1 5 c h a r a c t e r s p e s e c o n d i q u i c k - p r i n t m o d e .

1 . 3 . 2 T h d a i s y - w h e e l p r i n t e rs e c o n d t y p e o f p r i n t e r i t h d a i s y - w h e e l p r i n t e r . T h i s g r o u p i n c l u d e s t h

b a l l - h e a d p r i n t e r s . T h e s e p r i n t e r s a r t y p i c a l l y b a s e d o o b s o l e t e t y p e w r i t e rd e s i g n s , a n r e q u i r e l o o c o s t l y m a i n t e n a n c e . T h e i r l a r g e n u m b e r o m o v i n g p a r t s m a k e t h e m q u i t e e x p e n s i v e t m a n u f a c t u r e .D a i s y - w h e e l p r i n t e r s h a v e d i s k t h a t r e p l a c e s t h e t y p e - b a s k e t o r b a l l h e a d o

c o n v e n t i o n a l t y p e w r i t e r . T h i s d i s k c o n t a i n s t h v a r i o u s l e t t e r s a n c h a r a c t e r s r e q u i r e d f o p r i n t i n g o t h r i o t h d i s k i t s e l f . T h d i s k r o t a t e so i t a x i s , a n s m a l l h a m m e r h i t s t h r e q u i r e d c h a r a c t e r a g a i n s t t h er i b b o n , c r e a t i n g a n i m p r e s s i o n o t h p a p e r . D a i s y - w h e e l p r i n t i i n d i s t i n g u i s h a b l e f r o m t h a t o t y p e w r i t e r ' s . d a i s y - w h e e l p r i n t e r m i g h t b c o n s i d e r e d i y o u r c o m p u t e r o u t p u t n e e d s t b l e t t e r - q u a l i t y .

T h s p e e d o t h c h e a p e s t d a i s y - w h e e l p r i n t e r m o d e l s i a b o u t 2 c h a r a c t e r sp e s e c o n d . T o p - o f - t h e - l i n e m o d e l s c a p r i n t a a b o u t 8 c h a r a c t e r s p e s e c o n d .

1 3 . 3 T h i n k - j e t p r i n t e r

f a i r l y n e t y p e o p r i n t e r i t h i n k - j e t p r i n t e r . T h e s e a r l o c h e a p e rt h a n d a i s y - w h e e l p r i n t e r s . L i k e d o t - m a t r i x p r i n t e r , i p r i n t s l e t t e r s a n d i g i t s u s i n g l i t t l e d o t s . H o w e v e r , t h e r e a r e n m e c h a n i c a l p a r t s b e t w e e n t h p r i n t h e a d a n d t h e p a p e r . I n s t e a d , l i t t l e d r o p s o f i n a r s p r a y e d f ! a t h p a p e r . I t p r i n t q u a l i t y i c o m p a r a b l e t t h a t o c h e a p e r d o t - m a t r i x p r i n t e r .T h b i a d v a n t a g e o f i n k - j e t p r i n t e r s i t h a t t h e y a r v e r y q u i e t . P r i n t i n ga b o u t 1 5 c h a r a c t e r s p e s e c o n d , t h e i r n o i s e l e v e l i v e r y l o w . T h e i r m a j o rd i s a d v a n t a g e i t h a t t h e y c a n ' t m a k e m u l t i p l e c o p i e s t h r o u g h c a r b o n p a p e r ,s u c h a f o r p r i n t i n g i n v o i c e s i t r i p l i c a t e .

Page 21: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 21/316

Page 22: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 22/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 . D a t a m e m o r y

L e t ' s s e w h a t m a k e s u o u c o m p u t e r s f a r . W h a v e k e y b o a r d ,s c r e e n , a n p r i n t e r . N o w h a t w n e e d i p l a c e t s t o r e t h d a t a w w h i c h w e n t e r . F i r s t w n e e d s t o r a g e w h i l e t h d a t a i i n s i d e t h c o m p u t e r ,a n t h e n w n e e d l o n g - t e r m s t o r a g e . W c a s t o r e t h d a t a i n s i d e t h c o m p u t e r i i t m e m o r y . F o l o n g - t e r m s t o r a g e w c a u s f l o p p y d i s k e t t eo h a r d d i s k . L e t ' s t a k e a l o o k a h o c o m p u t e r s t o r e s i t d a t a .

1 . O n o z e r o : F o u n d a t i o n s o b i n a r y a r i t h m e t i c

T h c o m p u t e r i a e l e c t r o n i c d e v i c e . B e c a u s e o t h i s , a n i n f o r m a t i o ni n s i d e t h c o m p u t e r m u s t b r e p r e s e n t e d i e l e c t r i c a l f o r m . B u h o d w r e p r e s e n t i w i t h e l e c t r i c i t y ? H o d w t e l l t h c o m p u t e r w h a t w m e a n ?I t ' s e s s e n t i a l t o h a v e m e t h o d o r e p r e s e n t a t i o n t h a t t h c o m p u t e ru n d e r s t a n d s . O n r e p r e s e n t a t i o n w h i c h t h c o m p u t e r r e c o g n i z e s i p o w e rf l o w — e i t h e r t h p o w e r i o o t h p o w e r i o f f . I w o r k s o t h s a m ep r i n c i p l e a l i g h t b u l b . W h e n t h p o w e r i t u r n e d o n , t h e f i l a m e n t i t h l i g h t b u r n s . I y o c u o f i t p o w e r s o u r c e , t h l i g h t g o e s o u t . T h i s s i m p l ep r o c e s s i f u n d a m e n t a l t t h o p e r a t i o n o t h c o m p u t e r . T h c o m p u t e r i w i r e d i s u c h w a t h a t t h c o n d i t i o n " p o w e r o n h a t h s a m e m e a n i n g a t h v a l u e " 1 " .C o n v e r s e l y , i n p o w e r i f l o w i n g , t h c o m p u t e r r e a d s t h i s a t h v a l u e" 0 " . B e i n g a b l e t d i f f e r e n t i a t e b e t w e e n t h e s e t w s t a t e s l e a d s t s o m ea s t o n i s h i n g e f f e c t s .

1

Page 23: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 23/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 . C o u n t i n g i b i n a r y

T h b i n a r y n u m b e r s y s t e m u s e s o n l y o n e s a n z e r o s f o c o u n t i n g . I t ' s n o e s p e c i a l l y g o o d f o o r d i n a r y u s e — c o u n t i n g a l o u d i b i n a r y f r o m o n t h u n d r e d w o u l d p r o b a b l y t a k e y o s e v e r a l h o u r s . F o r t u n a t e l y , t h c o m p u t e r ' s c i r c u i t i y c a p r o c e s s t h t w d i g i t s o b i n a r y n u m b e r s y s t e mw i t h i n c r e d i b l e s p e e d .

T h e r e a r s e v e r a l c o u n t i n g s y s t e m s : b i n a r y , d e c i m a l , h e x a d e c i m a l , a n o t h e r s . W a l k n o w t h d e c i m a l s y s t e m v e r y w e l l . W a r a c c u s t o m e d t t h i n k i n g i t h d e c i m a l , o b a s e 1 0 s y s t e m . I f a c t , m o s t o u c a h a r d l yi m a g i n e c o u n t i n g a n o t h e r w a y .S w h a t c a w l e a r n f r o m t h i s n e s y s t e m ? T h i n k o d e c i m a l n u m b e r :z e r o , f o i n s t a n c e . I w w a n t l a r g e r n u m b e r , w c a c h o o s e o n e , t w o ,a n s o n I w w a n t n u m b e r l a r g e r t h a n 9 w g t a t w o - d i g i t n u m b e r :1 0

W c a d s o m e t h i n g s i m i l a r w h e n w h a v e o n l y t w o n u m b e r s t w o r kw i t h a i t h b i n a r y s y s t e m . T h f i r s t n u m b e r , a s b e f o r e , i z e r o . T h n e x ti o n e . W d o n ' t h a v e a n m o r e n u m b e r s t h a n t h e s e t w o r k w i t h , s w i m m e d i a t e l y g t t w o - d i g i t n u m b e r . W d e n o t e t h v a l u e t w a 1 0 T h r e e i 1 1 F o t h n u m b e r f o u r w h a v e t a d n e d i g i t p l a c e , a n g e 1 0 0 .

H e r e i t a b l e o b i n a r y n u m b e r s :z e r oo n t w t h r e ef o u rf i v es i s e v e ne i g h t

1 1

1 0 1 0 1 1 1 1

1 0 0 0W m u s t p a y a t t e n t i o n t o t h n u m b e r o p l a c e s i t h i s c o u n t i n g s y s t e m . W c a r e p r e s e n t t w n u m b e r s w i t h o n p l a c e , f o u r n u m b e r s w i t h t w p l a c e s ,e i g h t w i t h t h r e e p l a c e s , s i x t e e n w i t h f o u r p l a c e s , a n s o n T h n u m b e r o n u m b e r s t h a t c a b r e p r e s e n t e d d o u b l e s f o e v e r y p l a c e a d d e d o n . I n o u

1

Page 24: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 24/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

d e c i m a l s y s t e m w k n o w h o p l a c e v a l u e s w o r k . E a c h a d d e d p l a c e i t h d e c i m a l s y s t e m a l l o w s u s t r e p r e s e n t t e t i m e s a m a n y n u m b e r s . W i t h o n p l a c e w c a r e p r e s e n t 1 n u m b e r s , w i t h t w p l a c e s a h u n d r e d , w i t h t h r e ep l a c e t h o u s a n d , a n s o n

T h b i n a r y n u m b e r s y s t e m p r o v e d t b s u s e f u l f o u s w i t h c o m p u t e r st h a t p e o p l e s o o n d e v e l o p e d t e c h n i c a l t e r m s f o d e s c r i b i n g e l e m e n t s o t h i ss y s t e m . s i n g l e p l a c e i c a l l e d d i g i t . S i n c e t h e r e a r e o n l y t w p o s s i b i l i t i e sf o e a c h p l a c e , i i b i n a r y p l a c e . P u t o g e t h e r , w g e t h p h r a s e b i n a r yd i g i t . W r e f e r t o t h i s a b i t .

I o r d e r t m a k e i e a s i e r f o r t h e c o m p u t e r t h a n d l e t h e s e i n d i v i d u a l b i t s ,t h e y a r g r o u p e d i n t o u n i t o e i g h t b i t s — a b y t e . I w e x t e n d o u p r e v i o u st a b l e o b i n a r y n u m b e r s , w w o u l d f i n d t h a t b i t s , o o n b y t e , c a r e p r e s e n t 2 5 v a l u e s .

1 . M e m o r y v a l u e s

T h c o m p u t e r m u s t b a b l e t s t o r e t h e s e n u m b e r s . n u m b e r i r e p r e s e n t e db t h c o m p u t e r a a e l e c t r i c a l c o n d i t i o n , s e q u e n c e o s w i t c h e s t h a t a r o o o f f . S i n c e o n b y t e i s n ' t l o o m e m o r y , w o f t e n r e f e r t c o m p u t e r ' s s t o r a g e c a p a c i t y i k i l o b y t e s , o t h o u s a n d s o f b y t e s . T b p r e c i s e , o n k i l o b y t e r e p r e s e n t s 1 0 2 4 b y t e s . 6 4 , 0 0 0 b y t e m e m o r y i d e s i g n a t e d a 6 4 K .T h r o u g h e l e c t r o n i c s w i t c h i n g i i p o s s i b l e t r e a d t h v a l u e o b y t e , t p r o c e s s t h a t v a l u e , a n t a s s i g n i n e v a l u e . T h a t i t h p o w e r o c o m p u t e r . I t a d v a n t a g e i t h a t i c a c a r r y o u t h e s e o p e r a t i o n s v e r yq u i c k l y , m a k i n g i v e r y u s e f u l d a t a m a n i p u l a t o r .

A l c o m p u t e r m e m o r y h a s a l i m i t e d a r e a i w h i c h t s t o r e d a t a . T h t y p i c a ls i z e f o r t h e w o r k m e m o r y o p e r s o n a l c o m p u t e r w i t h a 8 - b i t p r o c e s s o r i 6 k i l o b y t e s ( o 6 4 f o s h o r t ) . T h n e 1 6 - b i t c o m p u t e r s h a v e w o r km e m o r y b e t w e e n 1 2 a n a b o u t e i g h t m e g a b y t e s . T h o u g h t h C o m m o d o r e 1 2 i a 8 - b i t m a c h i n e , i h a 1 2 o m e m o r y — t h e a m o u n to f s p a c e n e e d e d f o C P / M 3 . 0 . Y o c a n u p g r a d e i t 5 1 2 K i y o d e s i r e .

1

Page 25: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 25/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

Y o m i g h t w o n d e r h o w w e c a s t o r e t e x t i c o m p u t e r , s i n c e i c a o n l ya c c e p t a n o u t p u t n u m b e r s . F o t h i s p u r p o s e , t h c o m p u t e r u s e s ad i c t i o n a r y , s i m i l a r t o n w w o u l d u s t t r a n s l a t e f o r e i g n l a n g u a g e .W i t h i n t h c o m p u t e r i t a b l e t h a t a s s o c i a t e s e v e r y l e t t e r a n c h a r a c t e r w i t h

n u m e r i c v a l u e . W h e n y o t y p e i t h l e t t e r T f o i n s t a n c e , i l o o k s a t h t a b l e a n f i n d s t h r i g h t v a l u e f o T a n c o n v e r t s i i n t o t h i s b i n a r y n u m b e r .T h e n i p r o c e e d s t r e a d t h n e x t c h a r a c t e r . T o u t p u t c h a r a c t e r t t h s c r e e n o p r i n t e r , i r e v e r s e s t h e p r o c e d u r e .

T b e c o m p a t i b l e r e g a r d l e s s o t h b r a n d o m o d e l o u c o m p u t e r ,m a n u f a c t u r e r s h a v e a g r e e d u p o n a s t a n d a r d f o t h t r a n s l a t i o n t a b l e f o r m a t .M o s t c o m p u t e r s u s A S C I I ( A m e r i c a n S t a n d a r d C o d e f o I n f o r m a t i o nI n t e r c h a n g e ) . T h A S C I I c o d e c o n t a i n s 1 2 c h a r a c t e r s , e a c h o w h i c h h a i t o w n u m e r i c v a l u e . A p p e n d i x h a t a b l e l i s t i n g t h e s e A S C I I v a l u e s .

c o m p u t e r ' s m e m o r y , r e g a r d l e s s o s i z e , c a n n o t p e r f o r m w o r k u n l e s st h e r e i s e o c o m m a n d s t o r g a n i z e t h c o m p u t e r ' s w o r k . F o i n s t a n c e ,c o m m a n d m i g h t t a k e d a t a v a l u e i m e m o r y l o c a t i o n a d i t t h v a l u e i m e m o r y l o c a t i o n a n p u t h s u i m e m o r y l o c a t i o n C

T h c o m p u t e r ' s C P ( c e n t r a l p r o c e s s i n g u n i t ) c o n t a i n s m a n y s u c hc o m m a n d s .T c a r r y o u t a p a r t i c u l a r t a s k , t h c o m p u t e r m u s t h a v e a n e x a c t l i s t o c o i t l m a n d s t e l l i n g i w h a t t d o e v e r y s t e p o t h w a y . T h i s l i s t o c o m m a n d s i k n o w n a p r o g r a m . p r o g r a m ' s c o m m a n d s w o r k i s e q u e n c e t g u i d e t h c o m p u t e r t o w a r d i t e n g o a l . T h p r o g r a m m u s t b r e s i d e n t i t h c o m p u t e r ' s m e m o r y t r u n , a n t h e r e f o r e n e e d s m e m o r ys p a c e .

D e p e n d i n g o t h t a s k , s u c h p r o g r a m w i l l b b e t w e e n 1 0 a n 1 2 0 Kl o n g . S o m e t i m e s s m u c h m e m o r y s p a c e i t a k e n u b t h p r o g r a m t h a tt h e r e i n r o o m t s t o r e y o u r d a t a .

1

Page 26: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 26/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 . M a s s S t o r a g e

I t ' s r a r e l y n e c e s s a r y t h a v e a e n t i r e p r o g r a m i t h c o m p u t e r ' s w o r k i n gm e m o r y . U s u a l l y i t ' s s u f f i c i e n t i t h i m p o r t a n t p a r t s a r e i w o r k m e m o r ya n t h r e s t a r i s t o r a g e , r e a d y t b c a l l e d u w h e n n e e d e d . O n o t h w a y s c o m p u t e r d o e s t h i s i w i t h t h o v e r l a y t e c h n i q u e . U s i n g t h i s m e t h o df r e e s u i n t e r n a l m e m o r y , a w e l l a p r o v i d i n g a d d i t i o n a l s p a c e f o t h a tm e m o r y . T h m a s s s t o r a g e d e v i c e c a b f l o p p y d i s k d r i v e o h a r d d i s kd r i v e . E a c h h a i t o w a d v a n t a g e s a n d i s a d v a n t a g e s , b u a l p r o v i d e l a r g ea m o u n t s o s p a c e f o d a t a , a n c a n e x c h a n g e t h a t d a t a w i t h t h c o m p u t e r i

r e a s o n a b l e a m o u n t o t i m e .

1 . 8 . 1 T h F l o p p y D i s k e t t eT h f l o p p y d i s k e t t e , a l s o r e f e r r e d t o a s f l o p p y o r d i s k , i m a d e o u o m a t e r i a l s i m i l a r t m a g n e t i c t a p e s . I i t h i n d i s k w i t h f i n e l y p o l i s h e d ,h i g h - d e n s i t y m a g n e t i c s u r f a c e . F l o p p y s a r e n c l o s e d i j a c k e t s t p r o t e c t t h ed i s k f r o m s m a l l c o n t a m i n a n t s l i k e d u s t , d i r t a n f i n g e r p r i n t s . A e l e c t r o n i cr e a d - w r i t e h e a d o t h d i s k d r i v e m o v e s a l o n g t h d i s k ' s s u r f a c e a n m a g n e t i z e s o d e m a g n e t i z e s d i f f e r e n t a r e a s .

W i t h d i s k w a g a i n f i n d t w s t a t e s : m a g n e t i z e d , o n o m a g n e t i z e d .T h e r e ' s g o o d r e a s o n f o t h i s . T h d a t a r e p r e s e n t e d i t h c o m p u t e r a e l e c t r i c a l s t a t e s c a b d i r e c t l y t r a n s f e r r e d t t h f l o p p y . D a t a i w r i t t e n t t h f l o p p y i a b i n a r y t e c h n i q u e , a m a g n e t i z e d a n n o n - m a g n e t i z e d s p o t so t h e f l o p p y , a n i l a t e r r e a d b a c k b y t h c o m p u t e r i l i k e m a n n e r . I b i i O N t h w r i t e h e a d m a k e s a s m a l l s p o t o t h d i s k s u r f a c e m a g n e t i c . I t h n e x t b i i O F F , n o t h i n g i w r i t t e n o t h f l o p p y d i s k . T h i s c o r r e s p o n d sd i r e c t l y w i t h d a t a r e p r e s e n t a t i o n w i t h i n t h c o m p u t e r i t s e l f .

T h f l o p p y d i s k e t t e s p i n s r a p i d l y o i t a x i s , m a k i n g 2 0 t 3 0 r e v o l u t i o n sp e m i n u t e . T o r g a n i z e t h d a t a o t h m a g n e t i c s u r f a c e , t h d i s k i d i v i d e di n t o n u m b e r o t r a c k s , w h i c h l i n e x t t e a c h o t h e r l i k e l a n e s o a a t h l e t i ct r a c k .

I w w a n t t p u t d a t a o t h d i s k , t h w r i t e h e a d m o v e s o v e r p a r t i c u l a rt r a c k a n w r i t e s t h e d a t a t i t

T r e d u c e t h t i m e n e e d e d t r e a d a n w r i t e t d i f f e r e n t t r a c k s , t h d i s k i d i v i d e d o n c e a g a i n , i n t o s e c t o r s . T h e s e s e c t o r s a r b e t w e e n 1 2 a n 1 0 2 4b y t e s l o n g , d e p e n d i n g o t h m a n u f a c t u r e r . T h C o m m o d o r e 1 2 u s e s a

1

Page 27: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 27/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

d i f f e r e n t f l o p p y f o r m a t i t h C P / M m o d e , t m a k e i c o m p a t i b l e w i t hs e v e r a l d i f f e r e n t C P / M v e r s i o n s . W e ' l l d i s c u s s t h e s e d i f f e r e n t f o r m a t s l a t e r .

U n f o r t u n a t e l y , d i s k d r i v e s f r o m o n e c o m p u t e r m a n u f a c t u r e r a r e n ' tn e c e s s a r i l y c o m p a t i b l e w i t h a n o t h e r m a n u f a c t u r e r ' s d i s k d r i v e s . E v e r yc o m p u t e r m a k e r u s e s t h e i r o w f o r m a t , m u c h t t h c h a g r i n o u s e r s . A p p l ei e s p e c i a l l y a d e p t a f r u s t r a t i n g p r o g r a m m e r s w i t h i t i n c o m p a t i b l e d r i v e s .F o t h e s e r e a s o n s , f l o p p y d i s k s c a n ' t b e u s e d s t r a i g h t o u o t h b o x . T h e ym u s t f i r s t b f o r m a t t e d b e f o r e t h e y c a n b e u s e d . E a c h c o m p u t e r h a i t o w s p e c i a l p r o g r a m t w r i t e t t h o s e p a r t i c u l a r d i s k t r a c k s a n s e c t o r s t h a t t h c o m p u t e r w i l l u s e .

Y o u ' v e g o t b c a r e f u l t m a k e s u r e y o d o n ' t r e f o r m a t d i s k s c o n t a i n i n gi m p o r t a n t d a t a . F o r m a t t i n g d e s t r o y s a l t h d a t a a l r e a d y o d i s k e t t e . I t ' sg o o d i d e a t p u a w r i t e p r o t e c t t a o t h n o t c h o f v a l u a b l e d a t a d i s k s .T h e s e t a b s a r e t h e s m a l l s t i c k e r s p a c k e d i e v e r y b o o d i s k s . T h e y c a s a v e y o u f r o m t h e x t r e m e f r u s t r a t i o n o s e e i n g h o u r s o w o r k w i p e d o u b i n a d v e r t e n t r e f o r m a t t i n g .

B t h w a y , i i s m a r t a l w a y s t h a v e b a c k u p c o p y f o a l i m p o r t a n t d a t as t o r e d a w a y , s o m e p l a c e w h e r e c h i l d r e n , d o g s , c a t s , f i r e , t h i e v e s ,s n o w s t o r m s , a n t h l i k e c a n ' t h a r m t h e m . E v e n i y o d o n ' t k e e p y o u rd i a m o n d j e w e l r y i s a f e , a t l e a s t l o c k u y o u r b a c k u p c o p i e s . T h e y a r r e a l l y t h a t i m p o r t a n t t y o u r p r o g r a m m i n g . I y o n e e d h e l p m a k i n g C P / Mb a c k u p s a n o t h e r c o p i e s , s k i p a h e a d t t h n e x t c h a p t e r f o m o m e n tA t h p r e s e n t t i m e t h e r e a r l o o d i f f e r e n t d i s k f o r m a t s o t h m a r k e t .F o i n s t a n c e , y o c a s t i l l f i n d t h e o l 8 d i s k e t t e s , a o n t i m e h a i l e d a t h s t a t e - o f - t h e - a r t i d a t a p r o c e s s i n g . T h 1 / 4 " d i s k s a r e e s p e c i a l l y p o p u l a r ,w i d e l y u s e d b y p e r s o n a l c o m p u t e r u s e r s . T h i s f o r m a t i h a n d y a n dd e p e n d i n g o t h c o m p u t e r , y o c a f i u t t w M e g a b y t e s o t h e m .T h a n 1 / 2 " m i c r o - d i s k e t t e s f r o m J a p a n p r o m i s e e v e n m o r ec o n v e n i e n c e t h a n t h 1 / 4 " d i s k e t t e s . T h e s e d i s k s h a v e m e t a l f l a p t h a tc l o s e s a c c e s s t t h e a c t u a l d i s k s u r f a c e w h e n n o i u s e . T h i s p r e v e n t sa l m o s t a l c o n t a m i n a n t s f r o m r e a c h i n g t h m a g n e t i c s u r f a c e . A l s o , t h e y h a v e

s t i f f p l a s t i c j a c k e t t h a t p r e v e n t s d a m a g e d u t a c c i d e n t a l b e n d i n g , f o l d i n ga n o t h e r f o r m s o u s e r a b u s e .

1

Page 28: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 28/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

1 . 8 . 2 T h h a r d d i s kA n o t h e r t y p e o f m a s s s t o r a g e d e v i c e i t h h a r d d i s k d r i v e . U s e dp r e d o m i n a n t l y w i t h b u s i n e s s c o m p u t e r s , h a r d d i s k h a t h s a m em e a s u r e m e n t s a a 1 / 4 " f l o p p y d i s k ( a l t h o u g h t h e r e a r e a l s o l / 2 ! l h a r dd i s k d r i v e s ) . T h e y c a n n o t b i n s e r t e d a n e j e c t e d a w i t h n o r m a l f l o p p yd i s k s . T h i s i b e c a u s e h a r d d i s k s a r p e r m a n e n t l y e n c l o s e d i t i g h t l ys e a l e d h o u s i n g , a l l o w i n g m o r e p r e c i s i o n a n h e n c e i n c r e a s e d r o t a t i o ns p e e d s . T h s p i n n i n g m a g n e t i c d i s k m a k e s a b o u t 3 0 0 0 r o t a t i o n s p e m i n u t ea t h e r e a d / w r i t e h e a d g l i d e s o v e r t h d i s k s u r f a c e . d u s t o r s m o k e p a r t i c l eo t h d i s k s u r f a c e w o u l d a f f e c t t h h a r d d i s k l i k e a s m a l l r o c k o y o u rs t e r e o t u r n t a b l e .

T h s t a n d a r d m e m o r y c a p a c i t y o t h h a r d d i s k d r i v e s f a h a b e e n t h 1 M B y t e ( m e g a b y t e o m i l l i o n s o b y t e s ) d r i v e . B u t h 2 M h a r d d i s kd r i v e i s t a r t i n g t g a i n p o p u l a r i t y a i t p r i c e d r o p s .I n a d d i t i o n t i t e s p e c i a l l y l a r g e s t o r a g e c a p a c i t y , t h h a r d d i s k d r i v e o f f e r sa n o t h e r d e c i d e d a d v a n t a g e — i t s c a n s t o r e a n r e t r i e v e d a t a a b o u t 2 t i m e sf a s t e r t h a n t h f l o p p y d i s k e t t e d r i v e . A n t h o n l y r e a l d i s a d v a n t a g e o f h a r dd i s k d r i v e s i t h e i r s t e e p p r i c e t a g s . T h e y c o s t f r o m $ 8 0 0 t o v e r $ 5 0 0 0 .

1 . S u m m a r yH o p e f u l l y y o u V e g a i n e d a u n d e r s t a n d i n g o t h f u n d a m e n t a l c o m p o n e n t so f c o m p u t e r s y s t e m a n t h e i r o p e r a t i o n . H e r e ' s a q u i c k r e v i e w :

c o m p u t e r i a e l e c t r o n i c c a l c u l a t i n g m a c h i n e t h a t u s e s ak e y b o a r d a n d a m o n i t o r s c r e e n a i n p u t a n o u t p u t d e v i c e s .

p r i n t e r i a n o t h e r o u t p u t d e v i c e u s e d t m a k e p e r m a n e n tc o p i e s o c o m p u t e r ' s d a t a . T h c a t e g o r i e s o p r i n t e r si n c l u d e d o t - m a t r i x , d a i s y w h e e l , i n k - j e t , a n t h e r m a lp r i n t e r s , e a c h w i t h t h e i r o w a d v a n t a g e s a n d i s a d v a n t a g e s .

T h c o m p u t e r w o r k s w i t h b i n a r y n u m b e r s . T h b i n a r ys y s t e m i n c l u d e s o n l y t h n u m b e r s o n e a n d z e r o . c o m p u t e rg r o u p s b i n a r y d i g i t s , o b i t s , i n t o b i n a r y v a l u e s .

F l o p p y d i s k s a n h a r d d i s k s a r e e x t e r n a l s t o r a g e d e v i c e s .

I t h n e x t c h a p t e r w e l l e x a m i n e t h o p e r a t i n g s y s t e m a n i t f u n c t i o n s .

1

Page 29: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 29/316

C h a p t e r T w

T h O p e r a t i n g S y s t e m

2 . W h a t i a p r o g r a m ?2 . O p e r a t i n g s y s t e m s2 . C P / M ' s t a s k2 . 4 D i f f e r e n t C P / M v e r s i o n s2 . T h C P / M p r o m p t2 . P l a y i n g i s a f e2 . S u m m a r y

Page 30: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 30/316

Page 31: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 31/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h o p e r a t i n g s y s t e m

I t h p r e v i o u s c h a p t e r w t o o k q u i c k l o o k a t h c o m p u t e r ' sh a r d w a r e — t h e i n d i v i d u a l c o m p o n e n t s o a c o m p u t e r . I a n o i t s e l f ,c o m p u t e r h a r d w a r e h a v e r y l i t t l e v a l u e . T h a t ' s b e c a u s e c o m p u t e r c a n ' ti n i t i a t e a n u s e f u l a c t i v i t y . c o m p u t e r b e c o m e s v a l u a b l e w h e n i i a b l e t r u i m p o r t a n t , u s e f u l p r o g r a m s . T h a t i w h w n e e d s o f t w a r e . W h e nt a l k i n g a b o u t s o f t w a r e , w m u s t m a k e s o m e d i f f e r e n t i a t i o n s .W e ' l l d i s c u s s t w s o f t w a r e t y p e s : t h o p e r a t i n g s y s t e m a n t h p r o g r a m s .Y o s h o u l d k e e p i i t h b a c k o y o u r m i n d t h a t t h o p e r a t i n g s y s t e m i p r o g r a m , t o o . T h d i f f e r e n t i a t i o n i m i n e . I a r i s e s f r o m t h f u n c t i o n o t h t w t y p e s o s o f t w a r e .

W r e g u l a r l y h e a r i n e x p e r i e n c e d p e o p l e w h a r i n t e r e s t e d i c o m p u t e r sa s k : " C a n i a l s o d w o r d p r o c e s s i n g ? " T h e s e p e o p l e d o n ' t u n d e r s t a n d t h d i f f e r e n c e b e t w e e n p r o g r a m a n a o p e r a t i n g s y s t e m . T h e r e f o r e w w i l le x p l a i n i t i c a s e y o a r a s k e d t h q u e s t i o n s o m e t i m e .

1

Page 32: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 32/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

2 . W h a t i p r o g r a m ?

E s s e n t i a l l y , p r o g r a m i l i s t o t a s k s w h i c h t h c o m p u t e r p e r f o r m ss e q u e n t i a l l y , o n a f t e r t h o t h e r . T h e s e t a s k s a r e s p e c i f i e d a s i n s t r u c t i o n st h a t t h c o m p u t e r c a u n d e r s t a n d . S i n c e t h c o m p u t e r i m a c h i n e , t h i sl a n g u a g e i c a l l e d m a c h i n e l a n g u a g e . P r o g r a m s w r i t t e n i m a c h i n e l a n g u a g ea r i n c o m p r e h e n s i b l e t m o s t " n o r m a l 1 1 p e o p l e , b u t h c o m p u t e r l i k e s t h e m .S i n c e m a c h i n e l a n g u a g e i w r i t t e n i w a t h a t t h c o m p u t e r c a u n d e r s t a n d , i p e r f o r m s t h e s e i n s t r u c t i o n s v e r y q u i c k l y .T o m a k e p r o g r a m m i n g e a s i e r f o r u " n o r m a l " p e o p l e , o t h e r p r o g r a m m i n gl a n g u a g e s a r a v a i l a b l e . A m o n g t h e s e a r B A S I C , C O B O L , F O R T R A N ,P a s c a l , a n M o d u l a - 2 . T h e s e l a n g u a g e s h a v e c o m m a n d s o r s t a t e m e n t sw h i c h a r m o r e u n d e r s t a n d a b l e t h a n m a c h i n e l a n g u a g e i n s t r u c t i o n s . T h e s eh i g h - l e v e l c o m m a n d s a r e t r a n s l a t e d o c o n v e r t e d i n t o m a c h i n e l a n g u a g ei n s t r u c t i o n s b e f o r e t h c o m p u t e r c a r r i e s t h e m o u t .

A n p r o g r a m i n o t h i n g m o r e t h a n s e q u e n c e o m a c h i n e l a n g u a g ei n s t r u c t i o n s o h i g h - l e v e l c o m m a n d s . W h e n y o w r i t e p r o g r a m i B A S I Cf o t h e 1 2 8 , y o a r n o w r i t i n g a n o t h i n s t r u c t i o n s t h a t t h c o m p u t e ra c t u a l l y c a r r i e s o u t . l a r g e n u m b e r o s m a l l t a s k s a r e p e r f o r m e d b t h c o m p u t e r w i t h o u t y o u r k n o w l e d g e . F o e x a m p l e , t h c o m p u t e r m u s td e t e r m i n e w h i c h k e o t h k e y b o a r d w a p r e s s e d , w h i c h c h a r a c t e r i t a p p e a r o t h e s c r e e n , o w h a t d a t a i t b r e a d f r o m t h d i s k d r i v e .T h c o m p u t e r s p e n d s g r e a t d e a l o t i m e p e r f o r m i n g t h e s e t y p e s o a c t i v i t i e s . T w r i t e t h i n s t r u c t i o n s t o p e r f o r m t h e s e t h i n g s f o e a c h a n e v e r y p r o g r a m i c u m b e r s o m e .

2

Page 33: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 33/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

2 . O p e r a t i n g s y s t e m s

T h e r e i b e t t e r w a t p r o g r a m t h c o m p u t e r a n d a v o i d r e p e t i t i v e w o r k .W c a d i v i d e t h p r o g r a m i n t o m a i n p r o g r a m a n " o f t e n - u s e d r o u t i n e s . "T h m a i n p r o g r a m p e r f o r m s t a s k s s u c h a s p r i n t c u s t o m e r i n v o i c e o r d i a ln u m b e r u s i n g a m o d e m . T h " o f t e n - u s e d r o u t i n e s ' 1 p e r f o r m t a s k s s u c h a s c a n n i n g t h k e y b o a r d f o p r e s s e d k e o r c o n v e r t i n g a v a l u e i m e m o r y t a A S C I I c h a r a c t e r .

C o l l e c t i v e l y t h e s e " o f t e n - u s e d r o u t i n e s " c a p e r f o r m a l o t h e l o w - l e v e l ,f r e q u e n t l y u s e d t a s k s t h a t m o s t p r o g r a m s r e q u i r e . T h i s i t h e n c a l l e d a o p e r a t i n g s y s t e m .

T h o p e r a t i n g s y s t e m p r o v i d e s s t a n d a r d i z e d m e t h o d f o p r o g r a m s t u s t h c o m m o n l y u s e d f u n c t i o n s . T h m a j o r t a s k o t h o p e r a t i n g s y s t e m i t h a n d l e t h d a t a t r a n s m i s s i o n b e t w e e n t h c o m p u t e r a n t h p e r i p h e r a l s .I C P / M m o d e , t h 1 2 u s e s v e r y w e l l - k n o w n o p e r a t i n g s y s t e m . C P / M i t h a c r o n y m f o C o n t r o l P r o g r a m f o M i c r o p r o c e s s o r s . C P / M w o r k s o n8 0 8 0 , 8 0 8 5 , a n Z 8 m i c r o p r o c e s s o r s .

2

Page 34: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 34/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

2 . C P / M ' s t a s k

C P / M h a n d l e s t h e b a s i c t a s k s o a c c e p t i n g i n p u t o c h a r a c t e r s , o u t p u t t i n gc h a r a c t e r s , m a n a g i n g t h s t o r a g e a r e a s o t h d i s k d r i v e , a n r e a d i n g f r o mo w r i t i n g t o d i s k s . T h e s e r o u t i n e s c a b e u s e d i s t a n d a r d i z e d w a i a l a p p l i c a t i o n s p r o g r a m s .S i n c e t h i s i t r u e , C P / M m u s t d o i t j o i t w d i f f e r e n t m o d e s . I i d i v i d e di n t o t w l a r g e s e c t i o n s . T h f i r s t s e c t i o n , B D O S ( B a s i c D i s c O p e r a t i n gS y s t e m ) t a k e s c a r e o a l t h t a s k s w h i c h a r m a c h i n e i n d e p e n d e n t .s e c o n d p a r t o t h C P / M o p e r a t i n g s y s t e m i B I O S ( B a s i c I n p u t / O u t p u tS y s t e m ) . B I O S h a n d l e s t h p r o g r a m s e c t i o n s w h i c h a r m a c h i n e d e p e n d e n tE v e r y c o m p u t e r h a i t o w m e t h o d s o c a r r y i n g o u s p e c i f i c t a s k s .C o n s e q u e n t l y , w c a n ' t s i m p l y t a k e t h o p e r a t i n g s y s t e m f r o m o n c o m p u t e r a n d r u i o a n o t h e r . B e f o r e a o p e r a t i n g s y s t e m i a b l e t r u o d i f f e r e n t c o m p u t e r h a r d w a r e , n e B I O S m u s t b p r o d u c e d f o t h c o m p u t e r , s i n c e B I O S i d e p e n d e n t o t h c o m p u t e r ' s h a r d w a r e . Y o s h o u l d n ' t h a v e a n p r o b l e m w i t h y o u r C - 1 2 8 , s i n c e i t ' s f i t t e d w i t hf u n c t i o n i n g o p e r a t i n g s y s t e m .

2 . D i f f e r e n t C P / M v e r s i o n s

M o s t p r o g r a m s t h a t h a v e b e e n o t h c o m p u t e r m a r k e t f o a n l e n g t h o t i m e h a v e i m p r o v e m e n t s m a d e o t h e m . U s u a l l y n e v e r s i o n s a r r e l e a s e d .T h e r e a r n p e r f e c t p r o g r a m s , s s o m e o f a p r o g r a m ' s e r r o r s m a c r e e p i w h e n u s e r s t r i o u a n t e s t a l i t c a p a b i l i t i e s .W h e n t h s o f t w a r e p u b l i s h e r d i s c o v e r s p r o g r a m e r r o r s , a n t h e r r o r s a r c o r r e c t e d , n e v e r s i o n o t h p r o g r a m i u s u a l l y m a d e a v a i l a b l e . O n v e r s i o n , C P / M 2 . 2 , i p r a c t i c a l l y e r r o r - f r e e . I t i s t h s t a n d a r d o p e r a t i n gs y s t e m f o m a n y 8 - b i t c o m p u t e r s . T h n e w e r v e r s i o n C P / M 3 . i s n ' t j u s t a u p g r a d e t e l i m i n a t e e r r o r s , b u t a n e v e r s i o n w i t h n e f e a t u r e s . T h n e v e r s i o n i a i m e d a m a i n t a i n i n g t h l i f e o C P / M w i t h n e c o m p u t e r s a n dn e c o m p u t e r p r o g r a m m i n g m e t h o d s .

2

Page 35: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 35/316

A b a c u s S o f t w a r e c . 1 2 8 C P / M U s e r ' s G u i d e

2 . T h C P / M p r o m p t

L e t ' s l e a v e t h t h e o r y a n t a l k a b o u t t h C - 1 2 8 a n d t h C P / M o p e r a t i n gs y s t e m . T g e t h m o s t f r o m o u d i s c u s s i o n s y o u ' l l n e e d f u n c t i o n i n g1 2 8 , 1 5 7 1 f l o p p y d i s k d r i v e , a n d i s k e t t e w i t h t h C P / M o p e r a t i n gs y s t e m o i t

T u r n o n t h c o m p u t e r , i n s e r t t h d i s k e t t e w i t h t h C P / M o p e r a t i n g s y s t e m i d r i v e a n s h u t t h d r i v e ' s d o o r . P a a t t e n t i o n t t h i s s e q u e n c e . I y o t u r nt h c o m p u t e r o o o f w i t h a d i s k e t t e i t h d r i v e , p o w e r s u r g e f r o m t h r e a d / w r i t e h e a d c o u l d m a k e y o u r d i s k e t t e u n r e a d a b l e — a n d u n u s a b l e .N o y o u ' v e g o t y o u r c o m p u t e r ' s p o w e r o a n d y o u r C P / M s y s t e m d i s k e t t ei t h d r i v e . T h e r e a r s e v e r a l m e t h o d s t s t a r t C P / M o t h C o m m o d o r e1 2 8 . F i r s t , y o c o u l d s h u t o f t h p o w e r , i n s e r t t h C P / M s y s t e m d i s k e t t ea n t u r n o t h c o m p u t e r a g a i n . A m e n t i o n e d a b o v e , t h i s i s n ' t t h s a f e s tw a y . A n o t h e r , m u c h s a f e r w a i t t u r n t h c o m p u t e r o n i n s e r t t h d i s k e t t e , a n t h e n p r e s s t h R E S E T b u t t o n .

T h l a s t w a y , w h i c h i s n ' t m u c h m o r e c o m p l i c a t e d , i t i n s e r t t h d i s k e t t ea n t h e n e n t e r t h c o m m a n d :

B O O T < R E T U R N >P r e s s i n g t h R E S E T b u t t o n i t h e u s u a l m e t h o d o e n t e r i n g C P / M m o d e ,s i n c e i i t h m o s t d e p e n d a b l e a n f a s t e s t .

T h d i s k d r i v e w i l l b e g i n t r e a d t h d i s k e t t e , i t l i g h t w i l l g o n a n s h o r t l y t h e r e a f t e r y o s e m e s s a g e o t h e s c r e e n . T h s t a r t m e s s a g e l o o k ss o m e w h a t d i f f e r e n t o e v e r y m a c h i n e . T h a t i b e c a u s e t h m e s s a g e c o m e sf r o m t h B I O S p a r t o t h o p e r a t i n g s y s t e m a n v a r i e s f r o m c o m p u t e r t c o m p u t e r . B e f o r e t h C o m m o d o r e s t a r t m e s s a g e c o m e s o s c r e e n , y o u ' l ls e t h m e s s a g e B o o t i n g . . . , t h e n i b l u e t e x t , B o o t i n g C P / M P l u s .A y o k n o w , t h C o m m o d o r e 1 2 c a u s e i t h e r 4 0 - c o l u m n o a 8 0 - c o l u m n d i s p l a y . I t n i c e t w o r k w i t h a 8 0 - c o l u m n s c r e e n , b u C P / Ma l s o s u p p o r t s 4 0 - c o l u m n d i s p l a y . W i t h t h 4 0 / 8 0 d i s p l a y k e y o c a c h o o s e b e t w e e n w i t h t h 4 0 - o r 8 0 - c o l u m n s c r e e n ( p r o v i d i n g y o h a v e t h p r o p e r m o n i t o r ) . T h i n i t i a l m e s s a g e a p p e a r s o e i t h e r s c r e e n . A f t e r t h C P / M p r o m p t , o n l y o n d i s p l a y i a c t i v e .

2

Page 36: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 36/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 0 - c o l u m n s c r e e n s i m u l a t e s a 8 0 - c o l u m n d i s p l a y . B u s i n g< C O N T R O L > - a n < C O N T R O L > < y o c a s h i f t t h s c r e e n .T h r o u g h o u t t h i s b o o k , w a s s u m e t h a t y o a r u s i n g a 8 0 - c o l u m n s c r e e n .

I y o s e t h m e s s a g e :N O C P / M + . S Y S F i l e H I R E T U R N T R E T R YD E T E N T E R C 1 2 8 M O D E

t h e n y o m u s t h a v e i n s e r t e d t h C P / M s y s t e m d i s k e t t e u p s i d e d o w n . T u r nt h d i s k e t t e o v e r a n p r e s s t h < R E T U R N > k e y . Y o u r C o m m o d o r e w i l lt h e n b o o t C P / M .T h e r e c a a l s o b d i s k r e a d e r r o r s . I t h e s e c a s e s , t h s c r e e n d i s p l a y s t h em e s s a g e :

R E A D E R R O R H I R E T U R N T R E T R YD E T E N T E R C 1 2 8 M O D E

I y o w a n t t t r t r e b o o t , t h e n p r e s s t h < R E T U R N > k e y . I y o u ' r e t o of r u s t r a t e d t c o n t i n u e , p r e s s t h < D E L > k e y . A l l o t h e r k e y s a r i g n o r e d .I e v e r y t h i n g g o e s a p l a n n e d , f i r s t t h f o l l o w i n g f i v e l i n e s w i l l a p p e a r i t h l o w e r p a r t o t h s c r e e n :

B N K B I O S 3 S P F 4 0 0 0 8 0 0B N K B I O S 3 S P C A 0 0 1 6 0 0R E S B D O S 3 S P E E 0 0 0 6 0 0B N K B D O S 3 S P 9 C 0 0 2 E 0 05 8 T P

T h e s e a r i n f o r m a t i o n m e s s a g e s a b o u t t h B I O S a n B D O S , i . e . , w h e r et h e y a r s t o r e d a n h o l o n g t h e y a r e . T h i s p r o c e e d s r a p i d l y . 5 8 T P m e a n s t h a t 5 K B y t e s o m e m o r y r e m a i n f o p r o g r a m s a n d d a t a . T P m e a n s T r a n s i e n t P r o g r a m A r e a . W h e n t h e s e t h i n g s a r e d o n e , t h f o l l o w i n gf o u r l i n e s a p p e a r o t h u p p e r p a r t o t h s c r e e n :

D A T A T A B L E SC O M M O N C O D EB A N K E D C O D EB I O S 8 5 0 2 C O D E

2

Page 37: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 37/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

W h e n i n f o r m a t i o n f r o m t h d i s k e t t e i l o a d e d , t h n o r m a l C P / M m e s s a g ea p p e a r s o t h e s c r e e n . O t h C o m m o d o r e 1 2 i a p p e a r s l i k e t h i s :

C P / M 3 . O t h C o m m o d o r e 1 2 D E 8 8 c o l u m n d i s p l a y ( o 4 c o l u m n )

Y o u ' v e p r o b a b l y n o t i c e d t h a t t h e r e a r e a l w a y s s o m e n u m b e r s i t h l o w e rr i g h t c o r n e r d u r i n g l o a d i n g . E v e n w h e n t h i n i t i a l m e s s a g e d i s a p p e a r s , t h e s en u m b e r s d o n ' t g a w a y . T h l a s t l i n e o t h s c r e e n i t h s t a t u s l i n e , w h i c hc a n ' t b w r i t t e n o n . T h n u m b e r s i n t h e c o r n e r s h o w w h i c h b l o c k i b e i n gr e a d f r o m o w r i t t e n t o A s t a n d s f o r r e a d i n g f r o m , a n f o r w r i t i n gt b l o c k . F u r t h e r d o w n i a o m e s s a g e , i n d i c a t i n g t h e d i s k d r i v et h a t ' s b e i n g u s e d .

T h s t a t u s l i n e c a n b e t u r n e d o a n o f w i t h t h k e c o m b i n a t i o n< C O N T R O L > < R U N / S T O P > i y o w i s h . ( 8 c o l u m n d i s p l a y o n l y ) .W h a t i y o d o n ' t l i k e t h s c r e e n c o l o r ? N p r o b l e m . B h i t t i n g t h < C O N T R O L > k e y a n d o n e o t h k e y s t h r o u g h 8 y o c a n c h o o s e t h d i s p l a y c o l o r . Y o c a a l s o c h a n g e t h b a c k g r o u n d c o l o r b h i t t i n g t h < C O N T R O L > k e a n o n o t h n u m e r i c a l k e y s t h r o u g h o t h n u m e r i c a l p a d . F o e x a m p l e , i y o w a n t b l a c k p r i n t a n w h i t eb a c k g r o u n d , p r e s s < C O N T R O L > - 1 a n < C O N T R O L > - 2 ( t h e l a t t e rc o m b i n a t i o n f r o m t h n u m e r i c a l k e y p a d ) . T h a t ' s t a k e s c a r e o i t C P / M o t h C o m m o d o r e h a o t h e r p l e a s a n t s u r p r i s e s w a i t i n g f o y o u . ( 8 c o l u m nd i s p l a y o n l y ) .

B a c k t o u s t a r t m e s s a g e a g a i n . T h s t a r t m e s s a g e t e l l s y o t h a t t h C P / Mo p e r a t i n g s y s t e m i s t o r e d c o r r e c t l y i t h c o m p u t e r ' s w o r k m e m o r y . R i g h ta f t e r t h s t a r t m e s s a g e d i s p l a y , C P / M p u t s u r e a d y m e s s a g e — t h eo p e r a t i n g s y s t e m p r o m p t . T h p r o m p t l o o k s l i k e t h i s :

A

T h l a r g e t e l l s y o t h a t y o u ' r e w o r k i n g w i t h d i s k d r i v e o y o u r s y s t e m .T h s y m b o l i t h r e a d y m e s s a g e f r o m C P / M . C P / M e x p e c t s y o t e n t e ry o u r c o m m a n d o t h l i n e w i t h t h p r o m p t s y m b o l . W e l l , t h e n w w o n ' tm a k e C P / M w a i t t o l o n g a n w e ' l l w r i t e :

A > a b c d e f g hN o t h c u r s o r r e m a i n s b e h i n d t h l a s t i n p u t c h a r a c t e r a n d o e s n ' t m o v e .

2

Page 38: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 38/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h r e a s o n i t h a t C P / M d o e s n ' t k n o w w h e t h e r w e ' v e f i n i s h e d e n t e r i n g t h ec o m m a n d o i w s t i l l m i g h t h a v e i n p u t T h a v e t h i n p u t a c c e p t e d , w m u s t t e l l C P / M t h a t w e ' r e d o n e w i t h t h i n p u t .W d t h i s b p r e s s i n g t h < R E T U R N > o < E N T E R > k e y . T h i s i a a b b r e v i a t i o n f o c a r r i a g e r e t u r n , o C R A s o o n a w p r e s s t h i s k e y , t h ec o m p u t e r k n o w s t h a t c o m m a n d h a b e e n g i v e n , a n b e g i n s t c a r r y i o u t .P r e s s t h < R E T U R N > k e y a n d t h f o l l o w i n g a p p e a r s :

A > a b c d e f g hA B C D E F G H ?A

W h a t h a p p e n e d ? C P / M r e a d t h l i n e a n d i n o f i n d f i l e a b c d e f g h , s i l e u k n o w . T h o p e r a t i n g s y s t e m m a k e s u a w a r e o i n c o r r e c t o u n c o m p r e h e n s i b l e c o m m a n d s b r e p e a t i n g t h i n p u t a n f o l l o w e d b q u e s t i o n m a r k . T h q u e s t i o n m a r k m e a n s s o m e t h i n g l i k e , " W h a t i t h i sg a r b a g e ? ! ? c a n ' t d a n y t h i n g w i t h i t . "

W e ' l l t r a g a i n — m a y b e t h l o w e r c a s e l e t t e r s w e r e t h p r o b l e m . A f t e rb o o t i n g y o c a e n t e r c a p i t a l l e t t e r s ( u s i n g < S H I F T > ) . B h i t t i n g t h < S H I F T L O C K > k e y o c a e n t e r c a p i t a l l e t t e r s e v e r y t i m e . B t h w a y ,t h k e < C = > d o e s e x a c t l y t h s a m e t h i n g . P r e s s t h < S H l h l L O C K > k e n o w .

A > A B C D E F G HT h f o l l o w i n g d i s p l a y c o m e s b a c k a a a n s w e r :

A > A B C D E F G HA B C D E F G H ?A

T h o p e r a t i n g s y s t e m d i d n ' t u n d e r s t a n d t h c o m m a n d i c a p i t a l l e t t e r se i t h e r . Y o m i g h t h a v e w o n d e r e d i n t h e p r e v i o u s s a m p l e w h t h c o m m a n dl i n e i r e p e a t e d i c a p i t a l l e t t e r s , e v e n t h o u g h y o e n t e r e d l o w e r c a s e l e t t e r s .T h a t i q u i r k o C P / M t h a t w n e e d t p a a t t e n t i o n t o C P / M c o n v e r t s a l l e t t e r s t o c a p i t a l l e t t e r s a n t h e n i n t e r p r e t s t h i n p u t .T s h o w y o t h a t C P / M c a r e a l l y d s o m e t h i n g , w e ' l l n o e n t e rc o m m a n d t h a t w i l l r e a l l y w o r k . Y o r e a d i a p r e v i o u s s e c t i o n t h a t a e n t r yo t h d i s k e t t e i m a n a g e d b t a b l e o c o n t e n t s . F o t h i s r e a s o n , C P / Mp u t s d i r e c t o r y o e v e r y d i s k e t t e .

2

Page 39: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 39/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

T l o o k a t h t a b l e o c o n t e n t s , w e n t e r t h c o m m a n d d i r , w h i c h i a a b b r e v i a t i o n f o r d i r e c t o r y . E n t e r t h i s c o m m a n d n o a n p r e s s< R E T U R N > :

D I < R E T U R N >s m a l l n o t e : A y o m a k n o w , B A S I C l e t s y o s e t h t a b l e o c o n t e n t s

o t h s c r e e n b p r e s s i n g t h F u n c t i o n k e y . B e c a u s e t h c o d i n g i s n ' t t o d i f f i c u l t , t h i s i a l s o p o s s i b l e i C P / M . S i m p l y p r e s s t h F k e o n c e .P r e s s i n g t h F k e d i s p l a y s t h e t e x t D I o t h s c r e e n , w i t h o u t a a u t o m a t i c < R E T U R N > . W e ' l l t a l k m o r e a b o u t t h i s o p t i o n i l a t e r .

Y o u ' l l s e t h d i r e c t o r y o y o u r o p e r a t i n g s y s t e m d i s k e t t e o t h e s c r e e n .T a k e c l o s e r l o o k . O t h f a l e f t o t h e d i r e c t o r y l i s t i n g , t h d r i v e i d e n t i f i e ro t h d i s k e t t e i d i s p l a y e d . N e x t t t h i s i t h n a m e o t h d a t a , s e p a r a t e df r o m t h e d r i v e n a m e b b l a n k s p a c e s . Y o u ' l l o f t e n s e e t h e a b b r e v i a t i o nC O M , f o e x a m p l e , C C C O M , p i C O M , a n h e l p C O M . T h e s e n a m e sa r e x p l a n a t i o n s o t h e i r c o n t e n t s . R i g h t n o t h C O p r o g r a m s a r i n t e r e s t i n g t u b e c a u s e t h e y c o n t a i n u s a b l e p r o g r a m s .C O i a a b b r e v i a t i o n f o c o m m a n d . T h e s e f i l e s c o n t a i n c o m m a n d s w h i c hc a n b e e x e c u t e d i m m e d i a t e l y . I y o t y p e i t h n a m e o o n o t h e s ep r o g r a m s w i t h o u t t h C O f o l l o w i n g t h o p e r a t i n g s y s t e m p r o m p t , t h p r o g r a m w i l l b p u i n t o t h c o m p u t e r ' s m e m o r y a n r u n . I o t h e r w o r d s ,a l y o h a v e t d i e n t e r p i a n p r e s s < R E T U R N > . T h p r o g r a m t h e nb e g i n s t o r u n .

2

Page 40: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 40/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

2 . P l a y i n g i s a f e

I y o a r s t i l l w o r k i n g w i t h y o u r o r i g i n a l d i s k e t t e , w e ' d l i k e t s u g g e s t t h a ty o m a k e b a c k u p c o p y . Y o s h o u l d g e i t h e h a b i t o m a k i n g b a c k u p s .I t ' s g o o d i d e a t n e v e r w o r k w i t h t h o r i g i n a l p r o g r a m , b u i n s t e a d u s e ac o p y o t h p r o g r a m a n d k e e p t h o r i g i n a l h i d d e n a w a y i s a f e p l a c e . T m a k e i e a s i e r t m a k e b a c k u p c o p i e s , C P / M i n c l u d e s r o u t i n e s f o t h p r o d u c t i o n o b a c k u c o p i e s .

2 . S u m m a r y

Y o k n o w s i m p l e e x p l a n a t i o n o w h a t a o p e r a t i n g u s e s t m a n a g e i t t a s k s .

Y o k n o w w h a t p r o g r a m i a n w h w u s a o p e r a t i n gs y s t e m .

Y o a r e f a m i l i a r w i t h C P / M ' s t a s k s .Y o k n o w w h a t t h C P / M p r o m p t i a n h o t l o o k a t h d i r e c t o r y o y o u r d i s k s .Y o h a v e l e a r n e d t h a t y o s h o u l d m a k e a l e a s t o n b a c k u pc o p y o e v e r y i m p o r t a n t d i s k e t t e .

2

Page 41: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 41/316

C h a p t e r 3

W o r k i n g w i t h C P / M

3 . T h s y s t e m d i s k e t t e3 . C o p y i n g w i t h s i n g l e d i s k d r i v e3 . C o p y i n g w i t h t w d i s k d r i v e s3 . 4 D i s p l a y i n g t h d i r e c t o r y3 . C o p y i n g w i t h P I 3 . R u l e s f o f i l e n a m e s3 . 7 E x t e n s i o n s3 . F i n d i n g d a t a f i l e3 . S e a r c h i n g w i t h q u e s t i o n m a r k ( ? 3 . 1 0 S u m m a r y

Page 42: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 42/316

Page 43: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 43/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

W o r k i n g w i t h C P / M

3 . T h s y s t e m d i s k e t t e

Y o s h o u l d a l w a y s h a v e b a c k u p c o p i e s o y o u r o r i g i n a l d i s k e t t e s . I f a a c c i d e n t d e s t r o y s c o p y , y o u r o r i g i n a l s w i l l s t i l l b u s a b l e . N e x t w e ' l ls h o w y o h o t m a k e b a c k u p c o p y o t h s y s t e m d i s k e t t e .

T w p r o g r a m s a r n e e d e d t m a k e b a c k u p s . T y p e D I < R E T U R N > t d i s p l a y t h e d i s k e t t e ' s d i r e c t o r y . Y o u ' l l f i n d t w p r o g r a m s n a m e d :

F O R M A T . C O M a n P I P . C O MN o r m a l l y , d i s k e t t e c o n t a i n i n g t h C P / M o p e r a t i n g s y s t e m i c o p i e d u s i n gt h C O P Y S Y S c o m m a n d . I y o e n t e r C O P Y S Y S < R E T U R N > o t h C - 1 2 8 k e y b o a r d , y o u ' l l d i s c o v e r t h a t i i i n o p e r a t i v e . I o t h e r C P / Ms y s t e m s , C O P Y S Y S c o p i e s t h s y s t e m t r a c k s — t r a c k s a n 1 w h i c hc o n t a i n m o s t o t h C P / M o p e r a t i n g s y s t e m r o u t i n e s .

U n d e r C o m m o d o r e C P / M , t h F O R M A T c o m m a n d u s e s t r a c k s a n 1 f o r m a t p l a c e s B O O T s e c t o r o t h d i s k e t t e . L a t e r , i t h R E S E T b u t t o n i p r e s s e d o r t h B O O T c o m m a n d i t y p e d ( i C - 1 2 8 m o d e ) w h e n t h i s d i s k e t t ei i n t h e d r i v e , t h C P / M s y s t e m w i l l b l o a d e d a u t o m a t i c a l l y .

U n l i k e o t h e r C P / M s y s t e m s , t h p r o g r a m s o t h s y s t e m t r a c k s a r n a m e d .T h e y a r e : C P M + . S Y a n C C C O M .

T h f i l e C C P . C O M c o n t a i n s C P / M ' s r e s i d e n t c o m m a n d s . R e s i d e n tc o m m a n d s a r o f t e n - u s e d c o m m a n d s t h a t C P / M c a p e r f o r m w i t h o u t h a v i n gt l o a d C O f i l e s f r o m d i s k e t t e . T h e C C P . C O f i l e i l o a d e d d u r i n g b o o t .

3

Page 44: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 44/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . C o p y i n g w i t h s i n g l e d i s k d r i v e

N e x t w e l l s h o w y o h o t m a k e b a c k u p d i s k e t t e i y o h a v e s i n g l ed i s k d r i v e .

I n s e r t y o u r o r i g i n a l C P / M s y s t e m s d i s k e t t e i n t o d r i v e a n c l o s e t h e d o o r .E n t e r :

A > F O R M A T < R E T U R N >T h f o l l o w i n g m e s s a g e i d i s p l a y e d o t h s c r e e n :

C 1 2 8 F O R M A T P R O G R A M1 M a 1 9 8 5D r i v e i 1 5 7 1 ( o 1 5 4 1 )

P l e a s e s e l e c t d i s k t y p e t o f o r m a tC 1 2 8 d o u b l e s i d e dC 1 2 8 s i n g l e s i d e dC 6 s i n g l e s i d e d

Y o c a u s t h c u r s o r k e y s ( u p p e r r i g h t o t h k e y b o a r d ) t s e l e c t o n o t h e t h r e e f o r m a t s . L e t ' s f o r m a t s i n g l e - s i d e d d i s k e t t e . T d t h i s , p r e s s t h ec u r s o r d o w n k e ( u p p e r r i g h t ) a n p r e s s < R E T U R N > . T h f o l l o w i n ga p p e a r s o t h s c r e e n :

F o r m a t t i n g C 1 2 8 s i n g l e s i d e dI n s e r t d i s k e t t e T B F O R M A T T E Di d r i v e A T y p e w h e n r e a d y ,a n y o t h e r k e y t a b o r t

I y o u ' v e c h a n g e d y o u r m i n d , p r e s s a n y k e y e x c e p t t h e $ k e t a b o r t t h p r o g r a m . O t h e r w i s e , p r e s s t h e k e t c o n t i n u e . Y o u ' l l s e e t h f o l l o w i n go t h e s c r e e n :

F o r m a t t i n g C 1 2 8 s i n g l e s i d e dI a n e r r o r o c c u r s , t h e s c r e e n i c l e a r e d , w a r n i n g m e s s a g e i d i s p l a y e d ,a n t h d i s k d r i v e ' s g r e e n L E l i g h t f l a s h e s ( o r e L E o t h e 1 5 4 1 ) . I t h i s h a p p e n s , e x a m i n e t h d i s k e t t e . I m a b d a m a g e d .

3

Page 45: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 45/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I t h e r e w e r e n e r r o r s t h f o l l o w i n g a p p e a r s o t h e s c r e e n :

D y o w a n t t o f o r m a t a n o t h e r d i s k ?P r e s s t h k e y , s i n c e w o n l y n e e d s i n g l e f o r m a t t e d d i s k e t t e f o r n o w .R e m o v e t h f o r m a t t e d d i s k e t t e a n r e i n s e r t t h o r i g i n a l s y s t e m d i s k e t t e -

N e x t c o p y t h t w s y s t e m f i l e s : C P M + . S Y a n C C C O M . T d t h i s , u s t h I c o m m a n d . A w w i l l s e l a t e r , I i v e r y u s e f u l p r o g r a m . F o n o w , e n t e r t h e f o l l o w i n g :

P I E : = A : C P M + . S Y S < R E T U R N >T h f o l l o w i n g m e s s a g e a p p e a r s i t h s t a t u s l i n e :

I n s e r t D i s k i D r i v eR e m o v e t h o r i g i n a l s y s t e m d i s k e t t e f r o m t h d i s k d r i v e a n i n s e r t t h d i s k e t t e w j u s t f o r m a t t e d . T h e n p r e s s < R E T U R N > . T h m e s s a g ed i s a p p e a r s a n t h d i s k d r i v e b e g i n s c o p y i n g C P M + . S Y t t h n e d i s k e t t e . W h e n t h i s i c o m p l e t e d , t h C P / M p r o m p t r e a p p e a r s o t h s c r e e n .N o c o p y C C C O i t h s a m e w a y :

P I E : = A : C C P . C O MC P / M k n o w s t h a t y o s t i l l h a v e t h e d e s t i n a t i o n d i s k e t t e i t h d r i v e .m e s s a g e i t h s t a t u s l i n e a s k s y o t r e p l a c e t h e d i s k e t t e w i t h t h s y s t e md i s k e t t e a g a i n . D s a n p r e s s < R E T U R N > a g a i n . W h e n p r o m p t e d ,r e p l a c e t h s y s t e m d i s k e t t e w i t h t h d i s k s t h a t t h d a t a f i l e C C C O c a b c o p i e d . T d i s p l a y t h t a b l e o c o n t e n t s o t h n e C P / M d i s k e t t e ,e n t e r t h e c o m m a n d D I R . T h e s t a t u s l i n e r e q u e s t s t h a t y o i n s e r t t h d i s k e t t e i t h d r i v e . L e a v e y o u r d i s k e t t e i n t h e d r i v e a n p r e s s < R E T U R N >t c h a n g e t h d i s k e t t e t h n e d i s k e t t e .

T h a t ' s a l t h e r e i t i t T h s c r e e n w i l l d i s p l a y :A C P M - f S Y C C C O

3

Page 46: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 46/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h i s c o m p l e t e s t h f i r s t s t e p . S i n c e w w a n t t m a k e c o p y o t h e n t i r ed i s k e t t e f o b a c k u p , w n e e d t c o p y a l o t h d a t a f i l e s . T d t h i s , e n t e rt h f o l l o w i n g c o m m a n d :

P I E : = A : * . *

P I t e l l s y o w h a t f i l e i b e i n g c o p i e d a i i w o r k i n g . m e s s a g e i t h s t a t u s l i n e r e q u e s t s y o t c h a n g e d i s k e t t e s s e v e r a l t i m e s d u r i n g t h p r o c e d u r e . W h e n y o s e t h i s r e q u e s t , c h a n g e t h d i s k s a i n s t r u c t e d a n p r e s s < R E T U R N > . W h e n P I i t h r o u g h , t h e n t i r e f i r s t s i d e o t h C P / Ms y s t e m d i s k e t t e w i l l h a v e b e e n c o p i e d . T h f o l l o w i n g f i l e s w i l l b o i t

C O P Y I N GC P M + . S Y SC C P . C O MH E L P . C O MH E L P . H L PK E Y F I G . C O MK E Y F I G . H L PF O R M A T . C O MP I P . C O MD I R . C O MC 0 P Y S Y S . C O M

T c o p y t h s e c o n d s i d e ( t h i s i a d v i s e d ) , f o r m a t s e c o n d d i s k e t t e a n e n t e r :

P I E : = A : * . *E v e r y t h i n g e l s e i d i s p l a y e d o t h s c r e e n a a b o v e . A f t e r y o c o p y b o t hs i d e s , p u t h o r i g i n a l s y s t e m d i s k e t t e i s a f e p l a c e . I c o p i e d d i s k e t t e i d e s t r o y e d , y o w i l l s t i l l h a v e b a c k u p f o r t h e C P / M s y s t e m .

3

Page 47: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 47/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . C o p y i n g w i t h t w d i s k d r i v e s

I y o h a v e t w d i s k d r i v e s , y o c a c o p y d a t a f i l e s m u c h f a s t e r a n m o r ec o n v e n i e n t l y . Y o m u s t f i r s t f o r m a t d i s k e t t e . M a k e s u r e t h a t t h s y s t e md i s k e t t e i i d r i v e a n e n t e r :

A > F O R M A T < R E T U R N >T h f o l l o w i n g m e s s a g e i d i s p l a y e d o t h e s c r e e n :

C 1 2 8 F O R M A T P R O G R A M1 M a 1 9 8 5D r i v e i s 1 5 7 1 ( o 1 5 4 1 )

P l e a s e s e l e c t d i s k t y p e t o f o r m a tC 1 2 8 d o u b l e s i d e dC 1 2 8 s i n g l e s i d e dC 6 s i n g l e s i d e d

Y o c a u s t h c u r s o r k e y s i t h f i r s t r o o k e y s t s e l e c t o n o t h t h r e e f o r m a t s . L e t ' s f o r m a t s i n g l e - s i d e d d i s k e t t e . T d t h i s , p r e s s t h ec u r s o r d o w n k e ( o t h u p p e r r o o k e y s ) a n p r e s s < R E T U R N > . T h f o l l o w i n g a p p e a r s o t h e s c r e e n :

F o r m a t t i n g C 1 2 8 s i n g l e s i d e dI n s e r t d i s k e t t e T B F O R M A T T E Di d r i v e A T y p e w h e n r e a d y ,a n y o t h e r k e y t a b o r t

I y o u ' v e c h a n g e d y o u r m i n d , p r e s s a n y k e y e x c e p t t h k e t a b o r t t h p r o g r a m . O t h e r w i s e , p r e s s t h k e t c o n t i n u e . Y o u ' l l s e e t h e f o l l o w i n go t h s c r e e n :

F o r m a t t i n g C 1 2 8 s i n g l e s i d e dI a n e r r o r o c c u r s , t h e s c r e e n i c l e a r e d , w a r n i n g m e s s a g e i d i s p l a y e d ,a n t h d i s k d r i v e ' s g r e e n L E l i g h t f l a s h e s ( o r e L E o t h e 1 5 4 1 ) . I t h i s h a p p e n s , e x a m i n e t h d i s k e t t e . I m a b d a m a g e d .

3

Page 48: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 48/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I t h e r e w e r e n e r r o r s t h f o l l o w i n g a p p e a r s o t h s c r e e n :

D o y o u w a n t t o f o r m a t a n o t h e r d i s k ?F o n o w , p r e s s t h e k e y , s i n c e w o n l y n e e d s i n g l e f o r m a t t e d d i s k e t t e .

A f t e r t h f o r m a t t i n g i c o m p l e t e , r e p l a c e t h f o r m a t t e d d i s k e t t e w i t h t h s y s t e m d i s k e t t e . I n s e r t t h f o r m a t t e d d i s k e t t e i n t o t h d r i v e . N o e n t e r :

P I B : = A : * . * < R E T U R N >T h c o p y i n g p r o c e e d s w i t h o u t a n d i s k e t t e c h a n g e r e q u e s t s .

3 . D i s p l a y i n g t h d i r e c t o r y

Y o h a v e j u s t c o p i e d d a t a f r o m d r i v e t d r i v e B T v e r i f y t h c o n t e n t s o t h d i s k e t t e i d r i v e B , e n t e r :

D I B

D o n ' t f o r g e t t i n s e r t s p a c e a f t e r D I R . T h c o m m a n d a b o v e t e l l s C P / M t d i s p l a y t h c o n t e n t s o t h d i s k e t t e i n d r i v e B I y o d i s p l a y t h e c o n t e n t s o a e m p t y f o r m a t t e d d i s k e t t e , t h m e s s a g e N O F I L E i d i s p l a y e d . T h i sm e a n s t h a t t h d i s k e t t e c o n t a i n s n d a t a .

3

Page 49: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 49/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . C o p y i n g w i t h P I

U s u a l l y P I i u s e d t c o p y d a t a f i l e s w i t h t w o - d r i v e s y s t e m s . B u t h i sc o m m a n d w o r k s d i f f e r e n t l y o t h C o m m o d o r e 1 2 8 . W c a u s v i r t u a ld i s k d r i v e b s p e c i f y i n g d r i v e E T h i s d r i v e d o e s n ' t p h y s i c a l l y e x i s t , b u i r e c o g n i z e d b t h c o m p u t e r . D r i v e p h y s i c a l l y u s e s d r i v e A b a l t e r n a t i n gd i s k e t t e s . B e f o r e s t a r t i n g , y o s h o u l d n o t e w h i c h d i s k e t t e w i l l b t h d r i v e a n w h i c h d i s k e t t e w i l l b t h d r i v e . ( T h i s v i r t u a l m e m o r y t r i c kw o r k s w i t h m o r e t h a n j u s t I P b t h w a y . W e l l t a l k m o r e a b o u t i t u s e sl a t e r ) .

T h p i p r o g r a m i a a c r o n y m f o P e r i p h e r a l I n t e r c h a n g e P r o c e s s o r , a n c a b a v e r y u s e f u l p r o g r a m f o u s

Y o h a v e t h s y s t e m d i s k e t t e i n t h d i s k d r i v e a t t h i s t i m e . N o t y p e P I a n p r e s s < R E T U R N > . T h c o m p u t e r l o a d s t h P I p r o g r a m i n t om e m o r y . P I d i s p l a y s i t o w p r o m p t :

A > P I PC P / M P I V E R S I O N 3 .

T h a s t e r i s k s h o w s y o t h a t P I i r e a d y t a c c e p t c o m m a n d s . Y o u ' l l g e ta i n - d e p t h l o o k a t h f u l l r a n g e o P I c o m m a n d s i C h a p t e r 6

L e t ' s u s P I a g a i n . H e r e ' s o u t a s k : C o p y t h f i l e s f r o m t h d i s k e t t e i nd r i v e t t h d i s k e t t e i d r i v e ( o d r i v e E , i y o o n l y h a v e o n e d i s kd r i v e ) . A a l t e r n a t e w a o f s a y i n g t h i s i s T h d i s k e t t e i d r i v e s h o u l dr e c e i v e t h c o n t e n t s o t h f i l e s c o n t a i n e d o t h d i s k e t t e i d r i v e A

W h d i w r e p h r a s e o u g o a l f o r t h e t a s k ? B e c a u s e P I r e q u i r e s u t e n t e r c o m m a n d s i s i m i l a r w a y . W h e n t h f i l e s o t h d i s k e t t e i d r i v ea r c o p i e d t t h d i s k e t t e i d r i v e B b o t h d i s k e t t e s h a v e i d e n t i c a l c o n t e n t s .Y o u l l n o t i c e t h a t t h c o m m a n d s c o n t a i n a e q u a l s i g n . A n o t h e r w a t s t a t et h c o m m a n d P I B = A i " m a k e t h c o n t e n t s o t h d i s k e t t e i d r i v e e q u a l t t h c o n t e n t s o t h d i s k e t t e i n d r i v e A .

T h a s t e r i s k i w a t t e l l I t c o p y a l f i l e s . Y o c a t h i n k o t h e * a w i l d c a r d , w h i c h c a b u s e d t s u b s t i t u t e f o a n c a r d i a n s u i t .

3

Page 50: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 50/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

R e c a l l t h a t f i l e s a r i d e n t i f i e d b n a m e a n e x t e n s i o n . T h e x t e n s i o n i t h r e e l e t t e r i d e n t i f i c a t i o n f o l l o w i n g t h e p e r i o d .

T c o p y a l t h d a t a o d i s k e t t e , e n t e r * I l o o k s l i k e t h i s o t h s c r e e n :

B : = A : * . * ( o r ) E : = A : * . *B e c a u s e w w a n t t m a k e s u r e t h a t a l t h d a t a w a t r a n s f e r r e d c o r r e c t l y ,w c a i n s t r u c t i t d t h i s a i i c o p y i n g . T h i s i d o n e b y p l a c i n g a i s q u a r e b r a c k e t s a f t e r t h c o m m a n d , l i k e t h i s :

B : = A : * . * [ V ] .

T h s t a n d s f o r V e r i f y . B t h w a y , t h C o m m o d o r e p e r f o r m s a na u t o m a t i c V e r i f y , s t h O p t i o n [ V c o m m a n d u s u a l l y i s n ' t n e c e s s a r y . B u y o s h o u l d g e i n t o t h e h a b i t o u s i n g i t s t h a t i y o s w i t c h t C P / M o d i f f e r e n t c o m p u t e r m o d e l , y o w i l l h a v e t h s a m e d a t a v e r i f i c a t i o n .

A P I i w o r k i n g , i d i s p l a y s t h n a m e o t h f i l e w h i c h i i c o p y i n g .W h e n w o r k i c o m p l e t e d , t h p r o m p t i d e l a y e d . I t h e r e a r e n f u r t h e rc o m m a n d s , p r e s s < R E T U R N > a n t h f a m i l i a r C P / M A > p r o m p t i d i s p l a y e d .

3

Page 51: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 51/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . R u l e s f o f i l e n a m e s

Y o u ' v e r u a c r o s s t h e t e r m f i l e s s e v e r a l t i m e s n o w , a n y o u ' v e s e e nf i l e n a m e s i t h d i r e c t o r i e s o y o u r s c r e e n , b u y o s t i l l d o n ' t k n o w w h a tf i l e i s d o e s , o r w h a t i t ' s u s e d f o r .A y o k n o w , e v e r y f i l e i C P / M h a s a n a m e . T h a t i i m p o r t a n t t y o b e c a u s e i l e t s y o s e w h a t i o d i s k e t t e . U n f o r t u n a t e l y , C P / M ' sd e s i g n e r s b u i l t i f e a n n o y i n g l i m i t a t i o n s r e g a r d i n g f i l e n a m e s .

A f i l e n a m e i C P / M m a h a v e m a x i m u m o e i g h t c h a r a c t e r s , f o l l o w e d b p e r i o d , a n t h e n o p t i o n a l l y f o l l o w e d b t h r e e c h a r a c t e r e x t e n s i o n t

s p e c i f y t h e d a t a t y p e . T h a t m e a n s t h a t f i l e n a m e s c a u s n m o r e t h a n e i g h tc h a r a c t e r s , b u m u s t b d e s c r i p t i v e e n o u g h t o i d e n t i f y t h f i l e ' s c o n t e n t s .

A l l o w e d c h a r a c t e r s f o r t h e f i l e n a m e a r e t h e 2 l e t t e r s o t h e a l p h a b e t ,n u m b e r s 0 t h r o u g h 9 a n + , - , / , % , a n c h a r a c t e r s .

T h f o l l o w i n g c h a r a c t e r s a r e n o a l l o w e d i f i l e n a m e s o e x t e n s i o n s ,b e c a u s e t h e y h a v e s p e c i a l m e a n i n g i C P / M :

i •

E x p e r i e n c e h a t a u g h t u t a l w a y s g i v e f i l e m e a n i n g f u l n a m e . I t ' s m u c hh a r d e r t r e m e m b e r t h e c o n t e n t s o f i l e n a m e d X K 2 5 1 2 A C . A B C , t h a nP A Y R O L L . D A T . Y o u c a h a v e t w f i l e s o d i s k e t t e w i t h t h s a m ef i l e n a m e , b u d i f f e r e n t e x t e n s i o n s , e . g . P A Y R O L L . D A T a n P A Y R O L L . C M D .

3

Page 52: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 52/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

3 . E x t e n s i o n s

A e x t e n s i o n i t h r e e - c h a r a c t e r s u f f i x t h a t f o l l o w s t h f i l e n a m e . T h i d e ab e h i n d a e x t e n s i o n i t g r o u p s i m i l a r f i l e s b t y p e . O v e r t i m e , u s e r s o C P / M s y s t e m s h a v e m o r e o l e s s s t a n d a r d i z e d t h e x t e n s i o n n a m e s .P r o g r a m s t h a t a r r e a d y t r u b t y p i n g t h e i r n a m e a t h p r o m p t ( e . g . A > h a v e t h e x t e n s i o n o C O M . Y o u ' l l n o t i c e t h a t I P S Y S G E N a n C O P Y S Y Sa l h a v e C O e x t e n s i o n .

S o m e p r o g r a m s m a k e c o p y o f i l e t h a t m a b m o d i f i e d . F o e x a m p l e , i y o a r u s i n g t h C P / M e d i t o r E t m o d i f y f i l e c a l l e d T E X T . D A T , i f i r s tc r e a t e s c o p y o t h a t f i l e w i t h t h e x t e n s i o n B A o $ $ $ . B A s t a n d s f o b a c k u p . T h d a t a f i l e s w i t h $ $ e x t e n s i o n s a r t e m p o r a r y d a t a f i l e s . T h e ya r u s e d b p r o g r a m a n e r a s e d a t h e n o p r o g r a m r u n . F o e x a m p l e ,P I u s e s t e m p o r a r y d a t a f i l e s a n e r a s e s t h e m c o m p l e t e l y f r o m t h d i s k e t t ew h e n i t j o i f i n i s h e d . N a m e y o u r f i l e s t a v o i d c o n f u s i n g C P / M , a w e l la s y o u r s e l f .

I y o u s t h s a m e f i l e n a m e f o m o r e t h a n o n f i l e a n d i s t i n g u i s h b e t w e e nt h e m b u s i n g a d i f f e r e n t e x t e n s i o n , t h e n y o s h o u l d b a w a r e o p o t e n t i a lp r o b l e m s . S u p p o s e y o h a v e t w f i l e s n a m e d t e x t a n t e x t 2 W h e n y o u s E t o e d i t T E X T 1 i c r e a t e s c o p y o t h o r i g i n a l a n r e m n a m e s i T E X T . B A K . W h a t h a p p e n s i y o n o e d i t T E X T . W h e nE f i n d s f i l e a l r e a d y n a m e d T E X T . B A K , i d e l e t e s i a n t h u s d e s t r o y s a n b a c k u p c o p y o t h o r i g i n a l t e x t 1 T h e r e f o r e y o w o n ' t b a b l e t u s t h o r i g i n a l T E X T . ( n o w T E X T . B A K ) f i l e a f t e r e d i t i n g T E X T . 2

T a v o i d t h i s p r o b l e m , y o m i g h t n a m e t h f i r s t f i l e T E X T 1 . T X T , t h s e c o n d o n T E X T 2 T X T , a n t h t h i r d T E X T 3 T X T .T h e n i y o m o d i f y f i l e , b a c k - u p c o p y i a l w a y s c r e a t e d — y o u c a a l w a y s r e t r i e v e y o u r o r i g i n a l t e x t i n e c e s s a r y .

4

Page 53: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 53/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . F i n d i n g d a t a f i l e

I y o u s y o u r c o m p u t e r o f t e n , y o u ' l l p r o b a b l y c r e a t e l o o d i f f e r e n tf i l e s . T h i s m i g h t m a k e i d i f f i c u l t t o l o c a t e f i l e s t h a t y o u ' r e l o o k i n g f o i t h d i r e c t o r y . I w o u l d b n i c e t b a b l e t v i e w f i l e s , f o e x a m p l e , w i t h n a m e ss i m i l a r t T E X T . T X t h a t a r c o n t a i n e d o t h d i s k e t t e .

T h e r e a r t w d i f f e r e n t w a y s t s e a r c h f o t h e s e f i l e s .

T h a s t e r i s k , y o u ' l l r e c a l l , i w i l d c a r d . I c a r e p r e s e n t a n s t r i n g o c h a r a c t e r s .

T h q u e s t i o n m a r k i w i l d c a r d f o s i n g l e c h a r a c t e r i f i l e n a m e .

F o e x a m p l e , t h p a r a m e t e r t e x t ? s e a r c h e s f o a l f i l e s w i t h t h n a m eT E X T o w i t h t h n a m e T E X T a n o n a d d i t i o n a l c h a r a c t e r . F r o m t h p r e v i o u s e x a m p l e , t h f i l e s T E X T 1 , T E X T 2 a n T E X T 3 w o u l d b e f o u n dw i t h t h c o m m a n d :

D I R T E X T ? < R E T U R N >I f i l e n a m e d T E X T i a l s o o t h d i s k e t t e , i t o w i l l b e f o u n d a n dd i s p l a y e d . C P / M a l w a y s r e s e r v e s e i g h t c h a r a c t e r s f o d a t a f i l e n a m e . I y o e n t e r f i l e n a m e w i t h f e w e r t h a n e i g h t c h a r a c t e r s , C P / M f i l l s i t h r e s t o t h e p o s i t i o n s w i t h b l a n k s p a c e s . T h e r e f o r e , b l a n k s p a c e s a r e a s e q u a l l y v a l i dc h a r a c t e r s a a r l e t t e r s o d i g i t s .

4

Page 54: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 54/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

3 . S e a r c h i n g w i t h q u e s t i o n m a r k ( ?

S i n c e t h q u e s t i o n m a r k c a r e p r e s e n t a n c h a r a c t e r , t h e n n o o n l y t h f i l e sT E X T 1 , T E X T 2 a n T E X T 3 w i l l b f o u n d , b u a l s o t h e f i l e T E X T . E n t e r i n ga q u e s t i o n m a r k d o e s n ' t l e y o d e l e t e c h a r a c t e r , h o w e v e r . Y o c a u s a m a n y a e i g h t q u e s t i o n m a r k s w h e n e n t e r i n g t h f i l e n a m e a n u t t h r e eq u e s t i o n m a r k s f o t h e e x t e n s i o n .

B u t h i s i w a s t e d t y p i n g , s i n c e e n t e r i n g t h b e g i n n i n g c h a r a c t e r s f o f i l e n a m e f o l l o w e d b a a s t e r i s k f o r t h e x t e n s i o n w i l l d t h s a m e t h i n g .T h o p e r a t i n g s y s t e m d o e s n ' t d i s t i n g u i s h b e t w e e n e i g h t q u e s t i o n m a r k s a n do n a s t e r i s k . C P / M c o n v e r t s e v e r y a s t e r i s k i n t o e i g h t q u e s t i o n m a r k s b e f o r et h s e a r c h b e g i n s .

Y o c a s e a r c h u s i n g t h a s t e r i s k m o r e e x a c t l y i y o p u t h f i r s t l e t t e r o l e t t e r s o t h e d e s i r e d d a t a f i l e i n f r o n t o t h a s t e r i s k . H o w e v e r , t h s e a r c hw o n ' t w o r k i y o e n t e r a a s t e r i s k f o l l o w e d b l e t t e r s . T h i s m e t h o d o i n p u t t i n g f i l e n a m e s w i t h q u e s t i o n m a r k s o s t a r s , c a n b e u s e d w i t h t h c o m m a n d s D I R , T Y P E , E R A S E , S H O W , a n d P I P .

3 . 1 0 S u m m a r yY o c a n o c o p y y o u r s y s t e m d i s k e t t e a n s t o r e y o u ro r i g i n a l i n s a f e p l a c e .

Y o c a s i m p l i f y d a t a f i l e s e a r c h e s u s i n g a s t e r i s k s a n q u e s t i o n m a r k s i p l a c e o f l e t t e r s .

Y o k n o w t h a t y o s h o u l d a l w a y s u s m e a n i n g f u l n a m e sf o f i l e s .

4

Page 55: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 55/316

Page 56: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 56/316

Page 57: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 57/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h r e s i d e n t ( b u i l t - i n ) c o m m a n d s

I t h l a s t c h a p t e r w b e c a m e a c q u a i n t e d w i t h s e v e r a l o C P / M ' s b a s i cc o m m a n d s . I t h i s c h a p t e r w e ' l l t a k e c l o s e r l o o k a n u m b e r o r e s i d e n tC P / M c o m m a n d s : U S E R , D I R , D I R S ( Y S ) , E R ( S E ) , R E ( A M E ) , a n T Y P E .

W e l l a l s o t a k e a n o t h e r l o o k a t h e t r a n s i e n t p r o g r a m s . T h e y a r e t h e C P / Mp r o g r a m s t h a t a p p e a r i t h e d i r e c t o r y a n a r s t o r e d a C O d a t a f i l e s .F i n a l l y , w e ' l l e x p a n d o y o u r k n o w l e d g e o t h D I a n I c o m m a n d sc o v e r e d i C h a p t e r 3

4

Page 58: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 58/316

Page 59: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 59/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 . T h r e s i d e n t c o m m a n d s

A p r e v i o u s l y m e n t i o n e d , t w t y p e s o c o m m a n d s a r m a d e a v a i l a b l e w h e nC P / M i s t a r t e d .

R e s i d e n t c o m m a n d s a r l o a d e d i n t o m e m o r y f r o m t h f i l e C C C O M .R e s i d e n t c o m m a n d s a r b u i l t - i n ; t h a t i s t h e y a r a l w a y s i m e m o r y a n r e a d y f o e x e c u t i o n . T e x e c u t e r e s i d e n t c o m m a n d , t y p e i t n a m e : D I < R E T U R N > , a n i w i l l i m m e d i a t e l y s t a r t

t r a n s i e n t c o m m a n d i n o l o a d e d i n t o t h c o m p u t e r ' s m e m o r y u n t i l i i n e e d e d . T e x e c u t e t r a n s i e n t c o m m a n d , y o a l s o t y p e i t n a m e : p i < R E T U R N > , b u i d o e s n o s t a r t i m m e d i a t e l y . I n s t e a d , i t ' s l o a d e d i n t o t h c o m p u t e r ' s m e m o r y f r o m t h s y s t e m d i s k e t t e a n t h e n s t a r t e d . T h u s y o u ' l ln o t i c e s h o r t d e l a y a t r a n s i e n t c o m m a n d i r e a d f r o m d i s k e t t e a n t h e ns t a r t s i t e x e c u t i o n .

C P / M 3 . h a s i r e s i d e n t c o m m a n d s . T h e y a r l i s t e d b e l o w :

C o m m a n dD I

D I R S Y SE R A S ER E N A M ET Y P EU S E R

A b b r e v i a t i o nD I

D I R SE R R E T Y U S

F u n c t i o nS h o w s t h c o n t e n t s o d i s k

S h o w s t h S Y S T E M d a t a f i l e sE r a s e s f i l e sC h a n g e s f i l e n a m e sS h o w s t e x t f i l e sC h a n g e d u s e r r a n g e

Y o c a e x e c u t e a r e s i d e n t c o m m a n d b e n t e r i n g e i t h e r t h e c o m m a n d o i t a b b r e v i a t i o n .

s e v e n t h r e s i d e n t c o m m a n d d o e s n ' t h a v e n a m e . T h i s c o m m a n d a l l o w sy o t s w i t c h f r o m o n d r i v e t t h o t h e r . T l o o n t o d r i v e f r o m d r i v e A t y p e t h f o l l o w i n g a t h A p r o m p t :

A > B : < R E T U R N >

4

Page 60: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 60/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

Y o c a u s d r i v e d e s i g n a t i o n s f r o m t E A n o t h e r d e s i g n a t i o n c a u s e st h f o l l o w i n g e r r o r m e s s a g e :

C P / M E r r o r O F I n v a l i d D r i v eB D O S F u n c t i o n _ 1

I y o u ' r e n o u s i n g d r i v e a n t h s y s t e m d i s k e t t e i i d r i v e A y o c a s t i l l a c c e s s p r o g r a m s f r o m d r i v e A T d t h i s , p r e f i x t h e c o m m a n d w i t h t h d r i v e d e s i g n a t i o n l i k e t h i s :

B > A : D I RY o c a a l s o p r e f i x a p a r a m e t e r w i t h d r i v e d e s i g n a t i o n :

B > D I R A : D A T E I . X X X

4

Page 61: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 61/316

Page 62: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 62/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

N a t u r a l l y y o c a u s a n o t h e r d i s k d r i v e . T l o o t t h d r i v e , j u s t t y p e :

3 A B < R E T U R N >a n t h p r o m p t c h a n g e s t 3 B > .

A l t e r n a t e m e t h o d s o g e t t i n g t o t h i s u s e r a r e a o d r i v e a r e :

A B 3 ( o r )

A 3 B

I y o a r u s i n g b o t h a n d r i v e s , g e b a c k t t h d r i v e :

3 B A < R E T U R N >I y o d i s p l a y t h e d i r e c t o r y n o w , t h m e s s a g e N I L a p p e a r s , s i n c e y o h a v e n ' t p u a n f i l e s i n t o u s e r a r e a 3 C P / M s e p a r a t e s t h d i r e c t o r y e n t r i e sb u s e r a r e a s . T h i s i h e l p f u l i m a n y f i l e s i s i n g l e u s e r a r e a n e e d t b d i s p l a y e d .A l o t h b u i l t - i n , r e s i d e n t c o m m a n d s a r a v a i l a b l e f r o m a n u s e r a r e a .

5

Page 63: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 63/316

Page 64: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 64/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 . 4 . 1 d i w i t h p a r a m e t e r sY o c a a l s o u s e p a r a m e t e r s w i t h t h D I c o m m a n d . I y o h a v e l a r g en u m b e r o d i r e c t o r y e n t r i e s o d i s k e t t e , y o c a d i s p l a y t h e n t r y f o p a r t i c u l a r f i l e , i n s t e a d o r e a d i n g t h r o u g h a l t h e n t r i e s :

D I R B r T E X T . T X T < R E T U R N >T h f i l e n a m e i d i s p l a y e d i T E X T . T X e x i s t s o t h d i s k e t t e i n d r i v e B I t h f i l e i s n o o t h d i s k e t t e , t h f o l l o w i n g i d i s p l a y e d :

N F i l eT u s m o r e c o m p l e x f u n c t i o n s o t h D I c o m m a n d , y o m u s t u s t h t r a n s i e n t v e r s i o n . I t h i s c a s e , y o m u s t m a k e s u r e t h a t t h f i l e D I R . C O M .i o t h l o g g e d d i s k ( u s u a l l y o t h d r i v e ) . F o e x a m p l e , i t h s y s t e md i s k e t t e i i d r i v e A , b u y o a r l o g g e d o n t o d r i v e B , y o m u s t i s s u e t h eD I c o m m a n d w i t h o p t i o n s l i k e t h i s :

B A : D I R [ O p t i o n s ]

T h i s e n s u r e s t h a t D I R . C O i l o a d e d f r o m t h d r i v e .

4 . 4 . 2 M o r e a b o u t D I Y o u ' l l r e c a l l t h a t y o c a u s a s t e r i s k s i t h D I c o m m a n d . F o e x a m p l e :

D I * . C O M

d i s p l a y s a l o t h e * C O f i l e s o t h l o g g e d d i s k e t t e .

Y o c a a l s o d i s p l a y t h d i r e c t o r y e n t r i e s f o s e v e r a l d i f f e r e n t f i l e t y p e s :

D I * . C O M * . S Y SH o w e v e r , t h a b o v e c o m m a n d w i l l c a u s e a n e r r o r :

* . S Y S ?

O n l y t h t r a n s i e n t D I c o m m a n d c a h a n d l e t h i s r e q u e s t .

5

Page 65: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 65/316

Page 66: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 66/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D i r e c t o r y f o D r i v e A U s e r

N a m e B y t e s R e c s A t t r i b u t e s N a m e B y t e s R e c s A t t r i b u t e s

C C C P M +F O R M A TH E L PK E Y F I G

C O S Y

C O H L

H L

4 2 3 5 8 3

9

2 1 8 3 6 6

7

D i D i D i D i D i

R R R R R

C O P Y S Y SD I H E L PK E Y F I GP I

C O C O C O C O C O

I 1 5

7 1 0

9

1 1 5 7

6

D i D i

D i D i D i

R R

R R R

T o t a l B y t e s 1 6 6 k T o t a l R e c o r d s 1 2 9 6 F i l e s F o u n d = 1 T o t a l I B l o c k s 1 6 U s e d / M a x D i E n t r i e s f o D r i v e A 1 6 6

4 . 4 . 4 D I R S Y SW h e n y o d i s p l a y t h d i r e c t o r y , y o m a n o t i c e t h e f o l l o w i n g m e s s a g e :

S Y S T E M F I L E ( S ) E X I S TI t e l l s y o t h a t , i a d d i t i o n t t h f i l e s l i s t e d , t h d i s k e t t e a l s o c o n t a i n s t h es y s t e m f i l e s . I y o d o n ' t s e t h m e s s a g e , t h e n n s y s t e m f i l e s a r c o n t a i n e d o t h d i s k e t t e . S y s t e m f i l e s a r e s t o r e d i u s e r a r e a 0 a n c a n b er e a d a n u s e d b e v e r y w o r k a r e a . I y o u ' d l i k e t d i s p l a y t h n a m e s o t h s y s t e m f i l e s , e n t e r t h e c o m m a n d D I R S Y S o t h a b b r e v i a t i o n D I R S . U n d e rt h l i s t e d f i l e s y o t h e n r e c e i v e t h m e s s a g e t h a t N s y s t e m f i l e se x i s t .

Y o h a v e t h s a m e c a p a b i l i t i e s w i t h t h c o m m a n d D I R S Y S a w i t h t h c o m m a n d D I R . Y o c a a l s o u s a s t e r i s k s a n q u e s t i o n m a r k s , a i t h D I c o m m a n d .

5

Page 67: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 67/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 . E R A S E

T h c a p a c i t y o d i s k e t t e i l i m i t e d , a n t h e r e f o r e l i m i t s t h n u m b e r o e n t r i e s o d i s k e t t e ' s d i r e c t o r y . O s i n g l e - s i d e d d i s k e t t e , t h e r e i r o o mf o e x a c t l y 6 e n t r i e s . O d o u b l e - s i d e d d i s k e t t e , t h l i m i t i 1 2 e n t r i e s . I y o u s t h t r a n s i e n t d i c o m m a n d , t h m a x i m u m a n c u r r e n t n u m b e r o d i r e c t o r y e n t r i e s o t h d i s k e t t e i d i s p l a y e d .W h e n f i l e i n l o n g e r r e q u i r e d , y o w i l l w a n t t d e l e t e o e r a s e i t T h i sf r e e s u s p a c e o t h d i s k e t t e s t h a t i m a b e u s e d b o t h e r p r o g r a m s . T d t h i s y o c a u s t h E R A S E c o m m a n d .E n t e r t h c o m m a n d l i k e t h i s :

E R A S E d - . n a m e

T h r e p r e s e n t s t h d i s k d r i v e i d e n t i f i e r . T h n a m e s t a n d s f o t h f i l e n a m et b e r a s e d . I y o a r l o g g e d o n t o d r i v e a n w a n t t e r a s e f i l e o d r i v eA t h e n y o c a o m i t t h e d r i v e i d e n t i f i e r . T h E R A S E c o m m a n d c a b a b b r e v i a t e d t E R A .

L i k e t h D I c o m m a n d , y o c a u s a s t e r i s k s a n q u e s t i o n m a r k s w i t h t h E R c o m m a n d . Y o s h o u l d b v e r y c a r e f u l w h e n u s i n g o w i t h E R A .I t ' s e a s y t a c c i d e n t a l l y e r a s e t h w r o n g f i l e s a n s u f f e r t h c o n s e q u e n c e sa f t e r w a r d s .

T e r a s e s p e c i f i c t y p e o f i l e , f o e x a m p l e , f i l e s w i t h B A e x t e n s i o n ,e n t e r :

E R * . B A KT h f o l l o w i n g m e s s a g e i d i s p l a y e d :

E R A S E ' * . B A ( Y / N ) ?T h i s i a s k i n g y o t c o n f i r m t h d e l e t i o n s . I t ' s s a f e t y p r e c a u t i o nr e q u i r i n g y o t r e s p o n d b e f o r e C P / M e r a s e s a l o t h f i l e s w i t h t h B A e x t e n s i o n . A n s w e r t d e l e t e t h e e n t r i e s o t a b o r t .

5

Page 68: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 68/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I y o a r r e a l l y b r a v e , y o c a a l s o e r a s e a l o t h f i l e s o d i s k e t t e w i t ht h i s c o m m a n d :

E R * .

O n c e a g a i n y o a r a s k e d t c o n f i r m t h d e l e t i o n s :

E R A S E * . ( Y / N ) ?I y o r e s p o n d b t y p i n g a l o t h f i l e s w i l l b e r a s e d .

4 . 5 . 1 E r a s i n g w i t h E R i C P / M 3 . S u p p o s e t h a t y o w a n t t e r a s e a l . B A S f i l e s o d i s k e t t e . Y o w o u l d t y p e :

E R * . B A ST h f o l l o w i n g i d i s p l a y e d t m a k e s u r e t h f i l e s r e a l l y s h o u l d b e r a s e d :

E R A S E * . B A S ( Y / N ) ?B e f o r e y o a n s w e r f o r y e s , y o s h o u l d d o u b l e - c h e c k y o u r t y p i n g . A r y o c e r t a i n t h a t t h c o m m a n d i c o r r e c t a n t h a t y o r e a l l y w a n t t e r a s e t h i sf i l e t y p e ? O n c e y o u V e t y p e d Y t h e r e ' s n w a t g e t t h e f i l e s b a c k . T h f i l e s a r g o n e c o m p l e t e l y . C h e c k e s p e c i a l l y f o r t y p i n g m i s t a k e s . F o i n s t a n c e , i t ' s e a s y t m i s t a k e n l y t y p e P A i n s t e a d o B A S . I y o t y p e i t h c o m m a n d l i k e t h i s , a l l t h P a s c a l f i l e s o y o u r d i s k a r e e r a s e d .T p r o t e c t y o u r s e l f a g a i n s t t h e s e u n p l e a s a n t s u r p r i s e s , t h e r e a r e t w o w a y s t p r e v e n t a c c i d e n t a l e r a s u r e . F i r s t , y o c a w r i t e - p r o t e c t t h e i n d i v i d u a l f i l e s .Y o u ' l l s e h o t d t h i s s h o r t l y . S e c o n d , y o c a a s t h E R A S Ec o m m a n d t c o n f i r m e a c h d e l e t i o n i n d i v i d u a l l y . T d t h i s y o m u s t e n t e r :

E R A S E * . B A K [ C ]H e r e , a l f i l e s w i t h t h e x t e n s i o n B A a r e e r a s e d , b u t o n l y i y o r e s p o n d

t t h c o n f i r m a t i o n m e s s a g e .

5

Page 69: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 69/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 . C h a n g i n g f i l e n a m e s w i t h R E ( A M E )

T r e n a m e f i l e s , y o u s t h r e n a m e c o m m a n d . T h e f o r m a t l o o k s l i k e t h i s :

R E N A M E n e w n a m e = d : o l d n a m eN o t e t h a t n e w n a m e p r e c e d e s t h o l d n a m e a n t h a t t h e y a r s e p a r a t e d b t h

s i g n . I f t h f i l e o l d n a m e i o t h l o g g e d d r i v e , y o c a o m i t t h d r i v ei d e n t i f i e r d :

I t h f i l e n e w n a m e a l r e a d y e x i s t s , y o a r a s k e d i i s h o u l d b e r a s e db e f o r e o l d n a m e i r e n a m e d t n e w n a m e :

E r r o r : N o t r e n a m e d , n e w n a m e f i l e a l r e a d y e x i s t s ,d e l e t e ( Y / N ) ?

I y o a n s w e r t h i s q u e s t i o n w i t h N t h e n R E N A M E i a b o r t e d .I y o e n t e r Y t h e n t h f i l e n e w n a m e w i l l b e r a s e d , a n t h f i l e o l d n a m ei r e n a m e d n e w n a m e . I i i n t e r e s t i n g t h a t t h e r e s i d e n t p a r t o R E N A M Et a k e s c a r e o s i m p l e r e n a m i n g , b u i t h e r e a r o p t i o n s — i n t h i s c a s e , t h n e f i l e a l r e a d y e x i s t e d — t h e n t h t r a n s i e n t R E N A M E i l o a d e d b e f o r e i c o n t i n u e s . T h a b b r e v i a t i o n f o R E N A M E i R E N .H e r e i a e x a m p l e o f " s i m p l e " r e n a m i n g :

R E n e w . b a s = o l d . b a s

Y o c a a l s o u s a s t e r i s k s a n q u e s t i o n m a r k s w i t h t h R E N A M E c o m m a n d .s i m p l e e x a m p l e m i g h t l o o k l i k e t h i s :

R E N A M E * . T X T = * . B A K

T h i s c o m m a n d c h a n g e s a l t h f i l e s w i t h t h e x t e n s i o n t x t f i l e s w i t h t h B A e x t e n s i o n . T h R E N A M E c o m m a n d d o e s n ' t c h a n g e t h c o n t e n t s o f i l e , o n l y i t n a m e .

5

Page 70: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 70/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

4 . T Y P E

T h T Y P E c o m m a n d d i s p l a y s t h c o n t e n t s o f i l e o t h e s c r e e n . I w i l ld i s p l a y t h e c o n t e n t s o a n t e x t f i l e t h a t u s e s t h A S C I I c h a r a c t e r s e t . O t h e rf i l e t y p e s , f o e x a m p l e C O o R E f i l e s , m a c o n t a i n c h a r a c t e r s t h a t c a u s es t r a n g e o u t p u t o c a u s e t h c o m p u t e r t h a n g u p T h f o r m a t f o t h T Y P Ec o m m a n d i s

T Y P E d : f i l e n a m e

T d i s p l a y t h c o n t e n t s o f f i l e f r o m o t h e r t h a n t h l o g g e d d r i v e , e n t e rd i f f e r e n t d r i v e i d e n t i f i e r .

T h T Y P E c o m m a n d d i s p l a y s 2 l i n e s o t e x t p e s c r e e n . Y o c a r e a d t h t e x t o t h s c r e e n a t h e n p r e s s < R E T U R N > t v i e w t h n e x t 2 l i n e s o t e x t . B e n t e r i n g t h e o p t i o n [ N O P A G t h t e x t i d i s p l a y e d i i t e n t i r e t yb s c r o l l i n g c o n t i n u o u s l y . Y o c a h a l t t h s c r o l l i n g b p r e s s i n g< C O N T R O L > S a n t h e n r e s t a r t t h s c r o l l i n g w i t h < C O N T R O L > Q A l s o ,y o c a t o g g l e < C O N T R O L > t s e n d t h t e x t t o t h p r i n t e r .

T h r e v e r s e s i d e o t h C P / M S y s t e m d i s k e t t e ( t h e s i d e t i t l e d u t i l i t i e s )c o n t a i n s a a s s e m b l e r s o u r c e f i l e D A T E . A S t h a t i g o o d e x a m p l e f o u s i n g t h T Y P E c o m m a n d :

T Y P E D A T E . A S M

4 . S u m m a r y

C P / M h a b u i l t - i n c o m m a n d s t h a t m a k e i p o s s i b l e t w o r kw i t h a n m a n i p u l a t e f i l e s o d i s k .C o m m a n d s c a b e n t e r e d w i t h p a r a m e t e r s o r o p t i o n s .Y o k n o w t h n a m e s o a l t h b u i l t - i n c o m m a n d s , h o t h e yw o r k , a n w h i c h o p t i o n s w o r k o n l y w i t h t h e t r a n s i e n tc o m m a n d s .

5

Page 71: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 71/316

C h a p t e r s

T h t r a n s i e n t c o m m a n d s

5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 5 . 1 05 . 1 15 . 1 25 . 1 3

I n t r o d u c t i o nT r a n s i e n t c o m m a n d s u n d e r C P / MS E D i s k d r i v e c h a r a c t e r i s t i c sL a b e l sD i s k e t t e p a s s w o r dF i l e P A S S W O R DT i m e s t a m p i n gS E T D E FS H O WS U B M I TT h e h e l p c o m m a n dS u m m a r y

Page 72: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 72/316

Page 73: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 73/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

T h t r a n s i e n t c o m m a n d s

5 . I n t r o d u c t i o nY o h a v e j u s t r e a d a b o u t C P / M ! s b u i l t - i n , r e s i d e n t c o m m a n d s . B u t h r e a lp o w e r o t h o p e r a t i n g s y s t e m c o m e s f r o m t r a n s i e n t c o m m a n d s . T h e s e a r l i s t e d a C O f i l e s i t h d i r e c t o r y . W e V e n o t e d s e v e r a l t i m e s t h a t t h e s ec o m m a n d s a r l o a d e d i n t o m e m o r y f r o m d i s k e t t e s w h e n n e e d e d . T h e s ec o m m a n d s a r e s t o r e d o d i s k e t t e f o g o o d r e a s o n : t h e y a r s i m p l y t o b i a n w o u l d t a k e u t o m u c h i n t e r n a l m e m o r y i t h e y w e r e b u i l t - i n . T h e i rs i z e i d u t t h e l a r g e n u m b e r o o p t i o n s t h e y g i v e y o u .T r a n s i e n t c o m m a n d s a r f i r s t s e a r c h e d f o i t h e d i r e c t o r y a n t h e n l o a d e di n t o m e m o r y . T h e r e f o r e , t h e y a r e n ' t a q u i c k l y a c c e s s i b l e a t h e i r r e s i d e n tc o m m a n d c o u n t e r p a r t s . K e e p t h i s i m i n d w h e n y o w o r k w i t h C P / M .

5 . T r a n s i e n t c o m m a n d s u n d e r C P / MN o w e l l t a k e a l o o k a i m p o r t a n t a n o f t e n - u s e d C P / M c o m m a n d s . H e r ew e ' r e r e f e r r i n g t t h t r a n s i e n t c o m m a n d s f o u n d i t h e d i r e c t o r y w i t h C O e x t e n s i o n s . Y o a l r e a d y k n o w h o t c a l l t h p r o g r a m s — t y p e i t h p r o g r a m n a m e w i t h o u t t h e x t e n s i o n a n p r e s s t h < R E T U R N > k e y . T h e r ea r e t h r e e m e t h o d s t c a l l t r a n s i e n t p r o g r a m s . F i r s t , y o c a w o r k i u s e ra r e a 0 S e c o n d , y o c a m a k e p r o g r a m a c c e s s i b l e t a l u s e r a r e a s w i t hS E c o m m a n d . T h i r d , y o c a u s t h S E T D E F c o m m a n d . W e ' l l t a l k m o r ea b o u t t h i s t h i r d c o m m a n d l a t e r .

6

Page 74: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 74/316

Page 75: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 75/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

1 = O N / O F F S w i t c h e s t h u s e r - d e f i n e d f i l e a t t r i b u t e F o o o f f .

F 2 = 0 N / 0 F F S w i t c h e s t h u s e r - d e f i n e d f i l e a t t r i b u t e F o o o f f .

F 3 = 0 N / 0 F F S w i t c h e s t h u s e r - d e f i n e d f i l e a t t r i b u t e F o o o f f .

F = O N / O F F S w i t c h e s t h u s e r - d e f i n e d f i l e a t t r i b u t e F o o o f f .

L e t ' s s e s o m e e x a m p l e s o t h S E c o m m a n d .S u p p o s e y o h a v e p r o g r a m c a l l e d M Y P R O G . C O t h a t y o u w a n t t b a b l et u s f r o m a n u s e r a r e a . N o r m a l l y t h i s p r o g r a m i p l a c e d i u s e r a r e a 0

A a l t e r n a t e w a i t m a k e y o u r p r o g r a m S Y S T E M f i l e . Y o c a d t h i sw i t h t h S E c o m m a n d :

S E M Y P R O G . C O M [ S Y S ]Y o c a a l s o p r o t e c t y o u r p r o g r a m f r o m b e i n g o v e r w r i t t e n :

S E M Y P R 0 G . C O M [ R O ]

O y o c a m a k e i S Y S T E M f i l e a n p r o t e c t i t

S E M Y P R 0 G . C O M [ S Y S R O ]T u n d o t h a t t r i b u t e s , y o c a e n t e r :

S E M Y P R 0 G . C O M [ D I R R W

T h o p t i o n s m a a p p e a r i a n o r d e r [ D I R R W o [ r D I R ] a n m a b s e p a r a t e d b s p a c e s o r c o m m a s .N o t e : T u s t h p r e c e d i n g c o m m a n d s , y o s h o u l d i n i t i a l i z e t h e d i r e c t o r yu s i n g t h I N I T D I R c o m m a n d . Y o c a p r e p a r e a d i s k e t t e b t y p i n g :

I N I T D I R A

T h i s c o m m a n d r e o r g a n i z e s t h e d i r e c t o r y o d i s k e t t e a n p r e p a r e s i f o t i m e s t a m p i n g .

6

Page 76: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 76/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

5 . D i s k d r i v e c h a r a c t e r i s t i c s

Y o c a p r o t e c t t h e c o n t e n t s o a e n t i r e d i s k d r i v e s t h a t i n f o r m a t i o n c a o n l y b r e a d f r o m i a n c a n ' t b w r i t t e n t i t I y o u V e s e d i s k d r i v e t R ( r e a d o n l y ) , f i l e s c a n ' t b e r a s e d w i t h E R A S E , R E N A M E d o e s n ' t w o r k ,a n p i c a n ' t c o p y f i l e s t t o t h a t d r i v e .

T d t h i s , e n t e r :

S E A : [ R O ]

T h e n , d r i v e i s e t r e a d - o n l y . I y o e n t e r a R ( r e a d / w r i t e )i n s t e a d o R O t h d r i v e c a n b e w r i t t e n t a g a i n . S e t t i n g t h r e a d - o n l ya t t r i b u t e d o e s t h s a m e t h i n g a p u t t i n g o w r i t e - p r o t e c t t a b .

5 . L a b e l s

Y o c a g i v e a e n t i r e d i s k e t t e n a m e . d i s k n a m e i l i m i t e d t e i g h tc h a r a c t e r s , t h e s a m e a s f o r f i l e n a m e . T d t h i s y o u s t h n a m e =o p t i o n o t h S E c o m m a n d :

S E B : [ N A M E = F I B U ]I y o h a v e o n l y o n d i s k d r i v e , t h S E T c o m m a n d w i l l w o r k i t h f i l eS E T . C O i o t h d i s k e t t e b e i n g a c c e s s e d . T g e a r o u n d t h i s l i m i t a t i o n ,u s t h v i r t u a l d i s k d r i v e E . E n t e r t h f o l l o w i n g w h i l e t h d i s k e t t ec o n t a i n i n g S E T . C O i i n t h e d r i v e :

S E E : [ N A M E = F I B U ]C P / M l o a d s t h r e q u i r e d f i l e S E C O M , a n t h e n a s k s y o t i n s e r t t h d i s k e t t e r e p r e s e n t i n g d r i v e i n t o t h e d r i v e A I y o u ' v e e n t e r e d t h a b o v ec o m m a n d , t h f o l l o w i n g t e x t w i l l a p p e a r o t h s c r e e n :

6

Page 77: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 77/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

L a b e l f o d r i v e E

D i r e c t o r y P a s s w d s S t a m p S t a m pL a b e l R e q d C r e a t e U p d a t e

E F I B U o f o f f o f f

W e l l t a l k a b o u t t h o t h e r o p t i o n s m a r k e d o f s h o r t l y .

T h D I c o m m a n d d o e s n o d i s p l a y a d i s k ! s n a m e . T s e e t h e d i s k ' s n a m e ,u s t h S H O W c o m m a n d w i t h t h L A B E L o p t i o n :

S H O W E : [ L ]

W h e n u s i n g o n d r i v e a n t h v i r t u a l d r i v e E C P / M r e p e a t e d l y r e q u e s t s y o t i n s e r t d i s k i n t o e i t h e r t h e o d r i v e . A f t e r y o u V e r e s p o n d e d t o t h er e q u e s t , p r e s s t h d i s k o d i s k i t h d r i v e . A n s w e r t h r e q u e s t a n t h e nh i t h < R E T U R N > k e t p r o c e e d .

N o t h o u t p u t i m o r e d e t a i l e d t h a n w h e n w e n t e r e d t h S E c o m m a n d :L a b e l f o d r i v e E

D i r e c t o r y P a s s w d s S t a m p S t a m pL a b e l R e q d C r e a t e U p d a t e L a b e l c r e a t e d L a b e l U p d a t e d

E : F I B U o f o f o f 1 2 / 0 6 / 8 5 0 1 : 0 4 1 2 / 0 6 / 8 5 0 1 : 0 4

J u s t l i k e w i t h m o r e e x p e n s i v e c o m p u t e r s , t h c r e a t i o n d a t e a n t h l a s t t i m et h f i l e w a u p d a t e d a r d i s p l a y e d . W h e n e v e r f i l e ' s c o n t e n t s a r c h a n g e d ,t h d a t e o t h u p d a t e i a l s o c h a n g e d . D o i n g t h i s g i v e s u s s e v e r a la d v a n t a g e s . F o e x a m p l e , y o c a u s t h P I c o m m a n d w i t h s p e c i a lo p t i o n t u p d a t e a l t h f i l e s t h a t w e r e c h a n g e d o n o n e p a r t i c u l a r d a y . B u t h i s i r e l e v a n t o n l y i y o r e l i g i o u s l y e n t e r t h d a t e a n t i m e u s i n g t h D A T E c o m m a n d w h e n e v e r y o w o r k o t h c o m p u t e r . O t h e r w i s e , t h e d a t e sa r i n a c c u r a t e — l i k e t h o n e s i o u e x a m p l e .

6

Page 78: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 78/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

5 . D i s k e t t e P A S S W O R D

P a s s w o r d s c a n b e u s e d t p r e v e n t u n a u t h o r i z e d a c c e s s t d a t a f i l e s . Y o c a a s s i g n p a s s w o r d t a e n t i r e d i s k e t t e a n t h e r e b y r e s t r i c t a c c e s s t t h a td i s k e t t e , a w e l l a r e s t r i c t t h u s o t h S E c o m m a n d f o t h d i s k e t t e .

B e f o r e a s s i g n i n g p a s s w o r d t d i s k e t t e , i m u s t h a v e l a b e l S E d [ n a m e = l a b e l ] ) T a s s i g n p a s s w o r d e n t e r :

S E d [ V A S S W O R D = p a s s w o r d ]

N o t h d i s k e t t e i p a s s w o r d p r o t e c t e d . I y o t r t u s t h S E c o m m a n df o t h i s d i s k e t t e t h f o l l o w i n g i d i s p l a y e d :

D i r e c t o r y l a b e lP a s s w o r d ?

E n t e r t h e c o r r e c t p a s s w o r d a n d p r e s s < R E T U R N > t g a i n a c c e s s t t h d i s k e t t e . Y o u ' l l n o t i c e t h a t t h p a s s w o r d i n o d i s p l a y e d o t h s c r e e n a y o u f r e t y p i n g a t h k e y b o a r d . T h i s i a a d d e d s e c u r i t y m e a s u r e .

T r e m o v e p a s s w o r d f r o m t h d i s k e t t e t y p e :

S E [ P A S S W O R D = < c r > ( < c r > = < R E T U R N > )N a t u r a l l y y o c a r e m o v e t h p a s s w o r d o n l y i y o a l r e a d y k n o w t h p a s s w o r d b e f o r e h a n d , s i n c e C P / M r e q u i r e s y o t e n t e r i h e r e .

6

Page 79: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 79/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

5 . F i l e P A S S W O R D

Y o c a a l s o a s s i g n p a s s w o r d t a i n d i v i d u a l f i l e o d i s k e t t e . T a s s i g nf i l e p a s s w o r d s y o u m u s t a l l o w t h d i s k e t t e t o b p r o t e c t e d :

S E d [ P R O T E C T = O N ] < R E T U R N >w h e r e i t h e d r i v e i n d i c a t o r f o r t h d i s k e t t e .

N o y o c a a s s i g n p a s s w o r d t a i n d i v i d u a l f i l e . T a s s i g n t h p a s s w o r d s e c r e t t t h f i l e d i C O M , t y p e :

S E d : D I R . C O M [ P A S S W O R D = S E C R E T ] < R E T U R N >T r e m o v e p a s s w o r d f r o m t h f i l e , e n t e r :

S E d : D I R . C O M [ P A S S W O R D = o f f ] < R E T U R N >T h e r e a r a l s o s e v e r a l o t h e r o p t i o n s f o p r o t e c t i n g f i l e s :

R E A D T h p a s s w o r d i r e q u i r e d t r e a d , c o p y , w r i t e , e r a s e ,o r e n a m e f i l e

W R I T E T h p a s s w o r d i r e q u i r e d t w r i t e t o e r a s e , o r e n a m ef i l e .

D E L E T E T h p a s s w o r d i r e q u i r e d o n l y t e r a s e o r r e n a m ef i l e .

N O N E T h p a s s w o r d i r e m o v e dI y o o m i t t h o p t i o n , R E A D i t h d e f a u l t . E n t e r t h o p t i o n l i k e t h i s :

S E E i T E X T . T X T [ P R O T E C T = D E L E T E ]T h i s p r o t e c t s t h f i l e t e x t t x a g a i n s t a c c i d e n t a l e r a s u r e .

T a v o i d c o n f u s i o n , w s h o u l d u n d e r s t a n d t h a t y o c a n n o t p r o t e c t C O f i l e si t h i s w a y . I C O f i l e h a s h a s p a s s w o r d w i t h R E A D o p t i o n , w h e n y o t r t r u t h i s c o m m a n d y o s e t h i s :

6

Page 80: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 80/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

C P / M E r r o r O A P a s s w o r d E r r o rB D O S F u n c t i o n 1 F i l e D I . C O M

Y o a r n o a s k e d t e n t e r t h p a s s w o r d b e f o r e t h c o m m a n d i r u n — t h ec o m m a n d i s i m p l y a b o r t e d .

W h e n y o w a n t t r e m o v e p a s s w o r d , y o a r f i r s t a s k e d t e n t e r t h ep a s s w o r d , w h i c h m u s t b e n t e r e d c o r r e c t l y . I y o d o n f t e n t e r t h e p a s s w o r dc o r r e c t l y , t h e n y o w o n ' t b a b l e t r e m o v e i t T h i s p r e v e n t s u n a u t h o r i z e du s e r s f r o m u s i n g t h e s e f i l e s .

6

Page 81: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 81/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

5 . T i m e S t a m p i n g

t i m e s t a m p i s i m i l a r t p u n c h - c l o c k i f a c t o r y t h a t r e c o r d s e a c he m p l o y e e s w o r k i n g h o u r s b t h d a t e a n t i m e . C P / M c a t i m e s t a m p f i l e s .T h t i m e s t a m p c a t h e n b u s e d t d e t e r m i n e t h l a s t t i m e f i l e w a a c c e s s e d o r u p d a t e d , f o e x a m p l e .T h r e e s t e p s a r r e q u i r e d t u s e t i m e s t a m p i n g :

D A T E c o m m a n d t s e t h d a t e a n t i m e

I N i t d I c o m m a n d t p r e p a r e a d i s k e t t e ' s d i r e c t o r y t r e c o r d t h t i m e s t a m p

S E T c o m m a n d t t u r n o t h t i m e s t a m p i n g

T s e t h d a t e a n t i m e e n t e r :

D A T E S E < R E T U R N >T h D A T E c o m m a n d d i s p l a y s :

E n t e r t o d a y ' s d a t e ( M M / D D / Y Y ) :E n t e r t h d a t e i t h f o r m a t m o n t h / d a y / y e a r i n c l u d i n g t h e s l a s hb e t w e e n n u m b e r s a n p r e s s t h e < R E T U R N > k e y . N e x t t h D A T Ec o m m a n d d i s p l a y s :

E n t e r t h e t i m e ( H H : M M : S S ) :E n t e r t h c u r r e n t t i m e i t h f o r m a t h o u r : m i n u t e s s e c o n d si n c l u d i n g t h c o l o n b e t w e e n n u m b e r s a n p r e s s < R E T U R N > .Y o c a v e r i f y y o u r e n t r i e s b e n t e r i n g :

D A T E < R E T U R N >T h i s d i s p l a y s t h d a t e a n t i m e . T h e s e v a l u e s a r u p d a t e d a l o n g a t h c o m p u t e r s p o w e r r e m a i n s o n

6

Page 82: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 82/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

N e x t y o u m u s t i n i t i a l i z e t h d i s k e t t e t a c c e p t t h t i m e s t a m p s . H e r e w u s t h i n i t d i r c o m m a n d . W r e c o m m e n d t h a j ; y o f i r s t m a k eb a c k u p c o p y o t h d i s k e t t e . S i n c e t h i n i t d i r r e o r g a n i z e s t h d i s k e t t e ' s d i r e c t o r y , i i s h o u l d e n c o u n t e r a n e r r o r s , t h d a t a o t h d i s k e t t e m a b e c o m e i n a c c e s s i b l e . T h i s i w h y w e r e c o m m e n d m a k i n g

b a c k u p . T i n i t i a l i z e t h d i s k e t t e f o t i m e s t a m p i n g , e n t e r :I N I T D I R d : < R E T U R N >

T h i n i t d i r c o m m a n d d i s p l a y s t h f o l l o w i n g :

I N I T D I R W I L L A C T I V A T E T I M E S T A M P S F O S P E C I F I E D D R I V ED o y o u w a n t t r e - f o r m a t t h d i r e c t o r y o d r i v e : d ( Y / N ) ?

P r e s s a n < R E T U R N > t r e o r g a n i z e t h d i r e c t o r y .

N o y o c a u s t h S E c o m m a n d t b e g i n r e c o r d i n g t h t i m e s t a m p s .T h e r e a r e t h r e e o p t i o n s a v a i l a b l e :

C R E A T E = O N r e c o r d s t h t i m e s t a m p o n l y w h e n f i l e i c r e a t e d .

A C C E S S = O N r e c o r d s t h t i m e s t a m p w h e n f i l e i r e a d .

U P D A T E = O N r e c o r d s t h t i m e s t a m p w h e n f i l e i c h a n g e d .

C R E A T E a n U P D A T E a r m u t u a l l y e x c l u s i v e . Y o c a a l s o t u r n o f t h t i m e s t a m p b u s i n g O F i p l a c e o O N . T h i s i b e c a u s e w h e n y o c h a n g ef i l e , y o m a k e n e f i l e . T h o l f i l e b e c o m e s B A ( b a c k u p ) c o p y .T r e c o r d t h c u r r e n t d a t e a n t i m e , y o e n t e r t h f o l l o w i n g c o m m a n d :

S E E : [ A C C E S S = O N ]T s e t h r e s u l t o t h i s c o m m a n d , e n t e r :

D I R [ F U L L ]

7

Page 83: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 83/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

T h f o l l o w i n g d i r e c t o r y w i l l b d i s p l a y e d :D i r e c t o r y f o D r i v e B

N a m e B y t e s R e c s A t t r i b u t e s P r o t U p d a t e A c c e s s

T E X T . T X T 5 3 D I R N O N E 0 4 / 0 1 / 8 5 1 7 : 3 1F I B U 2 0 1 5 S Y S R O N O N E 0 4 / 0 1 / 8 5 0 9 : 1 0

T h A C C E S S o p t i o n l e t s y o f i n d o u w h e n y o l a s t a c c e s s e d a f i l e . T h c o m m a n d f o t w e n t r i e s i n t h t a b l e o c o n t e n t s l o o k s l i k e t h i s :

S E E : [ C R E A T E = O N , U P D A T E = O N ]T h i s d i r e c t o r y i t h e n d i s p l a y e d :

D i r e c t o r y f o D r i v e B

N a m e B y t e s R e c s A t t r i b u t e s P r o t U p d a t e C r e a t e

T E X T . T X T 5 3 D I R R W N O N E 0 4 / 1 7 / 8 5 : 1 0 : 0 0 0 1 / 0 1 / 8 5 0 9 : 0 0F I B U 2 0 K 1 5 S Y R O N O N E 0 4 / 1 7 / 8 5 : 1 6 : 4 3 0 1 / 0 1 / 8 2 1 9 : 2 1

7

Page 84: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 84/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

5 . S E T D E F

A f t e r C P / M r e c e i v e s c o m m a n d , i a l w a y s l o o k s f o t h e s p e c i f i e d f i l e o t h d i s k d r i v e c u r r e n t l y i u s e — i n d i c a t e d b t h e t h e d r i v e d e s i g n a t o r d i s p l a y e do n s c r e e n . T h S E T D E F c o m m a n d l e t s y o a l t e r t h i s . F o e x a m p l e , i y o a r w o r k i n g w i t h d r i v e b u h a v e a l y o u r C P / M f i l e s s t o r e d o d r i v e A ,S E T D E F w i l l a l l o w y o t t e l l C P / M t h s e a r c h p a t h t u s e . I t h i s w a y o c a s t o r e a n r e t r i e v e p r o g r a m s f r o m t h c o r r e c t d i s k d i r v e a u t o m a t i c a l l y ,w i t h o u t h a v i n g t s p e c i f y t h d r i v e d e s i g n a t o r e v e r y t i m e .

I y o e n t e r :

S E T D E F < R E T U R N >y o u ' l l r e c e i v e i n f o r m a t i o n a b o u t t h e c u r r e n t s e a r c h p a t h , w h i c h d i s k d r i v e i u s e d f o t e m p o r a r y f i l e s , a n w h a t t y p e o f i l e i b e i n g s o u g h t . I l o o k s l i k et h i s o t h s c r e e n :

D r i v e S e a r c h P a t h :1 s D r i v e D e f a u l tS e a r c h O r d e r C O T e m p o r a r y D r i v e D e f a u l tC o n s o l e P a g e M o d e O P r o g r a m N a m e D i s p l a y O f

Y o c a c h a n g e t h s e a r c h p a t h w i t h t h f o l l o w i n g c o m m a n d :S E T D E F A

T h i s c o m m a n d i n s t r u c t s C P / M t s e a r c h f o a n r e t r i e v e t h d e s i r e d f i l e s o d r i v e o n l y , e v e n i y o a r p r e s e n t l y w o r k i n g o d r i v e B Y o c a e x p a n dt h c o m m a n d l i k e t h i s :

S E T D E F A : , *

C P / M t h e n f i r s t l o o k s f o t h f i l e s o d r i v e A a n t h e n o t h e d r i v ec u r r e n t l y i u s ( r e p r e s e n t e d b t h e a s t e r i s k ) E a c h t i m e y o e n t e rS E T D E F c o m m a n d , y o g e a i n f o r m a t i o n l i s t a s f o l l o w s : .

7

Page 85: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 85/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D r i v e S e a r c h P a t h :1 s D r i v e - A 2 n D r i v e D e f a u l t

Y o c a h a v e t h i s i n f o r m a t i o n s e n t t t h p r i n t e r w i t h < C O N T R O L > P

I y o w a n t t e m p o r a r y f i l e s ( l i k e t h o n e s P I u s e s ) t b w r i t t e n t os p e c i f i e d d r i v e , e n t e r :

S E T D E F [ T E M P O R A R Y = E : ]

T h i s c o m m a n d w i l l w r i t e t e m p o r a r y f i l e s t t h v i r t u a l d r i v e E C P / Mr e c o g n i z e s t h t e m p o r a r y f i l e s b e c a u s e t h e i r $ $ f i l e e x t e n s i o n s , a d i s c u s s e d p r e v i o u s l y ,

S E T D E F n o r m a l l y o n l y s e a r c h e s f o f i l e s w i t h C O o S U e x t e n s i o n . B d e f a u l t , C P / M s e a r c h e s f o C O f i l e s f i r s t , b u t h i s o r d e r c a b c h a n g e dw i t h t h f o l l o w i n g c o m m a n d :

S E T D E F [ O R D E R = ( S U B , C O M ) ]

T h i s c h a n g e s t h s e a r c h o r d e r s o t h a t S U f i l e s a r s o u g h t f i r s t . S U f i l e sa r c a l l e d w i t h t h S U B M I T c o m m a n d , a n c o n t a i n a b a t c h o r u n a b l ec o m m a n d s . W e ' l l d i s c u s s t h S U B M I T c o m m a n d i d e t a i l s h o r t l y .

7

Page 86: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 86/316

Page 87: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 87/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A A c t i v e U s e rA A c t i v e F i l e s : 1 1 A o f i l e s 2 1 A N u m b e r o f r e e d i r e c t o r y e n t r i e s : 2

I y o s i m p l y e n t e r :

S H O W A : [ D I R ]y o u l l j u s t b s h o w n t h n u m b e r o f r e e d i r e c t o r y e n t r i e s — y o u g e t h l a s tl i n e o t h p r e v i o u s s c r e e n d i s p l a y .

T h S H O W c o m m a r d i c l o s e l y r e l a t e d t t h C P / M 2 . c o m m a n d S T A T .C P / M 3 . f e a t u r e s s e v e r a l n e c o m m a n d s t h a t a r d e r i v e d f r o m t h s i n g l eC P / M 2 . S T A T c o m m a n d . T h e r e f o r e , t h S H O W c o m m a n d i m o r ep o w e r f u l a n u s e r - f r i e n d l y t h a n i t p r e d e c e s s o r , a n h a n o n e o i t l i m i t a t i o n s .

7

Page 88: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 88/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

5 . 1 1 S U B M I T

Y o u V e l e a r n e d t e n t e r C P / M c o m m a n d s t h r o u g h t h k e y b o a r d . B y n o wy o u V e p r o b a b l y n o t i c e d t h a t y o h a v e t t y p e i t h s a m e c o m m a n d s a n s a m e i n s t r u c t i o n s o v e r a n o v e r a g a i n . T h i s r e d u n d a n t i n p u t c a g e q u i t ea n n o y i n g . C P / M h a c o m m a n d t r e l i e v e y o o t h i s b u r d e n .

T h S U B M I T c o m m a n d l e t s y o s t o r e " b a t c h 1 1 o o f t e n - u s e d c o m m a n d sa n t h 1 2 w i l l t r e a t t h e m l i k e k e y b o a r d i n p u t . S U B M I T f i l e h a t h e x t e n s i o n S U B .

T h S U B M I T c o m m a n d c a m a k e r e p e t i t i v e C P / M t a s k s m u c h e a s i e r . F o e x a m p l e , t h 1 2 d o e s n ' t h a v e b u i l t - i n c l o c k . C o n s e q u e n t l y , y o h a v e t e n t e r t h e t i m e a n d a t e e v e r y t i m e y o b o o t u t h c o m p u t e r . I y o w a n t t r e q u i r e a u p - t o - d a t e t i m e s t a m p o e v e r y f i l e a c c e s s , y o c a m a k e u s e o ft h f i l e P R O F I L E . S U B . T h i s f i l e w i l l b a c c e s s e d a n r u a f t e r e v e r y b o o to r e s t a r t . T h f i l e ' s c o m m a n d s w i l l b e u s e d a S U B M I T f i l e .p r o f i l e S U i c o m p a r a b l e t t h A U T O E X E C . B A f i l e s o t h I B P a n c o m p a t i b l e s .I y o d e c i d e t h a t t h t i m e a n d a t e s h o u l d b e n t e r e d , y o d o n ' t e n t e r i i t h u s u a l w a y . Y o w r i t e t h e f i l e l i k e t h i s :

A : D A T E S E

a n n a m e t h i s f i l e P R O F I L E . S U B . ( Y o u c a a l s o e n t e r a n o t h e r d i s k d r i v e ,p r o v i d i n g i c o n t a i n s t h D A T E . C O f i l e ) . D o n ' t f o r g e t t h e S U e x t e n s i o n .

I y o w a n t t e n t e r f i l e t h r o u g h t h k e y b o a r d , y o c a u s t h e d i t o r E D S i n c e E i q u i t e d i f f i c u l t t u s e , t h e r e i s t i l l a n o t h e r p o s s i b i l i t y : b u s i n gt h P I c o m m a n d s . Y o c a e n t e r f i l e s t h r o u g h t h k e y b o a r d w i t h t h I c o m m a n d , b u c a n n o t e d i t t h e m :

P I P R O F I L E . S U B = C O N :W a i t u n t i l t h d i s k d r i v e s t o p s r u n n i n g . E n t e r t h l i n e o t e x t a b o v e( A D A T E S E T ) a n t h e n h i < R E T U R N > . I y o w a n t t e n t e r s e v e r a ll i n e s , c o n t i n u e t m a k e e n t r i e s . Y o m u s t e n t e r < C O N T R O L > a t h l a s tl i n e .

7

Page 89: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 89/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

S U f i l e h o l d s m a n y p o s s i b i l i t i e s . I c a c o n t a i n C P / M c o m m a n d s ,i n t e r l o c k e d S U B M I T c o m m a n d s , o i n p u t p r o g r a m s o C P / M c o m m a n d s .Y o c a a l s o u s p a r a m e t e r s i S U f i l e . T h e s e p a r a m e t e r s a r r e p r e s e n t e db d o l l a r s i g n s ( $ ) . Y o c a u s t h p a r a m e t e r s $ 1 t h r o u g h $ 9 F o e x a m p l e , e n t e r t h e f o l l o w i n g l i n e s :

E R $ 1 . B A KD I * . $ 2

N a m e t h i s f i l e D I R . S U B . T h s e o c o m m a n d s i t h i s f i l e f i r s t e r a s e a l f i l e s w i t h p a r t i c u l a r n a m e a n w i t h t h e x t e n s i o n . B A K . T h e n i d i s p l a y sa l t h f i l e s w i t h p a r t i c u l a r e x t e n s i o n . T r u t h f i l e , y o e n t e r :

S U B M I T D I R T E X T C O M

H e r e D I i t h n a m e o t h S U B M I T f i l e , a n T E X T a n C O r e p l a c e t h p a r a m e t e r s $ a n $ 2 W h e n t h f i l e i r u n , f i r s t a l l t h f i l e s w i t h B A o $ e x t e n s i o n a r e e r a s e d . T h e n a l t h f i l e s w i t h C O e x t e n s i o n a r d i s p l a y e d ( p r o v i d e d t h S U B M I T . C O f i l e a n t h S U f i l e a r o t h s a m ed i s k s i d e : o t h e r w i s e t h v i r t u a l d r i v e m u s t b u s e d ) . T h " t r a n s l a t e d "S U B M I T f i l e — t h e s u b m i t f i l e s w i t h i t i n p u t t e d p a r a m e t e r s — l o o k s l i k e t h i s :

E R T E X T . B A KD I * . C O M

C P / M u s e s t h e s e c o m m a n d s a i t h e y w e r e e n t e r e d t h r o u g h t h k e y b o a r d .

I y o e n t e r f e w e r p a r a m e t e r s t h a n t h e r e a r e i t h S U B M I T f i l e , t h o s ep a r a m e t e r s w o n ' t b u s e d . I y o e n t e r m o r e p a r a m e t e r s t h a n t h S U B M I Tf i l e c o n t a i n s , t h e x t r a e n e o u s p a r a m e t e r s a r i g n o r e d . I y o u w a n t t u s d o l l a r s i g n i c o m m a n d i n s i d e S U B M I T f i l e , e n t e r t w d o l l a r s i g n s ( $ $ ) .

S U B M I T f i l e c a a l s o e x e c u t e c o m m a n d i n p u t f o p r o g r a m s . Y o c a c a l lp r o g r a m w i t h o n c o m m a n d l i n e a n u s t h n e x t t e n t e r c o m m a n d s t

t h e c a l l e d p r o g r a m . F o e x a m p l e :

P I < B : = A : * . C O MD I * . C O M

7

Page 90: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 90/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h i s s m a l l S U B M I T f i l e c a l l s P I P . C O i t h f i r s t l i n e . T h s e c o n d l i n e i t h c o m m a n d t c o p y a l t h C O f i l e s t d r i v e B T h t h i r d l i n e e x i t s I P a n t h e f o u r t h d i s p l a y s t h d i r e c t o r y . A l c o m m a n d s t b e n t e r e d i n t op r o g r a m a r i d e n t i f i e d w i t h l e s s t h a n s i g n ( < ) . I f y o e n t e r c o m m a n dw i t h o u t a d d i t i o n a l p a r a m e t e r s , a w i t h t h t h i r d l i n e , i s i g n i f i e s< R E T U R N > , w h i c h i t h i s c a s e e n d s I P T h S U B M I T c o m m a n d c a b q u i t e u s e f u l / F o r e x a m p l e , y o c a e x e c u t es e r i e s o f i l e s a n g g e s o m e t h i n g t e a w h i l e t h e y r u n . Y o w r i t e t h c o m m a n d f i l e l i k e t h i s :

P I L S T : = F I L E 1P I L S T : = F I L E 2P I L S T : = F I L E 3

P I L S T : = F I L E 9Y o c a n a c c o m p l i s h t h s a m e t h i n g w i t h t h f o l l o w i n g c o m m a n d l i n e :

P I L S T : = F I L E ?

N a m e t h f i l e b u n c h S U a n e n t e r t h e f o l l o w i n g b e f o r e y o l e a v e :

S U B M I T B U N C H S U < R E T U R N >Y o c a a l s o s t o r e t h i n d i v i d u a l f i l e s o d i f f e r e n t d i s k d r i v e s . Y o n e e do n l y w r i t e t h d r i v e d e s i g n a t o r i f r o n t o t h f i l e n a m e a n S U B M I Ts e a r c h e s f o a l t h f i l e s c o n c u r r e n t l y .

Y o c o u l d w r i t e c o m m a n d f i l e t l i s t a l t h d a t a f i l e s i a l t h U S E R a r e a so h a r d d i s k d r i v e . T h s c r e e n o u t p u t c a t h e n b w r i t t e n t o n e f i l ew i t h t h n a m e C o n t e n t s . I t h i s f i l e y o c a l o o k f o s p e c i f i e d f i l e w i t h

s e a r c h c o m m a n d i y o u r t e x t p r o g r a m , o p r i n t t h f i l e l i s t .

7

Page 91: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 91/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

5 . 1 2 T h h e l p c o m m a n d

B t h i s t i m e , y o u ' r e p r o b a b l y h a v i n g t r o u b l e r e m e m b e r i n g a l o t h m a n yC P / M c o m m a n d s , n o t m e n t i o n a l t h e i r o p t i o n s . F o r t u n a t e l y C P / Mc o n t a i n s h e l p p r o g r a m t r e m i n d y o o a l t h c o m m a n d c o d e s a n t h e i ro p t i o n s . Y o n e e d o n l y t e l l C P / M w h e r e y o n e e d h e l p .

S i m p l y e n t e r t h e c o m m a n d H E L P :A : > H E L P

m e n u w i t h t h p o s s i b l e h e l p i n f o r m a t i o n p a c k a g e s i d i s p l a y e d o t h s c r e e n . T h e r e y o c h o o s e s u b p o i n t a n w i l l r e c e i v e i n f o r m a t i o n a b o u t i t

I n c i d e n t a l l y , t h C o m m o d o r e 1 2 8 ! s k e y b o a r d f e a t u r e s < H E L P > k e t h a tn o r m a l l y d i s p l a y s p r o g r a m e r r o r i t h B A S I C o p e r a t i n g s y s t e m . U n d e rC P / M , p r e s s i n g t h i s k e d i s p l a y s t h w o r d H E L P o n s c r e e n , w i t h o u t a a u t o m a t i c < R E T U R N > . T h i s a l l o w s y o t e n t e r w o r d a f t e r i w h e n y o k n o w w h i c h t o p i c y o n e e d a s s i s t a n c e w i t h .

T h f o l l o w i n g i d i s p l a y e d t h s c r e e n w h e n y o e n t e r H E L P w i t h o u ts p e c i f y i n g t o p i c :

H E L P U T I L I T Y V I . 1A " H E L P > f l e n t e r t o p i c [ s u b t o p i c ] . .

E X A M P L E : H E L P > D I E X A M P L E S

T o p i c s a v a i l a b l e :

C 1 2 8 _ _ M O D E C O M M A N D S C N T R L C H A R S C O P Y S Y S D A T E D E V I C ED I G E L I N KR M A CS U B M I TH E L P >

D U M PH E L PM A S A V ET Y P E

E H E X C O MP A T C HS E U S E R

E R A S EI N I T D I RP I ( C O P Y )S E T D E FX R E F

F I L E S P E CK E Y F I GP U S H O W

G E N C O ML I R E N A M ES I

7

Page 92: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 92/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

Y o c a a l s o e n t e r t h e s u b t o p i c s d i r e c t l y . F o e x a m p l e , y o c a e n t e r :

H E L P S E T D E F

T h i s d i s p l a y s h e l p i n f o r m a t i o n o S E T D E F d i r e c t l y .

T h H E L P p r o g r a m i c o n t a i n e d i t h f i l e H E L P C O a n H E L P H L P . T a l t e r t h e s e f i l e s , c a l l t h f i l e h e l p C O a n e n t e r t h e x t r a c t o p t i o n :

H E L P [ E X T R A C T ]T h f o l l o w i n g d i s p l a y w i l l a p p e a r o t h s c r e e n :

E x t r a c t i n g D a t a . . . E x t r a c t i o n c o m p l e t eH E L P . D A T C r e a t e d

Y o c a a b b r e v i a t e t h e E X T R A C T t a E T h H E L P p r o g r a m t h e n c r e a t e sn e f i l e w i t h t h n a m e H E L P D A Y o c a c h a n g e t h i s f i l e a y o s e f i u s i n g y o u r t e x t e d i t o r . B u s i n g t h E X T R A C T o p t i o n y o s e i u s t h a ty o c a e d i t t h t o p i c s .

T e n t e r n e h e l p t e x t , y o m u s t f o l l o w c e r t a i n f o r m a t r u l e s . E v e r y o p t i o nw o r d m u s t b e g i n w i t h t h r e e s l a s h e s ( / / / ) a n n u m b e r . T h e n u m b e r g i v e st h h e l p s t e p s o t h o p t i o n . F o e x a m p l e :

< R E T U R N >/ / / 2 O P T I O N S < R E T U R N >/ / / 3 P A R A M E T E R S < R E T U R N >/ / / 4 E X A M P L E S < R E T U R N >

O n c e y o u V e m a d e y o u r c h a n g e s , s t o r e t h d a t a a n c a l l H E L P C O a g a i n ,b u t h i s t i m e w i t h C R E A T E o p t i o n ( a b b r e v i a t e d C ) T h i s c r e a t e s n e H E L P H L f i l e t h a t c o n t a i n s y o u r t e x t a l t e r a t i o n s .

8

Page 93: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 93/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

5 . 1 3 S u m m a r y

Y o u ' v e l e a r n e d a b o u t t h t r a n s i e n t c o m m a n d s o C P / MY o k n o w t h o p t i o n s t h a t c h a n g e o e x p a n d t h e t a s k s o t h t r a n s i e n t c o m m a n d sY o k n o w t h a t f i l e s c a n b e g i v e n l a b e l s

Y o u V e s e e n h o w w e c a p r o t e c t a e n t i r e d i s k , f i l e , o a i n d i v i d u a l C P / M c o m m a n d f o r e s t r i c t e d u s Y o k n o w h o t p r e p a r e t i m e s t a m p f o y o u r f i l e s t h a tf u r n i s h e s t h e t i m e a n d a t e o w h e n f i l e w a l a s t a c c e s s e d .

Y o k n o w h o t a l t e r t h f i l e s e a r c h p a t h w i t h S E T D E FY o k n o w h o t d i s p l a y t h s y s t e m f i l e s o a d i s k u s i n gS H O W

Y o c a u s t h P R O F I L E . S U f i l e t m a k e y o u rc o m p u t e r ' s b o o t r o u t i n e a u t o m a t i c a l l y r u p r o g r a m

8

Page 94: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 94/316

Page 95: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 95/316

Page 96: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 96/316

Page 97: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 97/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

E v e r y t h i n g a b o u t P I

Y o u V e a l r e a d y h e a r d a b o u t s o m e o t h c a p a b i l i t i e s o p i p . H e r e i c o m p l e t e l i s t o i t c a p a b i l i t i e s :

T r a n s f e r s i n g l e f i l e f r o m o n d i s k e t t e t a n o t h e rT r a n s f e r g r o u p o f i l e s f r o m o n d i s k e t t e t a n o t h e rC o p y f i l e a n r e n a m e i F o r m a t t e x t f o r p r i n t i n gS h o r t e n l i n e s o t e x t i n f i l e

♦ P r i n t g r o u p o f i l e sM e r g e s e v e r a l f i l e s i n t o o n A c c e s s s e c t i o n o t e x t f i l eC h a n g e l o w e r c a s e l e t t e r s t u p p e r c a s e l e t t e r s a n v i c e v e r s aR e s e t t h e e i g h t h o f l a g b i o b y t e t z e r oI n s e r t l i n e n u m b e r s i n t o f i l eD i s p l a y f i l e d u r i n g t r a n s f e rT r a n s f e r s y s t e m f i l e sC o p y f i l e s f r o m o n u s e r a r e a t a n o t h e rA u t o m a t i c a l l y b a c k u n e o a l t e r e d f i l e s

A y o c a s e e , t h e r e a r e m a n y u s e s f o p i p . Y o m i g h t d w e l l t r e a dt h i s c h a p t e r t h o r o u g h l y s t h a t y o m a u s I t y o u r g r e a t e s t a d v a n t a g e .

8

Page 98: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 98/316

Page 99: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 99/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

U s i n g t h i s m e t h o d , P I i m m e d i a t e l y b e g i n s c o p y i n g ; w h e n i h a f i n i s h e d ,i d i s p l a y s t h e p r o m p t ( A > ) . Y o p r o b a b l y n o t i c e d t h a t w d i d n ' t e n t e rf i l e n a m e f o d r i v e B T h f i l e n a m e d e f a u l t s t o t h s a m e n a m e a t h f i l eb e i n g c o p i e d . T c h a n g e t h f i l e n a m e w h e n y o c o p y , e n t e r :

P I B : T E X T l . T X T = A r T E X T . T X TT h i s l e t s y o c o p y f i l e a n c h a n g e i t n a m e a t h s a m e t i m e .B e f o r e c o p y i n g f i l e s t a n o t h e r d i s k e t t e , y o s h o u l d m a k e s u r e t h a t t h e r e i e n o u g h s p a c e o t h a t d i s k e t t e f o r t h e n e f i l e .

P I t r a n s f e r s e a c h f i l e t t e m p o r a r y f i l e t h a t h a t h s a m e f i l e n a m e , b u w i t h t h e x t e n s i o n $ $ $ . A e a c h f i l e i s u c c e s s f u l l y t r a n s f e r r e d , p i r e n a m e s t h t e m p o r a r y f i l e w i t h t h s p e c i f i e d f i l e n a m e .W h a t h a p p e n s w h e n y o t r t c o p y f i l e t d i s k e t t e t h a t a l r e a d y h a s t h a tp a r t i c u l a r f i l e n a m e — f o r e x a m p l e , T E X T . T X F i r s t , I t r a n s f e r s t h f i l et t e m p o r a r y f i l e c a l l e d T E X T $ $ $ . N e x t t h o l v e r s i o n o t h f i l et e x t T X o t h e d e s t i n a t i o n d i s k e t t e i e r a s e d . F i n a l l y t e x t $ $ i r e n a m e d T E X T . T X T . I t h d e s t i n a t i o n d i s k e t t e d o e s n ' t h a v e e n o u g h s p a c ef o t h n e f i l e , t h e n y o w i l l h a v e t e r a s e t h o l T E X T . T X f i l e f i r s t .

A y o t r a n s f e r f i l e s u s i n g p i w i t h o u t s p e c i a l o p t i o n s , t h e f i l e a t t r i b u t e ss u c h a S Y S , D I R , r o a n R a r a l s o t r a n s f e r r e d . I f y o t r a n s f e rS Y S T E M f i l e , t h c o p y w i l l a l s o b s y s t e m f i l e .

I y o t r a n s f e r f i l e t d e s t i n a t i o n d i s k e t t e t h a t h a t h s a m e f i l e n a m e a n i w r i t e - p r o t e c t e d ( R O ) , I a s k s y o t c o n f i r m t h a t i s h o u l d e r a s e t h i sf i l e . R e s p o n d w i t h e i t h e r o a a p p r o p r i a t e .

8

Page 100: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 100/316

Page 101: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 101/316

A b a c u s S o f t w a r e c . 1 2 8 C P / M U s e r ' s G u i d e

6 . M e r g i n g d a t a f i l e s

I y o w a n t t m e r g e t h c o n t e n t s o t w o m o r e f i l e s i n t o s i n g l e f i l e , y o c a d t h i s w i t h p i p . N o r m a l l y t h e s e f i l e s m u s t b t e x t f i l e s . M e r g i n g C O f i l e s p r o d u c e s a n o n - e x e c u t i b l e p r o g r a m .T m e r g e ( o c o n c a t e n a t e ) f i l e s u s i n g p i p , t h f i l e n a m e s t b c o m b i n e d a r s e p a r a t e d b c o m m a s :

P I A L L . T X T = P A R T 1 . T X T , P A R T 2 . T X T , P A R T 3 . T X TT h i s a s s u m e s t h a t a l o t h f i l e s a r c o n t a i n e d o t h s a m e d r i v e . I f t h f i l ei t b m e r g e d i n t o d i f f e r e n t U S E R a r e a , e n t e r :

P I A L L . T X T [ G 3 ] = P A R T 1 . T X T , P A R T 2 . T X T , P A R T 3 . T X TA n t a s s u r e t h a t t h f i l e s a r v e r i f i e d a t h e y a r m e r g e d , i n c l u d e t h [ V o p t i o n :

P I A L L . T X T [ G 3 ] = P A R T 1 . T X T [ V ] , P A R T 2 . T X T [ V ] , P A R T 3 . T X T [ V ]I y o t r t m e r g e n o n - t e x t f i l e s , y o m a e n c o u n t e r p r o b l e m s . P I u n d e r s t a n d s t h < C O N T R O L > c h a r a c t e r a s t h e e n d - o f - f i l e c h a r a c t e r .N o n - t e x t f i l e s m a c o n t a i n < C O N T R O L > c h a r a c t e r s .

I y o u s I t o t r a n s f e r C O f i l e , t h e n < C O N T R O L > c h a r a c t e r i t r a n s f e r r e d n o r m a l l y ; i i n o a e n d - o f - f i l e i n d i c a t o r . I n s t e a d , p i c o n t i n u e s t c o p y u n t i l t h a c t u a l e n d - o f - f i l e .

T c o p y f i l e s t h a t a r n e i t h e r t e x t f i l e s n o C O f i l e s , u s t h [ 0 o p t i o nf o l l o w i n g t h e f i l e n a m e :

P I A L L . D A T = P 1 . D A T [ O ] , P 2 . D A T [ 0 ]

8

Page 102: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 102/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . L i n e n u m b e r i n g

I c a a l s o i n s e r t l i n e n u m b e r s i n t o t e x t f i l e . T h i s f e a t u r e i o f t e n u s e db p r o g r a m m e r s o w r i t e r s w h w a n t t o i d e n t i f y t h e i r l i n e s o t e x t b n u m b e r . I y o c o p y f i l e u s i n g t h o p t i o n s , l i n e n u m b e r i i n s e r t e d a t h b e g i n n i n g o e a c h l i n e o t e x t :

P I T E X T N R . T X T = T E X T . T X T [ N ]

T h t e x t n o a p p e a r s l i k e t h i s :

1 T h i s i y o u r t e x t2 n u m b e r e d b l i n e .3 P r a c t i c a l , i s n ' t i t

Y o c a a l s o i n s e r t s i d i g i t l i n e n u m b e r b u s i n g t h N o p t i o n :P I T E X T N R . T X T = T E X T . T X T [ N 2 ]

T h t e x t n o a p p e a r s l i k e t h i s :

0 0 0 0 0 1 T h i s i y o u r t e x t0 0 0 0 0 2 n u m b e r e d b l i n e u s i n g o p t i o n N 2 0 0 0 0 0 3 A l s o p r a c t i c a l , i s n ' t i t

T h l i n e n u m b e r s a r a s s i g n e d s e q u e n t i a l l y a n t h o r d e r c a n ' t b c h a n g e d .

6 . C o n v e r t i n g b e t w e e n u p p e r c a s e a n l o w e r c a s eT c o n v e r t t h t e x t o f i l e t a l u p p e r c a s e , y o c a u s t h [ U o p t i o n :

P I C O N : = T E X T . T X T [ U ]T c o n v e r t t h t e x t o f i l e t a l l o w e r c a s e , y o c a u s t h [ o p t i o n :

P I C O N : = T E X T . T X T [ L ]

9

Page 103: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 103/316

Page 104: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 104/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . P r i n t i n g d a t a f i l e s

W a l r e a d y t a l k e d a b o u t t o g g l i n g t h p r i n t e r t o g e h a r d c o p y . B p r e s s i n g< C O N T R O L > P s c r e e n o u t p u t i s e n t t t h p r i n t e r . T p r i n t f i l e y o c o u l d d t h e f o l l o w i n g :

< C O N T R O L > P t o g g l e p r i n t e r o T Y P E T E X T . T X T l i s t f i l e< C O N T R O L > P t o g g l e p r i n t e r o f

A a l t e r n a t e w a t d t h i s i t u s t h P I o p t i o n t t r a n s f e r t h f i l e t t h p r i n t e r . T h p r i n t e r i d e s i g n a t e d b t h L S T : d e v i c e , s y o c a e n t e r :

P I L S T : = T E X T . T X TO c o u r s e , y o c a a l s o p r i n t m u l t i p l e f i l e s o n a f t e r t h o t h e r :

P I L S T : = T E X T 1 . T X T , T E X T 2 . T X T , T E X T 3 . T X TO t h e r o p t i o n s a r e a v a i l a b l e t o i n s e r t l i n e n u m b e r s , s e T A B s , a n e j e c t n e p a g e e v e r y 6 l i n e s . W e ' l l s e t h e s e o p t i o n s l a t e r .

9

Page 105: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 105/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . A u t o m a t i c a l l y b a c k i n g u d a t a f i l e s

A y o u s C P / M , y o u ' l l f i n d y o u r s e l f c r e a t i n g a n m o d i f y i n g m a n yd i f f e r e n t f i l e s . T h e n , i c a s e o n o t h f i l e s i a c c i d e n t a l l y ( o d e l i b e r a t e l y )d e s t r o y e d , y o w i l l s t i l l h a v e b a c k u p c o p y o y o u r d a t a .C P / M h a m e t h o d t h e l p y o o r g a n i z e y o u r b a c k u p c o p i e s .E a c h f i l e h a w h a t i c a l l e d a a r c h i v e f l a g . f i l e ' s a r c h i v e f l a g i n d i c a t e s i

b a c k u p h a b e e n m a d e u s i n g p i p . W h e n f i l e i c r e a t e d o u p d a t e d , i t a r c h i v e f l a g i s e t t o 1 W h e n b a c k u p i m a d e , t h f l a g i r e s e t t 0

U s u a l l y b a c k u p s a r t i m e - c o n s u m i n g , b e c a u s e c o p i e s a r m a d e o e a c h f i l e .Y o c a s a v e t i m e b u s i n g t h [ A ] o p t i o n o P I P , w h i c h c o p i e s f i l eo n l y i t h f i l e i s n e o i c h a n g e d — t h a t i s i t h f i l e ' s a r c h i v e f l a g i 1

T m a k e b a c k u p c o p y o t h n e o c h a n g e d T X f i l e s , e n t e r : :

P I B : = A : * . T X T [ A ]T h i s c o p i e s a n T X f i l e s t t h d i s k e t t e i d r i v e i t h a r c h i v e f l a g i 1 Y o u ' l l p r o b a b l y w a n t t i n s u r e t h a t t h c o p i e s a r e t r a n s f e r r e d w i t h o u t e r r o r ,s y o c a u s t h e [ V ] o p t i o n :

P I B : = A : * . T X T [ A V ]I y o d i s p l a y t h e d i r e c t o r y o t h d i s k e t t e i n d r i v e u s i n g :

D I R [ F U L L ]t h e n t h k e y w o r d a r c v a p p e a r s u n d e r t h a t t r i b u t e s i n d i c a t i n g w h i c h f i l e sw e r e b a c k e d u p

9

Page 106: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 106/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . 1 0 O v e r w r i t i n g w i t h o u t p r o m p t s

N o r m a l l y P I o v e r w r i t e s f i l e o d e s t i n a t i o n d i s k e t t e i t h f i l e n a m e i t h s a m e a t h o n t h a t i b e i n g t r a n s f e r r e d . B u i t h f i l e o t h d e s t i n a t i o nd i s k e t t e i p r o t e c t e d b t h R a t t r i b u t e ( S E T c o m m a n d ) , t h e n t h f o l l o w i n gm e s s a g e a p p e a r s :

D E S T I N A T I O N F I L E I R / O , D E L E T E ( Y / N ) ?Y o c a o v e r w r i t e t h f i l e b p r e s s i n g Y o a b o r t t h o p e r a t i o n b p r e s s i n gN T a v o i d h a v i n g t r e s p o n d t t h i s p r o m p t , y o c a u s t h [ W ] o p t i o n o p i p . F o e x a m p l e :

S E T T E X T . T X T [ R O ]P I T E X T . T X T = N E W . T X T [ W ]

w i l l a l l o w t h f i l e T E X T . T X t b o v e r w r i t t e n , e v e n t h o u g h i h a b e e np r e v i o u s l y s e t r e a d o n l y .

9

Page 107: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 107/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . 1 1 C o p y i n g s y s t e m d a t a f i l e s

P I n o r m a l l y c a n n o t c o p y f i l e w i t h t h S Y S t e m a t t r i b u t e . B u s i n g t h [ R o p t i o n , P I i a b l e t f i n d t h S Y S T E M f i l e . T c o p y d i s k e t t e w i t h

S Y S T E M f i l e s e n t e r :

P I B : = A : * . C O M [ R ]

T d e t e r m i n e i s y s t e m f i l e s a r c o n t a i n e d o d i s k e t t e , u s t h D I R S Y Sc o m m a n d .

6 . 1 2 T i d y i n g u t h 8 t b i

A S C I I c h a r a c t e r s c a b c o d e d i s e v e n b i t s o f a n e i g h t - b i t b y t e . T h e i g h t hb i i u n u s e d .

S o m e p r o g r a m s s u c h a W o r d S t a r ® u s t h e i g h t h b i f o s p e c i a l p u r p o s e s .O t h e r p r o g r a m s r e q u i r e t h e e i g h t h b i t r e m a i n u n u s e d — f o r e x a m p l e ,M B A S I C ® , t h B A S I C i n t e r p r e t e r f o C P / M . I y o u s W o r d S t a rd o c u m e n t m o d e t e d i t M B A S I C p r o g r a m , t h p r o g r a m w i l l n o r u c o r r e c t l y , s i n c e W o r d S t a r u s e s t h e i g h t h b i t . Y o c a f i t h i s p r o b l e mu s i n g P I P f s o p t i o n :

P I N E W P R O G . B A S = B A D P R O G B A [

T h i s " s t r i p s " a n y u s e d e i g h t h b i t s f r o m t h f i l e B A D P R O G . B A S a i t r a n s f e r s t h e c o n t e n t s t N E W P R O G . B A S .

9

Page 108: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 108/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . 1 3 P r a c t i c a l e x a m p l e s

I t h i s f i n a l s e c t i o n o t h i s c h a p t e r , w e l l c o v e r f e e x a m p l e s u s i n g p i i v a r i o u s " r e a l - l i f e " a p p l i c a t i o n s . Y o u V e g o t t e n t k n o w v a r i o u s p i o p t i o n s a n a l s o l e a r n e d t h a t y o c a u s t h e m t o g e t h e r .

T g e h a r d c o p y y o c a e n t e r :

P I L S T : T E X T . T X T [ N T 8 P 6 0 ]T h f i l e T E X T T X i p r i n t e d t t h L S T : d e v i c e . E a c h l i n e i n u m b e r e d

[ N ] , t h e t a b s a r s e a c o l u m n [ T ] a n e a c h p a g e w i l l c o n t a i n am a x i m u m o 6 l i n e s o t e x t P 6 ]

T d i s p l a y t h e t e x t i l o w e r c a s e , e n t e r :

P I L S T r T X T . T X T [ N T 8 P 6 0 L ]H e r e w e ' v e a d d e d t h [ L ] o p t i o n t d t h i s .

S u p p o s e y o w a n t t b a c k u f i l e s o d a i l y b a s i s . T d t h i s y o e n t e r :

P I A : = B : * . * [ W A R ]T h o p t i o n [ W A R ] w o r k s a f o l l o w s : t h [ R ] o p t i o n c o p i e s t h s y s t e mf i l e s , t h [ W o p t i o n o v e r w r i t e s a n r e a d o n l y f i l e s , a n t h [ A ] o p t i o nc o p i e s o n l y f i l e s t h a t h a v e n o b e e n p r e v i o u s l y c o p i e d .

Y o c a c r e a t e s u b m i t f i l e ( l e t ' s c a l l i A R C H I V E S U B ) c o n t a i n i n g t h a b o v e c o m m a n d . S U B M I T f i l e i t e x t f i l e c o n t a i n i n g o n o m o r ec o m m a n d s . T h e n w c a e n t e r t h e c o m m a n d :

S U B M I T A R C H I V E

T h i s t a k e s t h e t e x t f r o m t h f i l e A R C H I V E . S U a n p e r f o r m s t h c o m m a n d s a i t h e y w e r e e n t e r e d a t h k e y b o a r d . T c r e a t ea r c h i v e . S U B , e n t e r :

A > P I P < R E T U R N >* A R C H I V E . S U B = C O N : < R E T U R N >P I P A : = B : * . * [ W A R ] < C O N T R O L >

9

Page 109: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 109/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

N e x t y o u c a S U B M I T t h i s f i l e . T h i s w i l l t r a n s f e r t h f i l e s t h a t h a v e n o b e e n b a c k e d u f r o m t h d r i v e t t h d r i v e .

Y o c a a l s o e n t e r :

S U B M I T A R C H I V E [ E

a n t h c o m m a n d s c o n t a i n e d i t h S U B M I T f i l e a r e c h o e d t t h s c r e e n .

N a t u r a l l y y o c a p u o t h e r c o m m a n d s s u c h a D I a n S H O W i t h S U B M I T f i l e . T h i s l e t s y o s e w h i c h f i l e s a n h o m a n y f i l e s a r c o p i e d ,a w e l l a t h a m o u n t o s p a c e c o n t a i n e d o t h e d e s t i n a t i o n d i s k e t t e .

T h 1 2 h a s e v e r a l m o r e d e v i c e d e s i g n a t i o n s t h a n o t h e r C P / M s y s t e m sh a v e , b e c a u s e o i t 4 0 a n 8 0 - c h a r a c t e r s c r e e n s . T h e s e d e s i g n a t i o n s a r a f o l l o w :

K E Y S4 C O 8 C O P R T 1P R T 2

k e y b o a r d o t h C o m m o d o r e 1 2 4 c h a r a c t e r s c r e e n8 c h a r a c t e r s c r e e ns e r i a l p r i n t e r ( d e v i c e n u m b e r 4 s e r i a l p r i n t e r ( d e v i c e n u m b e r 5

D w i n g n o t a t i o n s f o i n p u t a n o u t p u t a r a v a i l a b l e :

C O N I N :C O N O U T :A U X I N :a u x o u t :L S T :

K E Y S8 0 C O L ( 4 0 C O L )N u l l D e v i c eN u l l D e v i c eP R T 1

N o t e t h a t t h s t a n d a r d p r i n t e r o u t p u t i t s e r i a l p r i n t e r , w h i c h h a t h d e v i c e a d d r e s s 4

9

Page 110: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 110/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

6 . 1 4 S u m m a r y

I i o n o t h m o s t p o w e r f u l C P / M u t i l i t i e sY o c a t r a n s f e r s i n g l e f i l e t a n o t h e r d i s k e t t eY o c a n c o p y a e n t i r e d i s k e t t e o n t o a n o t h e rY o c a m e r g e s e v e r a l f i l e s i n t o o n Y o c a e x t r a c t s e c t i o n o f f i l eY o c a a u t o m a t i c a l l y n u m b e r t h l i n e s o f t e x t f i l eY o c a a u t o m a t i c a l l y b a c k u a l t e r e d f i l e s

♦ Y o u c a c o n v e r t u p p e r c a s e l e t t e r s i n t o l o w e r c a s e l e t t e r s a n v i c e v e r s aY o c a c o p y b e t w e e n U S E R a r e a s

9

Page 111: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 111/316

C h a p t e r

C P / M c o m p o n e n t s

7 . C P / M o n t h e C - 1 2 87 . S y s t e m d i s k e t t e f o 1 5 7 17 . V i r t u a l d i s k d r i v e7 . T h e C O P Y S Y S c o m m a n d7 . T h s t a t u s l i n e7 . 1 5 7 1 d i s k f o r m a t s7 . T h k e y b o a r d7 . K e y b o a r d v a l u e s7 . 8 . 1 D i s a b l i n g / e n a b l i n g 8 0 - c o l u m n c o l o r s e l e c t i o n7 . 8 . 2 C h a n g i n g k e y ' s A S C I I v a l u e7 . 8 . 3 D e f i n i n g t h e f u n c t i o n k e y s7 . k e y f i g f u n c t i o n s a n u s e s

Page 112: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 112/316

Page 113: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 113/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

7 . C P / M o t h C - 1 2 8

C P / M 3 . i s u p p o s e d t b i d e n t i c a l f o a l c o m p u t e r s , y e t h e r e a r e o f t e nu n i q u e f e a t u r e s o t h h a r d w a r e a n a r c h i t e c t u r e o t h m a c h i n e s r e q u i r es p e c i a l a d a p t a t i o n s o t h C P / M f u n c t i o n s .O n o t h m o s t o b v i o u s d i f f e r e n c e s b e t w e e n t h 1 2 8 ' s C P / M 3 . a n o t h e r s i t h a t t h e i r s y s t e m d i s k e t t e i s p e c i a l . T h i s d i s k e t t e c a b r e a d b e i t h e r t h 1 5 4 1 o 1 5 7 1 d i s k d r i v e . O n d r a w b a c k o t h i s a r r a n g e m e n t i t h a tt h 1 5 7 1 i n o a b l e t a c c e s s b o t h s i d e s o t h d i s k e t t e w i t h o u t t h u s e rr e m o v i n g i a n f l i p p i n g i o v e r t i t o t h e r s i d e . C O f i l e s a r l o c a t e d o b o t h s i d e s o t h d i s k e t t e , y e t t h e y m a b a c c e s s e d o n l y i t h 1 5 T o n e - s i d e d m o d e . M o r e a b o u t t h 1 5 7 1 n e x t .

7 . S y s t e m d i s k e t t e f o 1 5 7 1

T t a k e a d v a n t a g e o f t h 1 5 T g r e a t e r s t o r a g e c a p a c i t y y o n e e d t d l i t t l e e x t r a p r e p a r a t i o n . F i r s t o a l l , y o m u s t f o r m a t d i s k e t t e a d o u b l e - s i d e d . T y p e :

F O R M A TT h f o l l o w i n g a p p e a r s o t h s c r e e n :

P l e a s e s e l e c t d i s k t y p e t f o r m a tC 1 2 8 d o u b l e s i d e dC 1 2 8 s i n g l e s i d e dC 6 s i n g l e s i d e d

U s t h c u r s o r k e y s o t h u p p e r r o o t h k e y b o a r d t o s e l e c t C 1 d o u b l e s i d e d a n p r e s s t h e < R E T U R N > k e y . T h e n i n s e r t b l a n kd i s k e t t e i n t o t h d r i v e . P r e s s t h k e o n l y w h e n y o a r s u r e t h a t i i s a f et f o r m a t t h d i s k e t t e i t h d r i v e .

A f t e r t h i s i d o n e , y o w i l l c o p y b o t h s i d e s o t h o r i g i n a l s y s t e m d i s k e t t e t ot h n e s y s t e m d i s k e t t e . P l a c e t h o r i g i n a l w i t h t h l a b e l " 1 2 8 C P / MS Y S T E M D I S K E T T E " i d r i v e a n t y p e :

P I P E : = A i y o h a v e o n e d r i v e( o r ) P I B = A i y o h a v e t w d r i v e s

1 0

Page 114: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 114/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I y o a r u s i n g o n d r i v e , y o a r a s k e d t c h a n g e d i s k e t t e s s e v e r a l t i m e s .F o l l o w t h e s e i n s t r u c t i o n s , k e e p i n g i m i n d t h a t t h d e s t i n a t i o n d i s k e t t e i t h n e w l y f o r m a t t e d o n e .

A f t e r t h f i r s t s i d e o t h e o r i g i n a l h a b e e n c o p i e d , y o u m u s t c o p y t h s e c o n d s i d e . T d t h i s , i n s e r t t h o r i g i n a l s y s t e m d i s k e t t e i n t o t h d r i v ew i t h t h l a b e l f a c i n g d o w n a n e n t e r :

P I A = E * i y o h a v e o n e d r i v e( o r ) P I B : E : * . * i y o h a v e t w d r i v e s

A f t e r y o f i n i s h , y o w i l l h a v e d o u b l e - s i d e d s y s t e m d i s k e t t e . U s t h i sd i s k e t t e w i t h y o u r 1 5 7 1 a n t a k e a d v a n t a g e o f t h g r e a t e r s t o r a g e c a p a c i t ya n c o n v e n i e n c e o d o u b l e - s i d e d d i s k .

1 0

Page 115: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 115/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r s G u i d e

7 V i r t u a l d i s k d r i v e

B d e s i g n , t h C - 1 2 8 a l l o w s y o t u s u t f o u r d i s k d r i v e s . I 1 2 m o d e , t h e s e a r e a s s i g n e d d e v i c e n u m b e r s 8 9 1 a n 1 1 U n d e r C P / Mt h e s e d e v i c e s h a v e t h i d e n t i f i e r s A : B : , C : , a n D : r e s p e c t i v e l y .Y o u V e a l r e a d y b e e n i n t r o d u c e d t d r i v e i C h a p t e r 3 B u t w h a t i v i r t u a l d r i v e ? V i r t u a l r e f e r s t s o m e t h i n g w h i c h a p p e a r s t e x i s t , b u r e a l l yd o e s n ' t . T h f i f t h d r i v e m a b a d d r e s s e d , b u d o e s n ' t r e a l l y e x i s t e x c e p t i i n t e r n a l m e m o r y . T h d a t a o d r i v e r e s i d e s i n m e m o r y u n t i l i i c o p i e d t

p h y s i c a l d i s k e t t e i n d r i v e A C P / M d i f f e r e n t i a t e s b e t w e e n d r i v e a n d r i v ea n k n o w s i i i t a d d r e s s t h r e a l d r i v e o p r e t e n d t a d d r e s s v i r t u a l

d r i v e E I a l t e r n a t e s b e t w e e n d r i v e a n d r i v e b p r o m p t i n g y o t c h a n g e d i s k e t t e s w h e n n e c e s s a r y .

B u s i n g t h v i r t u a l d r i v e , y o c a u s P I t c o p y f i l e s e v e n t h o u g h y o o n l y h a v e s i n g l e r e a l d r i v e . I y o h a v e t w d i s k d r i v e s , y o h a v e g r e a ta d v a n t a g e o v e r t h o s e u s e r s w i t h o n l y o n e . F o i n s t a n c e , c o p y i n g i m u c hf a s t e r , a n y o c a a c c e s s m u c h m o r e s t o r a g e c a p a c i t y a o n t i m e . B a l m e a n s m a k e f u l l u s e o f t h i s s e c o n d ( o e v e n t h i r d o f o u r t h ) d i s k d r i v e . B u e v e n i y o h a v e t h e s e a d v a n t a g e s , s o m e t i m e s i t ' s f a s t e r a n e a s i e r t u s t h v i r t u a l d r i v e .

1 0

Page 116: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 116/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

7 . T h C O P Y S Y S c o m m a n d

W i t h o t h e r C P / M c o m p u t e r s , t h o p e r a t i n g s y s t e m p r o g r a m s a r l o c a t e d o t r a c k s 0 a n d 1 a n a r c o p i e d w i t h t h C O P Y S Y S c o m m a n d . O t h C - 1 2 8 ,t h o p e r a t i n g s y s t e m i c o n t a i n e d i t h f i l e s n a m e d C P M + . S Y S a n C C C O M . Y o c a c o p y t h e s e t a n o t h e r d i s k e t t e u s i n g P D P . I f y o r u t h C O P Y S Y S c o m m a n d , y o w i l l s e t h a t t h i s c o m m a n d i n o a v a i l a b l e f o rt h ! 1 2 8 . I n s t e a d , y o s h o u l d d t h f o l l o w i n g t c o p y t h s y s t e m p r o g r a m st n e d i s k e t t e i n d r i v e E

F O R M A TP I E : = A : C P M + . S Y SP I E : = A : C C P . C O M

A f t e r F O R M A T i n g a n P i p i n g t h s y s t e m f i l e s , y o w i l l b a b l e t s t a r t( b o o t ) C P / M w i t h t h n e d i s k e t t e . S i n c e i d o e s n f t c o n t a i n a n t r a n s i e n tc o m m a n d s , c o p y t h C O f i l e s f r o m t h o r i g i n a l t o t h e n e s y s t e m d i s k e t t e .

1 0

Page 117: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 117/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

7 . T h s t a t u s l i n e

T h l a s t l i n e o t h s c r e e n i c a l l e d t h s t a t u s l i n e . T h i n f o r m a t i o n h e r e a r m e s s a g e s t h a t C P / M d i s p l a y s . F o e x a m p l e , w h e n u s i n g t h v i r t u a l d r i v e ,C P / M d i s p l a y s p r o m p t o n t h s t a t u s l i n e a s k i n g y o t i n s e r t t h d i s k e t t eo d i s k e t t e .

D i s k i n f o r m a t i o n i d i s p l a y e d i t h l o w e r r i g h t h a n d c o r n e r o t h s c r e e n .T h f o r m a t o t h i n f o r m a t i o n i a s f o l l o w s :

D t s T h s y m b o l s u s e d a b o v e h a v e t h f o l l o w i n g m e a n i n g s :

0 O p e r a t i o n : ( R ) e a d o ( W ) r i t eD r i v e b e i n g a c c e s s e d ( A B , C , o D

t t w o - d i g i t t r a c k n u m b e r t r a c k p r e s e n t l y b e i n g r e a d o r w r i t t e nt w o - d i g i t s e c t o r n u m b e r s e c t o r p r e s e n t l y b e i n g r e a d o r w r i t t e n

T h d i s p l a y c h a n g e s a t h d i s k o p e r a t i o n c h a n g e s .

T r a c k a n s e c t o r n u m b e r s a r s e p a r a t e d b s p a c e . I t h d i s k e t t e h a b e e nf o r m a t t e d i t h M F M - f o r m a t ( d o u b l e - s i d e d d i s k ) a n y o a r a c c e s s i n gt h s e c o n d s i d e , t h e t r a c k a n s e c t o r d i s p l a y s a r s e p a r a t e d b d a s h ( - ) .I y o d n o w a n t t d i s p l a y t h i s d i s k s t a t u s , y o c a t u r n i o f ( 8 0 - c o l u m no n l y ) b p r e s s i n g < C O N T R O L > < R U N / S T O P > . T h < C O N T R O L > k e m u s t b h e l d d o w n w h i l e p r e s s i n g < R U N / S T O P > . T r e a c t i v a t e t h ed i s p l a y , s i m p l y p r e s s t h s a m e k e c o m b i n a t i o n .

Y o c a n n o t d i s p l a y y o u r o w m e s s a g e s o t h s t a t u s l i n e . T h i s i r e s e r v e df o u s b C P / M .

Y o c a e c h o t h l a s t c o m m a n d t h a t y o m a n u a l l y t y p e d a t h k e y b o a r d b p r e s s i n g t h ( c u r s o r - d o w n ) k e o t h b o t t o m r o w . T h s e p a r a t e c u r s o rb l o c k o t h u p p e r r i g h t o t h k e y b o a r d w i l l b e e x c l u d e d h e r e , b e c a u s e i h a a n o t h e r i m p o r t a n t f u n c t i o n . F o i n s t a n c e , i y o h a v e e n t e r e d t h D I R * . * c o m m a n d a n p r e s s e d < R E T U R N > , y o c a p r e s s t h c u r s o r - d o w n k e y a n d t h c o m m a n d w i l l b r e d i s p l a y e d b e l o w — b u t w i t h o u tt h < R E T U R N > . T h i s i s y o c a m a k e a n n e c e s s a r y c h a n g e s i t h c o m m a n d b e f o r e i i e x e c u t e d .

1 0

Page 118: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 118/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

7 . 6 1 5 7 1 d i s k f o r m a t s

T h 1 5 7 1 d i s k d r i v e i c a p a b l e o r e a d i n g v a r i o u s d i s k e t t e f o r m a t s .

T h 1 5 l ! c o n t r o l l e r c a n b e p r o g r a m m e d t r e a d a n w r i t e d i f f e r e n tf o r m a t s , u n l i k e t h e a r l i e r 1 5 4 1 d r i v e s . Y o c a u s t h f o l l o w i n g d i s k e t t ef o r m a t s w i t h t h 1 5 7 1 d r i v e :

O s b o r n e D ( 1 0 2 4 b y t e s / s e c t o r , s i n g l e s i d e d , s e c t o r s / t r a c k )E p s o n Q X 1 0 ( 5 1 2 b y t e s / s e c t o r , d o u b l e s i d e d , 1 s e c t o r s / t r a c k )I B M - 8 S S ( C P / M 8 6 ( 5 1 2 b y t e s / s e c t o r , s i n g l e s i d e d , s e c t o r s / t r a c k )I B M - 8 D ( C P / M 8 6 ( 5 1 2 b y t e s / s e c t o r , d o u b l e s i d e d , s e c t o r s / t r a c k )K a y P r o I ( 5 1 2 b y t e s / s e c t o r , s i n g l e s i d e d , 1 s e c t o r s / t r a c k )K a y P r o I ( 5 1 2 b y t e s / s e c t o r , d o u b l e s i d e d , 1 s e c t o r s / t r a c k )

T h u s s i d i f f e r e n t f o r m a t s a r d i r e c t l y s u p p o r t e d .

A y o u ' v e p r o b a b l y n o t i c e d , t h d r i v e m o t o r s p i n s s h o r t l y a f t e r y o i n s e r tt h d i s k a n c l o s e t h d o o r . T h d i s k d r i v e i a t t e m p t i n g t i d e n t i f y t h ef o r m a t o f t h d i s k . T d t h i s , t h d r i v e c h e c k s b y t e s p e s e c t o r , a n s e c t o r sp e t r a c k . I t h i s i s n ' t s u f f i c i e n t t o i d e n t i f y t h f o r m a t , a s m a l l b o i t h l o w e r l e f t - h a n d c o r n e r o t h s c r e e n s h o w s t h p o s s i b l e f o r m a t s . Y o u m a yt h e n s e l e c t t h e c o r r e c t f o r m a t b s c r o l l i n g t h r o u g h t h l i s t o c h o i c e s . U s t h < r o - ( c u r s o r l e f t a n c u r s o r r i g h t k e y s ) t v i e w t h e c h o i c e s .

W h e n y o h a v e s c r o l l e d t t h d e s i r e d f o r m a t , c o n f i r m t h s e l e c t i o n b p r e s s i n g < R E T U R N > . I y o w i s h t u s t h a t f o r m a t e x c l u s i v e l y , h o l d t h < C O N T R O L > k e w h i l e p r e s s i n g < R E T U R N > . T h i s w a C P / M k n o w sw h i c h f o r m a t i b e i n g u s e d , a n w i l l n o a s y o t o e n t e r t h c o r r e c t o n e a c h t i m e y o s w i t c h d i s k e t t e s .

1 0

Page 119: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 119/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

7 . T h k e y b o a r d

T h 1 2 k e y b o a r d f u n c t i o n s d i f f e r e n t l y u n d e r C P / M t h a n i 6 o 1 2 m o d e .F o e x a m p l e , t h e c u r s o r k e y s d n o w o r k t h s a m e a t h e y d w h e n u s i n gB A S I C . P r e s s i n g t h c u r s o r d o w n k e o t h b o t t o m r o o t h k e y b o a r dr e d i s p l a y s t h c o m m a n d l a s t e n t e r e d . B u t h c u r s o r d o w n k e o t h t o r o o t h k e y b o a r d h a n e f f e c t .

Y o c a r e - b o o t t h C P / M s y s t e m f r o m t h k e y b o a r d b y p r e s s i n g< C O N T R O L > < E N T E R > . N o t e t h a t t h < E N T E R > k e i p a r t o t h n u m e r i c a l k e y p a d .

E a c h k e o t h 1 2 m a h a v e u t f o u r d i f f e r e n t v a l u e s . k e y ' s v a l u em a b e u n s h i f t e d , s h i f t e d , c o n t r o l , a n c a p s l o c k . T h s h i f t e d v a l u e i n o a l w a y s t h s a m e a t h c a p s l o c k v a l u e . W h e n y o e n t e r a u n s h i f t e d v a l u e ,m a k e s u r e t h a t t h c a p s l o c k k e i i t h " u p " p o s i t i o n . T h c h a r a c t e r sa p p e a r i n g o t h s c r e e n s h o u l d t h e n b l o w e r c a s e . T h < 4 0 / 8 0 D I S P L A Y >k e h a n e f f e c t o t h k e v a l u e s .

s h i f t e d v a l u e i p r o d u c e d b h o l d i n g t h < S H I F T > k e y a n d p r e s s i n g t h d e s i r e d k e y .

c o n t r o l v a l u e i p r o d u c e d b h o l d i n g t h < C O N T R O L > a n p r e s s i n g t h d e s i r e d k e y .

T e n t e r t h e " s i m u l a t e d " c a p s l o c k m o d e , p r e s s t h e C o m m o d o r e k e ( C = ) .I t h i s m o d e , o n l y l e t t e r s w i l l b s h i f t e d . N u m b e r s a n o t h e r c h a r a c t e r sr e m a i n u n s h i f t e d i " s i m u l a t e d " c a p s l o c k m o d e .U s i n g a 8 0 - c o l u m n m o n i t o r , y o c a c h a n g e t h b a c k g r o u n d a n d c u r s o rc o l o r . T c h a n g e t h c u r s o r c o l o r , p r e s s n u m b e r k e y s o t h t o r o o t h k e y b o a r d i c o m b i n a t i o n w i t h t h < C O N T R O L > k e y . T h c u r s o r w i l lc h a n g e c o l o r c o r r e s p o n d i n g l y . ' T c h a n g e t h b a c k g r o u n d c o l o r , p r e s sn u m b e r k e o t h n u m e r i c a l k e y p a d i c o m b i n a t i o n w i t h t h < C O N T R O L >k e y . T h e s e c o l o r s c o r r e s p o n d t t h e c o l o r s u s e d i B A S I C .

1 0

Page 120: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 120/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

7 . K e y b o a r d v a l u e s

T h 1 2 8 ' s k e y b o a r d i v e r y f l e x i b l e u n d e r C P / M . Y o c a e s s e n t i a l l y a s s i g nn e v a l u e t e a c h k e y .

W e ' v e a l r e a d y n o t e d t h a t C P / M u s e s t h A S C I I c h a r a c t e r s e t . T h e s ec h a r a c t e r s h a v e v a l u e s f r o m t 1 2 7 . A n v a l u e g r e a t e r t h a n 1 2 ( $ 8 0 ) i h e x a d e c i m a l h a s a d i f f e r e n t u s e — i t m a s e t h e c o l o r s o t h s c r e e n d i s p l a yo s u b s t i t u t e a p r e d e f i n e d s t r i n g o c h a r a c t e r s . H e r e ' s l i s t o t h e s e v a l u e s :

8 9 p r e d e f i n e d s t r i n g s 0 - 1 5A 0 - A F 8 0 - c h a r a c t e r f o r e g r o u n d c o l o r sB - B 8 0 - c h a r a c t e r b a c k g r o u n d c o l o r s

C 4 0 - c h a r a c t e r f o r e g r o u n d c o l o r s- D 4 0 - c h a r a c t e r b a c k g r o u n d c o l o r s

E - E 4 0 - c h a r a c t e r b o r d e r c o l o r- F s p e c i a l f u n c t i o n s

7 . 8 . 1 D i s a b l i n g / e n a b l i n g 8 c o l u m n c o l o r s e l e c t i o nY o c a c h a n g e t h f o r e g r o u n d c o l o r o 8 0 - c o l u m n c o l o r m o n i t o r w i t h< C O N T R O L > < t o p r o w n w n b e r > c o m b i n a t i o n . Y o c a a l s o c h a n g e t h b a c k g r o u n d c o l o r w i t h t h < C O N T R O L > < n u m e r i c a l k e y p a d n u m b e r >c o m b i n a t i o n . W h e n y o p r e s s o n o t h e s e k e c o m b i n a t i o n s , v a l u e o 1 6 0 - 1 6 7 o 1 7 6 - 1 8 3 i p r o d u c e d t h a t c h a n g e s e i t h e r t h s c r e e n f s f o r e g r o u n do b a c k g r o u n d c o l o r .

T d i s a b l e t h i s c o l o r s e l e c t i o n , y o c a p r e s s t h f o l l o w i n g k e c o m b i n a t i o n :

< C O N T R O L > < R S H I F T > < A L T >< R S H I F T > i t h r i g h t < S H I F T > k e y . Y o m u s t u s t h r i g h t < S H I F T >k e a n n o t h l e f t o n e . A l t h r e e k e y s m u s t b p r e s s e d s i m u l t a n e o u s l y t d i s a b l e t h e c o l o r s e l e c t i o n .

1 0

Page 121: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 121/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A f t e r p r e s s i n g t h i s k e c o m b i n a t i o n , y o c a n n o t c h a n g e t h s c r e e n ! sf o r e g r o u n d o b a c k g r o u n d c o l o r w i t h < C O N T R O L > < t o p r o n u m b e r > o < C O N T R O L > < n u m e r i c a l k e y p a d n w n b e r > .Y o c a r e - e n a b l e t h f o r e g r o u n d / b a c k g r o u n d c o l o r s e l e c t i o n b e n t e r i n gt h < C O N T R O L > < R S H I F T > < A L T > c o m b i n a t i o n a g a i n . T h i s k e c o m b i n a t i o n a c t s a t o g g l e . P r e s s t h c o m b i n a t i o n o n c e a n i d i s a b l e s .P r e s s t h e c o m b i n a t i o n a g a i n a n i e n a b l e s .

I y o d i s a b l e t h e c o l o r s e l e c t i o n , t h < H E L P > i a l s o d i s a b l e d .

7 . 8 . 2 C h a n g i n g k e y ' s A S C I I v a l u eW h e n y o p r e s s k e o r c o m b i n a t i o n o f k e y s ( s u c h a < S H I F T > < A o < C O N T R O L > < C > ) , C P / M e n c o d e s t h e k e y ' s p h y s i c a l l o c a t i o n o t h k e y b o a r d t n u m e r i c a l v a l u e r a n g i n g f r o m 0 t 2 5 ( $ 0 0 t $ F h e x a d e c i m a l ) .

F o e x a m p l e , w h e n y o p r e s s t h s p a c e b a r , C P / M r e c o g n i z e s t h a t t h l o n gk e y o n t h b o t t o m r o o t h k e y b o a r d w a d e p r e s s e d . C P / M a s s o c i a t e st h i s k e w i t h a v a l u e o 3 ( $ 2 0 h e x a d e c i m a l ) .U n d e r C P / M o t h f 1 2 8 , y o c a c h a n g e t h e n c o d i n g o e a c h k e y . U s i n gw h a t w e l l c a l l t h k e y b o a r d e d i t o r , y o c a n c h a n g e C P / M s t h a t p r e s s i n gt h s p a c e b a p r o d u c e s t h v a l u e n o r m a l l y a s s o c i a t e d w i t h t h l e t t e r " A ( 6 5 = $ 4 1 ) .T u s t h k e y b o a r d e d i t o r , e n t e r :

< C O N T R O L > < R S H I F T > < < -

T h k e d e n o t e d a < - i t h c u r s o r l e f t k e o t h t o r o o t h k e y b o a r d .N e x t p r e s s t h e k e w h o s e v a l u e y o w a n t t c h a n g e . F o e x a m p l e , p r e s s t h es p a c e b a r . h i g h l i g h t e d a r e a o t h s t a t u s l i n e a p p e a r s :

C S Z I I I

1 0

Page 122: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 122/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h v a l u e 2 i h e x a d e c i m a l n u m b e r a n r e p r e s e n t s t h e s p a c e b a r ! s c u r r e n tv a l u e . T h i s v a l u e i w h a t w n o r m a l l y e x p e c t t o s e e , s i n c e s p a c e h a a A S C I I v a l u e o 3 ( $ 2 0 i h e x a d e c i m a l ) . T c h a n g e t h s p a c e b a r s t h a t i w i l l p r o d u c e t h v a l u e f o t h l e t t e r H A l f , e n t e r n e v a l u e : 4 1 T h h i g h l i g h t e d a r e a w i l l d i s a p p e a r f r o m t h s t a t u s l i n e . Y o h a v e n o e x i t e dt h k e y b o a r d e d i t o r .

N o l e t ' s t r o u t h k e b o a r d t s e i t h c h a n g e w a e f f e c t e d . P r e s s t h s p a c e b a r . T h l e t t e r w i l l a p p e a r o t h s c r e e n a t h c u r s o r . T h i s i s n ' tv e r y u s e f u l c h a n g e , s i n c e y o n o h a v e n w a o e n t e r i n g s p a c e . E n t e rt h k e y b o a r d e d i t o r a g a i n a n u n d o t h c h a n g e . P r e s s :

< C O N T R O L > < R S H I F T >

N o t h e c u r r e n t v a l u e o t h s p a c e b a i d i s p l a y e d :

G t & i i oC h a n g e t h v a l u e b a c k t i t o r i g i n a l v a l u e 2 a n t h k e y b o a r d i b a c k t n o r m a l .A y o h a v e n o t i c e d , a l v a l u e s a r d i s p l a y e d a n e n t e r e d i h e x a d e c i m a ln o t a t i o n . S e A P P E N D I X f o c o m p l e t e l i s t o t h e c h a r a c t e r s a n t h e i rv a l u e s i h e x a d e c i m a l n o t a t i o n .

C h a n g i n g t h s p a c e b a t p r o d u c e t h l e t t e r " A 1 1 w a s n ' t v e r y u s e f u l . L e t ' st r a n o t h e r e x a m p l e t h a t w i l l b o m o r e u s t u s R e c a l l t h a t k e v a l u eg r e a t e r t h a n 1 2 h a d i f f e r e n t u s t h a n t h A S C I I v a l u e s . O 8 0 - c o l u m nc o l o r m o n i t o r , y o c a n o r m a l l y c h a n g e t h b a c k g r o u n d t o n o e i g h td i f f e r e n t c o l o r s . A c t u a l l y , i i p o s s i b l e t s e l e c t f r o m 1 d i f f e r e n t c o l o r s .E a c h d i f f e r e n t b a c k g r o u n d c o l o r i r e p r e s e n t e d b v a l u e f r o m$ B t $ B ( o $ D t $ D f o 4 0 - c o l u m n s c r e e n s ) .

T s e l e c t t h f i r s t e i g h t c o l o r s , y o p r e s s < C O N T R O L > < n w n b e r > , w h e r e< n u m b e r > i n u m b e r o t h n u m e r i c a l k e y p a d . F o e x a m p l e , t h k e c o m b i n a t i o n < C O N T R O L > < 1 p r o d u c e s t h v a l u e $ B a n c h a n g e s t h b a c k g r o u n d c o l o r t o b l a c k . B u w a r l i m i t e d t e i g h t c o l o r s w i t h t h < C O N T R O L > k e c o m b i n a t i o n .

1 1

Page 123: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 123/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

W c a u s t h k e y b o a r d e d i t o r t b a b l e t s e l e c t t h o t h e r e i g h t c o l o r s . I w d e c i d e t u s t h < S H E F T > < n u m b e r > k e c o m b i n a t i o n , a n a s s i g nt h e s e t v a l u e s b e t w e e n $ B a n $ B F , t h e n t h o t h e r e i g h t b a c k g r o u n dc o l o r s a r e a v a i l a b l e .

E n t e r t h k e y b o a r d e d i t o r :

< C O N T R O L > < R S H I F T > « - N o p r e s s < C O N T R O L > < 1 > , k e e p i n g i m i n d t h a t < 1 i o t h n u m e r i c a l k e y p a d T h e f o l l o w i n g i d i s p l a y e d :

C h a n g e t h i s k e c o m b i n a t i o n ' s v a l u e t Y o h a v e n o a d d e d t h b a c k g r o u n d c o l o r s e l e c t i o n f o r t h < S H I F T > < 1 k e c o m b i n a t i o n . Y o c a a d t h o t h e r s e v e n b a c k g r o u n d c o l o r s s i m i l a r l y .

7 . 8 . 3 D e f i n i n g t h f u n c t i o n k e y sI y o p r e s s f u n c t i o n k e y , a t e x t s t r i n g a p p e a r s o t h s c r e e n . B d e f a u l t ,t h e f u n c t i o n k e y s a r a s s i g n e d t h f o l l o w i n g s t r i n g v a l u e s :

F F F F F F F F 8

F F d i r < C R >d i F F F 6 D e c 8 5 ( m a y d i f f e r o y o u r s y s t e m )

P r e s s i n g < F 1 > p r o d u c e s t h v a l u e $ 8 0 , < F 2 > p r o d u c e s $ 8 1 , a n s o n P r e s s i n g < H E L P > p r o d u c e s $ 9 F . A C P / M r e c o g n i z e s k e y b o a r d v a l u ef r o m $ 8 0 t $ 9 F , i s u b s t i t u t e s s t r i n g .

I l

Page 124: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 124/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

F o e x a m p l e , w h e n y o p r e s s < H E L P > , t h v a l u e $ 9 i p r o d u c e d , i w h i c h C P / M s u b s t i t u t e s t h t e x t " H e l p . " Y o c a r e d e f i n e t h t e x ta s s o c i a t e d w i t h e a c h o t h v a l u e s $ 8 t $ 9 b u s i n g t h f u n c t i o n k e e d i t o r .

T u s t h f u n c t i o n k e e d i t o r , e n t e r :

< C O N T R O L > < R S H I F T > -

w h e r e — d e n o t e s t h c u r s o r r i g h t k e o t h t o r o o t h k e y b o a r d .

h i g h l i g h t e d a r e a a p p e a r s o t h s t a t u s l i n e o t h s c r e e n . N o p r e s s t h ek e < H E L P > , o < F 1 > t < F 8 > , w h i c h e v e r k e y o w i s h t c h a n g e t h t e x t o f F o t h i s e x a m p l e p r e s s t h e < H E L P > k e y , a n t h f o l l o w i n g a p p e a r so t h s t a t u s l i n e :

\ m

T h s y m b o l s a n a r e t h e s t a r t a n d e n d o t h t e x t . b l o c k c u r s o r i p o s i t i o n e d o v e r t h f i r s t c h a r a c t e r o t h s t r i n g H . F o n o w , d o n ' t p r e s s a n o t h k e y s . W e l l f i r s t e x p l a i n e x p l a i n t h p u r p o s e o f s o m e o t h k e y s .

K e c o m b i n a t i o n F u n c t i o n

< C O N T R O L x R S H I F T > < - > m o v e c u r s o r r i g h t

< C O N T R O L > < R S H I F T > < m o v e c u r s o r l e f t< C O N T R O L > < R S H I F T > i n s e r t s p a c e a c u r s o r< C O N T R O L x R S H I F T > < d e l e t e c h a r a c t e r a c u r s o r< C O N T R O L > < R S H I F T > < R E T U R N > e n f u n c t i o n k e e d i t o r

T c h a n g e t h t e x t o t h < H E L P > k e t M d i r a : " , s i m p l y t y p e t h l e t t e r sa n t h s c r e e n w i l l l o o k l i k e t h i s :

1 1

Page 125: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 125/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I y o p r e s s < R E T U R N > w i t h o u t h o l d i n g < C O N T R O L > < R S H I F T > ,c a r r i a g e r e t u r n i i n s e r t e d i n t o t h t e x t ( i a p p e a r s a l o w e r c a s e m ) T h e ne x i t t h f u n c t i o n k e e d i t o r w i t h t h k e c o m b i n a t i o n :

< C O N T R O L > < R S H I F T > R E T U R N >N o e v e r y t i m e y o p r e s s t h < H E L P > k e y , y o w i l l d i s p l a y t h e d i r e c t o r yo t h d r i v e . Y o u ' l l n o t i c e t h a t y o c a a s s i g n t e x t s t r i n g s t a n v a l u ef o r m $ 8 0 t $ 9 F . T h e r e f o r e y o c a d e f i n e u t 3 d i f f e r e n t t e x t s t r i n g s .T i n v o k e t h e s e s t r i n g s y o w i l l h a v e t u s t h k e y b o a r d e d i t o r ( d i s c u s s e di t h p r e v i o u s s e c t i o n ) t a s s i g n o n o t h e s e v a l u e s t t h d e s i r e d k e y .F o e x a m p l e , s o m e p r i n t e r s a r e n ! t a b l e t p r i n t t h s y m b o l £ Y o c o u l ds u b s t i t u t e t h s t r i n g " P o u n d s s t e r l i n g ' 1 f o t h s y m b o l . T d t h i s ,f i r s t c h a n g e t h k e v a l u e o t h k e f r o m i t n o r m a l v a l u e $ 2 t o n i t h r a n g e $ 8 t $ 9 F . L e t ' s c h a n g e i t $ 9 9 .D t h i s b u s i n g t h k e y b o a r d e d i t o r :

< C O N T R O L > < R S H I F T > * -

a n p r e s s i n g t h k e y . Y o u ' l l s e e t h f o l l o w i n g o t h s t a t u s l i n e :

E n t e r t h n e v a l u e 9 N o y o c a e d i t t h t e x t s t r i n g t h a t i a s s o c i a t e dw i t h " p s e u d o f u n c t i o n k e y " £ P r e s s t h f o l l o w i n g :

< C O N T R O L > < R S H I F T >a n t h e n p r e s s t h k e y . Y o w i l l s e e :

T y p e t h w o r d s " P o u n d s s t e r l i n g " a n t h e n p r e s s :

< C O N T R O L > < R S H I F T > < R E T U R N >

1 1

Page 126: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 126/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h h i g h l i g h t e d a r e a i t h s t a t u s l i n e d i s a p p e a r s a i a c c e p t s t h n e t e x ts t r i n g . N o i y o p r e s s t h k e y , t h w o r d s P o u n d s s t e r l i n ga p p e a r . Y o u V e s u c c e s s f u l l y p r o g r a m m e d n e f u n c t i o n k e y !H e r e i c o m p l e t e l i s t o t h f u n c t i o n s a n t h e i r h e x a d e c i m a l c o d e s :

$ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8 $ 8

d i r < C R >d i

F D e 8

F F 1 F l S c r e e n l e f t

S c r e e n r i g h tS c r e e n l e f tS c r e e n r i g h tF 1

$ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9 $ 9

$ 9 $ 9 $ 9 $ 9

F 1 F 1 F 1 F 2 F 2 F 2 F 2 F 2 F 2 F 2 F 2 F 2

F 2 F 3 F 3 H E L P

F r o m t h t a b l e a b o v e , i a p p e a r s t h a t t h t e x t s t r i n g s f o c o d e s $ 8 t $ 8 o o m i t t e d . A c t u a l l y , t h e s e c o d e s a r u s e d t s c r o l l t h 4 0 - c o l u m n s c r e e nh o r i z o n t a l l y .

1 1

Page 127: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 127/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

I n t h e f o l l o w i n g t a b l e , t h v a l u e s $ F t $ F a r r e s e r v e d f o s p e c i a lf u n c t i o n s . T h e s e s p e c i a l f u n c t i o n s , w h i c h a r d e f i n e d f o r t h e 1 2 8 f s C P / M ,a r a f o l l o w :

$ F $ F $ F $ F $ F $ F $ F

t u r n d i s k s t a t u s o n / o f fp a u s e / u n p a u s e d i s p l a y4 0 - c o l u m nl e f t s c r e e n ( 4 0 - c o l u m n )r i g h t s c r e e n ( 4 0 - c o l u m n )M F u n l o c kr e b o o t s y s t e m

T i n v o k e c o d e $ F 0 , p r e s s < C O N T R O L > < R U N / S T O P > . T h i s c a u s e s t h d i s k s t a t u s l i n e t d i s a p p e a r .

T i n v o k e c o d e $ F 1 , p r e s s t h < N S C R O L L > k e y . P r e s s i n g i o n c et e m p o r a r i l y h a l t s t h e d i s p l a y o i n f o r m a t i o n o t h s c r e e n a n d i s p l a y sP A U S E o t h s t a t u s l i n e . P r e s s i n g i a s e c o n d t i m e r e a c t i v a t e s t h d i s p l a y .T i n v o k e c o d e $ F F , p r e s s < C O N T R O L > < E N T E R > . T h i s i t h e q u i v a l e n t t t u r n i n g t h c o m p u t e r o f a n t h e n o a g a i n .

1 1

Page 128: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 128/316

Page 129: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 129/316

Page 130: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 130/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T c h a n g e t h k e d e f i n i t i o n s , c h o o s e t h o p t i o n E d i t k e d e i n i t i o n / T h e f o l l o w i n g m e n u a p p e a r s :

E d i t i n g : n o k e y

T h i s k e h a t h v a l u e s s h o w n b e l o w :

n o r m a l — *C M D R S H F T ^S H I F T - C T R L -

( d o n e e d i t i n g - e x i t a n s a v e w o r k f i l e )

H e r e t o o , y o s e l e c t t h d e s i r e d o p t i o n b u s i n g t h c u r s o r k e y s o t h t o r o w . I k e i p r e s s e d , i t f o u r v a l u e s a p p e a r o t h s c r e e n . C M D R S H F To t h s c r e e n d i s p l a y ( < C = > < S H I F T > ) i e q u i v a l e n t t < C A P S L O C K > .( R e m e m b e r , t h < C A P S L O C K > k e i i n o p e r a t i v e u n d e r C P / M ) .O n o t h i m p r e s s i v e f e a t u r e s o K E Y F I G i s i t s a b i l i t y t d e s c r i b e i t e x tw h a t i c a n n o t d i s p l a y . F o e x a m p l e , i c a d e s c r i b e t h l e f t - a r r o w l o c a t e d i t h u p p e r l e f t h a n d c o r n e r o t h k e y b o a r d a L E F T A R R O W n e x t T 1 T h u s k e l i k e < D E L E T E > , f o w h i c h a A S C I I c o d e c a n ' t b d i s p l a y e d ,i d e s c r i b e d i t e x t . F o e x a m p l e , t h t e x t f o r t h e < D E L E T E > k e i R U B O U T . I y o w i s h t c h a n g e o n o t h e f o u r d e f i n i t i o n s p e k e y , m o v et h m a r k e r t t h a t o p t i o n a n p r e s s < R E T U R N > .

A S S I G N S T R I N G ( m o r e t h a n c h a r a c t e r )A S S I G N n e ( s i n g l e ) c h a r a c t e rA S S I G N C O L O RA S S I G N h e x v a l u eA S S I G N S P E C I A L F U N C T I O Nd o n ' t m o d i f y t h i s k e y

K E Y F I G a l l o w s y o t s a v e t h e s e m o d i f i c a t i o n s . Y o m a s a v e t h c h a n g e so t h s y s t e m d i s k e t t e o s e p a r a t e d i s k e t t e . I t h c h a n g e s a r s a v e d o t h s y s t e m d i s k e t t e , t h e y a r l o a d e d a u t o m a t i c a l l y w h e n C P / M i r e b o o t e d .

1 1

Page 131: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 131/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T s a v e y o u r k e y b o a r d c h a n g e s , s e l e c t t h f o l l o w i n g o p t i o n s :E x i t a n s a v e y o u r w o r k f i l eo C P / M b o o t d i s k

A f t e r t h c h a n g e s a r s a v e d , K E Y F I G w i l l a s k :D o y o u w a n t t o d o a n y t h i n g e l s e [

A n s w e r o a a p p r o p r i a t e . T e x i t K E Y F I G a a n t i m e , y o c a p r e s s< C O N T R O L > K E Y F I G a s k s y o t c o n f i r m t h i s s t h a t y o d o n ' t e x i tt h c o m m a n d a c c i d e n t a l l y .

1 1

Page 132: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 132/316

Page 133: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 133/316

C h a p t e r

A d d i t i o n a l u t i l i t i e s

8 . T h a s s e m b l e r s m a a n r m a c8 . U s i n g t h m a a s s e m b l e r8 . W o r k i n g w i t h S U B M I T8 . T h m e m o r y l a y o u t

Page 134: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 134/316

Page 135: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 135/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A d d i t i o n a l u t i l i t i e s

I t h i s c h a p t e r w e ' l l t a k e l o o k a s e v e r a l u t i l i t i e s . T h e s e u t i l i t i e s a r p a r t o t h C P / M d e v e l o p m e n t p a c k a g e a v a i l a b l e f r o m D i g i t a l R e s e a r c h .I y o u ' r e a b e g i n n i n g C P / M u s e r , y o m i g h t w a n t t s k i p t h i s c h a p t e r . I nf a c t , t h i s c h a p t e r m i g h t b e r e n a m e d " C P / M f o A d v a n c e d P r o g r a m m e r s " .T h C P / M d e v e l o p m e n t p a c k a g e i n c l u d e s a a s s e m b l e r , d i s a s s e m b l e r ,m o n i t o r , a n o t h e r u t i l i t i e s f o t h C P / M m a c h i n e l a n g u a g e p r o g r a m m e r .W e ' l l t a k e a l o o k a s o m e o t h e s e u t i l i t i e s s h o r t l y .

1 2

Page 136: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 136/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

8 . T h a s s e m b l e r s M A a n R M A C

M A a n R M A C a r b o t h a s s e m b l e r p r o g r a m s . T h e y a r s u c c e s s o r s t t h o r i g i n a l A S a s s e m b l e r d i s t r i b u t e d b D i g i t a l R e s e a r c h .M A i m a c r o a s s e m b l e r . R M A C i v a r i a t i o n o M A t h a t g e n e r a t e sr e l o c a t a b l e o b j e c t c o d e . R e l o c a t a b l e c o d e i m a c h i n e c o d e t h a t c a b e x e c u t e d f r o m a n l o c a t i o n i t h c o m p u t e r ' s m e m o r y .T h t h r e e a s s e m b l e r s d t h e i r w o r k i 8 0 8 0 c o d e . T w L I f i l e s c o n t a i n i n gs e v e r a l m a c r o s a r i n c l u d e d w i t h t h d e v e l o p m e n t p a c k a g e .

O n L I f i l e i c a l l e d Z 8 . L I B a n t h o t h e r X 6 5 0 2 . L I B . U s i n g t h e s eL I f i l e s , y o c a n a s s e m b l e Z - 8 0 m n e m o n i c s w i t h M A a n R M A C ,a l t h o u g h m o s t o t h o p c o d e s s t i l l l o o k l i k e 8 0 8 0 m n e m o n i c s . F o e x a m p l e ,t h l H L i n s t r u c t i o n m u s t b e c o d e d a L X 0 A d d i t i o n a l Z - 8 0i n s t r u c t i o n s a r a d d e d t t h 8 0 8 0 i n s t r u c t i o n s — e x a m p l e s a r r e l a t i v ej u m p s , t h I a n I r e g i s t e r s , a n t h e x c h a n g e r e g i s t e r i n s t r u c t i o n s .

Y o c a l i s t t h e s e m n e m o n i c s b e n t e r i n g :

T Y P E Z 8 0 . L I B

Y o c a p r o g r a m i 6 5 0 2 m a c h i n e l a n g u a g e u s i n g t h e o t h e r m a c r o l i b r a r y .T h d e v e l o p m e n t p a c k a g e a c t u a l l y c o n t a i n s t w a s s e m b l e r s . L e t ' s l o o k a t h M A a s s e m b l e r f i r s t . F i r s t l i t t l e b a c k g r o u n d . T h 8 0 8 0 p r o c e s s o r i t h p r e d e c e s s o r t t h Z - 8 0 c o n t a i n e d i t h ' 1 2 8 , a n i c e r t a i n s e n s e i i t " p a r e n t . " T h Z - 8 0 c a e x e c u t e p r o g r a m s t h a t t h 8 0 8 0 u n d e r s t a n d s , b u h a l a r g e r v o c a b u l a r y ( o i n s t r u c t i o n s e t ) a n d i f f e r e n t m n e m o n i c s .M n e m o n i c s a r t h e n o t a t i o n s f o r t h e m a c h i n e l a n g u a g e i n s t r u c t i o n s u s e d i w r i t i n g a s s e m b l y l a n g u a g e p r o g r a m s .

A y o u k n o w , m a c h i n e l a n g u a g e c o n s i s t s o l i n e o b i n a r y n u m b e r s . F o e x a m p l e , t h Z - 8 0 p r o c e s s o r u n d e r s t a n d s t h e i n s t r u c t i o n $ 4 a n c a e x e c u t e i t B u i t ' s v e r y d i f f i c u l t f o h u m a n t a s s o c i a t e t h i s n u m b e r w i t ha n p a r t i c u l a r i n s t r u c t i o n o f u n c t i o n . M n e m o n i c s a r u s e d t r e p r e s e n tt h e s e m a c h i n e c o d e s a n m a k e t h e m e a s i e r t u n d e r s t a n d . W i t h t h Z - 8 0 ,t h m n e m o n i c f o t h i n s t r u c t i o n $ 4 l o o k s l i k e t h i s :

L B ,

1 2

Page 137: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 137/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h i s m n e m o n i c h a s p e c i f i c m e a n i n g t t h m a c h i n e l a n g u a g ep r o g r a m m e r . I m a k e s p r o g r a m m i n g m u c h e a s i e r , b e c a u s e y o d o n ' t h a v et k e e p r e f e r r i n g t a b l e t o f i n d o u w h a t c o d e 4 d o e s .

B u t h p r o c e s s o r c a n ' t d a n y t h i n g w i t h t h m n e m o n i c L b , C . T h a s s e m b l e r ' s t a s k i t c o n v e r t t h e s e m n e m o n i c s , w h i c h h u m a n s u n d e r s t a n d ,t c o d e s t h a t t h c o m p u t e r c a u n d e r s t a n d . T h a s s e m b l e r a c t s a s o r t o i n t e r p r e t e r , t r a n s l a t i n g t h h u m a n l a n g u a g e i n t o m a c h i n e l a n g u a g e . T h M A a s s e m b l e r a l s o s u p p o r t s t h u s e r i o t h e r w a y s , w h i c h w e ' l l m e n t i o n l a t e r .

W e ' v e m e n t i o n e d t h a t t h o l d e r 8 0 8 0 p r o c e s s o r i t h p a r e n t o t h Z - 8 0 .Y o a l s o k n o w t h a t t h Z - 8 0 h a m o r e i n s t r u c t i o n s t h a t t h 8 0 8 0 . T h i s i i m p o r t a n t t k n o w , s i n c e a l C P / M p r o g r a m s m u s t b w r i t t e n i 8 0 8 0 c o d e .T h i s i b e c a u s e t h e r e a r m a n y C P / M c o m p u t e r s e q u i p p e d w i t h t h e a r l i e r8 0 8 0 p r o c e s s o r . C o n s e q u e n t l y , Z - 8 0 p r o g r a m m e r i l i m i t e d t t h o s ec o m m a n d s t h a t t h 8 0 8 0 c a u n d e r s t a n d . T h i s p r e c l u d e s s o m e q u i t e u s e f u lZ - 8 0 i n s t r u c t i o n s .

O t h Z - 8 0 , t h c o d e $ 4 r e p r e s e n t s t h f o l l o w i n g m n e m o n i c :L B ,

O t h 8 0 8 0 , t h i s s a m e c o d e r e p r e s e n t s t h i s m n e m o n i c :M O B ,

E i t h e r r e p r e s e n t s t h s a m e o p e r a t i o n : t r a n s f e r t h c o n t e n t s o t h C - r e g i s t e rt t h B - r e g i s t e r . T h o p e r a t i o n s a r e i d e n t i c a l ; t h n o t a t i o n s a r d i f f e r e n t .

1 2

Page 138: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 138/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

8 c U s i n g t h M A a s s e m b l e r

O n o t h p r o b l e m s y o u l l e n c o u n t e r i m a c h i n e l a n g u a g e p r o g r a m m i n g i i r e f e r e n c i n g m e m o r y l o c a t i o n s w h e n p e r f o r m i n g i n s t r u c t i o n s l i k e l o a d i n go r s a v i n g a r e g i s t e r . A n o t h e r c o m m o n p r o b l e m i k e e p i n g t r a c k o m e m o r yl o c a t i o n j u m p s . F o i n s t a n c e , s u p p o s e y o w r i t e p r o g r a m t h a t s t a r t s a tm e m o r y a d d r e s s $ 5 0 0 0 , a n l a t e r w a n t t m o v e i t a d d r e s s $ 4 0 0 0 . Y o u ' dh a v e t c h a n g e a l j u m p a d d r e s s e s ( e x c e p t f o t h r e l a t i v e j u m p s ) w i t h i n t h p r o g r a m . I y o i n s e r t n e i n s t r u c t i o n i n t o p r o g r a m , a l o t h r e l a t i v ej u m p s a n a l o t h e r j u m p s a r s h i f t e d . I w o u l d b n e r v e - w r a c k i n g t t r t k e e p t r a c k o a l t h e s e a d d r e s s e s .

T o m a k e t h i s w o r k e a s i e r , t h M A a s s e m b l e r a l l o w s u t d e f i n e l a b e l s .L a b e l s a r t r a n s f o r m e d i n t o a c t u a l m e m o r y a d d r e s s e s d u r i n g t h a s s e m b l y .W i t h l a b e l s , i t ' s n l o n g e r a p r o b l e m t i n s e r t n e i n s t r u c t i o n a o t m o v e r o u t i n e t d i f f e r e n t m e m o r y l o c a t i o n — t h e a s s e m b l e r d o e s a l t h w o r k f o y o u .

T h M A a n R M A C a s s e m b l e r s a l l o w y o d t h i s a n m u c h m o r e . T h " A d d i t i o n a l U t i l i t i e s " d i s k e t t e c o n t a i n s t h e s e p r o g r a m s . I n s e r t i i n t o d r i v e A L i s t t h d i r e c t o r y :

A A A A

L I C B D O S 3C A L L V E R ST R A C E

C O S P

A S U T

L I N KB N K D O S 3

D U M PR E A D

N o t i c e t h f i l e n a m e d d u m p

C O S P C O

M

. C O M .

D U M P

M A C C O MC R E S B D O S 3 S P Z E C H O V E R S A S M

T h s y n t a x f o t h i s

< f i l e n a m e >

R M A C C O H E X C O M C O MR A N D O M A S M

c o m m a n d i s

S I D C O MX R E F C O MH I S T U T L

D U M P d i s p l a y s t h e c o n t e n t s o t h e s p e c i f i e d f i l e i h e x a d e c i m a l f o r m a t ( h e xd u m p ) . T s e s a m p l e d u m p d i s p l a y , e n t e r :

D U M P D A T E . C O MT h f i l e c o n t e n t s o d u m p . C O M i d i s p l a y e d o t h s c r e e n . Y o c a p a u s et h s c r o l l i n g o u t p u t b p r e s s i n g < C O N T R O L > a n s t a r t i a g a i n w i t h< C O N T R O L > Q A l t e r n a t i v e l y , y o c a n u s e t h < N S C R O L L > k e y ,w h i c h y o m i g h t f i n d m o r e p r a c t i c a l . Y o c a t e r m i n a t e t h o u t p u t b p r e s s i n g < C O N T R O L > C

1 2

Page 139: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 139/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

d u m p . A S M i t h a s s e m b l y l a n g u a g e s o u r c e p r o g r a m f o r t h e d u m pc o m m a n d . Y o c a d i s p l a y t h A S C I I c o n t e n t s o t h i s f i l e o t h s c r e e n ( o p r i n t e r ) i y o w i s h . E n t e r :

T Y P E D U M P . A S MT h p r o g r a m h e a d e r i t h e D i g i t a l R e s e a r c h c o p y r i g h t n o t i c e ( t h e o r i g i n a ld e v e l o p e r s o t h C P / M o p e r a t i n g s y s t e m ) .

H e r e i a s m a l l e x a m p l e o w h a t a p p e a r s o t h s c r e e n w h e n y o D U M PC O f i l e :

0 0 A 0 0 C 3 1 0 F 8 C B 0 C D C E 0 B C B 0 0 B 0 0 3 C 9 5 F 1 6 0 0 3 3 1 0 2 8 0 0 0 1 7 B 0 0 C 0 C 9 A 3 7 0 1 5 0 0 E O F C 0 5 0 0 C 9 E 5 D 50 0 D 0 C 5 1 5 0 0 E 1 4 C 0 5 0 0 C l D l E l C 9 4 4 4 0 0 E 0 4 5 2 0 4 5 5 4 D 5 0 2 0 5 6 4 5 5 2 5 4 4 F 4 E 2 0 3 0 0 F 0 2 E 3 4 2 4 0 D 0 4 E 4 F 2 0 4 9 4 5 5 5 5 4 2 0 4 4 0 1 0 0 4 4 2 5 0 5 2 4 5 5 4 4 E 5 4 2 0 4 F 4 E 2 0 4 4 4

N o h e r e ' s s h o r t e x a m p l e o a a s s e m b l e r l i s t i n g :

c o n s o l e s t a t u s f u n c t i o n ?n o t h e n j u s t e x i ty e s , u p d a t e t h t i m e

u p d a t e $ c l o c k :m o

c p j n

l x d a s h l dl x

a , 1 n e x t

h , s r e t $ s t a c ks p , l o c a l $ s t a c k

T h i s i g o o d c o m p a r i s o n o t h a s s e m b l y l a n g u a g e s o u r c e p r o g r a m ( . A S M )a n t h h e x a d e c i m a l m a c h i n e l a n g u a g e d i s p l a y ( C O M ) . I t ' s o b v i o u s t h a t t h a s s e m b l y l a n g u a g e s o u r c e i m u c h m o r e r e a d a b l e . Y o c a e v e n i n s e r tc o m m e n t s i n t o t h e a s s e m b l y l a n g u a g e s o u r c e t d e s c r i b e t h p r o g r a m .T h e s e c o m m e n t s s t a r t w i t h s e m i c o l o n s t h a t t h a s s e m b l e r k n o w s i s h o u l d i g n o r e t h e s e l i n e s o t e x t . O t h e r w i s e t h a s s e m b l e r w o u l d t r t a s s e m b l e t h e m , a n c a u s e n u m e r o u s e r r o r s i n t h e p r o c e s s .

T h d u m p A S p r o g r a m m a a p p e a r t b v e r y l o n g , b u i t ' s a c t u a l l y q u i t es h o r t f o a a s s e m b l y l a n g u a g e s o u r c e c o d e l i s t i n g . C o n s i d e r t h a t t h o p e r a t i n g s y s t e m i w r i t t e n i a s s e m b l y l a n g u a g e — w h e n p r i n t e d o u i c a

1 2

Page 140: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 140/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

r e a c h f u l l 2 0 0 0 p a g e s i l e n g t h . E v e n p r o g r a m s l i k e t h w o r d p r o c e s s o rT E X T O M A T c a e a s i l y r e a c h 4 0 t 5 0 p a g e s .

A y o c a s e e , p r o g r a m m i n g i m a c h i n e l a n g u a g e c a n b v e r yt i m e - c o n s u m i n g p r o c e s s . O u g o a l h e r e i t a s s e m b l e p r o g r a m t d e m o n s t r a t e t h o p e r a t i o n o t h a s s e m b l e r .

C o p y D U M P . A S M t y o u r t h b a c k u p c o p y o t h A d d i t i o n a l U t i l i t i e sd i s k e t t e . M a k e s u r e t h a t y o u r d i s k e t t e i n o w r i t e - p r o t e c t e d , s i n c e w h a v et w r i t e t t h d i s k e t t e o w h i c h t h s o u r c e c o d e i l o c a t e d . Y o h a v e m a d e

b a c k u p - c o p y o y o u r C P / M d i s k e t t e , h a v e n ' t y o u ? ( I n o t , d s q u i c k l y ) .T a s s e m b l e t h i s s o u r c e p r o g r a m , e n t e r :

M A C D U M PN o t i c e t h a t y o d o n ' t h a v e t s p e c i f y t h f i l e n a m e e x t e n s i o n . Y o d o n ' th a v e t t y p e D U M P . A S M , b e c a u s e t h a s s e m b l e r a u t o m a t i c a l l y a p p e n d s t h e x t e n s i o n . A S M . T h f o l l o w i n g d i s p l a y a p p e a r s o t h s c r e e n :

C P / M M A C R O A S S E M 2 . 0 2 5 70 0 2 H U S E F A C T O RE N O A S S E M B L Y

A T h a s s e m b l e r q u i c k l y c r e a t e s t h r e e f i l e s :

A a s s e m b l e r l i s t i n g n a m e d D U M P . P R h e x a d e c i m a l f i l e c a l l e d D U M P H E s y m b o l t a b l e n a m e d D U M P S Y

T a k e a l o o k f i r s t a t h a s s e m b l e r l i s t i n g b e n t e r i n g :

T Y P E D U M P . P R N < R E T U R N >H e r e ' s a i l l u s t r a t i o n o w h a t s h o u l d a p p e a r o n y o u r s c r e e n :

1 2

Page 141: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 141/316

A b a c u s S o f t w a r e

0 1 1 20 1 1 50 1 1 8

0 1 1 B0 1 1 D

0 1 2 0

1 1 F 3 0 1C D 9 C 0 1C 3 5 1 0 1

3 E 8 03 2 1 3 0 2

2 1 0 0 0 0

L X C A L LJ M

M V T

L X

D , O P N M S GE R F I N I S

A , 8 0 HI B

H ,

C - 1 2 8 U F / M U

; T R E T U R N; O P E N O K :

; O P E N O P E R A T I O N O K ; S E T B U F F E R I N D E X T O E N

/ S E T B U F F E R P O I N T E R T 8 O ; H C O N T A I N S N E X T A D D R E S S T

/ S T A R T W I T H 0 0 0 0

> e r s u u i a e

P R I N T

T h a s s e m b l y l a n g u a g e p r o g r a m i l i s t e d w i t h a l o t h i n f o r m a t i o n a d d e db t h a s s e m b l e r . T h f i r s t c o l u m n l i s t s t h a d d r e s s a w h i c h t h c o d e i l o c a t e d — i f l a b e l i d e f i n e d , t h e f i r s t c o l u m n c o n t a i n s t h v a l u e o f t h l a b e l . T h p r o g r a m s t a r t s a a d d r e s s $ 0 1 0 0 a n e n d s a $ 0 5 7 A r e s u l t w k n o w t h m e a n i n g o t h n u m b e r t h a s s e m b l e r p r i n t e d ( s e ea b o v e ) . M o s t C P / M p r o g r a m s b e g i n a a d d r e s s $ 0 1 0 0 .A f t e r r e v i e w i n g t h a s s e m b l e r l i s t i n g , o p r i n t e d o u a h a r d c o p y , l o o k a t h s e c o n d f i l e c r e a t e d b t h a s s e m b l e r . E n t e r t h e f o l l o w i n g :

T Y P E D U M P . H E X < R E T U R N >H e r ! s a i l l u s t r a t i o n o w h a t s h o u l d a p p e a r o y o u r s c r e e n :

: 1 0 0 1 3 0 0 0 4 4 0 1 C D 7 2 0 1 C D 5 9 0 1 0 F D A 5 1 0 1 7 C C D 8 F 0 1 F F: 1 0 0 1 4 0 0 0 7 D C D 8 F 0 1 2 3 3 E 2 0 C D 6 5 0 1 7 8 C D 8 F 0 1 C 3 2 3 6 6: 1 0 0 1 5 0 0 0 0 1 C D 7 2 0 1 2 A 1 5 0 2 F 9 C 9 E 5 D 5 C 5 0 E 0 B C D 0 5 F l: 1 0 0 1 6 0 0 0 0 0 C l D l E l C 9 E 5 D 5 C 5 0 E 0 2 5 F C D 0 5 0 0 C l D l 0 1: 1 0 0 1 7 0 0 0 E 1 C 9 3 E 0 D C D 6 5 0 1 3 E 0 A C D 6 5 0 1 C 9 E 6 0 F F E 2 0: 1 0 0 1 8 0 0 0 0 A D 2 8 9 0 1 C 6 3 0 C 3 8 B 0 1 C 6 3 7 C D 6 5 0 1 C 9 F 5 D 6

s e o n u m b e r s i d i s p l a y e d . T h e s e a r e t h e p r o g r a m c o d e s ( o p c o d e s ) .O t h e r i n f o r m a t i o n i d i s p l a y e d , s u c h a t h a d d r e s s t w h i c h t h c o d e w i l ll a t e r b m o v e d . T h i s f i l e i a l r e a d y c o n s i d e r a b l y s h o r t e r t h a n t h D U M P P R f i l e . T h e r e i a l s o s y m b o l t a b l e w i t h t h e x t e n s i o n . S Y M .B u w s t i l l c a n ' t e x e c u t e t h i s m a c h i n e l a n g u a g e p r o g r a m , s i n c e i i s n f tC O f i l e . T h e r e i a n o t h e r p r o g r a m c a l l e d H E X C O M t h a t c r e a t e s C O f i l ef r o m h e f i l e . T d t h i s e n t e r :

H E X C O M D U M P

1 2

Page 142: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 142/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

N o t i c e t h a t a e x t e n s i o n i n o e n t e r e d . H E X C O M a u t o m a t i c a l l y a d d s t h e x t e n s i o n . h e x . T h s c r e e n t h e n d i s p l a y s :

H E X C O M V E R S : 3 . 0 0

F I R S T A D D R E S S 0 1 0 0L A S T A D D R E S S 0 2 1 2B Y T E S R E A D 0 1 1 3R E C O R D S W R I T T E N 0

Y o h a v e j u s t c r e a t e d C O f i l e , t h f i l e D U M P C O M . W c a e x e c u t eD U M P . C O b s i m p l y e n t e r i n g :

D U M P D U M P . C O M ( d i s p l a y s i t s e l f )

N e x t w e ' l l d i s c u s s f e t h i n g s a b o u t t h a s s e m b l e r , s t h a t y o c a u s i p r o p e r l y . T h s o u r c e p r o g r a m s f o t h a s s e m b l e r a r A S C I I t e x t f i l e s . E a c hl i n e o t e x t h a t h f o l l o w i n g f o r m a t :

< l i n e n u w b e r x l a b e l > : < m n e m o n i c > < a r g u m e n t > < c o m m e n t >T h < l i n e n u m b e r > i o p t i o n a l . I n e e d n o b p r e s e n t , a s i o u e x a m p l e . I i i g n o r e d b t h a s s e m b l e r , a n u s e d h e r e o n l y b e c a u s e s o m e t e x t e d i t o r s( s u c h a E D a u t o m a t i c a l l y i n s e r t l i n e n u m b e r s . T h < m n e m o n i c > : i a l s oo p t i o n a l , b u i u s e d m u s t b p l a c e d a t t h i s l o c a t i o n . T h e < m n e m o n i c > a n t h < a r g u m e n t > m u s t b i n c l u d e d i a l a s s e m b l e r s o u r c e l i n e s , u n l e s s t h l i n e i l i n e o c o m m e n t s .T h a s s e m b l e r c o n v e r t s l o w e r c a s e l e t t e r s t u p p e r c a s e b e f o r e p r o c e s s i n gt h e m . T h i s s i m p l i f i e s p r o g r a m m i n g g r e a t l y . T h o n e x c e p t i o n t t h i s r u l e i t h l e t t e r s b e t w e e n q u o t a t i o n m a r k s r e p r e s e n t i n g f i x e d s t r i n g — t h e s e l e t t e r sa r l e f t i l o w e r c a s e , a i t h f o l l o w i n g i n s t r u c t i o n :

D " F i l e D u m p V e r s i o n 1 . 4 "T h i n d i v i d u a l c o m p o n e n t s o a a s s e m b l e r s o u r c e l i n e a r s e p a r a t e d b a l e a s t o n s p a c e . I t i s s t a n d a r d p r a c t i c e t b e g i n t h l i n e w i t h t h < l a b e l > ( f a rl e f t ) a n t h e n u s t h e d i t o r t T A t t h n e x t c o m p o n e n t s . T h i s i n o r e q u i r e d , b u i i m p r o v e s t h r e a d a b i l i t y o t h p r o g r a m . T h p r o g r a m l i s t i n gw i l l b i n e a t c o l u m n s , l i k e i n t h i s e x a m p l e :

1 3

Page 143: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 143/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D I S K R : ; R E A D D I S K F I L E R E C O R DP U S H H P U S H D P U S HL X D , F C BM V C , R E A D FC A L L B D O SP O B P O D P O R E

T h a b o v e p r o g r a m s e g m e n t i f r o m t h D U M P p r o g r a m . D I S K R i l a b e l ,a n l a b e l s a r a l w a y s i d e n t i f i e d b c o l o n . T h e n c o m e s t h m n e m o n i c a n t h a r g u m e n t , i n t h a t o r d e r .

Y o a l s o s e a n o t h e r f e a t u r e o t h a s s e m b l e r i t h i s s h o r t r o u t i n e . M u l t i p l ea s s e m b l e r m n e m o n i c s m a a p p e a r o t h s a m e l i n e s e p a r a t e d b e x c l a m a t i o n p o i n t s .

s e m i c o l o n i n d i c a t e s t h a t c o m m e n t s f o l l o w . A l t e r n a t i v e l y , y o c a d e f i n ea e n t i r e l i n e a c o m m e n t b b e g i n n i n g t h a t l i n e w i t h a n a s t e r i s k . Y o c a u s t h i s f e a t u r e t g i v e i n d i v i d u a l r o u t i n e s i t h a s s e m b l y l a n g u a g ep r o g r a m h e a d e r l i n e , l i k e i t h f o l l o w i n g e x a m p l e :

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ** * R e a d D i s k F i l e R e c o r d * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

B s u r e t h a t a n l a b e l s y o u s a r n o t h s a m e a a n o t h a s s e m b l e rm n e m o n i c s , s u c h a M V I , M O V , a n d S T A . R e f e r t A p p e n d i x f o l i s t i n go 8 0 8 0 a s s e m b l e r m n e m o n i c s .W i t h t h A S a s s e m b l e r a n m a n y o t h e r a s s e m b l e r s , y o c a r e f e r t t h c u r r e n t v a l u e o f t h p r o g r a m c o u n t e r d u r i n g t h a s s e m b l y p r o c e s s . F o i n s t a n c e , t h i s i d o n e a u t o m a t i c a l l y f o p r o g r a m l a b e l s , a i t h f o l l o w i n ge x a m p l e :

p o s i t : E Q A r g u m e n t s m a b c o m p o s e d o v a r i o u s a r i t h m e t i c o p e r a t o r s . F o e x a m p l e :

M V A , 1 2 + 2 * 3

m n e m o n i c a r g u m e n t s

1 3

Page 144: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 144/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h a r i t h m e t i c o p e r a t o r s a r a s f o l l o w :

+ P o s i t i v e n u m b e r- N e g a t i v e n u m b e r , c o r r e s p o n d s t 0 - ( a l w a y s 1 b i t ! )x + A d d i t i o n o t w 1 6 - b i t v a l u e sX S u b t r a c t i o n o t w 1 6 - b i t v a l u e sX * P r o d u c t o X * x / D i v i s i o n o t h a r g u m e n t s

M O R e m a i n d e r o t h e d i v i s i o n X /

I a d d i t i o n , t h e s e t w s h i f t o p e r a t o r s m a b u s e d :

S H S h i f t s d i 1 6 - b i t v a l u e b p o s i t i o n s t t h l e f tB i t s s h i f t e d o u a r l o s t

S H S h i f t s t h 1 6 - b i t v a l u e b p o s i t i o n s t t h l e f tB i t s s h i f t e d o u a r l o s t

F u r t h e r m o r e , t h e s e l o g i c a l o p e r a t o r s a r a v a i l a b l e :

N O L o g i c a l n e g a t i o n o t h a r g u m e n tA N L o g i c a l a n o t h a r g u m e n t s a n O L o g i c a l O o t h a r g u m e n t s a n X O L o g i c a l X O o t h a r g u m e n t s a n

Y o u m a y n o s e t h v a l u e o t h e s e p o s s i b i l i t i e s a f i r s t g l a n c e . B u y o u ' l ls o o n f i n d o u t h e y a r v e r y u s e f u l . F o e x a m p l e , i y o u w a n t t l o a d t h a c c u m u l a t o r w i t h t h h i g h - o r d e r b y t e o a a d d r e s s l a b e l , y o c a e a s i l y d t h i s b s h i f t i n g t h i s v a l u e t t h r i g h t b b i t s :

M V A , l a b e l S H T l o a d t h l o w e r b i t s , y o u m u s t e x p l i c i t l y m a s k t h u p p e r b i t s .O t h e r w i s e y o w o u l d l o a d t h 8 - b i t a c c u m u l a t o r w i t h 1 6 - b i t v a l u e .

1 3

Page 145: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 145/316

Page 146: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 146/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

D p l a c e s t h e i n d i v i d u a l l y d e f i n e d v a l u e s i n t o m e m o r y .T h i n d i v i d u a l b y t e s a r s e p a r a t e d b c o m m a s .S t r i n g s m a a l s o b u s e d .E x a m p l e s :D i s k t x t : D B " P l e a s e i n s e r t t h e d i s k "D i s k t 2 : D 2 3 , 3 2 , 0 , 3 , 1 2 2

D p l a c e s 1 6 - b i t v a l u e s ( w o r d s ) i n t o m e m o r y . T h i n d i v i d u a l 1 6 - b i t v a l u e s a r s e p a r a t e d b c o m m a s .E x a m p l e : D i s k a d r : D 0 3 A B 9 H , l a b e l l

E N d e f i n e s t h e n o t h p r o g r a m t b a s s e m b l e d . F o s p e c i a l p u r p o s e s i t ' s a l s o p o s s i b l e t s p e c i f y as t a r t i n g a d d r e s s f o t h e x e c u t i o n o t h a s s e m b l e dp r o g r a m .

S E S i m i l a r t t h E Q c o m m a n d , t h S E c o m m a n da s s i g n s a v a l u e t l a b e l . B u t h e r e i d i f f e r e n c e :t h a s s i g n m e n t i p e r m a n e n t u s i n g E Q U . L a b e l sd e f i n e d w i t h S E T m a y b c h a n g e d d u r i n g a s s e m b l y .L a b e l s d e f i n e d w i t h S E d n o a p p e a r i t h l e f t h a n d c o l u m n o t h a s s e m b l e r l i s t i n g .

E x a m p l e s :L a b e l l : S E T A l f aL a b e l l : S E T L a b e l l + 3 2

B u w s t i l l h a v e n ' t c o v e r e d a l t h c a p a b i l i t i e s o M A C . L i k e m a n y o t h e rc a p a b l e a s s e m b l e r s , A S c a n p e r f o r m c o n d i t i o n a l a s s e m b l y . C o n d i t i o n a la s s e m b l y i n v o l v e s a s s e m b l i n g c e r t a i n g r o u p o a s s e m b l e r s o u r c e l i n e so n l y u n d e r s p e c i f i c c o n d i t i o n s . I t ' s d o n e w i t h t h p s e u d o o p c o d e s I a n E N D I F .

S u p p o s e t h a t w w a n t t w r i t e p r o g r a m t r e a d t w v a l u e s , a n t h e n e i t h e ra d t h e m o m u l t i p l y t h e m t o g e t h e r . T h a l g o r i t h m w o u l d b t h s a m e f o b o t h o p e r a t i o n s a n b o t h p r o g r a m s . Y o c a w r i t e p r o g r a m t h a t c h e c k sf l a g d u r i n g a s s e m b l y t d e t e r m i n e i t h p r o g r a m s h o u l d a d o m u l t i p l y :

1 3

Page 147: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 147/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

M u l t i E Q U / P r o g r a m i t a d O R G 0 1 0 0 H/ R e a d v a l u eC A L L R e a dI M u l t i

C A L L M u l t i r / C a l l m u l t i p l i c a t i o n r o u t i n eE N I I N O T M u l t i

C a l l A d d i r / C a l l a d d i t i o n r o u t i n eE N I C A L L O u t p u tE N

T h i s p r o g r a m i i n i t i a l l y s e t p e r f o r m a d d i t i o n , s i n c e t h v a l u e o M u l t ii s e t t o T c h a n g e t h p r o g r a m t m u l t i p l y , s e t h v a l u e f o M u l t ie q u a l t N O i t h f i r s t l i n e — t h a t ' s t h o n l y c h a n g e t h a t h a t b e m a d e .W h e n y o a s s e m b l e d t h D U M P p r o g r a m , t h r e e f i l e s w e r e c r e a t e d o d i s k e t t e :

K f i l e n a m o . V R N , < f i l e n a m e > . H E X , a n d < f i l e n a m e > . S Y MT h e r e a r o p t i o n s t s u p p r e s s t h e s e f i l e s o s p e c i f y w h e r e t h e y a r w r i t t e n .T h f i v e o p t i o n s a v a i l a b l e a r p r e c e d e d w i t h t h s y m b o l . T h o p t i o n s a r e :

D r i v e f o . A S M f i l e ( A - O )D r i v e f o . H E X f i l e ( A - O , Z )D r i v e f o . L I B f i l e ( A - O )D r i v e f o . p r n f i l e ( A - O , Z P X

S D r i v e f o . S Y M f i l e ( A - O , z p X

1 3

Page 148: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 148/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s c r f s G u i d e

T h v a l u e s t h r o u g h a r t h d r i v e i n d i c a t o r s . W i t h t h ! 1 2 8 , o n l yt h o u g h a r p o s s i b l e .

T h v a l u e s p e c i f i e s t h p r i n t e r .

T h v a l u e s p e c i f i e s t h s c r e e n .

T h v a l u e s u p p r e s s e s t h f i l e .

T a s s e m b l e f i l e D U M P A S o t h d r i v e , c r e a t e p r i n t e d p r o g r a ml i s t i n g a n w r i t e t h e h e f i l e t t h d r i v e , y o u w o u l d e n t e r :

M A D U M P $ A A . P P H E

N o t i c e t h a t t h o p t i o n s a r s e p a r a t e d b s p a c e .i n d i c a t e s t h a t o p t i o n s f o l l o w

A i n d i c a t e s t h a t t h A S f i l e i c o n t a i n e d o t h d r i v e .P i n d i c a t e s t h a t t h a s s e m b l e r l i s t i n g i t b s e n t t o t h e p r i n t e r .H i n d i c a t e s t h a t t h H E f i l e i t b w r i t t e n t o t h e d r i v e .

R M A C i v e r y s i m i l a r t M A C , e x c e p t i c a p r o d u c e r e l o c a t a b l e c o d e i m e m o r y . W h e n a s s e m b l i n g , a H E f i l e i n o c r e a t e d , b u t a R E f i l e . T h R E f i l e i p r o c e s s e d b t h l i n k e r , L I N K , u n l i k e H E f i l e w h i c h i p r o c e s s e d b H E X C O M . U s i n g R M A C , t h e r e a r e o n l y t h r e e o p t i o n s f o R M A C :

D r i v e f o . R E L f i l e ( A - O , Z D r i v e f o . S Y M f i l e ( A - O , X P Z D r i v e f o . P R N f i l e ( A - O , X P Z

O p t i o n s a r i n d i c a t e d b t h $ s y m b o l , a n m u l t i p l e o p t i o n s m u s t b s e p a r a t e d s i n g l e s p a c e s .

N e x t w e l l d i s c u s s t h e d i s a s s e m b l e r / m o n i t o r S I a n t h u s e o f S U B M I Tf i l e s .

1 3

Page 149: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 149/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

8 . W o r k i n g w i t h s u b m i t

W h e n y o p r o g r a m i a s s e m b l y l a n g u a g e , y o h a v e t r e p e a t e d l y e n t e rs p e c i f i e d s e q u e n c e o C P / M c o m m a n d s . F o e x a m p l e , y o w i l l u s t h A S t a s s e m b l e t h s o u r c e f i l e , c o n v e r t t h H E f i l e t C O f i l e a n t h e n t e s tt h n e c o m m a n d . I t h n a m e o y o u r p r o g r a m i T E S T P G M , t h e n y o w o u l d h a v e t u s t h f o l l o w i n g s e q u e n c e o C P / M c o m m a n d s t a s s e m b l e , c o n v e r t a n e x e c u t e y o u r p r o g r a m :

M A C T E S T P G MH E X C O M T E S T P G MT E S T P G M

I y o u s m a s u c h s e q u e n c e s o f c o m m a n d s w h e n w o r k i n g w i t h C P / M ,y o m a w a n t t c r e a t e S U B M I T f i l e f o e a c h s e q u e n c e . S U B M I T f i l e i a o r d e r e d l i s t o C P / M c o m m a n d s . L a t e r , t h u s e r c a r e d i r e c t t h i n p u tf r o m t h k e y b o a r d t t h S U B M I T f i l e . I o t h e r w o r d s , C P / M t a k e s t h ec o m m a n d s f r o m t h s u b m i t f i l e r a t h e r t h a n t h k e y b o a r d .

F o t h o s e o y o w h w a n t t k n o w h o t h i s t a k e s p l a c e , h e r e ' s s h o r te x p l a n a t i o n . W h e n y o S U B M I T f i l e , t e m p o r a r y f i l e c a l l e d $ $ S U B .i c r e a t e d . I c o n t a i n s c o p y o t h o r i g i n a l S U B M I T f i l e , e x c e p t t h a ts y m b o l i c p a r a m e t e r s a r e r e p l a c e d . T h C C P , w h i c h h a n d l e s u s e r i n p u t f r o mt h k e y b o a r d , r e c o g n i z e s t h p r e s e n c e o a n a c c e p t s t h f i r s t l i n e o i n p u tf r o m t h $ $ S U f i l e . ( T h e f i r s t i n p u t l i n e i t h e n d e l e t e d f r o m t h $ $ $ . S U B f i l e ) .

F i n a l l y , t h c o m m a n d c o n t a i n e d i t h f i r s t i n p u t l i n e i e x e c u t e d a i i h a b e e n t y p e d a t h k e y b o a r d . W h e n t h f i r s t c o m m a n d l i n e h a b e e nc o m p l e t e l y e x e c u t e d , t h C C r e t u r n s t t h $ $ S U f i l e t g e t h n e x ti n p u t l i n e . T h i s i r e p e a t e d u n t i l t h $ $ S U f i l e i e m p t y , a w h i c h t i m et h C C r e v e r t s b a c k t t h k e y b o a r d f o s u b s e q u e n t i n p u t .

L e t ' s s e p r a c t i c a l e x a m p l e i n a c t i o n .

W h e n y o d i s p l a y d i r e c t o r y o d i s k e t t e , y o u ' l l n o t i c e t h a t n i n f o r m a t i o na b o u t t h r e m a i n i n g s p a c e i d i s p l a y e d . Y o c a g e t h i s i n f o r m a t i o n b u s i n g t h S H O W c o m m a n d . L e t ' s c r e a t e S U B M I T f i l e , w h i c h w e ' l l c a l lD I S P , t h a t d i s p l a y s b o t h t h e d i r e c t o r y a n t h c a p a c i t y .

1 3

Page 150: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 150/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T c r e a t e f i l e c a l l e d D I S P S U w u s a e d i t o r . T h C P / M e d i t o r i c a l l e d E D H e r e ' s q u i c k l e s s o n o t h u s o f E D .I n s e r t t h e s y s t e m d i s k e t t e i n t o t h d r i v e , m a k i n g s u r e t h a t t h s e c o n d s i d e i f a c e u ( u n l e s s y o u ' v e a l r e a d y m a d e a d o u b l e - s i d e d 1 5 7 1 s y s t e m d i s k e t t e ) .T c r e a t e t h S U B M I T f i l e u s i n g E D t y p e :

E D I S P . S U B

T h c u r s o r f l a s h e s a s E w a i t s f o u t i n p u t d a t a . E i s n ' t t h e a s i e s te d i t o r t o u s e . B u s i n c e w e ' l l o n l y b e n t e r i n g t w l i n e s , w w o n ' t h a v e t s u f f e r v e r y l o n g . N e x t , e n t e r t i n d i c a t e t h a t y o u ' l l b i n p u t t i n gc h a r a c t e r s i n t o t h f i l e . T h d i s p l a y w i l l l o o k l i k e t h i s :

* 1

E n t e r t h e f o l l o w i n g :

1 s h o w a < R E T U R N >2 d i < R E T U R N >3 < C O N T R O L > Z

T h e n e x i t f r o m E b e n t e r i n g t h e E c o m m a n d :* < R E T U R N >

E s a v e s t h f i l e D I S P S U t t h d i s k e t t e . Y o c a v i e w t h f i l e w i t hT Y P E D I S P . S U B . L e t ' s t r o u t h n e S U B M I T f i l e . E n t e r :

S U B M I T D I S PN o t i c e t h a t t h e x t e n s i o n . S U B i n o r e q u i r e d . C P / M c r e a t e s t e m p o r a r y$ $ S U f i l e b c o p y i n g t h c o n t e n t s o D I S P S U B , a n d t h e n e r a s e s t h c o m m a n d s , l i n e b l i n e , f r o m $ $ $ . S U a i p r o c e e d s t e x e c u t e e a c h l i n e .

H o p e f u l l y o u r n e S U B M I T f i l e w o r k s : i d i s p l a y s t h e u n u s e d s p a c e o t h d i s k e t t e a s w e l l a t h d i r e c t o r y .

R e c a l l o u o r i g i n a l t a s k . W w a n t t a s s e m b l e a f i l e , c o n v e r t i i n t o C O f i l e w i t h H E X C O M , t h e n e x e c u t e i t T h c o m m a n d s e q u e n c e w o u l d l i k e l i k e :

1 3

Page 151: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 151/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

M A < f i l e n a m e > $ < o p t i o n s >H E X C O M < f i l e n a m e >< f i l e n a m e >

B o t h < f i l e n a m e > a n < o p t i o n s > i t h i s e x a m p l e a r p a r a m e t e r s , a n a r s e p a r a t e d b a t l e a s t o n s p a c e . p a r a m e t e r m a b s p e c i f i c p a r a m e t e r o

s y m b o l i c p a r a m e t e r .

s p e c i f i c p a r a m e t e r i e n t e r e d a s t r i n g o c h a r a c t e r s , s u c h a d u m p , I o A :

s y m b o l i c p a r a m e t e r i n u m b e r p r e c e d e d b d o l l a r s i g n ( $ ) . W h e n i i e n c o u n t e r e d i S U B M I T f i l e , s y m b o l i c p a r a m e t e r i r e p l a c e d b v a l u ee n t e r e d i t h S U B M I T c o m m a n d l i n e . H e r e ' s a n e x a m p l e . T h i s i t h c o n t e n t s o S U B M I T f i l e c a l l e d A S S E M . C O M :

M A $ $ $ $ 2H E X C O M $ $ $

T h i s i t h S U B M I T c o m m a n d y o e n t e r t i n v o k e t h S U B M I T f i l e a b o v e :

S U B M I T A S S E M D U M P A B S H 0 W . C O MT h f o l l o w i n g $ $ $ . S U B f i l e i a c t u a l l y c r e a t e d :

M A C D U M P $ A H E X C O M D U M PD U M P S H 0 W . C O M

I w r e t u r n t t h S U B M I T c o m m a n d l i n e , w c a s e w h a t h a p p e n e d . T h p a r a m e t e r s i t h c o m m a n d l i n e a r n u m b e r e d b e g i n n i n g w i t h 1

S U B M I T A S S E M D U M P A S H 0 W . C O M

p a r a m e t e r p a r a m e t e r p a r a m e t e r

A S U B M I T p r o c e s s e s a S U B M I T f i l e , i r e p l a c e s t h e p a r a m e t e r s i t h S U B M I T f i l e w i t h t h c o r r e s p o n d i n g a c t u a l p a r a m e t e r f r o m t h c o m m a n dl i n e . T h u s w h e n i e n c o u n t e r s $ i t h S U B M I T f i l e , t h f i r s t a c t u a lp a r a m e t e r D U M P i s u b s t i t u t e d . W h e n i e n c o u n t e r s $ $ $ 2 i t h S U B M I T

1 3

Page 152: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 152/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

f i l e , t h s e c o n d a c t u a l p a r a m e t e r $ A i s u b s t i t u t e d ( $ i t h n o t a t i o n t i n s e r t s i n g l e $ ) A n f i n a l l y , w h e n i e n c o u n t e r s $ 3 t h t h i r d p a r a m e t e rS H O W . C O i s u b s t i t u t e d .

T r e i t e r a t e a b o u t e m b e d d e d $ l e t ' s g i v e a n o t h e r e x a m p l e . S u p p o s e y o w a n t t e n t e r t h e f o l l o w i n g S U B M I T f i l e :

E R * . $ $ $F o e a c h $ y o m u s t s u b s t i t u t e $ $ T h e r e f o r e t h c o m m a n d l o o k s l i k e t h i si S U B M I T f i l e :

E R * . $ $ $ $ $ $

S U B M I T i p o w e r f u l c o m m a n d . B e s i d e s r e d i r e c t i n g t h C C t i n p u tc o m m a n d s f r o m S U B M I T f i l e , y o c a r e d i r e c t t h i n p u t f o o t h e rc o m m a n d s s u c h a E o I P T h e s e e m b e d d e d c o m m a n d s a r p r e c e d e d b

l e s s - t h a n c h a r a c t e r ( < ) . A e x a m p l e u s i n g e m b e d d e d c o m m a n d s :p i < E : = A : * . C O M

D I * . C O MN o t i c e t h a t t h l a s t i n p u t l i n e f o P I c o n s i s t s o c h a r a c t e r . T h i s i u s e dt o e x i t t h t r a n s i e n t I P T h i s a p p l i c a t i o n c o u l d a l s o b e n t e r e d l i k e t h i s :

P I e : = a * . C O M

T h i s w o u l d c o p y a l t h C O f i l e s f r o m d r i v e t d r i v e E I t ' s s u f f i c i e n t t op u t a c h a r a c t e r i t h f i r s t c o l u m n i o r d e r t p a s s d a t a t C O f i l e s .P a r a m e t e r s w h i c h a r o t h e r w i s e e n t e r e d o t h k e y b o a r d c o m e f r o m t h f i l e$ $ . S U B i n s t e a d .

H e r e w e n o u d i s c u s s i o n S U B M I T f i l e s . T r m a k i n g y o u r o w n S U B M I Tf i l e t h n e x t t i m e s u i t a b l e a p p l i c a t i o n c r o p s u p

W e ' v e n o d i s c u s s e d t h a s s e m b l e r a n S U B M I T f i l e s . W e ' l l b r i e f l ym e n t i o n t h S I d i s a s s e m b l e r . D i s a s s e m b l y i t h o p p o s i t e o a s s e m b l y :t h m a c h i n e o p c o d e s a r c o n v e r t e d t o t h e i r m n e m o n i c e q u i v a l e n t s . S I i n o j u s t d i s a s s e m b l e r , b u t m o n i t o r a w e l l .

1 4

Page 153: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 153/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

S I D , a a c r o n y m f o S y m b o l i c I n t e r a c t i v e D e b u g g e r , a l l o w s y o t t e s t a n d e b u g p r o g r a m s y o h a v e d e v e l o p e d . S I s u p p o r t s b r e a k p o i n t s , s y m b o l i cd i s a s s e m b l y , a s s e m b l y , m e m o r y d i s p l a y , m e m o r y f i l l f u n c t i o n s , a n i m o n i t o r s t h p r o g r a m e x e c u t i o n .

T g e c o m p l e t e l i s t o t h S I D c o m m a n d s l i s t e d o y o u r p r i n t e r , i n s e r t t h C P / M s y s t e m d i s k e t t e a n e n t e r :

< C O N T R O L > PH E L P S I C O M M A N D S < R E T U R N >

T h i s w i l l l i s t a l l o t h S I c o m m a n d s t y o u r p r i n t e r . W h e n t h l i s t i n g i f i n i s h e d e n t e r < C O N T R O L > a g a i n t t u r n o f t h e p r i n t e r o u t p u t .

I f f o e x a m p l e , y o w a n t t d i s a s s e m b l e t h c o m m a n d f i l e H E X C O M . C O M ,y o s i m p l y e n t e r :

S I D U M P . C O MB e f o r e y o p r e s s < R E T U R N > , y o m a p r e s s < C 0 N T R 0 L > t s e n d t h o u t p u t t t h p r i n t e r a s w e l l .

C P / M S I V e r s i o n 3 . N E X T M S Z E P C E N D0 2 8 0 0 2 8 0 0 1 0 0 C E F F

C a l l u t h d i s a s s e m b l e r H E X C O M b e n t e r i n g t h c o m m a n d L

# 0 1 0 0 L X H , 0 0 0 00 1 0 3 D A S

# L 1 8 00 1 8 0 L D A Z0 1 8 1 J N C 0 1 8 9

T h o p t i o n d u m p s a a r e a o m e m o r y i h e x a d e c i m a l a n d A S C I I . T h o p t i o n e x e c u t e s t h p r o g r a m . T h o p t i o n l e t s y o e n t e r s o u r c e c o d ed i r e c t l y w i t h d i r e c t a s s e m b l e r .

1 4

Page 154: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 154/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

8 . T h m e m o r y l a y o u t

W h a v e a l r e a d y m e n t i o n e d B D O S , C C P , a n B I O S . T h e s e t e r m s a r o b v i o u s l y v e r y i m p o r t a n t , a n y o u ' v e p r o b a b l y h e a r d o r e a d t h e m b e f o r e .Y o m a h a v e w o n d e r e d a l o t h e m a r l o c a t e d i t h c o m p u t e r ' s m e m o r y .H e r e ' s a q u i c k o v e r v i e w :

C C T h C o n s o l e C o m m a n d P r o c e s s o r . T h i s p a r t o C P / Mc o n t r o l s t h i n p u t f r o m t h k e y b o a r d a n d c o n t a i n s t h r e s i d e n t c o m m a n d s D I R , E R A , R E N , S A V E , T Y P E , a n U S E R .

B D O S T h B a s i c D i s k O p e r a t i n g S y s t e m . T h i s p a r t c o n t r o l s t h et r a n s f e r o d a t a b e t w e e n t h c o m p u t e r a n d t h d i s k d r i v e s .

B I O S T h B a s i c I n p u t / O u t p u t S y s t e m . T h B I O S c o n t a i n s t h m a c h i n e - s p e c i f i c c o d e f o t h C P / M o p e r a t i n g s y s t e m T h eB I O S a n B D O S w o r k c l o s e l y t o g e t h e r . T h i s i w h t h t w a r o f t e n o f t e n f o u n d u n d e r o n c o m m o n n a m e :F D O S .

T P T h T r a n s i e n t P r o g r a m A r e a . T h T P i t h u s e r p r o g r a ma r e a i m e m o r y . T h e p r o g r a m s t b e x e c u t e d , a n t h d a t at b p r o c e s s e d b t h e s e p r o g r a m s , a r m a n a g e d i t h i sm e m o r y .

B I O S

B D O S

C C

T P

S y s t e m p a r a m e t e r

1 4

Page 155: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 155/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h p r e c e d i n g f i g u r e s h o w s t h e b a s i c m e m o r y p a r t i t i o n s o C P / M . T h u s e ra r e a ( T P A ) s t a r t s a a d d r e s s $ 0 1 0 0 ,T h B D O S c o n t a i n s a c o l l e c t i o n o s u b r o u t i n e s t h a t p e r f o r m s t h f u n d a m e n t a l w o r k w i t h f i l e s o d i s k , a n h a n d l e s o t h e r p e r i p h e r a l d e v i c e s .C P / M f i r s t a p p e a r e d i t h e a r l y 7 0 f s , w h i c h e x p l a i n s i t o b s o l e t e r o u t i n e sf o i n p u t a n o u t p u t f r o m p u n c h t a p e .

T c a l l B D O S r o u t i n e , y o m u s t f o l l o w t h s t a n d a r d i z e d d e c l a r a t i o n sd e s c r i b e d b e l o w :

T h B D O S f u n c t i o n c o d e f o r t h e d e s i r e d s e r v i c e i p a s s e d t t h B D O S i t h r e g i s t e r . D a t a i p a s s e d t t h s u b r o u t i n e i t h r e g i s t e r f o 8 - b i tv a l u e s , o t h D r e g i s t e r p a i r f o 1 6 - b i t v a l u e s . A f t e r t h r e g i s t e r s a r l o a d e d , y o j u m p t t h B D O S a a d d r e s s w i t h a s u b r o u t i n e i n s t r u c t i o n( C A L L ) .B D O S d e t e r m i n e s t h a d d r e s s o t h d e s i r e d r o u t i n e f r o m t h r e g i s t e r .T h i s e n s u r e s t h a t p r o g r a m s w r i t t e n c a r e a l l y r u o a l c o m p u t e r s , b e c a u s et h e y a l f o l l o w s e t r u l e s . A l h a r d w a r e - d e p e n d e n t a s p e c t s o o p e r a t i o n , l i k ei n p u t a n o u t p u t f r o m t h k e y b o a r d , a r h a n d l e d b s p e c i a l B D O S r o u t i n e s .W h e n n e c o m p u t e r i b e i n g d e v e l o p e d , o n l y t h e s e r o u t i n e s n e e d t b r e w r i t t e n f o r a l C P / M p r o g r a m s t r u o t h n e c o m p u t e r .N a t u r a l l y , t w p r e c o n d i t i o n s m u s t b m a d e . T h c o m p u t e r m u s t h a v e a 8 0 8 0 o 8 0 8 0 - c o m p a t i b l e p r o c e s s o r , a n i m u s t b p o s s i b l e t r e a d t h e x i s t i n g p r o g r a m s .

I t h s e c o n d c o n d i t i o n i n o t m e t , i i s t i l l t h e o r e t i c a l l y p o s s i b l e t r u C P / M p r o g r a m s o t h n e c o m p u t e r . T r a n s f e r r i n g e x i s t i n g p r o g r a m s h a p r o v e d t b t h s m a l l e r o t h t w p r o b l e m s . T h i s c a n b e d o n e b

a p r o g r a m m i n g t h c o n t r o l l e r , o

b u s i n g s i m p l e c o m m u n i c a t i o n s p r o g r a m t o t r a n s f e r t h e x i s t i n gp r o g r a m s b e t w e e n t h t w c o m p u t e r s , o v e r c o m m o n i n t e r f a c es u c h a a R S - 2 3 2 .

1 4

Page 156: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 156/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

I t h B D O S i t r e t u r n v a l u e s t t h m a i n p r o g r a m , 8 - b i t r e s u l t s a r r e t u r n e d i t h a c c u m u l a t o r , w h i l e 1 6 - b i t v a l u e s a r r e t u r n e d i t h H r e g i s t e r p a i r . F o 1 6 - b i t r e t u r n v a l u e s , t h a c c u m u l a t o r c o n t a i n s t h l o w - o r d e r b y t e , w h i l e t h h i g h - o r d e r b y t e i i t h r e g i s t e r .

F o e x a m p l e , t o u t p u t c h a r a c t e r t t h c o n s o l e , y o w o u l d u s B D O Sr o u t i n e n u m b e r 2 L e t f s p r i n t q u e s t i o n m a r k ( u s i n g Z - 8 0 m n e m o n i c s ) :

L D C , 2 / C O N S O L E O U T P U TL E , l f ? " ; L O A D Q U E S T I O N M A R KC A L L / J U M P T B D O S

I y o w a n t t d s e r i o u s p r o g r a m m i n g i m a c h i n e l a n g u a g e w i t h C P / M ,w s u g g e s t y o i n v e s t i o n o t h m a n y s p e c i a l b o o k s f o C P / Mp r o g r a m m e r s . T h e y ' l l g i v e y o u m o r e i n f o r m a t i o n a b o u t t h e i n d i v i d u a lr o u t i n e s . H e r e w w i l l o n l y l i s t t h B D O S r o u t i n e s w i t h i n p u t a n o u t p u tp a r a m e t e r s f o e x p e r i m e n t a t i o n :

1 4

Page 157: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 157/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

R o u t i n e n a m e B D O Sf u n c t i o n c o d e

G e n e r a t e w a r m s t a r tC o n s o l e i n p u tC o n s o l e o u t p u tR e a d p u n c h t a p eP u n c h t a p eC h a r a c t e r t p r i n t e rD i r e c t c o n s o l e i n p u ta n o u t p u tR e a d I O B Y T ES e I O B Y T EO u t p u t s t r i n gI n p u t f r o m b u f f e r 1 C o n s o l e s t a t u s 1 C P / M v e r s i o n 1 D i s k s y s t e m r e s e t 1 S e r e f e r e n c e d r i v e 1 O p e n f i l e 1 C l o s e f i l e 1 F i n d f i r s t e n t r y 1

N e x t e n t r y 1 D e l e t e f i l e 1 R e a d s e c t o r 2 W r i t e s e c t o r 2 C r e a t e f i l e 2 R e n a m e f i l e 2 R e a d a c t i v e d r i v e 2 R e a d r e f e r e n c e d r i v e 2 F i d a t a b u f f e r 2 R e a d a l l o c a t i o n t a b l e 2 P r o t e c t r e f . d r i v e 2 P r o t e c t e d d r i v eS e f i l e o p t i o n s 3 R e a d d i s k p a r a m e t e r s 3 M a n a g e u s e r n u m b e r 3

R e a d s e c t o r 3 W r i t e s e c t o r 3 D e t e r m i n e f i l e s i z e 3 S e d e s c r i p t o r 3 R e s e t d r i v e 3

R e q u i r e dp a r a m e t e r

E : c h a r a c t e r

c h a r a c t e rc h a r a c t e r

E : 2 5 5E : c h a r a c t e r

E : I O B Y T ED E : = > s t r i n gD E : = > b u f f e r

E : d r v n u m b e rD E r i n f oD E r i n f oD E : i n f oe l s e :

D E : i n f oD E r i n f oD E r i n f oD E : i n f oD E r i n f o

D E r b u f f e r

D E r i n f o

E : 2 5 5E r n u m b e rD E r i n f oD E r i n f oD E r i n f oD E r i n f o

B D O S r e t u r n st h i s v a l u e :

A : i n p u t

A : i n p u t

A : A c h a r a c t e rA : I O B Y T E

A c h a r a c t e rA : = 0 ( n k e y )H L : v e r s i o n

A : 2 5 5 ( e r r o r )A : 2 5 5 ( e r r o r )A : 2 5 5 ( e r r o r )A c h a r a c t e rA 2 5 5 / c h a r a c t e rA : 2 5 5 ( e r r o r )A : ( O K )A : ( O K )A : 2 5 5 ( e r r o r )A : 2 5 5 ( e r r o r )H L : d r v v e c t o rA : d r v n u m b e r

H L : a d d r e s s

H L : d r i v e v e c t o rA : 2 5 5 ( e r r o r )H L : a d d r e s sA n u m b e r

A : ( O K )A : ( O K )

( i b u f f e r )( i b u f f e r )

D E : d r v v e c t o r A :

1 4

Page 158: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 158/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h i s t a b l e i i n t e n d e d t s h o w t h p o s s i b i l i t i e s a n c a p a b i l i t i e s o t h B D O S .A a l r e a d y m e n t i o n e d , m o r e i n t e r n a l k n o w l e d g e o t h r o u t i n e s i r e q u i r e df o r s e r i o u s B D O S p r o g r a m m i n g .T h t a s k s o t h B I O S a r e v e n m o r e s p e c i a l i z e d . L i k e t h B D O S , t h B I O Sc o n s i s t s o l i s t o r o u t i n e s f o d a t a i n p u t a n o u t p u t . T h B I O S a l s o h a r o u t i n e s w h i c h d u p l i c a t e s o m e o t h B D O S r o u t i n e s , s u c h a r e a d i n g t h c o n s o l e s t a t u s .

T h B I O S i l a r g e l y r e s p o n s i b l e f o r t h e f l e x i b i l i t y o C P / M , b e c a u s e C P / Mp r o g r a m s c a u s s p e c i a l B I O S r o u t i n e s t p e r f o r m h a r d w a r e - d e p e n d e n ti n p u t a n o u t p u t t t h e c o n s o l e .

T h B I O S i d i v i d e d i n t o f o u r a r e a s :

I n t e r f a c e t t h B D O S a n C P / M p r o g r a m s ( s u c h a S U B M I Tf i l e s )

I n t e r f a c e t t h e x t e r n a l s t o r a g e m e d i a ( d i s k d r i v e s )

I n p u t a n o u t p u t v i t h e p e r i p h e r a l a d d r e s s e d b t h B D O SB u f f e r f o d a t a , w h i c h i s t o r e d a n t h e n m a d e a v a i l a b l e a t h e a p p r o p r i a t e t i m e ( s u c h a w i t h S U B M I T f i l e s ) .

T h B D O S a n t h B I O S a r e r e l o c a t a b l e i m e m o r y . T h r o u t i n e s i t h B D O S a r a d d r e s s e d b p a s s i n g t h f u n c t i o n n u m b e r i t h r e g i s t e r — a n dc a l l i n g t h f i x e d m e m o r y a d d r e s s $ 0 0 0 5 .C a l l i n g B I O S r o u t i n e s i l i t t l e d i f f e r e n t t h a n c a l l i n g t h B D O S . . T h e r e i f i x e d j u m p t a b l e , b u t h s t a r t i n g a d d r e s s o t h i s t a b l e c a n b e m o v e d . F i r s tl e t ' s t a k e l o o k a t h j u m p t a b l e :

1 4

Page 159: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 159/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 0 + o f f s e t J M B O O T0 3 + o f f s e t J M W B O O T0 6 + o f f s e t J M C O N S T0 9 + o f f s e t J M C O N I NO C + o f f s e t J M C O N O U TO F + o f f s e t J M L I S T1 2 + o f f s e t J M P U N C H1 5 + o f f s e t J M R E A D E R1 8 + o f f s e t J M H O M El B + o f f s e t J M S E L D S Kl E + o f f s e t J M S E T T R K2 1 + o f f s e t J M S E T S E C2 4 + o f f s e t J M S E T D M A2 7 + o f f s e t J M R E A D2 A + o f f s e t J M W R I T E2 D + o f f s e t J M L I S T S3 0 + o f f s e t J M S E C T R A N ;

/ C o l d s t a r t/ W a r m s t a r t/ R e a d c o n s o l e s t a t u s/ C o n s o l e i n p u t/ C o n s o l e o u t p u t/ O u t p u t t o p r i n t e r/ P a p e r t a p e p u n c h e r/ P a p e r t a p e r e a d e r/ H e a d t o t r a c k/ S e l e c t d r i v e/ S e t t r a c k/ S e l e c t s e c t o r/ S e l e c t d a t a b u f f e r/ R e a d s e c t o r/ W r i t e s e c t o r/ R e a d p r i n t e r s t a t u s/ T r a n s l a t e s e c t o r

T h o f f s e t s t a n d s f o r t h e s t a r t i n g a d d r e s s i m e m o r y , w h i c h w e ' l l s o o nd i s c u s s i m o r e d e t a i l I o n o t h f u n c t i o n s i n o r e q u i r e d , s u c h a t h t w r o u t i n e s f o t h p u n c h t a p e , t h c o r r e s p o n d i n g m e m o r y a d d r e s s e s a r f i l l e d w i t h :

R E N O N O T h i s i u s e d s t h m e m o r y b e h i n d t h e s e r o u t i n e s i n o m o v e d . J u m p i n g t t h i s r o u t i n e w o u l d c a u s e a i m m e d i a t e r e t u r n t t h u s e r ( w i t h n B I O Ss e r v i c e h a v i n g b e e n p e r f o r m e d ) .

T d e t e r m i n e t h B I O S s t a r t i n g a d d r e s s ( t h e o f f s e t ) , w m u s t k n o w t h a ta d d r e s s o t h b a s e p a g e o t h s y s t e m c o n t a i n s j u m p t t h w a r m s t a r tv e c t o r ( t h e s e c o n d v e c t o r i t h t a b l e ) . T h i s m a k e s i e a s y t f i n d t h s t a r t i n ga d d r e s s . F i r s t b o o t u t h C P / M s y s t e m , t h e n l o a d t h d i s a s s e m b l e r :

S I

1 4

Page 160: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 160/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T d i s a s s e m b l e ( L i s t ) t h m e m o r y a r e a a a d d r e s s 0 w e n t e r :

L 0 0 0 0S I D ' s d i s p l a y s t h e f o l l o w i n g :

0 0 0 0 J M F 4 0 30 0 0 3 R S 0 0 0 0 4 N O P0 0 0 5 J M D 3 0 00 0 0 8 N O ( e t c . )

W h a t i n t e r e s t s u i t h f i r s t l i n e — a j u m p i m a d e t a d d r e s s $ F 4 0 3 . T h i sm e a n s t h B I O S j u m p t a b l e b e g i n s a a d d r e s s $ F 4 0 3 . T j u m p t o n o t h v e c t o r s , w c a l c u l a t e t h j u m p a d d r e s s b e n t e r i n g :

A d d r e s s : = j u m p n u m b e r $ F 4 0 3A w i t h B D O S r o u t i n e s , y o c a p a s s p a r a m e t e r s t t h B I O S r o u t i n e s o r e c e i v e r e s u l t s f r o m t h e m . I v a l u e s a r t b p a s s e d t t h B I O S r o u t i n e s ,8 - b i t v a l u e s a r p a s s e d i t h r e g i s t e r , w h i l e 1 6 - b i t v a l u e s a r p a s s e d i t h B r e g i s t e r p a i r . H e r e y o s e d i f f e r e n c e f r o m t h B D O S r o u t i n e s .T h e y e x p e c t t h p a r a m e t e r i t h r e g i s t e r o t h D r e g i s t e r p a i r . T h o s ep a r a m e t e r s t h a t t h B I O S r o u t i n e s r e t u r n t t h m a i n p r o g r a m a r r e t u r n e dl i k e t h B D O S r o u t i n e s : w i t h 8 - b i t v a l u e s i t h a c c u m u l a t o r . A l 1 6 - b i tv a l u e s a r r e t u r n e d i t h H r e g i s t e r p a i r . S i n c e t h B I O S r o u t i n e s a r a c c e s s e d v i v e c t o r s i R A M , t h e y c a b c h a n g e d . T h i s a l l o w s y o t w r i t ey o u r o w r o u t i n e s t h a t c a t h e n r e t u r n t o t h o r i g i n a l p r o g r a m .T h e r e r f e a d d i t i o n a l f e a t u r e s o t h b a s e p a g e o t h s y s t e m ( a d d r e s s$ 0 0 0 0 t $ 0 1 0 0 ) . Y o j u s t d i s a s s e m b l e d t h a r e a f r o m $ 0 0 0 0 t $ 0 0 1 6 w i t ht h c o m m a n d L S e v e r a l a d d i t i o n a l J M i n s t r u c t i o n s a r e f o u n d h e r e .E s p e c i a l l y i m p o r t a n t i t h j u m p i n s t r u c t i o n a a d d r e s s 5 T h i s i t h a d d r e s so t h B D O S v e c t o r h a n d l e r . N o t e t h a t t h B D O S r o u t i n e s f o t h e ' 1 2 8 a r l o c a t e d a $ D 3 0 0 . T h J M i n s t r u c t i o n a $ 0 0 0 5 t e l l s u t h i s .

L e t ' s t a k e c l o s e r l o o k a t h i s m e m o r y a r e a :

L D 3 0 0

1 4

Page 161: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 161/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A $ D 3 0 0 i a n o t h e r J M i n s t r u c t i o n , t h i s t i m e t $ D 9 A 4 .T h i s c o n c l u d e s o u i n t r o d u c t i o n t t h i m p o r t a n t p r o g r a m s a n d u t i l i t i e s i t h A d d i t i o n a l U t i l i t i e s p a c k a g e . Y o s h o u l d n o b f a m i l i a r w i t h t h e s ea d d i t i o n a l p r o g r a m s . W h e t h e r t h e y a r v a l u a b l e t y o o n o i s o m e t h i n gw h i c h y o a l o n e w i l l d e c i d e .

1 4

Page 162: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 162/316

Page 163: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 163/316

C h a p t e r 9

T h Z - 8 0 R O l i s t i n g

Page 164: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 164/316

Page 165: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 165/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h Z - 8 0 R O l i s t i n g

T h f 1 2 8 ! s R O M s c o n t a i n p a r t s o t h Z - 8 0 c o d e a n a r l i s t e d i t h b o o kC o m m o d o r e l 2 8 I n t e r n a l s . I n a l l , 4 o m e m o r y , a a r e a p h y s i c a l l y l o c a t e di t h a d d r e s s r a n g e $ D 0 0 0 t $ D F F F , a r c o n t a i n e d i t h R O M .W h e n t h Z - 8 0 p r o c e s s o r i a c t i v a t e d a n t h Z - 8 0 a d d r e s s e s m e m o r y i t h r a n g e $ D 0 0 0 t $ D F F F , t h p r o g r a m c o d e s l o c a t e d i t h R O a $ D 0 0 0 t $ D F F F a r a c t u a l l y a d d r e s s e d . T h M M ( M e m o r y M a n a g e m e n t U n i t ) i r e s p o n s i b l e f o r r e d i r e c t i n g t h e s e a d d r e s s e s t r a n s p a r e n t l y t t h u s e r .

W h e n t h e ' 1 2 8 i t u r n e d o f a n o n o R E S E T i p e r f o r m e d , t h Z - 8 0 i e n a b l e d b r i e f l y . T h ' 1 2 8 m a k e s t h n e c e s s a r y p r e p a r a t i o n s f o p o s s i b l eC P / M s t a r t ; y o k n o w t h a t t h C - 1 2 8 a u t o m a t i c a l l y b o o t s a n s t a r t s i C P / M d i s k e t t e i f o u n d i t h d r i v e o R E S E T . W h e n t h Z - 8 0 i f i n i s h e dw i t h i t p r e p a r a t i o n s t h 8 5 0 2 i s w i t c h e d b a c k o n T h i s t h e n c o n t i n u e s a e x a c t l y t h e p l a c e i w a a w h e n i w a s w i t c h e d o f f — t h e p l a c e w h e r e t h Z - 8 0 w a f i r s t s w i t c h e d o n T h i s m a s o u n d c o m p l i c a t e d , b u t i t ' s r e a l l y n o t .I y o w a n t t p r o g r a m u s i n g t h Z - 8 0 , y o w i l l n e e d t k n o w w h a t t h Z - 8 0 R O c o n t a i n s . F u r t h e r m o r e , y o w i l l h a v e t k n o w h o t p r o g r a mt h Z - 8 0 i t h C o m m o d o r e 1 2 8 , b e c a u s e t h e r e a r e s o m e c h a r a c t e r i s t i c sw h i c h m i g h t l e a d t p r o b l e m s .

F o e x a m p l e , i y o u w a n t t a d d r e s s t h a r e a $ D 0 0 0 t $ D F F F , t h a t i s c o m p o n e n t l i k e t h V I C , V D C , S I D , e t c . , y o c a n ' t d s o w i t h t h " n o r m a l "a d d r e s s i n g c o m m a n d s . T h i n s t r u c t i o n s I a n O U m u s t b u s e d t a c c e s st h e s e " p o r t s . " . T t u r n o t h 8 5 0 2 , f o e x a m p l e , t h f o l l o w i n g i n s t r u c t i o n sa r n e c e s s a r y :

L B C , $ D 5 0 5 / A d d r e s s M o d e C o n f i g u r a t i o n R e g i s t e rL A , $ B 1 ; C o d e t o t u r n t h 8 5 0 2 o O U ( C ) , A / C o r r e s p o n d s t o L D ( B C ) , A

C o r r e s p o n d i n g l y , y o m u s t u s t h I i n s t r u c t i o n t r e a d f r o m m e m o r yl o c a t i o n s . T h a d d r e s s m u s t a l w a y s b i t h B r e g i s t e r p a i r .B c a r e f u l l y s t u d y i n g t h R O l i s t i n g s , y o u ' l l d i s c o v e r t h a t i a l s o c o n t a i n s8 5 0 2 c o d e s e q u e n c e s . E n a b l i n g t h p r o c e s s o r s , f o e x a m p l e , m u s t b g i v e ni b o t h Z - 8 0 a n d 8 5 0 2 m n e m o n i c s , o i w i l l n o w o r k . I a d d i t i o n , t h s w i t c h m u s t b m a d e i c o m m o n m e m o r y a r e a o r t h c o m p u t e r w i l l c r a s ha f t e r t h Z - 8 0 i t u r n e d o n

1 5

Page 166: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 166/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

W h a t f u n c t i o n s d o e s t h Z - 8 0 R O p e r f o r m ?I l o a d s a l o t h n e c e s s a r y C P / M r e s i d e n t o p e r a t i n g s y s t e m r o u t i n e s . A l s c r e e n h a n d l e r s a r c o n t a i n e d i t h R O M s , b o t h f o r t h e 4 0 - c o l u m n a n 8 0 - c o l u m n s c r e e n s . B o t h t h B I O S a n B D O S a c c e s s t h e s e R O r o u t i n e s .A l s y s t e m m e s s a g e s d u r i n g b o o t a r i s s u e d b t h R O r o u t i n e s . N o a l o t h C P / M o p e r a t i n g s y s t e m i h a n d l e d b t h R O M ; o n l y e x t r e m e l ys y s t e m - s p e c i f i c r o u t i n e s a r f o u n d h e r e .L o a d i n g p r o g r a m s f r o m d i s k e t t e i p e r f o r m e d b t h 8 5 0 2 . H e r e t h Z - 8 0r e - e n a b l e s t h 8 5 0 2 , w h i c h t h e n t u r n s t h Z - 8 0 o n a f t e r i h a f i n i s h e dr e a d i n g t h d a t a f r o m d i s k e t t e . I t h i s w a y , t h Z - 8 0 c a u s t h e x i s t i n gK e r n a l r o u t i n e s o t h 8 5 0 2 .B e f o r e t a k i n g a c l o s e r l o o k a t h Z - 8 0 R O M s , t h e r e a r f e t h i n g s y o s h o u l d k n o w . W h e n t h Z - 8 0 i a c t i v a t e d , s e v e r a l c o m p o n e n t s a r " r e a r r a n g e d . "T h m e m o r y r a n g e $ D 0 0 0 t $ D F F F i r e m a p p e d t $ 0 0 0 0 . T a d d r e s s t h l o g i c a l r a n g e $ D 0 0 0 t $ D F F F y o m u s t u s I ( X a n O U ( X ) .T h s c r e e n m e m o r y a n c h a r a c t e r g e n e r a t o r a r a l s o r e l o c a t e d . T h s c r e e nm e m o r y ( v i d e o R A M ) i m o v e d t $ 2 C 0 0 . T h c h a r a c t e r g e n e r a t o r i m o v e d t $ D 1 0 0 . T h c o l o r m e m o r y r e m a i n s a { $ D x x x } } s i n c e i c a n n o tb m o v e d .B e s i d e s t h 4 0 - c o l u m n a n d 8 0 - c o l u m n s c r e e n s t h e r e i t h i r d s c r e e n . T h i st h i r d s c r e e n i u s e d t s i m u l a t e t h 8 0 - c o l u m n s c r e e n . I t i s l o c a t e d a $ 1 4 0 0a n i t c o l o r R A a $ l C 0 0 . W a d v i s e y o n o t u s t h i s a r e a , s i n c e i w i l l b o v e r w r i t t e n s o o n e r o l a t e r .

H e r e i s h o r t l i s t i n g o t h i m p o r t a n t a d d r e s s e s :

1 5

Page 167: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 167/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

$ 2 4 0 0 M i s c t e m p o r a r y s t o r a g e$ 2 4 0 2 C o l u m n f o r t h e 8 0 - c o l u m n s i m u l a t i o n$ 2 4 0 4 + M a s k f o r t e x t o u t p u t$ 2 4 0 6 + A d d r e s s c u r s o r 4 0 - c o l u m n s c r e e n$ 2 4 0 8 L i n e s p e s c r e e n ( d e f a u l t 2 4 $ 2 4 0 9 + C u r s o r a d d r e s s $ 1 4 0 0 f o 8 0 - c o l u m n s i m u l a t i o n$ 2 4 0 B C u r s o r c o l u m n ( 4 c o l u m n )$ 2 4 0 C C u r s o r l i n e ( 4 c o l u m n )$ 2 4 0 D C h a r a c t e r c o l o r$ 2 4 0 E B a c k g r o u n d c o l o r$ 2 4 0 F B o r d e r c o l o r$ 2 4 1 0 F i l l c h a r ( e i t h e r $ 0 o $ 8 0 ) f o r e v e r s e s p a c e$ 2 4 1 1 C u r s o r a d d r e s s$ 2 4 1 3 C u r s o r c o l u m n$ 2 4 1 4 C u r s o r l i n e$ 2 4 1 5 A t t r i b u t e$ 2 4 1 6 B a c k g r o u n d c o l o r 8 c o l u m n s c r e e n$ 2 4 1 7 F o r e g r o u n d c o l o r 8 c o l u m n s c r e e n$ F D 0 1 F l a g f o s e v e c t o r s y e s / n o$ F D 0 3 T r a c k t r e a d$ F D 0 4 S e c t o r t r e a d$ F D 0 5 N u m b e r o b l o c k s t o b e l o a d e d y e $ F D 0 6 E r r o r f l a g ( $ 0 0 , $ 0 D , $ F F )$ F D 0 8 L o g i c a l f i l e n u m b e r$ F D 0 D P o i n t e r t c o n v e r s i o n t a b l e$ F D 1 0 A t t a c k / d e c a y$ F D 1 1 V o l u m e$ F D 1 2 F r e q u e n c y ( h i )$ F D 1 3 S u s t a i n / r e l e a s e$ F D 1 4 T u r n s o u n d o f $ F D 1 5 T u r n s o u n d o $ F D 1 8 B a s e a d d r e s s o b l o c k t l o a d

T h a d d r e s s e s m a r k e d w i t h " + " a r e t o b i n t e r p r e t e d a 1 6 - b i t v a l u e s .

1 5

Page 168: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 168/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T h C P / M b o o t s e c t o r i i d e n t i f i e d a s s u c h b t h e t h r e e l e t t e r s C B f o l l o w e db f i v e b y t e s c o n t a i n i n g z e r o . T h p r o g r a m l o o k s l i k e t h i s :

S E D i s a b l e i n t e r r u p t sJ S $ F F 8 4 I O I N I TL D # $ 3 E D e f i n eS T $ F F 0 0 C o n f i g u r a t i o n b y t eL D # $ C 3 C o d e f o J u n d e r Z - 8 0S T A $ F F E E S t o r e c o d eL D # $ 0 8 L o w b y t e i $ 0 S T A $ F F E F S t o r eL D # $ 0 0 H i g h b y t e i $ 0 S T $ F F F 0 S t o r e ; c o r r e s p o n d s t R S $ 0 J M $ F F D 0 T u r n Z - 8 0 o

T h i s i s a l l t h a t t h b o o t s e c t o r d o e s . E v e r y t h i n g e l s e i p e r f o r m e d b t h Z - 8 0 R O M .M e m o r y a r e a s w h i c h a r c o p i e d a r s p e c i f i e d w i t h t w a d d r e s s e s . F i r s t t h p h y s i c a l / l o g i c a l a d d r e s s a n t h e n t h d e s t i n a t i o n a d d r e s s . R e l a t i v e j u m p sr e f e r t t h e i r i n t e n d e d m e m o r y e n v i r o n m e n t .

N o t t h R O l i s t i n g :

1 5

Page 169: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 169/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R g g ( c o l d s t a r t )

0 0 0 0 : 3 E 3 E L A , $ 3 E c o n f i g u r a t i o n b y t e( R A M , I / O )

0 0 0 2 : 3 0 F L ( $ F F 0 0 ) , A i n t o c o n f i g . r e g i s t e r0 0 0 5 : C 3 3 B 0 J $ 0 0 3 B c o l d s t a r t r e s t

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R S 0 8 t u r n Z _ 8 Q Q a g a i n

0 0 0 8 : 3 7 3 L S P , $ 3 C 7 7 S i n i t i a l i z a t i o n0 0 0 B : 3 E 3 F L D A , $ 3 F c o n f i g u r a t i o n b y t e0 0 0 D : C 8 0 J $ 0 1 8 C R S T - 0 8 - R o u t i n e ' s r e s t* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * r s 1

0 0 1 0 :0 0 1 1 :

0 0 1 2 :0 0 1 5 :0 0 1 6 :0 0 1 7 :

E 6

C 2 0 0 0 0

P O L

J N O N O N O

H L ( H L )

$ 0 0 2 0

S t a c k ' s r e t u r n a d d r e s sr e t r i e v e f o l l o w i n g b y t ea o f f s e t

S t a r t R S T - 2 0 - R o u t i n eF i l l b y t e s

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 0 1 8 :0 0 1 9 :0 0 1 A :0 0 1 D :0 0 1 E :0 0 1 F :

E 6 C 2 0 0 0 0

P O L J N O N O N O

H L , ( H L )$ 0 0 2 8

S t a c k ' s r e t u r n a d d r e s sL o - B y t e o r e t u r n a d d r e s ss t a r t R S T - 2 8 - R o u t i n eF i l l b y t e s

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * g 2

0 0 2 0 : 3 O F L A , ( $ F D 0 F )0 0 2 3 : A A N S e F l a g s0 0 2 4 : 2 0 J Z , $ 0 0 2 8 R e t u r n o n u l l f l a g0 0 2 6 : 2 I N o t h e r w i s e i n c r e m e n t t h 0 0 2 7 : 2 C I N r e t u r n p o i n t e r t

1 5

Page 170: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 170/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

• • • a * * * * * * * * * * * * * * * * * * * * * * * * * * * * r s 2 8 r e t r i e v er e t u r n a d d r e s sf r o m t a b l e

H i - B y t e o t a b l e i o f f s e tp o i n t e r n o t H i - B y t er e t r i e v e a l s o H i - B y t eL o - B y t e t A n r e t u r n i n d i r e c t l yF i l l b y t e

0 0 2 8 :0 0 2 A :0 0 2 B :0 0 2 C :0 0 2 D :0 0 2 E :0 0 2 F :

2 0 7 2 6 6 E 0

L L

I N L L J N O

H , $ 0 1A , ( H L )

H H , ( H L )L ,

( H L )

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R S 3 0 D u m m y ;c o n s t r u c t i o n d a t a

0 0 3 0 : 3 0 3 5 2 3 3 2 3 3 . A S C " 0 5 / 1 2 / 8 5 '= J u n e 1 2 1 9 8 5

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R S 3

0 0 3 8 : C 3 F D F J $ F D F D C o n t i n u e R S 3 o $ F D F D

0 0 3 B :

0 0 3 E :0 0 4 1 :0 0 4 3 :0 0 4 4 :0 0 4 6 :0 0 4 9 :0 0 4 B :0 0 4 D :0 0 4 F :0 0 5 0 :0 0 5 2 :

0

1 E 0 E 0 3 E E 2 E 2

2

F 5

5 0 B 7 7

3 0

D

F

D

L

L O U I N O U L L O U I C P A N J

B C f $ D 0 2 F

D E , $ F F F C< C ) , D

B ( C ) , E

B C , $ D 5 0 5A $ B

( C ) , AA ( C

$ 3 Z , $ 0 0 5 9

R S C o n t n ' d

R e g i s t e r 4 o V I C c h i p( K e y b o a r d )

w r i t e $ F t t h k e y b o a r dn e x t e n s i o n k e y sR e g i s t e r 4 8 = c l o c k r e g i s t e rs e $ F C t o - > M H z - M o d eM o d e c o n f i g u r t i o n R e g i s t e r/ E X R O M a n d / G A M E t e s t ,a n d t u r n o 1 2 8 - M o d eM o d e c o n f i g u r t i o n R e g i s t e rr e a d o u a g a i n a n d n e g a t e/ E X R O M O d e r G A M E s e t ?N o t h e n n c a r r i a g e r e

1 5

Page 171: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 171/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 0 5 4 :0 0 5 6 :0 0 5 8 :0 0 5 9 :0 0 5 C :0 0 5 E :0 0 6 0 :0 0 6 1 :0 0 6 3 :

0 0 6 5 :0 0 6 6 :0 0 6 8 :0 0 6 9 :0 0 6 A :0 0 6 C :0 0 6 D :0 0 6 E :0 0 7 0 :0 0 7 2 :0 0 7 3 :0 0 7 5 :0 0 7 7 :

0 0 7 A :0 0 7 C :0 0 7 F :0 0 8 2 :0 0 8 4 :0 0 8 5 :0 0 8 7 :0 0 8 8 :

0 0 8 9 :0 0 8 A :0 0 8 C :0 0 8 F :0 0 9 2 :0 0 9 5 :

3 E C 0 3 E 0 E 0

A E 0 3 E O O 3 E 0 E E 0

2 2 0 1 7 E 2 O

1 2 2 1 0 E

F 7

O 0 7

7 0

7

7

7 7

7 2 0

D B O O

7

F 1 0 0 B

D

D

O D

O 1 0

L O U R S L L O U D E O U L

X O O U D E D E O U D E D E L O U I N I A N L

J L L L L O U D E D E

D E J L L L L D I R

A , $ F 1( C ) , A

$ 0 B C , $ D C 0 FA $ 0

( C ) , A

( C ) , AC $ 0

( C ) f A

( C ) , A

A , $ 7 F( C ) , A

B A ( C $ 2 B C , $ D 5 0 5

Z , $ 0 0 5 4H L , $ 0 F B 4B C , $ D 5 0 AD $ 0 A ( H L )

( C ) , AH

N Z , $ 0 0 8 4H L , $ O D 1 AD E , $ 1 1 0 0B C , $ 0 0 0 8

t u r n o 6 4 - M o d e a n t u r n c o n t r o lo v e r t c a r t r i d g e

t u r n o n 8 5 0 2 a n d s e l e c tt h e 6 4 - m o d ea n d c a r r y o u c o l d s t a r tC R B - R e g i s t e r i C I s e l e c t a n d t h e ns t o p T i m e r a n T i m e r o C I D D R B - d a t a d i r e c t i o nr e g i s t e r

f o r P o r t B : s e t a l b i t sf o r i n p u ts e p o i n t e r t D D R A a n a l b i t s h e r e t o u t p u tA f t e r d e c r e m e n t i n g t i m e ss h o w B C o n P o r tP o r t w i t h $ 7 ( S e e a l s ok e y b o a r d m a t r i x ) d e s c r i b ep o i n t e r t o P o r t ( i n p u t )a n d r e a d o u C o m m o d o r e - k e y m a s k i n gp o i n t e r f o M o d e - c o n f i g . - R e g .

w a h i t - > 6 4 e r - M o d eN o s e t h R e g i s t e r o t h M M w i t h t h v a l u e sf r o m $ 0 F A AN o t e , t h a t a l 1 R e g i s t e r s o M M f r o m b e h i n d w i t h v a l u e sw i l l b d e s c r i b e df r o m $ 0 F B 4

d o w n w a r d !L o o p e n C o p y t h e a r e a f r o m $ O D 1 At $ 1 1 0 0E i g h t B y t e s a r e t o b c o p i e d ( 8 5 0 2 - C o d e ! )

1 5

Page 172: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 172/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 0 9 7 : 2 1 E 5 0 L H L , $ 0 E E 5 A l s o c o p y t h a r e a0 0 9 A : 1 D F L D E , $ F F D 0 f r o m $ 0 E E 5 o n u n t i l C o m m o n0 0 9 D : 0 I 0 L B C , $ 0 0 1 F A r e a f r o m $ F F D 00 0 A 0 : E B L D I R 3 B y t e s a r e t o b c o p i e d0 0 A 2 : 2 1 0 1 L H L , $ 1 1 0 0 $ 1 1 0 0 a r e t u r n v e c t o r0 0 A 5 : 2 F F L ( $ F F F A ) f H L c o p y r e t u r n v e c t o r i 0 0 A 8 : 2 F C F F L ( $ F F F C ) , H L a l l a d d r e s s e s ,0 0 A B : 2 F E F F L D ( $ F F F E ) , H L u n d e r o t h e r0 0 A E : 2 D D F F L ( $ F F D D ) , H L a l s o o $ F F D D

( f r e s h l y c o p i e d )0 0 B 1 : C E F J $ F F E 0 a n d r e t u r n i Z - 8 0 - p a r t

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 0 B 4 :0 0 B 7 :0 0 B A :

0 0 B D :0 0 C 0 :0 0 C 1 :0 0 C 4 :0 0 C 7 :0 0 C 8 :0 0 C B :0 0 C E :0 0 C F :0 0 D 0 :0 0 D 2 :

C 3 2

1 F C C F 2 1 1 3 2 C

6 0 1

E

D F

1 2

E

0 3 F

0

0 0

F 0

C A L LL L

L P U S HC A L LC A L LP O L L A D D E J R E

$ 0 3 6 DA ( $ 3 C 0 6 )

( $ F D 1 8 ) , H

D E , $ 0 0 EA $ 0 0 D 3Z , $ 0 2 F AA H L ( $ F D 1 8D E , $ 0 0 2 0H L f D E

N Z , $ 0 0 B A

L o a d B l o c kg e b l o c k n u m b e rD e s t i n a t i o n a d d r e s s o

l o a d e d b l o c k

S a v e b l o c k n u m b e rc o m p a r e ( H L ) w i t h ( D E )I o k t h e n c a l lg e b l o c k n u m b e r b a c kG e l o a d a d d r e s s3 a O f f s e ta d t e a c h o t h e rD e c r e m e n t b l o c k c o u n t e rs t i l l n o d o n e , t h e n l o o pE n o t h e s u b r o u t i n e

0 0 D 3 :0 0 D 5 :

0 E

O L E

B D

$ 0 , H

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * c o m p a r e ( H L ) w i t h ( D E )

1 B y t e s t b c o m p a r e dE x c h a n g e t h e t w oc o m p a r e d r e g i s t e r sL o a d t h e f i r s t v a l u ei a c c u m u l a t o ra n d e r a s e t h e 8 t h B i tc o m p a r e w i t h ( H L ) l e a dt h r o u g ha n b r e a k o f i d i f f e r e n t

0 0 D 6 : 1

0 0 D 7 :0 0 D 9 :

E 7 B

0 0 D A : C O

L

A N C

R E

A , ( D E )

$ 7 ( H L )

N

1 6

Page 173: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 173/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O O D B : 2 I N H

O O D C :O O D D :O O D F :0 0 E 2 :0 0 E 4 :0 0 E 5 :0 0 E 7 :0 0 E 8 :O O E B :O O E C :

1 1 3 F 1 2 I 3 A C

F 0 3 4

0

3 5 3 C

I N D J N ZL C L J R R L X O R E

D $ 0 0 D 6A , ( $ 3 C 0 6 )$ 4 A , ( D E )N Z , $ 0 0 E 8

< $ 3 C 3 5 ) ,

o t h e r w i s e i n c r e m e n tb o t h a d d r e s s e sb o n a n l o o pG e b l o c k n u m b e r6 B l o c k s z l o a d ?G e b l o c k f r o m t a b l e$ 3 C 0 6 i s m a l l e r t h a n 6 o t h e r w i s e d o u b l e a c c ua n n o t eE r a s e a c c u a n d F l a g sR o u t i n e ' s e n d

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * T e x t

0 0 E D : 0 N O 0 0 E E : 4 5 0 4 D 2 2 0 2 0 2 0 2 00 0 F 6 : 5 3 5 9 5 0

" C P M + "" S Y S " < E n d >

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o m p a r e H L w i t h D E

0 0 F A :0 0 F B :0 0 F C :0 0 F D :0 0 F E :

0 0 F F :

7 B C 7 B

C

L C R E L C

R E

A ,

N A

H i - B y t e o H c o m p a r e w i t ha n e n d , w h e n d i f f e r e n to t h e r w i s e c o m p a r et h L o - B y t e s f r o mH a n D a n r e t u r n w i t h F l a g s

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * r e t u r n t a b l e f o r R S T 2

6 R e t u r n a d d r e s s e s0 1 0 0 :0 1 0 2 :

0 1 0 4 :0 1 0 6 :0 1 0 8 :0 1 0 A :0 1 0 C :0 1 0 E :

8 6

A B C D D F

0 0

0 0 0 0 0 0

. W o r d. W o r d

. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d

$ 0 6 8 4$ 0 9 6 E

$ 6 A $ 0 9 B C$ 0 6 C 2$ 9 D $ O 6 D 1$ O 9 F 1

1 6

Page 174: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 174/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 1 1 0 : D 0 0 1 1 2 : 3 O 0 1 1 4 : E 0

0 1 1 6 : 3 C O

0 1 1 8 :0 1 1 A :

0 1 1 C :0 1 1 E :0 1 2 0 :0 1 2 2 :0 1 2 4 :0 1 2 6 :0 1 2 8 :0 1 2 A :0 1 2 C :0 1 2 E :0 1 3 0 :0 1 3 2 :0 1 3 4 :0 1 3 6 :0 1 3 8 :0 1 3 A :0 1 3 C :0 1 3 E :0 1 4 0 :0 1 4 2 :0 1 4 4 :0 1 4 6 :0 1 4 8 :0 1 4 A :0 1 4 C :0 1 4 E :0 1 5 0 :0 1 5 2 :0 1 5 4 :0 1 5 6 :0 1 5 8 :0 1 5 A :0 1 5 C :0 1 5 E :

F 4

7 4 8 6 9 8 C B D D I 2 I 7 1 6 1 9 2 A 4 A E E E E E 6 F E E E E E

0 O

0 O 0 O 0 O 0 O 0 O 0 O 0 O 0 O 0 0 0 0 0 O 0 0 0 0 0 0 O 0 0 0 0 0

W o r dW o r dW o r d

W o r d

W o r dW o r d

W o r dW o r dW o r dW o r dW o r dW o r d

. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d. W o r d

$ 0 6 D D$ 0 A 3 1$ 0 6 E 8

$ 0 A 3 C

$ O 6 F 1$ 0 A 4 5

$ 0 7 7 A$ 0 A 4 8$ 0 7 8 0$ 0 A 6 2$ 0 7 9 1$ 0 A 8 E$ 0 7 C A$ 0 A B A$ 0 7 D C$ 0 A D F$ 0 8 1 E$ 0 B 2 D$ 0 7 1 B$ 0 B 7 B$ 0 7 1 0$ 0 B 6 2$ 0 9 1 C$ 0 9 9 5$ 0 9 2 7$ 0 9 A 2$ 0 7 4 E$ 0 B A E$ 0 0 E B$ 0 0 E B$ 0 0 E B$ 0 0 E B$ 0 3 E 3$ 0 4 6 B$ 0 C F A$ 0 0 E B$ 0 0 E B$ 0 0 E B$ 0 0 E B$ 0 0 E B

1 6

Page 175: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 175/316

A b a c u s S o f t w a r e

0 1 6 0 :0 1 6 2 :0 1 6 4 :0 1 6 6 :0 1 6 8 :0 1 6 A :0 1 6 C :0 1 6 E :0 1 7 0 :0 1 7 2 :0 1 7 4 :0 1 7 6 :0 1 7 8 :0 1 7 A :0 1 7 C :0 1 7 E :0 7 8 0 :0 1 8 2 :0 1 8 3 :

3 4 C O 2 3 2 E 7 C C E E 3 A 6 C 0 C

O O O O 0 0 0 0 O O O O 0 0 0 0 O

3

C - 1 2 8 C P / M U s e r ' s G u i d e

. W o r d $ 0 C 3 C. W o r d $ 0 C 4 A. W o r d $ 0 B C F. W o r d $ 0 C 0 C. W o r d $ 0 5 2 6. W o r d $ 0 5 3 2. W o r d $ 0 5 2 C. W o r d $ 0 0 E B. W o r d $ 0 C 7 F. W o r d $ 0 C C 2. W o r d $ 0 C C 7. W o r d $ 0 C E 4. W o r d $ 0 0 E B. W o r d $ 0 8 3 D. W o r d $ 0 8 A E. W o r d $ 0 6 6 0. W o r d $ 0 A C 3

A D H L , B C A d B a O f f s e t0 J $ 0 9 3 3 G e t A : a t t r i b u t e , B : c h a r o

( H L ) i V D

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * H a U p d a t e a d d r e s s i V D

0 1 8 6 : C 5 0 J $ 0 9 5 3 H a U p d a t e a d d r e s si V D

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * w a i t f o V D C - S t a t u s a n c h o o s e r e g i s t e r < a c c u >

0 1 8 9 : C 3 4 0 J $ 0 9 4 5 w a i t f o V D C - S t a t u s a n c h o o s e < a c c u >

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o n t n ' d

0 1 8 C :0 1 8 F :0 1 9 2 :0 1 9 5 :

3 2 0 0 F 2 0 3 1 1 0 1 3 00 F F C E

0 1 9 8 : 7

L L L L L

( $ F F 0 0 ) , A a c c u i n t o c o n f i g . b y t eH L , $ 3 0 0 0 T h e a r e a sD E , $ 3 0 0 1 $ 3 0 0 0 t o $ F E F FB C $ C E F F w i l l b f i l l e d w i t h

( H L ) , L t h v a l u e $ 0

1 6

Page 176: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 176/316

A b a c u s

0 1 9 9 :0 1 9 B :0 1 9 E :0 1 A 1 :0 1 A 4 :0 1 A 6 :0 1 A 9 :0 1 A C :0 1 A F :0 1 B 1 :0 1 B 3 :0 1 B 6 :0 1 B 9 :0 1 B C :

0 1 B F :0 1 C 1 :0 1 C 2 :0 1 C 4 :0 1 C 5 :0 1 C 6 :0 1 C 7 :0 1 C 9 :0 1 C C :0 1 C F :0 1 D 2 :0 1 D 3 :0 1 D 5 :0 1 D 7 :0 1 D A :0 1 D C :

0 1 D E :

0 1 E 0 :

0 1 E 3 :

0 1 E 5 :0 1 E 8 :0 1 E B :

0 1 E D :

S o f t w a r e

E 2 1 0 E 2 1 0 E 3 3 C 2 0

1 7 E 2 O 1 2 2 1 0 7 E 3 C 3 E

3

3

3

3 C 3

3

B 2 0 C B E D I B C E E B O

O

7

F 0 0 F

B 1 4 9 7

8

1

O

O B 1

0

O 3 0

O F 0

F F O D

1 1 I

0

2

2 0

2

L D I RL L L L D I RL L L L D I RL L C A L LL L

L L O U D E D E D E J L L L L L D I RL C A L LL O U

L

L

L

L C A L LL

L

H L , $ 0 D 2 2D E , $ 3 0 0 0B C , $ 0 1 C 3

H L , $ 0 E E 5D E , $ F F D 0B C , $ 0 0 1 F

A , $ C 9( $ F F E E ) , A

$ F F E 0H L , $ 0 F B 4B C , $ D 5 0 A

D , $ 0 BA , ( H L )

( C ) , AH

N Z , $ O 1 C 1H L , $ 1 0 0 0D E , $ 1 0 0 1B C , $ 1 F F F

( H L ) , L

A , $ 1 A$ 0 9 4 5A , $ 9 0

< C ) , A

A $ 8

( $ 2 4 1 5 ) , A

A $ 0

( $ 2 4 0 D ) , A$ 0 5 B DA $ 1

( $ 2 4 0 8 ) , A

C - 1 2 8 C P / M U s e r ' s G u i d e

T h a r e a f r o m $ 0 D 2 2w i l l b e c o p i e d t $ 3 0 0 0H e r e i w o r k s w i t h8 5 0 2 - C o d e !A r e a d o w n$ 0 E E 5 i C o m m o n A r e aC o p y f r o m $ F F D 03 B y t e sC o d e f o r R E T u r nS e R S w i t h R E T u r n o 8 5 0 2 , t h e n c o n t i n u eT h M M U - R e g i s t e rw i l l b e f i l l e d w i t h t h et a b l ef r o m $ 0 F A As . o .s . o .s . o .s . o .s . o .E n o t h e l o o pF i l l t h e a r e a$ 1 0 0 0 t o $ 2 F F Fw i t h t h v a l u e$ 0 s . o .R e g i s t e r 2 ( c o l o r ) o V D c h o o s e a n t h e n f r o n t /S e B a c k g r o u n d c o l o ro V D t $ 9 ( l i g h t r e C u r s o r )

D e f i n e l i g h t b l u ea n a l t e r n a t e

h a s e a a t t r i b u t e s( V D C )

D e f i n e C h a r c o l o r f o V I C - C h i p

P r e p a r e V D C - c h a r s e T h s c r e e n i d e f i n e dw i t h 2 l i n e s ( D E V I C E )

1 6

Page 177: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 177/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 1 F 0 :0 1 F 3 :0 1 F 4 :O 1 F 5 :0 1 F D :0 2 0 5 :0 2 0 8 :0 2 0 B :

0 2 0 D :

0 2 0 F :

0 2 1 2 :0 2 1 5 :0 2 1 8 :0 2 1 B :0 2 1 E :0 2 2 1 :0 2 2 4 :0 2 2 5 :0 2 2 6 :0 2 2 9 :0 2 2 C :0 2 2 F :0 2 3 2 :0 2 3 5 :0 2 3 8 :0 2 3 B :0 2 3 D :0 2 4 0 :

0 2 4 3 :0 2 4 6 :0 2 4 9 :0 2 4 C :0 2 4 F :

C F 8 4 4 5 0 3

E

C

C 2 2 C C 2 7 B C 2 2 C 2 1 0 E C 8

2 C 2 2 C

2

O 4 5 0 1 B

7

D

F B 0 B B 0

F 0 0 6 0 2 O B 2

8 3 0 0 2

0

4 2

D

0

0 O 3 0 0 3

0 3 3 0 3 3 0

0

3 0 3 3 0

C A L L. B y t e. B y t e

5 4 9 4 E4 D 2 0 5

L L

O U

C A L L

J L L C A L LC A L LL L O J L L C A L LL L L L D I RC A L L. B y t e

L C A L LL L C A L L

$ 0 5 2 6$ F $ 8 1 , $ 0 A

4 2 4 5

B C , $ D 0 1 8A $ B

( C ) , A

$ 0 2 D 2

N Z , $ 0 4 F FH L , $ 0 F B 2( $ 3 C 0 2 ) , H

$ 0 0 B 4$ 0 0 B 4H L , ( $ 3 C 0 9A ,

Z , $ 0 4 F FH L , $ 3 C 0 9

O u t p u t t h e f o l l o w i n g t e x te r a s e s c r e e n ( $ F F )l i n e 1 c o l u m n 1 B O O T I N GC P / M P L U SU S < E n d >B a s i s a d d r e s s o V i d e o - R A MB - > 1 0 - 1 3 V i d e o - R A M ,

C H A R R O M ; V i d e o r a m f r o m$ 2 C 0 0B o o t s e c t o r c h e c k a n r e t r i e v eO u t p u t e v t l . e r r o r sM a r k t a b l e b e g i n n i n gi $ 3 C 0 2L o a d f i r s t p a r tL o a d s e c o n d p a r tR e t r i e v e v a l u eS e t h z e r o f l a gi t h e 1 6 - b i t v a l u e i a n d r e t u r n i y e M a r k n e w t a b l e b e g i n n i n g

( $ 3 C 0 2 ) , H L$ 0 3 6 DH L , $ 3 4 0 0D E , $ 3 C 2 9B C , $ 0 0 0 C

$ 0 5 2 6

L o a d d a C o p y 1 B y t e sf r o m $ 3 4 0 0t o $ 3 C 2 9

O u t p u t b l a n k l i n e$ 8 A , $ 0 0 , $ 0 0 l i n e 1 0 c o l u m n a n

H L , $ 3 4 8 0$ 0 5 3 4H L , $ 3 5 0 0

< E n d >p o i n t e r t o u t p u t t e x ta n o u t p u t T e x t f r o m ( H L )N o t e p o i n t e r $ 3 5 0 0

( $ 3 C 0 4 ) , H L$ 0 5 2 6 O u p u t t h f o l l o w i n g t e x t

0 2 5 2 :0 2 5 4 :0 2 5 C :0 2 6 0 :0 2 6 3 :0 2 6 6 :

8 4 4 4 1 5 44 4 5 5 32 3 3 3 C2 2 0 9 F 2 3 3

. B y t e $ 8 3 , $ 0 C4 0

2 0 5 4 4 4

L L L

l i n e 3 c o l u m n 1 D A T A T A L E S < E n d >

H L , ( $ 3 C 3 3 ) L o a d C P / M s e g m e n t s( $ F D 0 9 ) , H L o n a f t e r t h e o t h e r i n t o

H L , $ 3 C 3 2 w o r k m e m o r y

1 6

Page 178: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 178/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 2 6 9 :

0 2 6 C :0 2 6 F :0 2 7 2 :

0 2 7 5 :0 2 7 6 :

0 2 7 8 :0 2 7 B :0 2 7 D :0 2 8 5 :0 2 8 9 :0 2 8 C :0 2 8 F :0 2 9 2 :0 2 9 4 :0 2 9 C :0 2 A 0 :0 2 A 3 :0 2 A 6 :0 2 A 9 :0 2 A B :0 2 B 3 :0 2 B 9 :0 2 B C :0 2 B F :0 2 C 2 :0 2 C 3 :0 2 C 6 :0 2 C 7 :0 2 C A :0 2 C B :0 2 C E :

C

2 C 1

1 2

C 8 4 4 2 C C 8 4 4 2 C C 8 4 2 2 C 3 4 3 9 3 A 3 2

3

O 4 8

F

2 O 4 4 2 2 2 O 4 4 2 2 2 O 4 4 3 2 3

2

D

D 2

0

F 0 0

0

4 4 3 0 0 4 4 3 0 0

4 4 3 0 3

3

F

F 3

C A L L

L C A L LL

A D J

C A L L. B y t e

4 D 4 F 4 E0

L C A L LC A L L. B y t e

4 4 4 0

L C A L LC A L L. B y t e

5 3 3 4 4 0

L C A L LL L L S U L X O L L

$ 0 3 3 1

( $ F D 0 B ) , H$ 0 3 4 4D E , $ 0 0 8 0

H L , D EN Z , $ 0 2 6 F

$ 0 5 2 6$ 8 4 , $ 0 C

2 4

H L , $ 3 C 2 A$ 0 3 2 4$ 0 5 2 6$ 8 5 , $ 0 C

2 4

H L , $ 3 C 2 C$ 0 3 2 4$ 0 5 2 6$ 8 6 , $ 0 C

3 3

H L , $ 3 C 3 0$ 0 3 2 4A , ( $ 3 C 3 0 )B , A , ( $ 3 C 2 F )

( $ F F D E ) , A

( $ F F D D ) f AH L , ( $ 3 C 2 D )

G e b l o c k n u m b e r a n dS t a r t a d d r e s sN o t e S t a r t a d d r e s s

A d d R e c o r d o f f s e t( C P / M - I n t e r n )f r o m 1 2

I s t i l l n o t f i n i s h e d ,t h e n o u t p u t

t h f o l l o w i n g t e x tl i n e 4 c o l u m n 1 C O M M O NO D E < E n d >B a s i s a d d r e s s f o r T a b l ea n l o a d C o m m o n C o d eo u t p u t t h e f o l l o w i n g t e x tl i n e 5 c o l u m n 1 B A N K E DO D E < E n d >B a s i s a d d r e s s f o T a b l ea n d l o a d B a n k e d C o d eO u t p u t t h e f o l l o w i n g t e x tl i n e 6 c o l u m n 1 B I O S 8 5 0 2C O D E < E n d e >B a s i s a d d r e s s f o T a b l ea n d l o a d B I O S 8 5 0 2 D a t a

F o r m d i f f e r e n c eD i f f e r e n c e a H i - B y t ea c c u e r a s e ( = 0 )M a r k a L o - B y t e

r e t u r n a d d r e s s f o

0 2 D 1 : E J ( H L )C P / M - r e t u r nr e t r i e v e a n r e t u r n

1 6

Page 179: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 179/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R e a d f r o m t r a c k I / S e c t o r

N o t e l o a d a d d r e s s f o f i r s t t o l o a dB l o c ka c c u e r a s eS e c t o r # = 0a c c u = lD e f i n e t r a c kR e a d t r a c k / S e c t o rI f r e a d , t e s t b o o t s e c t o rN o B o o t s e c t o rL a s t c h a r a c t e r o t h b l o c k + 1S t a r t a d d r e s s3 a B l o c k c o u n t e rI a c c u b e f o r eI N C O $ F F , r e t u r n

c h a n g e H i - B y t e t $ 3 a n d o u b l e b l o c k n u m b e r

( R e c o r d n u m b e r )N o t e l o a d a d d r e s sN o t e b l o c k n u m b e re r a s e a c c u a n dF l a g s ( i m p o r t a n t )

a n d E n d t h R o u t i n e

0 2 D 2 :

0 2 D 5 :0 2 D 8 :0 2 D 9 :0 2 D C :0 2 D D :0 2 E 0 :0 2 E 3 :0 2 E 6 :0 2 E 7 :

0 2 E 8 :0 2 E B :0 2 E D :

0 2 E F :0 2 F 1 :

0 2 F 2 :0 2 F 5 :0 2 F 8 :

2

2 A 3 3 3 C C C 3

2 3 2

2 8

2 3 A

0

1

0

0 4 6

0 2 0

3

0 0

F

F

F

F 0 0

3

3 3

L

L X O L I N L C A L LC A L LR E I N

L L J

L A D

L L X O

H L , $ F E 0 0

( $ F D 1 8 ) , H

( $ F D 0 4 ) , A

( $ F D 0 3 ) , A$ 0 4 4 F$ 0 4 6 BN

H L , $ 3 8 0 0A $ 2 N Z f $ 0 2 F 2

H , $ 3 CA

( $ 3 C 0 7 ) , H( $ 3 C 0 6 ) ,

0 2 F 9 : C R E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 2 F A :0 2 F D :0 3 0 0 :0 3 0 1 :0 3 0 3 :0 3 0 6 :

0 3 0 7 :0 3 0 A :0 3 0 D :0 3 1 0 :0 3 1 1 :

1 3 B 2 1 3

C 2 0 0 E

0 3

0 1

8 1 1

B

3 3

3

0 F 0

L L O J L D E

J L L A D L D I R

D A

z D

N H B H

, $ 3 C 0 9( $ 3 C 3 5 )

$ 0 3 0 A, $ 3 C 1 9

, $ 0 4 8 0( $ F D 1 8 )

, $ 0 0 1 0, B

L o a d a d d r e s s f o c o p yG e F l a gS e F l a g sF l a g i s n ' t s e o t h e r w i s e S t a r t a d d r e s s + 1 6a n d d e c r e m e n t f l a g( c o u n t e r )

a n d o u t p u t e r r o r sG e g o a l a d d r e s s

1 a I n c r e m e n ta d a n d c o p y 1 B y t e s

1 6

Page 180: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 180/316

A b a c u s

0 3 1 3 :0 3 1 6 :0 3 1 7 :0 3 1 8 :0 3 1 B :0 3 1 C :0 3 1 D :0 3 1 F :0 3 2 0 :0 3 2 1 :

S o f t w a r e

3 B C 2 A B 2 B C C

0

1

0

2

3

3

0

L O R E L X O C J C R E J

A

H

z

( $ 3 C 0 9 )

i ( $ 3 C 1 8

$ 0 3 2 1

$ 0 2 2 9

C - 1 2 8 C P / M U s e r ' s G u i d e

G e c o u n t e r a n ds e F l a g sO z e r o , t h w o r k i d o n eE l s e g e t a d d r e s sa n d c o m p a r e w i t h $ 0 0 0 0a c c u i z e r oL o - B y t e i z e r oc o m p a r e w i t h H i - B y t eH i - B y t e i z e r oZ e r o f l a g w i l l b

p a s s e d a P a r a m e t e r

0 3 2 4 :0 3 2 7 :0 3 2 A :0 3 2 B :0 3 2 E :0 3 3 0 :

C 1 1 C 2 C

3 8

4 F

0 F

0

C A L LL A D C A L LJ R E

$ 0 3 3 1D E , $ F F 8 0H L , D E$ 0 3 4 4N Z , $ 0 3 2 7

L o a d R e c o r d s f r o m F l o p p y

G e n u m b e r s t a r t a d d r e s s1 2 a t w o ' s c o m p l e m e n ta d ( f l a g ! )L o a d r e c o r dA n o t h e r R e c o r do t h e r w i s e e n d o R o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Q e n u m b e r S t a r t a d d r e s s

0 3 3 1 : 5 E L D E , ( H L ) G e n u m b e r0 3 3 2 : 1 0 L D , $ 0 0 a n e r a s e H i - B y t e0 3 3 4 : 7 L A , T e s t n u m b e r0 3 3 5 : B O a g a i n s t z e r o0 3 3 6 : C I 0 J Z , $ 0 5 1 B B A D i z e r o0 3 3 9 : E E D E , H L o t h e r w i s e n u m b e r t o H L0 3 3 A : 2 A D H L , H L a n d d o u b l e ( R e c o r d n u m b e r )0 3 3 B : 2 0 3 C L D ( $ 3 C 0 0 ) f H L n o t e i $ 3 C 0 00 3 3 E : E E X D E , H L a g a i n t D 0 3 3 F : 2 D E H D e c r e m e n t t a b l e p o i n t e r0 3 4 0 : 6 L D H , ( H L ) G e H i - B y t e0 3 4 1 : 2 0 L L , $ 0 0 a n d e r a s e L o - B y t e0 3 4 3 : C R E E n o t h R o u t i n e

1 6

Page 181: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 181/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 3 4 C : C F 0 0 3 4 F : C 6 D 0 30 3 5 2 : E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * L o a d R e c o r d a n d e c r e m e n t c o u n t e r

0 3 4 4 : E P U S H H L S a v e t o s t a c k0 3 4 5 : 2 0 3 L H L , ( $ 3 C 0 7 ) S a v e t h c o m p a r i s o n

a d d r e s s0 3 4 8 : E E X D E , H L a n m a r k i D 0 3 4 9 : 2 0 3 L H L , ( $ 3 C 0 4 ) G e t s e c o n d c o m p a r i s o n

a d d r e s sC A L L $ 0 0 F A C o m p a r e ( H L ) w i t h ( D E )C A L L Z , $ 0 3 6 D a n d r e t u r n , i t h s a m eE D E , H L e l s e e x c h a n g e t h e

r e g i s t e r a g a i n0 3 5 3 : 2 8 0 0 0 L H L , $ 0 0 8 0 R e c o r d - O f f s e t o 1 2 0 3 5 6 : 1 A D H L , D E a d t e a c h o t h e r0 3 5 7 : 2 2 0 4 3 C L D ( $ 3 C 0 4 ) , H L a n d n o t e a g a i n0 3 5 A : E l P O P H L c a l l a d d r e s s b a c k a g a i n0 3 5 B : E 5 P U S H H L r e s t o r e s a f e l y t s t a c k0 3 5 C : E B E X D E , H L E x c h a n g e g o a l a n s o u r c e0 3 5 D : 0 8 0 0 0 L B C , $ 0 0 8 0 a n d c o p y 1 2 B y t e s0 3 6 0 : E B L D I R ( R e c o r d )0 3 6 2 : 2 0 3 C L D H L , ( $ 3 C 0 0 ) G e R e c o r d c o u n t e r0 3 6 5 : 2 B D E H D e c r e m e n t b y o n 0 3 6 6 : 2 0 3 C L D ( $ 3 C 0 0 ) , H L a n s t o r e a g a i n0 3 6 9 : 7 D L A , T e s t i r e c o r d n u m b e r0 3 6 A : B O i e x a c t l y z e r o , s e f l a g s0 3 6 B : E l P O P H L c a l l a d d r e s s b a c k0 3 6 C : C 9 R E a n e n R o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * L o a d d a t a f r o m$ 3 4 0 0 O f f s e t

H L , $ 3 4 0 0 L o a d a d d r e s s ( B a s i s )( $ F D 1 8 ) , H N o t e f o 8 5 0 2 - C o d e

H L a n d p u s h t S t a c kH L , ( $ 3 C 0 2 ) p o i n t e r t B l o c k l o a d

t a b l eD , $ 0 0 E r a s e H i - B y t eE , ( H L ) a n g e L o - B y t e f r o m T a b l eH I n c r e m e n t p o i n t e r t T a b l e

( $ 3 C 0 2 ) , H L a n d n o t e a g a i nD E , H L N u m b e r b l o c k s t H

0 3 6 D :0 3 7 0 :0 3 7 3 :0 3 7 4 :

0 3 7 7 :0 3 7 9 :0 3 7 A :0 3 7 B :0 3 7 E :

2 2 E 2

1 5 2 2 E

0 1

0

0

0

3 F

3

3

L L P U S HL

L L I N L E

1 6

Page 182: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 182/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 3 7 F :0 3 8 0 :0 3 8 1 :0 3 8 4 :0 3 8 5 :0 3 8 6 :0 3 8 7 :0 3 8 9 :0 3 8 B :0 3 8 C :

2 2 3 O O O F 2 2 2

0 3

0 0

1 F

A D A D L R R C AR R C AR R C AC J A D L

H L , H LH L , H LA , ( $ 3 C 0 6 )

$ 0 Z , $ 0 3 8 CH L , H L( $ F D 1 6 ) A

0 3 8 F : 3 D

0 3 9 0 :0 3 9 3 :0 3 9 4 :

0 3 9 6 :0 3 9 9 :

0 3 9 C :0 3 9 F :0 3 A 0 :0 A 3 0 3 A 4 :0 3 A 6 :0 3 A 9 :0 3 A A :0 3 A C :0 3 A F :0 3 B 0 :

3 2 0 5 F F 3 0

3 B 3 C E 0

2 1 F 2 2 1 F F 2 2 3 0 F A 2 8 2 42 0 F E C E 0

0 3 B 3 : E

D E

L P U S HL

L C A L L

L I N L P O J L A N J L P U S HC A L L

P O H

A A $ 0

0 3 B 4 :0 3 B 7 :

0 3 B 8 :0 3 B A :0 3 B B :0 3 B E :0 3 B F :

3 B

2 E 2 2 2

0

1

1

1

F

F

F

L C

J P U S HL I N L

A , ( $ F D 0 3 )

N Z , $ 0 3 C DH H L ( $ F D 1 (H

( $ F D 1 6 ) , I

a n d d o u b l e - > , R e c o r d n o d o u b l e a g a i nG e b l o c k n u m b e r/ / / I b l o c k n u m b e r 3 6 3 ? ?Y e s , t h e n r e t u r ne l s e d o u b l e H L a g a i n

( $ F D 1 6 ) , H L N o t e u a B l o c k n u m b e r( l o a d C P / M )

D e c r e m e n t n u m b e r t l o a d e d B l o c k s

( $ F D 0 5 ) , A a n d o t h e r w i s e n o t eS a v e n u m b e r t S t a c kN u m b e r t t h

l o a d e d d a t a b l o c k s( $ 3 1 B D ) , A s e t

$ 0 3 E 3 S e t B l o c k * - T r a c k / S e c t o r

H L , ( $ F D 1 6 ) G e t B l o c k n u m b e rH L I n c r e m e n t b o n a n ( $ F D 1 6 ) , H L l a y d o w n a g a i n

A G e c o u n t e r a n d F l a g sZ , $ 0 3 D 0 I e n d , t h e n r e t u r nA ( $ F D 0 8 ) E l s e g e t e r r o r f l a g

a n s e F l a g sN e r r o r s

H L ( $ F D 0 3 ) G e T r a c k / S e c t o rH a n s a v e t s t a c k$ 0 3 E 3 w a n d e r B l o c k * i

T r a c k / S e c t o rc a l c u l a t e T r a c k / S e c t o r ,c a l l b a c k

G e t r a c k *C o m p a r e w i t h c a l c u l a t e dt r a c kt h e y a r d i f f e r e n ts a v e T r a c k / S e c t o rG e B l o c k *a n d i n c r e m e n t B l o c k n u m b e r

( $ F D 1 6 ) , H L N o t e n e w B l o c k n u m b e r

Z , $ 0 3 D 0

1 7

Page 183: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 183/316

A b a c u s

0 3 C 2 :

0 3 C 5 :0 3 C 6 :

0 3 C 9 :

0 3 C A :0 3 C C :

0 3 C D :

S o f t w a r e

2

3 2

3

2 E

2

B

0

E

0

3

F

F

L

I N L

D E

J P O

L

H L , $ 3 1 B D

( H L )H L , $ F D 0 5

( H L )

N Z , $ 0 3 B 0H

( $ F D 0 3 ) ,

C - 1 2 8 C P / M U s e r ' s G u i d e

p o i n t e r t l o a d e d B l o c kn u m b e ra n a l s o i n c r e m e n tS t i l l t o l o a d e d B l o c kn u m b e ra l s o i n c r e m e n t b

( e r r o r c o r r e c t i o n )s t i l l a l e a s t o n e B l o c kG e T r a c k / S e k t o r f r o mS t a c k

H N o t e T r a c k / S e k t o r

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * E r r o r w a l k

0 3 D 0 : C 4 F 0 4 C A L L $ 0 4 4 F

0 3 D 3 : 2 1 1 9 F L

R e a d B l o c k / B l o c k sf r o m D i s k e t t e

H L , $ F D 1 9 H i - B y t e d e s t i n a t i o na d d r e s s

0 3 D 6 :0 3 D 9 :0 3 D A :0 3 D B :

0 3 D E :0 3 D F :

0 3 E 1 :0 3 E 2 :

3 8 7 3

A 2

E C

B 3

0 F

A

L A D L L

A N J

P O R E

A , ( $ 3 1 B DA ( H L )

( H L ) , AA , ( $ F D 0 5

N Z , $ 0 3 8 F

H

A , ( $ 3 1 B D ) G e n u m b e r t l o a d e d b l o c kA d t d e s t i n a t i o n a d d r e s sa n n o t eG e n u m b e r t l o a d e db l o c k sS e f l a g sC o n t i n u e , i n o t y e tf i n i s h e de l s e g e T r a c k / S e k t o ra n E n t h R o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 3 E 3 : 3 E 2 3

0 3 E E : B

L A $ 2

0 3 E 5 :0 3 E 8 :0 3 E B :

3 2 1

0 1 A

2 F 0

L L L

O

M a k e o u o B l o c k *T r a c k / S e c t o r

3 5 a s O f f s e t f o r 1 5 7 1( S i d e 2

( $ 2 4 0 0 ) , A a n m a r k O f f s e tH L , ( $ F D 1 6 ) G e t B l o c k *D E , $ 0 2 A 8 f r o m B l o c k $ 2 A 8 - >

a d d r e s s s i d eC a r r y f o s u b t r a c t i o ne r a s e

1 7

Page 184: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 184/316

A b a c u s

0 3 E F :

0 3 F 1 :

0 3 F 3 :0 3 F 4 :0 3 F 7 :0 3 F 8 :

0 3 F 9 :0 3 F A :

0 3 F D :

0 4 0 0 :

0 4 0 1 :

0 4 0 3 :

0 4 0 5 :0 4 0 6 :0 4 0 9 :0 4 0 C :

S o f t w a r e

E

3

A 3 1 2

2 1

0

B

E

3

2 1 0 E

5

0

0

6

0

5

I

8 1 5

2

0

1

0 1

S B

J

X O L A D I N

I N L

L

O

S B

J

I N L L S B

H L , D E

N C , $ 0 3 F 8

( $ 2 4 0 0 ) , AH L , D EH

H D E , $ 0 1 6 5

B C , $ 1 5 0 0

H L , D E

C $ 0 4 2 0

H D E , $ 0 0 8 5B C f $ 1 3 1 1H L , D E

C - 1 2 8 C P / M U s e r ' s G u i d e

0 4 0 E : 3 8 1 0 J C , $ 0 4 2 0

0 4 1 0 :0 4 1 3 :

1 0

6 1

0 1

L L

D E B C

$ 0 0 6 C$ 1 2 1 8

0 4 1 6 : E 5 S H L , D E

0 4 1 8 :0 4 1 A :0 4 1 D :0 4 2 0 :0 4 2 1 :0 4 2 3 :0 4 2 4 :0 4 2 5 :0 4 2 6 :0 4 2 8 :0 4 2 A :

3 1 0 1 1 5 B O E 3 1

0 0 0 0 0I 1

0

5 F

J L L A D L L O I N S B J A D

C $ 0 4 2 0D E , $ 0 0 0 0B C , $ 1 1 1 EH L , D ED , $ 0 0E ,

H L , D EN C , $ 0 4 2 5H L , D E

a b s o l u t e B l o c k n u m b e r o s i d eF i n d o u b s u b t r a c t i o n

r e t u r n o n s i d eO f f s e t e r a s ea n s a v es u b t r a c t i o n c o r r e c t i o nB l o c k * 2 t h e r e 1 . / 2 .B l o c kR e s e r v e d f o D i r e c t o r y

( 3 5 7 ) B l o c k n u m b e r f r o mt r a c k 1

t r a c k 0 h a 2 s e c t o r s / t r a c ke r a s e c a r r y f o s u b t r a c t i o nC o n t r o l o 2 s e c t o r s / t r a c kY e s , B l o c k l i e s i 2 1 - s e c t o r s - a r e a+ f o e r r o r c o r r e c t i o nH a v e t h e n e x t 1 3 b l o c k s1 s e c t o r s p e r t r a c kT e s t i b l o c k i i t h i sa r e aY e s , t h e n e n s e r i e s o t e s t sH a v e n e x t t r a c k1 s e c t o r s / t r a c k ( f r o mt r a c k $ 1 8 )T e s t i b l o c k i i t h i sa r e aY e s , t h e n e n d t e s t s e r i e sc o r r e c t i o n f a c t o r t z e r of r o m t r a c k 3 0 - 1 7 s e c t o r sS u b t r a c t i o n c o r r e c t i o nE r a s e H i - B y t e f r o m D s e c t o r t E r a s e C a r r yI n c r e m e n t t r a c ks u b t r a c t s e c t o r s p e r t r a c ka n e v t l . c o n t i n u e l o o p i n ge r r o r c o r r e c t i o n

1 7

Page 185: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 185/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 4 2 B :0 4 2 E :0 4 2 F :0 4 3 2 :0 4 3 3 :

0 4 3 6 :0 4 3 9 :0 4 3 A :0 4 3 B :0 4 3 D :

0 4 3 E :0 4 3 F :0 4 4 0 :

0 4 4 1 :0 4 4 3 :

0 4 4 4 :0 4 4 5 :0 4 4 7 :0 4 4 8 :0 4 4 9 :0 4 4 A :0 4 4 D :0 4 4 E :

3 8 3 E 2

0 7 B 2 0

O O B

2 0

O 1 C 0 7 3 3 C

0

0

B

1

O

0

F

0

2

F

O

0

F

L A D L P U S HL

L L C J A D

D E D E C

J A D

D E J P O A D L L I N R E

A ( $ 2 4 0 0 )A ,

( $ F D 0 3 ) , AH H L , $ 0 F B 5

B C , $ 0 0 1 5A ,

Z , $ 0 4 4 7H L , B C

B B

Z , $ 0 4 4 7H L , B C

B $ 0 4 4 0B H L , B CA , ( H L )

( $ F D 0 4 ) ,

G e O f f s e t f o p a g e 0 / a d O f f s e t t t r a c kN o t e c a l c u l a t e d t r a c kS a v e s e c t o r * t o S t a c kT a b l e f o a d j u s t e d s e c t o rn u m b e r sT o p t i m i z e a c c e s sG e t s e c t o r n u m b e r a n c o m p a r e w i t h m a x i m a l v a l u eI 2 1 t h e n e n e l s e a d O f f s e t f o t a b l ep o i n t e rN e x t a r e a h a s e c t o r sf e w e r p e t r a c kH a t h m a x i m a l v a l u e b e e nr e a c h e d ?Y e s , t h e n e n e l s e a d O f f s e t f o r n e x ta r e aN e x t a r e a h a s o n e s e c t o rf e w e r a n c o n t . s e a r c h i n gG e s e c t o r * f r o m S t a c ka n d a d d t B a s i sG e a d j u s t e d s e c t o ra n n o t eE r a s e f l a g s a n E n d b l o c k c a l c u l a t i o n s

1 7

Page 186: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 186/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R e a d i n g f r o m d i s k

S e n u m b e r o r e a d t r i e so n t h e f l o p p ys e t h e f l a g f o v e c t o r( w o n ' t b s e a g a i n )S h o w B l o c k ( T r a c k / s e c t o r )o t h s c r e e n

T u r n o n 8 5 0 2T u r n o C o n f i g u r a t i o n b y t eR A B a n k

G e r e a d e r r o r f l a ga n t e s t f o r e a d e r r o r sR e a d r e a d e r r o r sE l s e e n t h r o u t i n e

0 4 4 F :0 4 5 1 :0 4 5 4 :0 4 5 6 :0 4 5 9 :

0 4 5 C :0 4 5 F :

0 4 6 1 :0 4 6 4 :0 4 6 7 :0 4 6 8 :0 4 6 A :

3 3 3 3 C

C 3

3 3 B 2 C

0 3 0 0 8

E 3

0 0

3

3

F 0

F

F F

L L L L C A L L

C A L LL

L L O J R E

A $ 0 ( $ 3 C 3 6 ) , A

A $ 0 ( $ F D 0 1 ) , A$ 0 5 8 C

$ F F E 0A $ 3

( $ F F 0 0 ) f AA , ( $ F D 0 6

N Z , $ 0 4 9 C

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 4 6 B :

0 4 6 E :0 4 6 F :0 4 7 1 :0 4 7 2 :0 4 7 3 :0 4 7 4 :0 4 7 6 :0 4 7 7 :0 4 7 8 :0 4 7 9 :0 4 7 B :0 4 7 C :0 4 7 E :0 4 7 F :

2

7 F C 2 7 F C 2 7 F C 2 7 C

0 F

4

4

4

F

L

L C R E I N L C R E I N L C R E L L R E

H L , $ F E 0 0

A , ( H L )$ 4 N

A ( H L )$ 4 N

A ( H L )$ 4 N L , $ F FA , ( H L )

T e s t l o a d e d b l o c k o b o o t s e c t o r

S t a r t a d d r e s s o l o a d e d B l o c kG e t f i r s t c h a r a c t e ri i " C " ?N o t h e n n o b o o t s e c t o rg e n e x t c h a r a c t e ra n c o m p a r e w i t h " B N o t h e n e n t h i r d c h a r a c t e r w i l l b ec h e c k e da g a i n s t " M N o n o B o o t s e c t o rC o u n t e r o l a s t c h a r a c t e rG e t t h i s c h a r a c t e ra n e n t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * e r r o r t r e a d

0 4 8 0 :0 4 8 3 :

C 2 0 9 3 0 5

C A L L $ 0 5 2 6. B y t e $ 9 3 , $ 0 5

O u t p u t t h f o l l o w i n g T e x tl i n e 1 9 c o l u m n

1 7

Page 187: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 187/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 4 8 5 :0 4 8 D :0 4 9 5 :0 4 9 B :0 4 9 C :0 4 9 D :0 4 9 F :0 4 A 2 :0 4 A 3 :0 4 A 6 :0 4 A 8 :0 4 A B :0 4 A D :0 4 B 4 :0 4 B 8 :0 4 B B :0 4 C 5 :0 4 C D :0 4 D 1 :0 4 D 3 :0 4 D B :0 4 E 3 :0 4 E A :

0 4 E D :0 4 E F :0 4 F 1 :0 4 F 2 :0 4 F 4 :0 4 F 6 :0 4 F 8 :0 4 F A :0 4 F C :0 4 F E :0 4 F F :0 5 0 2 :0 5 0 4 :0 5 0 7 :0 5 0 A :0 5 0 B :0 5 1 3 :0 5 1 9 :0 5 1 B :

3 4 2 C 3 2 3 3 3 2 C 9 5 5 C 2 4 2 9 4 4 3 0

3 E O E E 2 E E 2 C C 9 4 C 2 4 2 1 C

3 5 5

F 3

3 A 2 0 4 4 2 2 5 5 O 4 5 2 0

F 7

7 0 A 7 0 E

2 0 4 2 4 5 4 9 2

4 4 4

3

3

0

4 5 0 2 5 4

4 4 4 D

0

0 0

4 4

0

2 0 4 D 4 12 2 E 5 35 4 0

R S I N J L D E L J C A L L. B y t e

4 4 2 0 4 50

C A L L4 8 4 9 5 5 2 4 E 2 5 4 5 2 5 9

. B y t e2 5 4 5 2 2 0 4 4 4 4 4 5

L

L O U I N I A N J I A N J R S C A L L. B y t e

C A L L. B y t e

2 2 5 4 4 5 0 0

J C A L L

5 8 2 05 5

$ 0

Z , $ 0 4 9 BA , ( $ 3 C 3 6 )

( $ 3 C 3 6 ) , AN Z , $ 0 4 5 4$ 0 5 2 6$ 9 3 , $ 0 55

$ 0 5 2 62 5 5 4 4 F

$ 9 4 , $ 0 F2 4 3 3 0

B C $ D C 0 0

A $ F < C ) , A

A ( C $ 0 Z , $ 0 4 9 BA ( C $ 0 N Z , $ 0 4 E A$ 0 $ 0 5 2 6$ 9 3 , $ 0 5

$ 0 5 2 6$ 2 0 , $ 4 3

5 9 5 3

$ 0 4 B 8$ 0 5 2 6

3 2 M A C P M + . S Y SS I Z E < E n d >R e p e a t B o o t p r o c e e d i n g sT e s t i A c c u = & F FI A c c u = & F F a l s o r e b o o tE l s e g e t t h e r e a d c o u n t e ra n d d e c r e m e n t b o n p u i d o w n a g a i nT r a g a i nO u t p u t t h e f o l l o w i n g t e x tl i n e 1 9 c o l u m nR E A D E R O R < E n d >O u t p u t f o l l o w i n g t e x tH I R E T U R N T R E T R Yl i n e $ 1 4 , $ 0 FD E T E N T E R C 1 2 8M O D E < E n d >P o r t C I A 1

( K e y b o a r d d e c o d i n g )D E L - a n < C R > a r m a s k e d a n c h e c k e d

P o i n t e r t P o r t o C I A 1G e t r e s u l tT e s t B i t f o < C R >< C R > w a h i - R e b o o tE l s e g e t n e w v a l u eT e s t D E L - B i tN o h i t , t h e n k e e p t r y i n gE l s e i t h C - 1 2 8 - M o d eO u t p u t t h e f o l l o w i n g t e x tl i n e 1 9 c o l u m nN O < E n d >O u t p u t t h f o l l o w i n g t e x t$ 2 0 = A b C u r s o r p o s i t i o nC P M + . S Y SF I L E < E n d >N e t r o 1 2 M o d eO u t p u t t h e f o l l o w i n g t e x t

1 7

Page 188: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 188/316

Page 189: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 189/316

Page 190: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 190/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * • • • • • • • • • • • • • • • • • • • • • • • • • • • • A n n o u n c e b l o c k( T r a c k / s e c t o r ) t r e a d

S e t l i n e 2 4 c o l u m n 7 a C u r s o r

S e 8 0 - c h a r c u r s o r p o s .L i n e 2 4 c o l u m n 3 S e 4 0 - c h a r a c t e r - C u r s o rt r e a d t r a c kw a n d e r i A S C I IB l a n k c h a r a c t e ro u t p u tt l o a d i n g s e c t o r

0 5 8 C :

0 5 8 F :0 5 9 2 :0 5 9 5 :0 5 9 8 :0 5 9 B :0 5 9 E :0 5 A 0 :0 A 3

1

C 1 C 3 C 1 C 3

4

A 2 B 0 A 2 B 0

1

0 1 0 F 0

0 F

L

C A L LL C A L LL C A L LL C A L LL

D E , $ 1 8 4 A

$ 0 6 A BD E , $ 1 8 2 2$ 0 9 B CA ( $ F D 0$ 0 5 A 6D , $ 2 0$ 0 5 B 6A , ( $ F D 0

• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • M a k e o u < A c c u > A S C I I

0 5 A 6 :0 5 A 8 :0 5 A 9 :0 5 A B :

0 5 A D :

0 5 A F :0 5 B 0 :

0 5 B 1 :0 5 B 4 :

0 0 D 3

C

F 7

C F

2

0 F

3

B 0

L I N S U J

A D

P U S HL

C A L LP O

B , $ 2 F

$ 0 N C , $ 0 5 A 8

A $ 3

A A ,

$ 0 5 B 5A

A S C I I " 0 I n c r e m e n t t e n ' s p l a c eM o v e ( i p o s s i b l e ) 1 d o w nT e n ' s p l a c e i s t i l ln o z e r oe r r o r c o r r e c t i o n p l u sA S C I I " 0 S a v e o n e ' s p l a c eT e n ' s p l a c e ( A S C I I )t < A c c u >a n o u t p u tG e t o n e ' s p l a c e ( A S C I I )

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * O u t p u t c h a r a c t e r < a c c u )

0 5 B 5 :0 5 B 6 :0 5 B 7 :0 5 B A :0 5 B B :

0 5 B C :

5 D C 6 E 0 9D D

0

L P U S HC A L LP O R S

. B y t e

D , D $ 0 9 6 ED $ 1

$ 0

c h a r a c t e r s a f t e r < D >a n d n o t ec h a r a c t e r o u t p u tG e o u t p u t c h a r a c t e r ( V c h a r a c t e r t 4 0 - c h a r a c t e r - s c r e e nV e c t o r

1 7

Page 191: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 191/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * P r e p a r e 8 c h a r a c t e r s e

A d d r e s s i V D C - R A MG e v a l u e f r o m $ 3 0 0 4a n d c h e c k a g a i n s t b d e c r e m e n t i n g a n di n c r e m e n t i n gI f z e r o , t h e n i w a a l r e a d y p r e p a r e d

0 5 B D :0 5 C 0 :0 5 C 3 :0 5 C 4 :

2 C 0 0

0 3

3 0

L C A L LI N D E

H L , $ 3 0 0 4$ 0 9 3 D

0 5 C 5 : C R E

0 5 C 6 :0 5 C 9 :0 5 C C :0 5 C E :0 5 D 1 :0 5 D 4 :0 5 D 7 :0 5 D A :0 5 D D :0 5 E 0 :0 5 E 3 :0 5 E 6 :0 5 E 9 :0 5 E C :0 5 E F :0 5 F 2 :0 5 F 5 :0 5 F 8 :0 5 F B :0 5 F E :0 6 0 1 :0 6 0 4 :0 6 0 7 :0 6 0 9 :0 6 0 C :0 6 0 F :0 6 1 2 :0 6 1 5 :0 6 1 8 :0 6 1 B :0 6 1 E :0 6 2 1 :0 6 2 4 :0 6 2 7 :

2 0 1 C 2 1 0 C 2 1 0 C 2 1 0 C 2 1 0 C 2 0 1 C 2 1 0 C 2 1 0 C 2 1

0 0 0 4 A A 0 B 9 9 0 B E E 1 B 1 1 9 B 0 0 0 4 0 0 0 B B B 2 B C 0

3 0

0 3 3 0 0 3 3 0 0 3 3 0 0 3 3 0 0 3 0

0 2 3 0 0 2 3 0 0 2 3

L L L C A L LL L L C A L LL L L C A L LL L L C A L LL L L C A L LL L L C A L LL L L C A L LL L L

C A L LL L

H L , $ 3 8 0 0B C , $ 0 4 0 0D , $ 0 0$ 0 8 4 7H L , $ 3 7 A 0D E , $ 3 8 A 0B C , $ 0 0 0 8$ 0 8 B 0H L , $ 3 6 9D E , $ 3 8 9 0B C , $ 0 0 0 8$ 0 8 B 0H L , $ 3 5 E 0D E , $ 3 8 E 0B C , $ 0 0 1 8$ 0 8 B 0H L , $ 3 0 1 0D E , $ 3 6 1 0B C , $ 0 1 9 8$ 0 8 B 0H L , $ 3 0 0B C , $ 0 2 0 0D , $ 0 0$ 0 8 4 7H L , $ 2 0 0 0D E , $ 3 4 0 0B C , $ 0 0 0 8$ 0 8 B 0H L , $ 2 1 B 0D E , $ 3 5 BB C , $ 0 0 2 8

$ 0 8 B 0H L , $ 2 1 C 0D E , $ 3 8 0 0

F i l l$ 3 F F Fv a l u e

$ 3 8 0 0 t ow i t h t h

( e r a s e )A S C I I 1 2 b e c o m e sA S C I IA S C I I

1 3 1 0

b e c o m e sA S C I I

A S C I I

1 3

9 ( P I )b e c o m e sA S C I I 9 ( _

A - ( A S C I I 1 - 2 6 )t A S C I I

E r a s ei

9 f f

$ 3 0 0 0 t $ 3 1 F F

V D C - R A M

C o p yi n t oR A

t t A S C I I

A S C I It

" @ ( A S C I I 6 4 V D C -

u ( A S C I I 2 t h r u 2 9

9

2 ( f i n d c h a r a c t e r )

1 7

Page 192: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 192/316

A b a c u s

0 6 2 A :0 6 2 D :0 6 3 0 :0 6 3 3 :0 6 3 6 :0 6 3 9 :0 6 3 C :

0 6 3 F :0 6 4 2 :0 6 4 5 :0 6 4 8 :0 6 4 B :0 6 4 E :0 6 5 1 :0 6 5 4 :0 6 5 6 :0 6 5 9 :0 6 5 C :0 6 5 E :0 6 6 0 :0 6 6 1 :

S o f t w a r e

0 C 2 1 0 C 2

1 0 C 1 2 C 2 0 C 2 0 1 E E

0 B E 1 1 B 0

0 F B 1 C 7 E 0 6 B 0 0

0 0 2 3 0 0 2

3 0 0 O 3 0 3

0 3

L C A L L

L L L C A L LL

L L C A L LL L C A L LL L C A L LL L J P O E

B C , $ 0 0 0 8$ 0 8 B 0H L , $ 2 1 E 0D E , $ 3 8 1 0

$ 0 8 B 0H L , $ 2 4 0 0

D E , $ 3 C 0 0B C , $ 0 3 F 8$ 0 8 B 0D E , $ O F 1 AH L , $ 3 5 C$ 0 6 7 0H L , $ 3 5B , $ 0 3$ 0 6 6 2H L , $ 3 7 BB , $ 0 5$ 0 6 6 2H

( S P ) , H L

C - 1 2 8 C P / M U s e r ' s G u i d e

A S C I I 1 2

A S C I I 3 ( A b e c o m e s 1 2 a n

C a p i t a l l e t t e r s a n o t h e r c h a r a c t e r st $ 3 C 0 0 ( A S C I I 1 9 2 )

A S C I I 2 2 b e c o m e sA S C I I 9 A S C I I 2 2 8 - 2 3 0b e c o m e sA S C I I 9 4 - 9 6A S C I I 2 3 1 - 2 3 5b e c o m e sA S C I I 1 2 f f G e r e t u r n a d d r e s s t H a n e r a s e r e t u r n a d d r e s s

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o p y ( D E ) - > ( H L ) V D ( B C )

S a v e c o u n t e rN o t e d e s t i n a t i o n a d d r e s s

( D E ) - > ( H L ) V D C - R A MB y t e sG e g o a l a d d r e s s b a c kA n d a d d 1 ( i n s t e a d o 8 b e c a u s e o i n t e r n a lV D C - b u i l d i n gG e c o u n t e r b a c kA n o t h e r c h a r a c t e r t c o p y ?N o t h e n e n d

0 6 6 2 :0 6 6 3 :0 6 6 4 :

0 6 6 7 :0 6 6 8 :0 6 6 B :

0 6 6 C :6 6 D :

0 6 6 F :

C E C

E 0 0

C 1 C

7 0 0 6

1 0 0 0

F

P U S HP U S HC A L L

P O L A D

P O D J N ZR E

B H $ 0 6 7 0

H B C , $ 0 0 1H L , B C

B $ 0 6 6 2

1 8

Page 193: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 193/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ( d e ) - > ( H L ) V D C ; B y t e s

A n n o u n c e H a u p d a t eB y t e s s h o u l d b e c o p i e d

G e t t h e c h a r a c t e r f r o m R A Ma n d s t o r e i i V D P o i n t e r t S t a t u s - F l a gI n c r e m e n t p o i n t e r t t a b l eG e s t a t u s f l a gT e s t r e a d y - B i tS t i l l n o f i n i s h e dP o i n t e r a g a i n t $ D 6 0 1D e c r e m e n t p o i n t e ra n j u m p i s t i l l n o

B y t e se l s e e n r o u t i n e

0 6 7 0 :0 6 7 3 :0 6 7 5 :0 6 7 6 :0 6 7 8 :0 6 7 9 :0 6 7 A :0 6 7 C :0 6 7 D :0 6 7 F :0 6 8 0 :0 6 8 1 :

C 2 1 E 0 1 E 1 3 O 2 2

5 0

7

7

F

F

C A L LL L O U D E I N I R L J I N D E J

$ 0 9 5 3H $ 0 A ( ( C ) , A

D A ( C

N C , $ 0 6 7

N Z , $ 0 6

0 6 8 3 : C 9 R E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * o u t p u t < A c h a r a c t e r i n k l .C u r s o r m o v e

0 6 8 4 :0 6 8 7 :

0 6 8 A :0 6 8 D :

0 6 8 F :0 6 9 1 :

0 6 9 2 :0 6 9 5 :0 6 9 8 :0 6 9 9 :

2 C

3 F

2 3

3 2 2 2

1 0

1 4

3

1 1

1

2 0

2

2 2

2

L C A L L

L C

J I N

L L I N L

H L ( $ 2 4 1 1$ 0 9 0 7

A ( $ 2 4 1$ 4

Z , $ 0 6 C D

( $ 2 4 1 3 ) ,H L , ( $ 2 4 1H ( $ 2 4 1 1 ) ,

G e c u r s o r a d d r e s sO u t p u t c h a r a c t e r o 8 0 - c h a r a c t e rC u r s o r c o l u m nr i g h t b o a r d e r( 7 9 ) r e a c h e d ?

Y e s , t h e n n e x t l i n ee l s e i n c r e m e n t t h c o l u m n p o i n t e ra n n o t e t h e n e c o l u m nG e c u r s o r a d d r e s sa n a l s o i n c r e m e n t p l a c e

a n s t o r e a g a i n

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * S e H a C u r s o r a d d r e s s

0 6 9 C : 3 E 0 0 6 9 E : C 4 5 0 90 6 A 1 : E 6

L A , $ 0 EC A L L $ 0 9 4 5O U ( C ) , H

C u r s o r a d d r e s s H i - B y t eA n n o u n c e t V D H a n d o v e r H i g h B y t e o V D

1 8

Page 194: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 194/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 6 A 3 :

0 6 A 5 :6 A 8 :

0 6 A A :

3

C E C

O

4 0 6

L

C A L LO U R E

A $ 0

$ 0 9 4 5< C ) , L

R e g i s t e r 1 i C u r s o r a d d r e s s L a n n o u n c e t V D a n a l s o p a s s L o - B y t eE n o t r a n s f e r

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * S e 8 0 - c h a r a c t e r - C u r s o rp o s i t i o nD : c o l u m n , E l i n e

0 6 B 7 :6 B A :6 B D :6 C 0 :

7 L A , G e l i n eF 1 C P $ 1 9 L a r g e r t h a n 2 D R E N Y e s , t h e n i n v a l i d a n d e n d7 B L D A , G e c o l u m nF 5 C $ 5 L a r g e r t h a n 9 D O R E T N Y e s , t h e n i n v a l i d a n d e n dE E D E , H L f o t h p u r p o s e o s t o r i n g

H t D ( $ 2 4 1 3 ) , H L a n d n o t i n g

C u r s o r p o s i t i o nL H L , ( $ 2 4 1 3 ) G e t c u r s o r p o s i t i o nC A L L $ 0 C C E l i n e * 8 0 + c o l u m nL ( $ 2 4 1 1 ) , H L N o t e a d d r e s sJ $ 6 9 P a s s c u r s o r a d d r e s s

t V D

6 A B :0 6 A C :0 6 A E :

6 A F :6 B 0 :6 B 2 :6 B 3 :

0 6 B 4 : 2 2 1 3 2 L

2 1 2 C C 0 2 1 1 D

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e c r e m e n t l i n e b o n

0 6 C 2 : 3 1 2 L A ( $ 2 4 1 4 ) G e c u r s o r l i n e0 6 C 5 : B 7 O s e t h C P U - F l a g s0 6 C 6 : C R E L i n e i a l r e a d y t h

t h e n s t o p0 6 C 7 : 3 D D E e l s e d e c r e m e n t t h l i n e0 6 C 8 : 3 1 2 4 L D ( $ 2 4 1 4 ) , A a n d n o t e t h i s

6 C B : 1 E J $ 0 6 B 7 n e c a l c u l a t e dc u r s o r a d d r e s s

1 8

Page 195: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 195/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * c o l u m n = 0 ( 1 s t c o l )s e i n k l .I n f l u e n c e l i n e s

0 6 C D :0 6 C E :0 6 D 1 :

6 D 4 :6 D 6 :

0 6 D 8 :6 D A :

0 6 D B :

A 3 3 F 2 3 3

1

1 2 1 2 1 2 1

E

X O L L C J J I N

J

( $ 2 4 1 3 ) , AA ( $ 2 4 1$ 1 Z , $ 0 6 FN C , $ 0 6 F 4

$ 0 6 C 8

A c c u b e c o m e s n u l la n n o t e a c o l u m n

G e a c t u a l c u r s o r l i n eI s i t t h 2 3 r d l i n e . ?R e a c h e d , t h e n j u m pL i n e i 2 E l s e i n c r e m e n t l i n eb o n a n m a r k l i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e c r e m e n t c o l u m n b o n

G e a c t u a l c o l u m ns e f l a g s t o t e s t f o z e r oI a l r e a d y f i r s t c o l u m n ,t h e n e n e l s e d e c r e m e n t c o l u m n p t e r

a n n o t e n e w c o l u m nC a l c u l a t e n e wC u r s o r a d d r e s s

6 D D :0 6 E 0 :0 6 E 1 :

0 6 E 2 :0 6 E 3 :0 6 E 6 :

3 B C

3 3 1

1

1 C

2

L O R E

D E L J

A ( $ 2 4 1 3

( $ 2 4 1 3 ) , A$ 0 6 B 7

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * i n c r e m e n t c o l u m n b o n

0 6 E 8 :6 E B :

0 6 E C :

0 6 E E :0 6 F 0 :

3 1 2 L A , ( $ 2 4 1 3 ) G e a c t u a l c o l u m n3 C I N C a n i n c r e m e n t b o n F 5 C $ 5 h a c o l u m n 8 b e e n

r e a c h e d ?2 F J R N Z , $ 0 6 E N o t h e n m a r k c o l u m nC R E e l s e e n d t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

6 F 1 :0 6 F 2 :

A 1 E

X O J $ 0 6 E 3

( f i r s t c o l u m n )

S e a c c u t e x a c t l y 0 t h e n n o t e a n e w c o l u m n

1 8

Page 196: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 196/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * S e l i n e = 2 3

S e l i n e t 2 3 r da n m a r k i m e m o r y

S c r o l l ' t h e s c r e e no n e l i n e u b y c o p y i n g t h 2 n l i n e t t h e f i r s t l i n e e t c .P o i n t e r t o l a s t l i n e ( n o tS t a t u s l i n eN u m b e r i 8 c h a r a c t e r sL i n e e r a s ea n n o u n c e n e c u r s o rp o s i t i o n

0 6 F 4 :6 F 6 :6 F 9 :6 F C :

0 6 F F :0 7 0 2 :0 7 0 5 :

0 7 0 8 :0 7 0 B :0 7 0 E :

3 3 2 1 0 C 2

0 C 1

1 1 5 0 3 B 3

5 4 A

2 0 0 0 0 0

0 0

L L L L L C A L LL

L C A L LJ

A $ 1 ( $ 2 - 4 1 4 ) ,

H L , $ 0 0 5 0D E , $ 0 0 0 0B C , $ 0 7 3 0$ 0 8 B 0H L , $ 0 7 3 0

B C , $ 0 0 5 0$ 0 8 4 1$ 0 6 B 7

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e f i n e n e wa t t r i b u t e s ( B : t o e r a s e ,C : t o s e p a r a m e t e r s )

G e a t t r i b u t eC o m p l e m e n t a t t r i b u t et e r a s e B i t s ( q u a l i t i e s )c o m p l e m e n t a g a i nt s e B i t s ( q u a l i t i e s )

( $ 2 4 1 5 ) , A S t o r e t h e n e w a t t r i b u t e sR o u t i n e ' s e n d

0 7 1 0 :0 7 1 3 :0 7 1 4 :0 7 1 5 :0 7 1 6 :0 7 1 7 :0 7 1 A :

3 2 B 2 B 3 C

1

1

2

2

L C P O C P O L R E

A ( $ 2 4 1 5 )

( $ 2 4 1 5 ) , i

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 7 1 B :0 7 1 C :0 7 1 E :0 7 2 0 :0 7 2 2 :0 7 2 4 :0 7 2 7 :0 7 2 8 :0 7 2 9 :0 7 2 B :0 7 2 C :

7 D F 3 0 C D 7 E 8 3

2 2 0 2 E 5 0 C

O

0 2

L S U C J L C A L LR E L A N A D L

A , $ 2 $ 2 C , $ 0 7 2 CC $ 2 0$ 0 C E 5

A , ( H L )$ 0 A ,

( $ 2 4 0 0 )

G e c h a r a c t e rS u b t r a c t A S C I I 3 ( b l a n k )A S C I I 3 2 S m a l l e r , t h e n j u m pM o v e m a r k e r f o A S C I I 3 T r a n s f o r m A S C I I C o d eP r o d u c eG e c h a r a c t e r f r o m t a b l eM a s k B i t s 4 - a n m a r k < B a O f f s e tc h a r a c t e r

1 8

Page 197: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 197/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 7 2 F : O E 2 0 L C $ 2

0 7 3 1 :0 7 3 3 :0 7 3 6 :0 7 3 9 :0 7 3 A :0 7 3 B :

0 7 3 D :

0 7 3 F :0 7 4 1 :0 7 4 4 :0 7 4 5 :

0 7 4 7 :

0 7 4 A :0 7 4 B :0 7 4 D :

C 2 C 7 8 F

3

E 3 F 3

C

F E C

3 0 E

1

I

O 1

1

4

7

O O

2

0

A D L C A L LL A D C

J

A N L

A $ 3 H L , $ 0 F 0 A$ 0 C E 8A ( H L )A $ 1

C , $ 0 7 5 A

$ 0 ( $ 2 4 1 6 ) , A

P U S H A L

C A L L

P O O U R E

A , $ 1 A

$ 0 9 4 5

A ( C ) , A

A S C I I 3 s u b t r a c t i o n - c o u n t e rA S C I I 4 ( " 0 " ) a d T a b l e f o c o l o r a l t e r a t i o nt r a n s f o r mG e c o l o r v a l u e sa n d a d d a t t r i b u t eT r a n s f e r i n t o h i g hv a l u e N i b b l e ?F o r e g r o u n d c o l o ri d e f i n e de l s e m a s k B i t s 4 - N o t e b a c k g r o u n d c o l o rS a v e c o l o r c o d eR e g i s t e r

6 = f o r e / b a c k g r o u n dc o l o rV D C - S t a t u s w a i t f o ra n d a n n o u n c eG e c o l o r v a l u ea n s e c o l o rE n o t h r o u t i n e

0 7 4 E :0 7 5 1 :0 7 5 2 :0 7 5 5 :0 7 5 6 :0 7 5 9 :

3 4 3 5 3 C

1

. 1

1

2

2

2

L L L L L R E

B : B a c k g n d , D : A t t r i b u tA : F o r e g n d

A ( $ 2 4 1 7 ) G e b a c k g r o u n d c o l o rB , a n d m o v e t o < B >A ( $ 2 4 1 5 ) G e a t t r i b u t eD , a n m o v e t A ( $ 2 4 1 7 ) G e f o r e g r o u n d c o l o r

E n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e f i n e n e w f o r e g r o u n d c o l o r

C o l o r t G e a c t u a l a t t r i b u t eM a s k c o l o r n i b b l ea n s e n e c o l o r

A ( $ 2 4 0 0 ) G e b a c k g r o u n d c o l o r a n d

0 7 5 A :0 7 5 B :0 7 5 E :0 7 6 0 :0 7 6 1 :0 7 6 4 :

4 3 E B 3 3

1 F

1 0

2

2 2

L L A N O L L

B , A , ( $ 2 4 1 7 )$ F

( $ 2 4 1 5 ) , ;A ( $ 2 4 0 0 )

1 8

Page 198: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 198/316

A b a c u s

0 7 6 7 :0 7 6 A :0 7 6 D :0 7 7 0 :0 7 7 1 :0 7 7 4 :0 7 7 7 :0 7 7 9 :

S o f t w a r e

3 2 1 1 C 3 E C

1 . 1 0

5 1 7

2 2 0

0 2

L L L A D C A L LL O U R E

( $ 2 4 1 7 ) , AH L ( $ 2 4 1 1D E , $ 0 8 0 0H L , D E$ 0 9 5 3A ( $ 2 4 1 )

< C ) , A

i > i z » t r / M u s e r u u i a e

n o t eG e C u r s o r a d d r e s sO f f s e t f o R A a t t r i b u t ea d A n n o u n c e H a U p d a t eG e a t t r i b u t es t o r e t o C u r s o r a d d r e s sE n o r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * E r a s e c u r s o r p o s i t i o n t l i n e e n

G e c u r s o r p o s i t i o n ,n u m b e r o c h a r a c t e r sI n c r e m e n t t h n u m b e re r a s e t h e r e s t o f t h e l i n e

0 7 7 A :

0 7 7 D :0 7 7 E :

C

0 1

C

0

O C A L L

I N J

$ 0 C C 7

B $ 0 7 8 E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 7 8 0 : C C 0 C A L L $ 0 C C 7

0 7 8 3 :0 7 8 4 :

0 7 8 7 :

0 7 8 8 :

0 7 8 A :

0 7 8 B :0 7 8 C :

0 7 8 D :

0 7 8 E :

E 2

A

E

F

4 4

E

C

8 0

5

4 1 0 8

E L

X O

S B

R E

L L

E

J

D E , H LH L , $ 0 7 8 0

H L , D E

B , C ,

D E , H L

$ 0 8 4 1

E r a s e C u r s o r p o s i t i o n t s c r e e n ' s e n

G e C u r s o r p o s i t i o n ,n u m b e r o c h a r a c t e rC u r s o r a d d r e s s t D a d d r e s s b e g i n n i n g o s t a t u s l i n eE r a s e c a r r y f o s u b t r a c t i o nC a l c u l a t e c h a r s t s t a t u s l i n eI n e g a t i v e , t h e nE n ( e r r o r )E l s e B C e x a c t l yN u m b e r c h a r a c t e r s t s t a t u s l i n ea n d a c t u a l c u r s o r p o s i t i o na g a i n t o H LE r a s e t b e g i n n i n g o s t a t u s l i n e

1 8

Page 199: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 199/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 7 9 1 : C C 7 0 C C A L L $ 0 C C 7

0 7 9 4 :0 7 9 7 :0 7 9 8 :0 7 9 9 :0 7 9 B :0 7 9 C :0 7 9 D :0 7 9 E :0 7 9 F :0 7 A 0 :0 7 A 1 :0 7 A 4 :0 7 A 7 :0 7 A 8 :0 7 A 9 :0 7 A A :

0 7 A B :0 7 A C :0 7 A D :0 7 A E :0 7 B 1 :0 7 B 3 :

0 7 B 4 :

0 7 B 5 :

0 7 B 8 :

0 7 B 9 :

0 7 B B :

0 7 B C :0 7 B D :0 7 B E :

2 1 3 2 5 5 2 C E D C 0 E 0 E E

0 C C C E E

F

C

F

E

E

C 2 I

4

2

A 0

5 7

5

7

0 L A D D E J L L D E P U S HP U S HP U S H

0 C A L L0 L

P O H A D H L E D E P O P H L

A D H L P O B P U S H B

H L , $ 0 0 4 FH L , D E

Z , $ 0 7 C 7D , E , H B H D $ 0 7 A DB C , $ 0 8 0 0

B T , H

- B

C A L L $ 0 9 5 3I A E D E

P U S H A

( C H

C A L L $ 0 9 5

P O A

O U ( C

E D E

P O B D E H D E D

,

H

I n s e r t c h a r a c t e r s h i f tr e s t l i n e

G e c u r s o r p o s i t i o n a n n u m b e r c h a r a c t e ra d 7 t o l i n e b e g i n n i n gg o t o l i n e b e g i n n i n gN u m b e r c h a r s t l i n e e n d - 1N o t h i n g m o r e t h e n s t o pA d d r e s s t h l i n e e n t D A d d r e s s l i n e e n d - 1S a v e n u m b e rS a v e s o u r c eS a v e d e s t i n a t i o n

C o p y ( H L ) - > ( D E ) i V D C - R A MN o a d d O f f s e t f o R A a t t r i b u t e i V D s o u r c e a d d r e s sn o t e i D g e d e s t i n a t i o n a d d r e s sf r o m S t a c ka l s o a d t h e o f f s e tg e n u m b e ra n s a v e a g a i nA n n o u n c e H a u p d a t eG e a c t u a l c o n t e n t sE x c h a n g e d e s t i n a t i o n a n g o a l a d d r e s sS a v e t h f o u n do u c h a r a c t e rA n n o u n c e H L a g a i na u p d a t eG e b a c k t h f o u n do u c h a r a c t e rc o p y i d e s t i n a t i o na d d r e s sG o a l a n d d e s t i n a t i o na d d r e s s e s a g a i n o k G e n u m b e r b a c kD e c r e m e n t s o u r c e p o i n t e rD e c r e m e n t d e s t i n a t i o np o i n t e r

1 8

Page 200: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 200/316

A b a c u s

0 7 B F :0 7 C 0 :0 7 C 1 :0 7 C 2 :0 7 C 4 :0 7 C 7 :

S o f t w a r e

O 7 B 2 E 2 1 C 0

2 0

D E L O J L J

C - 1 2 8 C P / M U s e r ' s G u i d e

B D e c r e m e n t t h c o u n t e rA , B M a k e s u r e R e g i s t e r -

p a i r B i e x a c t l y z e r oN Z , $ 0 7 A D t h e n c o p y n e x t c h a r a c t e rH L , ( $ 2 4 1 1 ) e l s e g e t C u r s o r a d d r e s s ,$ 0 9 0 5 o u t p u t b l a n k c h a r a c t e r

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * E r a s e c h a r a c t e r i C u r s o rp o s i t i o n

G e C u r s o r a d d r e s s a n n u m b e r o c h a r a c t e r s

S a v e l i n e b e g i n n i n gt s t a c ka c t u a l C u r s o r p o s i t i o nc o p y t D I n c r e m e n t s o u r c e b o n ( H L ) - > ( D E ) B C t i m e s

e r a s e o n c h a r a c t e rL i n e b e g i n n i n g t H A n a d f o l i n e e n O u t p u t b l a n k c h a r t e n l i n e

0 7 C A :

0 7 C D :

0 7 C E :0 7 C F :0 7 D 0 :0 7 D 1 :

0 7 D 4 :0 7 D 5 :0 7 D 8 :0 7 D 9 :

C

D

5 5 2 C

E 1 1 C

C

B

4

0

O

0

0

0

C A L L

P U S H

L L I N C A L L

P O L A D J

$ 0 C C /

D

D , E , H $ 0 8 B 0

H D E , $ 0 0 4 FH L f D E$ 0 9 0 5

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * I n s e r t l i n e o nc u r s o r l i n e

0 7 D C :0 7 D F :0 7 E 1 :0 7 E 4 :0 7 E 5 :0 7 E 8 :0 7 E A :

0 7 E D :

0 7 F 0 :0 7 F 2 :

1 3 2 B C 3 2

1

0 C

6 1 1

0 1 E

3

1 0

O

2

0

0

0

0

L L L C J J L

L

L C A L L

D E , $ 0 F 6A $ 1 H L , ( $ 2 4 1

Z , $ 0 7 0 5C $ 0 8 0 4H L , $ 0 6 E 0

D E , $ 0 7 3 0

B , $ 1 8$ 0 8 0 A

P o i n t e r t t a b l eL i n e 2 3 i n a c c u

G e l i n e / c o l u m nL i n e 2 r e a c h e d ?Y e s , t h e n e r a s e 2 3 r d l i n es m a l l e r t h a n 2 3 t h e n j u m pS o u r c e a d d r e s s ( t h i r d t l a s t l i n eD e s t i n a t i o n a d d r e s s

( s e c o n d t o l a s t l i n e2 l i n e s a r e t o b e c o p i e dC o p y l i n e ( H L ) t ( D E )

1 8

Page 201: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 201/316

A b a c u s

0 7 F 5 :0 7 F 8 :0 7 F 9 :0 7 F B :

0 7 F E :0 7 F F :

0 8 0 2 :0 8 0 4 :0 8 0 5 :0 8 0 6 :0 8 0 7 :

S o f t w a r e

3 B 2 C

E 0

1 3 B C C

1

F C

5

3

2

2

O

0

0

L C J C A L L

E L

J I N C R E J

A ( $ 2 4 1 4 )

N Z , $ 0 7 F 2$ 0 C C 7

D E , H LB C , $ 0 0 5 0

$ 0 8 4 1

N $ 0 5 2 C

C - 1 2 8 C P / M U s e r ' s G u i d e

G e t l i n eA c t u a l l i n e r e a c h e d ?N o t h e n c o n t i n u e c o p y i n gG e c u r s o r p o s i t i o n a n

c h a r a c t e r sH L l i n e b e g i n n i n g8 a b e g i n n i n g o t h f o l l o w i n g l i n e sE r a s e c u r s o r l i n eT h i s l o c a t i o n w o n ' t b r e a c h e d , o r t h e c u r s o rw o u l d b o s t a t u s l i n eO u t p u t t e x t f r o m D

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o p y l i n e ( H L ) t ( D E )i V D

0 8 0 A :0 8 0 B :0 8 0 C :

0 8 0 D :0 8 1 0 :0 8 1 3 :

0 8 1 6 :0 8 1 7 :0 8 1 8 :0 8 1 9 :0 8 1 A :0 8 1 B :0 8 1 C :0 8 1 D :

C E D

0 5 0 C B 0 0 B F

E 0 E E 0 C 0 C

P U S HP U S HP U S H

L C A L LL

P O A D E P O A D P O D E R E

B H D

B C , $ 0 0 5 0$ 0 8 B 0B C , $ F F B 0

H H L , B CD E , H LH H L , B CB

S a v e n u m b e r t s t a c kS a v e s o u r c e a d d r t o s t a c kS a v e d e s t i n a t i o n a d d r e s s

t s t a c k8 c h a r a c t e r s p e l i n eC o p y l i n eA d d i n g 8 0 f s c o m p l e m e n t i u s e d f o s u b t r a c t i o nG e d e s t i n a t i o n a d d r e s sd e l e t e 8 c h a r a c t e r sa n p u i n t o D G e s o u r c e a d d r e s ss u b t r a c t 8 G e n u m b e rD e c r e m e n t t h e c o u n t e rE n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 8 1 E :0 8 2 1 :0 8 2 3 :

3 F D

1 1

2 L C R E

E r a s e c u r s o r l i n e a n m o v et h r e s t u

A ( $ 2 4 1 4 ) G e t l i n e$ 1 H a l i n e 2 b e e n r e a c h e d ?N Y e s , t h e n q u i t

1 8

Page 202: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 202/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 8 2 4 : C C 0 C A L L $ 0 C C 7

0 8 2 7 :0 8 2 A :0 8 2 B :0 8 2 C :

0 8 2 D :0 8 3 0 :0 8 3 1 :

0 8 3 4 :0 8 3 5 :

5 0 0 02 1 E E

2 8 0 A E 5

0 8 3 3 : 4

4 E

0 8 3 6 : E

L A D E P U S H

L X O S B

L

L P O

E

G e c u r s o r p o a n n u m b e r o c h a r s

H L , $ Q 0 5 0 A d 8 t o t h e s t a r t a d d r e s sH L , D E o t h c u r s o r l i n eD E , H L a n n o t e t h a t i D H P u s h s t a r t a d d r e s s t

t h S t a c kH L , $ 0 7 8 0 S t a t u s l i n e ' s s t a r t a d d r e s s

H L , D E

B ,

C , H

D E , H L

0 8 3 7 :0 8 3 A :

C C

B 0

0 0

C A L LJ

$ 0 8 B 0$ 0 7 0 5

E r a s e c a r r y f o s u b t r a c t i o nS u b t r a c t t h e f o l l o w i n gl i n e ' s s t a r t a d G i v e t h e n u m b e r o c h a r a c t e r s u p t o t h s c r e e n ' s e n t B G e t s t a r t a d d r e s s b a c k

E x c h a n g e s o u r c e a n d e s t i n a t i o n a d d r e s s( H L ) - > ( D E ) i V D C - R A M

E r a s e t h l a s t l i n e b e f o r et h s t a t l i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * P u v a l u e i V D C - R A M

0 8 3 D : E l P O P H L G e t r e t u r n a d d r e s s0 8 3 E : E E ( S P ) , H L a n e x c h a n g e w i t h

p r e c e d i n g r e t u r n a d d r e s s0 8 3 F : 1 8 0 6 J $ 0 8 4 7 J u m p t r o u t i n e0 8 4 1 : 3 1 2 L A ( $ 2 4 1 5 ) G e a t t r i b u t e0 8 4 4 : 5 L E , L o a d a t t r i b u t e i n t o0 8 4 5 : 1 2 L D , $ 2 0 A S C I I - C o d e f o b l a n k c h a r

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * F i l l ( H L ) i V D C - R A M w i t hD , a t t r i b u t e w i t h

( H L + 8 0 0 ) w i l l b e f i l l e d .T e s t n u m b e r ' s H i - B y t ea n d H i - B y t e a g a i n s t z e r oI z e r o , t h e n o n l y f i l lL o - B y t eS a v e d e s t i n a t i o n a d d r e s sS a v e f i l l v a l u e s

0 8 4 7 :0 8 4 8 :0 8 4 9 :

0 8 4 B :0 8 4 C :

7 A 2 0

E D

L A N J

P U S HP U S H

A ,

Z , $ 0 8 5 8

H D

1 9

Page 203: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 203/316

Page 204: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 204/316

A b a c u s

0 8 7 8 :0 8 7 B :0 8 7 D :0 8 7 F :0 8 8 1 :

0 8 8 3 :0 8 8 6 :0 8 8 7 :

0 8 8 9 :0 8 8 B :

0 8 8 C :0 8 8 D :0 8 8 E :0 8 8 F :0 8 9 0 :0 8 9 2 :0 8 9 5 :0 8 9 7 :0 8 9 9 :0 8 9 C :0 8 9 E :

0 8 9 F :0 8 A 0 :0 8 A 3 :0 8 A 4 :0 8 A 5 :0 8 A 8 :0 8 A 9 :0 8 A B :0 A C

0 8 A E :0 8 A F :

S o f t w a r e

C E E E 3

C F E

0 4

0 0 D E 3 C E 3 C E D

C C D C C C E 2 1

E E

4 7 7 7 I

4

7

0

1 4 6 1 4 6

F

5

4

F

0

0

0

0

0

0

C A L LI A N O U L

C A L LP O O U

L L

I N A D P U S HP U S HL C A L LI L C A L LI P O

P O C A L LR E P U S HC A L LP O O U I N J

P O E

$ 0 9 4 5A ( C $ 7 ( C ) , A

A , $ 1 E

$ 0 9 4 5A

( C ) , A

B , $ 0 0C ,

B H L , B CD H A $ 1 $ 0 9 4 5H ( C A $ 1 $ 0 9 4 5L ( C D

B $ 0 0 F AN B $ 0 9 5 3B

( C ) , BH $ 0 8 A 0

H ( S P ) , H L

C - 1 2 8 C P / M U s e r ' s G u i d e

( c o p y - b i t )G e r e g i s t e r ' s c o n t e n t sa n d m a s k c o p y - B i tA g a i n i n t o V D C m e m o r yS e l e c t r e g i s t e r 3 ( W o r d c o u n t )a n a n n o u n c e

G e n u m b e r f r o m S t a c ka n p a s s t h e n u m b e r ' sr e m a i n d e r t V D S e B C ' s H i - B y t e t o z e r oa n L o - B y t e w i t hn u m b e r ' s r e m a i n d e ra d o n a d s t a r t a d d r e s sS a v e s t a r t a d d r e s sS a v e c a l c u l a t e d s t o p a d d rU p d a t e H i - B y t e - R e g i s t e ra n n o u n c ea n r e a d t h e e n t i r e v a l u eU p d a t e L o - B y t e - R e g i s t e ra n n o u n c ea n d r e a d t h e n t i r e v a l u eG e t t h e c a l c u l a t e ds t o p a d d r e s sG e t s t a r t a d d r e s sC o m p a r e H L w i t h D E v e r y t h i n g O K n m i s t a k e s !N u m b e r t S t a c kA n n o u n c e H a U p d a t eG e n u m b e r ' s r e m a i n d e ra n d e r r o r c o r r e c t i o ni c a l c u l a t e d s t o p a d d r e s sa n d a c t u a l s t o p a d d r e s s a r d i f f e r e n tG e r e t u r n a d d r e s sa n g o o n e d e e p e r i t h S t a c k

1 9

Page 205: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 205/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 8 B 0 :0 8 B 1 :0 8 B 2 :0 8 B 4 :0 8 B 5 :0 8 B 6 :0 8 B 7 :0 8 B 8 :0 8 B B :0 8 B C :0 8 B D :0 8 B E :

7 A 2 O E D C A C C 0 C D E 2

L A N J P U S HP U S HP U S HX O C A L LP O P O P O I N

A f

Z , $ 0 8 C 2H D B

$ 0 8 C 5B D H

0 8 B F : 1 I N

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ( H L ) - ( D E ) i V D C - R A M< B C > t i m e s

G e n u m b e r ' s H i - B y t eT e s t H i - B y t e a g a i n s t z e r oI z e r o , t h e n n u m b e r < 2 5 6S a v e s o u r c e a d d r e s sS a v e d e s t i n a t i o n a d d r e s sS a v e n u m b e r t o S t a c ke r a s e A c c u f o r 2 5 6 c h a r s

( H L ) - > ( D E ) < A > t i m e sG e n u m b e rG e d e s t i n a t i o n a d d r e s sG e s o u r c e a d d r e s sI n c r e m e n t s o u r c e a d d r e s s 1H i - B y t eI n c r e m e n t d e s t i n a t i o na d d r e s s 1 H i - B y t eI m o r e t h a n 2 5 c h a r a c t e r ,t h e n g e L o - n u m b e rs e i i t i s z e r oe n i f i t i s z e r oe l s e e x c h a n g e s o u r c e a n dd e s t i n a t i o n a d d r e s s e sS a v e n u m b e r t S t a c kS a v e d e s t i n a t i o n a d d r e s sS a v e s o u r c e a d d r e s s( D E ) - > ( H L ) i V D C - R A M

< A > n u m b e r o t i m e sO f f s e t f o R A M a t t r i b u t eG e s o u r c e a d d r e s sa d d O f f s e tS o u r c e a d d r e s s + O f f s e ti n t o D G e d e s t i n a t i o n a d d r e s sa d d O f f s e tT e s t a g a i n s t m e m o r yb o u n d a r yG e n u m b e r

0 8 C 0 :0 8 C 2 :0 8 C 3 :0 8 C 4 :0 8 C 5 :

0 8 C 6 :0 8 C 7 :0 8 C 8 :0 8 C 9 :

0 8 C C :0 8 C F :0 8 D 0 :0 8 D 1 :

0 8 D 2 :0 8 D 3 :0 8 D 4 :

1 7 A C E

F E D C

0 E 0 E

E 0 C

F

D 0

0 0 0 8

F 0

D J N ZL A N R E E

P U S HP U S HP U S HC A L L

L P O A D E

P O A D C A L L

$ 0 8 B 4A ,

D E , H L

A H D $ 0 8 D 8

B C , $ 0 8 0 0H H L f B CD E f H L

H H L , B C$ 0 8 F E

0 8 D 7 : F P O A

1 9

Page 206: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 206/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

• • i t * * * * * * * * * * * * * * * * * * * * * * * * * *

0 8 D 8 :0 8 D 9 :

0 8 D C :0 8 D E :0 8 E 1 :0 8 E 3 :0 8 E 5 :0 8 E 7 :

0 8 E 9 :0 8 E C :0 8 E E :

0 8 F 0 :0 8 F 3 :0 8 F 5 :0 8 F 7 :0 8 F A :0 8 F B :0 8 F D :

F C

3 C E F E 3

C E 3

C E 3 C F E C

5

1 4 7 8 7 2

4 5 2

4 5 I 4

7

0

0

0

0

0

P U S HC A L L

L C A L LI O O U L

C A L LO U L

C A L LO U L C A L L

P O O U R E

A $ 0 9 5 3

A $ 1 $ 0 9 4 5A ( C $ 8 < C ) , A

A $ 2

$ 0 9 4 5< C ) , D

A $ 2

$ 0 9 4 5( C ) , E

A , $ 1 E$ 0 9 4 5A

( C ) , A

( D E ) - ( H L ) i V D C - a c c u m u l a t o r< A t i m e s

S a v e n u m b e r t s t a c kA n n o u n c e H a U p d a t e a d d r e s sA n n o u n c e r e g i s t e r 2 ( c o p y b i t )G e r e g i s t e r ' s c o n t e n t sa n s e t h e c o p y b i tR e p o r t r e g i s t e r t V D A n n o u n c e R e g i s t e r 3

( B l o c k - S t a r t - H i )i V D P a s s H i - a d d r e s s s o u r c eA n n o u n c e R e g i s t e r 3

( B l o c k - S t a r t - L o )i V D

a n d p a s s L o - a d d r e s s s o u r c eA n n o u n c e R e g i s t e r 3 ( W o r dc o u n t )a n g e n u m b e r f r o m s t a c kR e p o r t V D n u m b e rE n o r o u t i n e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 8 F E :0 8 F F :0 9 0 1 :0 9 0 2 :0 9 0 3 :

7 F 2 D F F

L C R E P O P O

A , $ 2

A A

0 9 0 4 : C 9 R E

T e s t i a f t e r a d d i n g t h o f f s e t < H L >t h R A a t t r i b u t e c h a n g e s

L o a d H i - B y t e i n t o a c c ua n d c h e c k t h b o r d e rI c a r r y i s s e t , < H L > i O G e t A F f r o m s t a c kG e r e t u r n a d d r e s s f r o mt h e S t a c ka n r e t u r n o c c u r s a f t e rC A L L $ 0 8 5 B

1 9

Page 207: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 207/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 9 0 5 : 1 2 L 0 9 0 7 : 3 1 2 L

O u t p u t b l a n k c h a r a c t e r t ( H L ) ( V D C )

D , $ 2 0 A S C I I v a l u e f o < s p a c e >A , ( $ 2 4 1 5 ) G e t a t t r i b u t e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 9 0 A :0 9 0 B :0 9 0 C :

0 9 0 F :0 9 1 0 :

0 9 1 1 :0 9 1 4 :0 9 1 5 :0 9 1 6 :0 9 1 9 :0 9 1 B :

E D 1

1 5

C D E C E C

0

1

5 5

0

0

0

P U S HP U S HL

A D L

C A L LP O P O C A L LO U R E

O u t p u t c h a r a c t e r < D > w i t ha t t r i b u t e < A t ( H L )

H S a v e d e s t i n a t i o n a d d r e s sD E S a v e c h a r a c t e r / a t t r i b u t eD E , $ 0 8 0 0 A d o f f s e t f o R A

a t t r i b u t eH L , D E t d e s t i n a t i o n a d d r e s sD , O u t p u t a t t r i b u t e a

t h f i l l c h a r a c t e r$ 0 9 1 6 < D t ( H L )D G e c h a r a c t e rH L G e t d e s t i n a t i o n a d d r e s s$ 0 9 5 3 U s e H L a u p d a t e( C ) f D a n d o u t p u t c h a r t ( H L )

R o u t i n e ' s e n

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Q e < c > : a t t r i b u t e ,< B > : c h a r a c t e r , t c u r s o r p o s i t i o n < D E >

0 9 1 C : C A 0 C A L L $ 0 6 A B S e c u r s o r p o s i t i o n < D E >0 9 1 F : 2 1 2 L H L f ( $ 2 4 1 1 ) G e c u r s o r a d d r e s s0 9 2 2 : C 3 0 C A L L $ 0 9 3 3 G e t c h a r a c t e r / a t t r i b u t e0 9 2 5 : 4 L C , A < C > i a t t r i b u t e

9 2 6 : C R E E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 9 2 7 : C 5 P U S H0 9 2 8 : C A 0 C A L L0 9 2 B : 2 1 2 L

< B > : c h a r a c t e r ,< C > : a t t r i b u t e , o u t p u tt < D E >

B C S a v e c h a r a c t e r / a t t r i b u t e$ 0 6 A B S e c u r s o r p o s i t i o n < D E >H L , ( $ 2 4 1 1 ) G e t C u r s o r a d d r e s s

1 9

Page 208: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 208/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 9 2 E :0 9 2 F :0 9 3 0 :0 9 3 1 :

C 5 7 1 D

P O L L

J

B D , A ,

$ 0 9 0 A

G e c h a r a c t e r / a t r r i b u t e< D i c h a r a c t e r< A i a a t t r i b u t eO u t p u t c h a r a c t e r a n a t t r i b u t e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * G e < A > : A t t r i b u t e ,< B > : c h a r a c t e r t ( H L )

0 9 3 3 :0 9 3 4 :

0 9 3 7 :0 9 3 8 :

0 9 3 B :0 9 3 C :0 9 3 D :0 9 3 E :0 9 4 1 :0 9 4 2 :0 9 4 4 :

E 1

1 C

7 E F C F E C

0 0 0 8

3 0

5 3 0 9

4

P U S HL

A D C A L L

L P O P U S HC A L LP O I R E

H D E $

H L , D E$ 0 9 3 D

A , H A $ 0 9 5 3A B ( C

S a v e a d d r e s sD E , $ 0 8 0 0 A d o f f s e t f o

a t t r i b u t e a d d r e s s

G e v a l u e s t V D C - a d d r e s s ( H L )A t t r i b u t e t < A G e t e x t a d d r e s sS a v e a t t r i b u t eU s ( H L ) a u p d a t eG e a t t r i b u t eG e v a l u e t a d d r e s s ( H L )R o u t i n e ' s e n

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * W a i t f o r V D C — S t a t u s

0 9 4 5 :0 9 4 6 :0 9 4 9 :0 9 4 B :0 9 4 C :0 9 4 E :

0 9 4 F :0 9 5 1 :0 9 5 2 :

F 0 E 1 3 F

E O C

0 D 7

F

7

P U S HL I R L J P O

O U I N R E

A B C $ A ( C

N C $ A

< C ) , A

S a v e o u t p u t r e g i s t e rB C f $ D 6 0 0 S t a r t a d d r e s s V D C - C h i p

G e S t a t u sS h i f t S t a t u s - B i t i n t o C a r r y

N C f $ 0 9 4 9 S t i l l n o d o n e - > j u m pG e t h r e g i s t e r f r o m s t a c ko n c e m o r ea n c h o o s e r e g i s t e rP o i n t t o $ D 6 0 1a n d R E T u r n f r o m r o u t i n e

1 9

Page 209: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 209/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 9 5 3 :0 9 5 5 :0 9 5 8 :0 9 5 A :0 9 5 C :0 9 5 F :0 9 6 1 :

0 9 6 3 :0 9 6 6 :0 9 6 7 :0 9 6 9 :0 9 6 A :0 9 6 C :0 9 6 D :

3 C E 3 C E 3

C 0 E 1 3 O C

1 4 0 6 1 4 0 6 I

4 0

7

F

L C A L LO U L C A L LO U L

C A L LD E I R L J I N R E

A $ 1 $ 0 9 4 5( C ) , H

A $ 1 $ 0 9 4 5( C ) , L

A , $ 1 F

$ 0 9 4 5

A ( C

N C , $ 0 9 6 7

H a U p d a t e - a d d r e s s

A n n o u n c e U p d a t e - a d d r e s s H

P a s s H i - B y t eA n n o u n c e U p d a t e - a d d r e s s L P a s s L o - B y t eA n n o u n c e w o r d c o u n tr e g i s t e r

P o i n t e r a g a i n t $ D 6 0 0G e S t a t u sR o l l s t a t u s i n t o C a r r yS t i l l n o d o n eY e n o w , p o i n t e r t o $ D 6 0 1R E T u r n f r o m s u b r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * O u t p u t c h a r a c t e r < D t 4 0 - c h a r a c t e r s c r e e n

0 9 6 E :0 9 6 F :0 9 7 2 :0 9 7 5 :0 9 7 6 :

0 9 7 9 :0 9 7 A :0 9 7 B :0 9 7 C :0 9 7 F :0 9 8 2 :0 9 8 3 :0 9 8 6 :0 9 8 7 :0 9 8 A :0 9 8 C :0 9 8 E :

0 9 8 F :0 9 9 2 :

4 C 2 4 3

B 7 2 2 1 1 3 7 3 F 2 3

3 C

7 0

1

0 F

0

0 4 5

0 4

O 2

2

2 0

2

2

2 O

L C A L LL L L

O L I N L L A D L L L C J I N

L J

B , c h a r a c t e r t < B $ 0 C 7 F A S C I I c o d e t r a n s f o r m V I H L , ( $ 2 4 0 9 ) 8 0 - c h a r a c t e r - a d d r e s sB f c h a r a c t e r t o < B >A , ( $ 2 4 1 0 ) G e t c h a r a c t e r o f f s e t

( B i t 1 / 0 )O p e r a t e w i t h c h a r a c t e r

( H L ) , A a n d w r i t e i n t o R A H I n c r e m e n t p o i n t e r( $ 2 4 0 9 ) , H L a n d m a r k t h i s

D E , $ 0 7 F F A d t o f f s e tH L , D E f o c o l o r R A A , ( $ 2 4 0 D ) G e t c h a r a c t e r c o l o r

( H L ) f A a n s e c h a r a c t e r c o l o rA , ( $ 2 4 0 B ) G e t c u r s o r p o s i t i o n$ 4 L a s t c o l u m n ?Z , $ 0 9 E D Y e s , t h e n j u m p l i n e s

e l s e i n c r e m e n t t h ec o l u m n p o i n t e r

( $ 2 4 0 B ) , A a n m a r k t h n e p o s i t i o n$ 0 C 4 A R e p r e s e n t l i n e

1 9

Page 210: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 210/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * G e c h a r a c t e r < B a n c o l o r< C > f r o m C u r s o r p o ( D E )

D e f i n e l i n e / c o l u m n ( D E )H L , ( $ 2 4 0 9 ) G e c u r s o r a d d r e s s o

8 0 - c h a r a c t e r s i m u l a t o rG e c h a r a c t e r i C u r s o r p o s i t i o n

D E , $ 0 8 0 0 A d o f f s e t f o R A a t t r i b u t e

G e a t t r i b u t e i C u r s o r p o s i t i o nE n o r o u t i n e

0 9 9 5 :0 9 9 8 :

0 9 9 B :

0 9 9 C :

0 9 9 F :9 A 0 :

C 2

4

1

1 4

C 0

0

0 2

0

C A L LL

L

L

A D L

$ O 9 C 1H L , ( $ 2

B , ( H L )

D E , $ 0 E

H L , D EC , ( H L )

9 A 1 : C R E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * < B > : c h a r a c t e r , < C > : a t t r i b u t et ( D E )

9 A 2 :9 A 3 :9 A 6 :9 A 7 :

0 9 A A :9 A B :9 A D :9 A F :9 B 1 :

9 B 3 :0 9 B 4 :

9 B 7 :9 B 8 :

0 9 B 9 :

C C C 2

7 E C 2 C

7 1

1 7 C

C

0

7 7 0 8

0

4

0

2

0

O

P U S HC A L LP O L

L A N B I J A D

L L

A D L J

B $ O 9 C 1B

S a v e c h a r a c t e r / a t t r i b u t eS e C u r s o r p o s i t i o nG e c h a r a c t e r / a t t r i b u t e

H L ( $ 2 4 0 9 ) G e 8 0 - c h a r a c t e r

A , $ 7 6 , Z , $ 0 9 B 3A , $ 8 0

( H L ) , AD E , $ 0 8 0 0

H L , D E( H L ) , C

$ 0 C 4 A

s i m u l a t o r a d d r e s sc h a r a c t e r i n t o < A c c u >E r a s e B i T e s t B i tI s n ' t s e S e B i ( r e v e r s e sc h a r a c t e r )a n s e c h a r a c t e rA d o f f s e t f o R A a t t r i b u t e

D e f i n e a t t r i b u t e a l s oR e p r e s e n t l i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e f . l i n e / c o l u m n

H L , $ 2 4 0 4 a d d r e s s 4 0 - c h a r a c t e r6 , ( H L ) 4 0 - c h a r a c t e r b i s e A , G e t l i n e

9 B C :0 9 B F :0 9 C 1 :

2 C 7

0 F

2 L S E L

1 9

Page 211: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 211/316

A b a c u s

9 C 2 :0 9 C 4 :0 9 C 5 :0 9 C 6 :

9 C 8 :0 9 C 9 :0 9 C A :

S o f t w a r e

F 1 D 7 F 5 D E 2 O 2

C R E L C R E E L

$ 1 N A , $ 5 N D E , H L

( $ 2 4 0 B )

C - 1 2 8 C P / M U s e r ' s G u i d e

B i g g e r t h a n 2 4 Y e s , t h e n e n ( e r r o r )G e c o l u m nH a v e r e a c h e d c o l u m n 8 0 Y e s , t h e n e n ( m i s t a k e )l i n e / c o l u m n t H i , H L S e l i n e / c o l u m n

• a * * * * * * * * * * * * * * * * * * * * * * * * * * * * N e w c u r s o r p o s i t i o n

0 9 C D : 2 O 2 L H L ( $ 2 4 0 B G e l i n e / c o l u m n0 9 D 0 : C C 0 C A L L $ 0 C C E C a l c u l a t e n e w c u r s o r

a d d r e s sD E , $ 1 4 0 0 A d o f f s e t f o

8 0 - c h a r a c t e r s i m u l a t o r1 A D H L , D E t i 2 0 2 L ( $ 2 4 0 9 ) , H L A n n o t e t h

a d j u s t e d a d d r e s s0 9 D A : C 3 4 0 J $ 0 C 4 A R e p r e s e n t l i n e

0 9 D 3 : 1 0 0 1 4 L

0 9 D 6 :0 9 D 7 :

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e c r e m e n t l i n e

0 9 D D :0 9 E 0 :0 9 E 1 :0 9 E 2 :0 9 E 3 :0 9 E 6 :0 9 E 9 :0 9 E B :

3 B C 3 3 2 C 1

O

O 0 F E

2

2 2

L O R E D E L L S E J

A ( $ 2 4 0 C ) G e c u r s o r l i n eS e F l a g sl i n e 0 D o n ' t d a n y t h i n ge l s e d e c r e m e n t l i n e p o i n t e r

( $ 2 4 0 C ) , A a n n o t e l i n eH L , $ 2 4 0 4 S e B i t o $ 2 4 0 46 , ( H L ) a O K - c h a r a c t e r$ 0 9 C D C a l c u l a t e n e w

c u r s o r p o s i t i o n

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o l u m n = 0 D e f i n e c o l u m n ( + 1 )

0 9 E D : A X O R A A c c u = 0 f o r f i r s t c o l u m n0 9 E E : 3 0 B 2 4 L D ( $ 2 4 0 B ) , a n d d e f i n e c o l u m n0 9 F 1 : 3 0 2 L A ( $ 2 4 0 C ) G e t l i n e0 9 F 4 : F 1 C $ 1 L a s t l i n e ?0 9 F 6 : 2 0 J Z , $ 0 A 0 2 Y e s , t h e n j u m p0 9 F 8 : 3 0 0 3 J R N C , $ 0 9 F D C o r r e c t e r r o r s

1 9

Page 212: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 212/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

9 F A : 3 I N I n c r e m e n t l i n e b o n 0 9 F B : 1 E J $ 0 9 E 3 a n n o t e0 9 F D : 3 1 L A $ 1 N o t e l i n e 2 ( l a s t0 9 F F : 3 O C 2 4 L ( $ 2 4 0 C ) , A l i n e )0 A 0 2 : 2 5 0 1 4 L H L , $ 1 4 5 0 S e c o n d l i n e ' s s t a r t a d d r e s s0 A 0 5 : 1 0 1 L D E , $ 1 4 0 0 F i r s t l i n e ' s s t a r t a d d r e s s0 A 0 8 : 0 1 3 0 0 L B C , $ 0 7 3 0 C o p y 2 l i n e s0 A 0 B : E B L D I R S c r o l l i n g0 A 0 D : E E D E , H L D e s t i n a t i o n a d d r e s s

a s o u r c e0 A 0 E : 1 3 I L D E , $ 1 B 3 1 L a s t l i n e ' s 2 n d c h a r a c t e r0 A 1 1 : 0 4 0 L B C , $ 0 0 4 F F i l l 7 c h a r a c t e r s0 A 1 4 : C 2 0 C A L L $ 0 B 2 4 F l l a s t l i n e w i t h

f i l l c h a r a c t e r s0 A 1 7 : 2 1 5 1 L H L , $ l C 5 0 S e c o n d l i n e ' s a d d r e s s

b e g i n n i n g ( a t t r i b u t e )0 A 1 A : 1 0 1 L D E , $ l C 0 0 1 s l i n e ' s a d d r e s s

b e g i n n i n g ( a t t r i b u t e )0 A 1 D : 0 1 3 0 0 L B C , $ 0 7 3 0 S c r o l l 2 l i n e s0 A 2 0 : E B L D I R E x e c u t e s c r o l l i n g i c o l o r R A 0 A 2 2 : E E X D E , H L 1 s c h a r o f l a s t l i n e t o H L0 A 2 3 : 1 1 3 1 2 3 L D D E , $ 2 3 3 1 2 n d c h a r a c t e r o l a s t l i n e

( c o l o r R A M )0 A 2 6 : 0 4 0 L B C , $ 0 0 4 F F i l l 7 c h a r a c t e r s0 A 2 9 : 3 0 D 2 4 L A ( $ 2 4 0 D ) G e t c o l o r f o c o l o r R A 0 A 2 C : 7 L ( H L ) s e 0 A 2 D : E B L D I R a n d a l s o f i l l t h r e s t o t h e l i n e0 A 2 F : 1 B J $ 0 9 E 6 O s e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * M o v e c u r s o r l e f t

A ( $ 2 4 0 B ) G e c o l u m n p o s i t i o nS e F l a g sF i r s t c o l u m n ? T h e n e n e l s e m o v e c u r s o r l e f t

( $ 2 4 0 B ) , A S t o r e t h n e w c o l u m n$ 0 9 C D C a l c u l a t e c u r s o r a d d r e s s

0 A 3 1 :0 A 3 4 :0 A 3 5 :0 A 3 6 :0 A 3 7 :0 A 3 A :

3 B C 3 3 1

0

0 9

2

2

L O R E D E L J

2 0

Page 213: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 213/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * M o v e c u r s o r r i g h t

A ( $ 2 4 0 B ) G e c o l u m na n d m o v e i r i g h t

$ 5 H a v e w r e a c h e d t h 8 0 t h c o l u m n ?N Z , $ 0 A 3 7 N o t h e n s t o r e t h en e p o s i t i o ne l s e d o n ' t m o v e t h e c u r s o r

0 A 3 C :0 A 3 F :0 A 4 0 :

0 A 4 2 :

0 A 4 4 :

3 3 F

2

C

O 2

5

F

L I N C

J

R E

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * s e c o l u m n

0 A 4 5 : A 0 A 4 6 : 1 E

X O J $ 0 A 3 7

E r a s e a c c u a n s t o r e a c o l u m n v a l u e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 A 4 8 :0 A 4 B :0 A 4 C :

0 A 4 F :

0 A 5 2 :0 A 5 3 :0 A 5 6 :0 A 5 7 :0 A 5 8 :0 A 5 9 :0 A 5 A :0 A 5 B :0 A 5 C :0 A 5 D :0 A 5 E :0 A 6 0 :

2 E C

1

1 C 7 A C C E 5 5 1 E 1

C

C

0

B

B 1

0

O

1

0

L P U S HC A L L

L

A D C A L LL A N R E P U S HP U S HL L I N L D I RJ

H L , $ 0 B C FH $ 0 C C 2

D E , $ 1 4 0 0

H L , D E$ 0 A B 3A ,

B H D , E , D

$ 0 A 7 E

E r a s e f r o m c u r s o r p o s i t i o nt l i n e e n

R e t u r n a f t e rs i m u l a t i n g $ 0 B C FF i n d o u c u r s o r p o s a n dr e s t o c h a r s / l i n eA d o f f s e t f o 8 0 - c h a r a c t e r s i m u l a t o r

S e f i l l c h a r a c t e r sr e s t o c h a r a c t e r s / l i n eS e F l a g sN m o r e c h a r a c t e r sS a v e n u m b e rS a v e s o u r c e a d d r e s sR e g i s t e r p a i r D e q u a l s H Lp l u sE r a s e u p t o l i n e e n A l s o e r a s e a t t r i b u t e

2 0

Page 214: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 214/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * E r a s e f r o m c u r s o r p o t e n o s c r e e n

0 A 6 2 : 2 1 O C O L

0 A 6 5 :0 A 6 6 :0 A 6 9 :

0 A 6 C :0 A 6 D :0 A 6 E :

0 A 7 0 :0 A 7 1 :0 A 7 2 :0 A 7 4 :0 A 7 5 :0 A 7 6 :

0 A 7 7 :0 A 7 8 :0 A 7 9 :0 A 7 A :0 A 7 B :

0 A 7 E :0 A 8 1 :0 A 8 2 :0 A 8 3 :0 A 8 4 :0 A 8 5 :0 A 8 6 :0 A 8 7 :

0 A 8 A :0 A 8 B :

E 1 7 F I B2 0 2

E A E 5

F E 2 3 4 4 5

5 1 C E C 2 4 O B

0 1 0 0 0 8E 0 C 5 5 1 3 0 D 2 4

7 E B

0 A 8 D : C

P U S HL L

E X O

S B

R E E J L L L

L I N P U S HP U S HC A L L

L P O A D P O L L I N L

L L D I R

R E

H L , $ 0 C 0 C S i m u l a t e $ 0 C 0 C a r e t u r n a d d r e s s

H f o r t h e s t a c kD E , $ 1 B 7 F T h e l a s t l i n e ' s l a s t c o l u m nH L , ( $ 2 4 0 9 ) G e c u r s o r a d d r e s s

8 0 - c h a r a c t e r - S i m u l a t o rD E , H L t D E $ 1 B 7 F t H

E r a s e c a r r y f o s u b t r a c t i o nH L , D E F i n d o c h a r s t o

e n o s c r e e ni n e g a t i v e , t h e r e i e r r o r

D E f H L e l s e g i v e r e s u l t t o D EZ , $ 0 A B 3 I o n l y o n c h a r , t h e n f i l lB , D e l s e n u m b e rC f E i n t o r e g i s t e r p a i r B D , H a n d r e g i s t e r p a i r D

( d e s t i n a t i o n )E , e q u a l s r e g i s t e r p a i r H D E p l u s o n B P u s h n u m b e r t S t a c kH P u s h s o u r c e o n t o S t a c k$ 0 B 2 4 F i l l t e x t l i n e w i t h

a t t r i b u t eB C , $ 0 8 0 0 O f f s e t f o c o l o r R A H R e t r i e v e s o u r c e a d d r e s sH L , B C a n d a d d o f f s e tB G e n u m b e r o c h a r a c t e r sD , H D e s t i n a t i o n a d d r e s s e q u a l sE , L s o u r c e a d d r e s sD E p l u s o n A ( $ 2 4 0 D ) G e c o l o r f o

c o l o r R A M V I C( H L ) , A a n s e c o l o r

f i l l t h e r e s t u t s c r e e n ' s e n dE n o t h r o u t i n e

2 0

Page 215: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 215/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 A 8 E :

0 A 9 1 :0 A 9 2 :

0 A 9 5 :

0 A 9 8 :0 A 9 9 :0 A 9 A :0 A 9 C :0 A 9 D :0 A 9 E :0 A 9 F :O A A O :

0 A A 1 :0 A A 3 :0 A A 4 :0 A A 7 :0 A A 8 :O A A B :O A A C :O A A D :O A A E :O A A F :O A B O :0 A B 2 :

2

E C

2

1 3 2 5 5 2 C D

E E C E 0 0 C 5 5 2 E C

C

C

4

1

B

B

0

B

O

O

1

O

0

L

P U S HC A L L

L

A D D E J L L D E P U S HP U S H

L D D RE C A L LP O L A D P O L L D E L D D RR E

H L , $ 0 B C F

H $ 0 C C 2

H L , $ 1 4 4 F

H L , D E

Z , $ 0 A B 3D , E , H B D

D E , H L$ 0 A B 3H B C , $ 0 8 0 0H L , B CB D , E , H

I n s e r t o n e s p a c e a t h c u r s o r p o s i t i o n

C o p y l i n e f r o m R A Mt s c r e e na r e t u r n a d d r e s s f o S t a c kF i n d o u c u r s o r p o a n r e s t o c h a r a c t e rA d t h l a s t c h a r o f t h ef i r s t l i n et t h e c u r s o r a d d r e s sl a s t c o l u m n ?Y e s , t h e n j u m pE l s e d e s t i n a t i o n g o a l i s o u r c e a d d r e s sm i n u s o n S a v e n u m b e r t s t a c kS a v e d e s t i n a t i o n a d d r e s st S t a c kM o v e c h a r b e h i n d C u r s r i g h tH L : = C u r s o r p o G e t f i l l c h a r a c t e r sR e t r i e v e d e s t i n a t i o n a d d rA d o f f s e t f o c o l o r R A t s o u r c e a d d r e s sR e t r i e v e n u m b e rD e s t i n a t i o n a d d r e s s e q u a l ss o u r c e a d d r e s sm i n u s o n M o v e c o l o r R A a l s oE n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ( $ 2 4 1 0 ) + $ 2 - ( H L ) ; s e t h f i l l c h a r a c t e r s

0 A B 3 :

0 A B 6 :0 A B 8 :0 A B 9 :

3

C 7 C

1

2

2 L

A D L R E

A , ( $ 2 4 1 0 ) r e a d a d d r e s s $ 2 4 1 0( F i l l c h a r a c t e r s )

A , $ 2 0 A d $ 2 0 = 3 2 t o ( H L ) , A a n s t o r e i ( H L )

R E T u r n f r o m r o u t i n e

2 0

Page 216: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 216/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

O A B A :

O A B D :O A B E :

0 A C 1 :

0 A C 4 :0 A C 5 :0 A C 6 :0 A C 8 :0 A C 9 :O A C A :O A C B :O A C C :

O A C D :O A C F :O A D O :0 A D 3 :0 A D 4 :0 A D 7 :0 A D 8 :0 A D 9 :O A D A :O A D B :O A D C :O A D E :

2

E C

1

1 3 2 5 5 C E 2

E E C E 0 0 C 5 5 2 E C

C

C

0

E

B

B

0

B

O

O

1

O

0

L

P U S HC A L L

L

A D D E J L L P U S HP U S HI N

L D I RE C A L LP O L A D P O L L I N L D I RR E

H L , $ O B C F

H $ 0 C C 2

D E , $ 1 4 0 0

H L , D E

Z $ 0 A B 3D , E , B H H

E r a s eD E , H L$ 0 A B 3H G e B C , $ 0 8 0 1H L , B CB D , E , H

E r a s e c h a r a c t e r i C u r s o r p o s i t i o n

G i v e $ 0 B C F a r e t u r na d d r e s s t s t a c ki n s e r t e x t r aG e c u r s o r a d d r e s s /r e s t o c h a r a c t e r sA d o f f s e t f o 8 0 - c h a r a c t e r s i m u l a t o rt C u r s o r a d d r e s sT e s t n u m b e r / c h a r a c t e rI f z e r o , t h e n j u m pe l s e d e s t i n a t i o n a d d r e s ss o u r c e a d d r e s sS a v e n u m b e rS a v e s o u r c e a d d r e s sS o u r c e a d d r e s s i e q u a l t s o u r c e a d d r e s s + 1c h a r i c u r s o r p o s i t i o nC u r s o r a d d r e s s t H S e f i l l c h a r a c t e rs o u r c e a d d r e s sA d o f f s e t f o c o l o r R A M + 1

G e o c h a r s f r o m S t a c kD e s t i n a t i o n a d d r e s s e q u a l ss o u r c e a d d r e s sp l u s o n A l s o m o v e c o l o r R A E n o r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 A D F :0 A E 2 :0 A E 3 :0 A E 6 :0 A E 8 :0 A E A :

A E B :

2 E 3 F 2 D C

O

O 1 3

C

O

2

O

L P U S HL C J R E C A L L

I n s e r t l i n e a c u r s o r p o s i t i o n

H L f $ 0 C 0 C I n s e r t r e t u r n a d d r e s s $ 0 C 0 CH p u s h t s t a c kA ( $ 2 4 0 C ) G e c u r s o r l i n e$ 1 l i n e 2 ( l a s t ) ?Z , $ O B 1 B Y e s , t h e n j u s t e r a s eN C M i s t a k e , t h e n e n $ 0 C C 2 G e c u r s o r a d d r e s s /

2 0

Page 217: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 217/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O A E E : 2 0 1 L

0 A F 1 :0 A F 2 :

0 A F 6 :0 A F 7 :0 A F 8 :O A F B :O A F C :

O A F E :O A F F :0 B 0 0 :

0 B 0 3 :0 B 0 6 :0 B 0 7 :

0 B 0 9 :0 B 0 A :O B O D :0 B 1 0 :0 B 1 2 :0 B 1 3 :0 B 1 4 :0 B 1 5 :0 B 1 6 :0 B 1 9 :0 B 1 B :0 B 1 E :0 B 2 1 :

0 B 2 4 :0 B 2 7 :0 B 2 9 :0 B 2 A :

1 E

1 E 2 8 I A E 5

4 4 2 2 I

1 7 F I BC E B

C 2 2 2 1 7 F 2 3E B E 5 5 1 0 4 0 1 0 2 3 1 3

I I

0 4 0

3 1 2 C 2 7 E B

A D P U S H

0 A F 3 : 1 1 5 0 0 L

0 B 2 C : C 9

A D E L X O S B

L L L

L P U S HL D D R

P O L L L D D RP O L L I N L J L L L

L A D L L D I R

R E

r e s t o c h a r a c t e r sH L f $ 1 4 0 0 A d o f f s e t f o

8 0 - c h a r a c t e r s i m u l a t o rH L , D E t i H L S a v e s o u r c e a d d r e s s

t s t a c kD E , $ 0 0 5 0 A d o f f s e t f o t h b e g i n n i n g o t h n e x t

H L , D E t s t a r t a d d r e s sD E , H L R e s u l t t o ( D E )H L , $ 1 B 8 O L a s t l i n e ' s a d d r e s s

E r a s e c a r r y f o s u b t r a c t i o nH L , D E F i n d o u n u m b e r c h a r s t o

e n o s c r e e nB , H N u m b e r c o m e s f r o mC , L H L t B H L f $ l B 2 F l a s t c o l u m n o

s e c o n d - t o - l a s t l i n eD E , $ 1 B 7 F l a s t c o l u m n o l a s t l i n eB C S a v e n u m b e r t s t a c k

I n s e r t l i n e o nt h c u r s o r l i n e

B C R e t r i e v e n u m b e rH L , $ 2 3 2 F C o l o r R A M ' s a d d r e s sD E , $ 2 3 7 F C o l o r R A M ' s a d d r e s s

a l s o m o v eH G e s o u r c e a d d r e s sD , D e q u a l sE , s o u r c e a d d r e s sD E p l u s o n B C , $ 0 0 4 F 7 c h a r a c t e r s$ 0 B 2 4 E r a s e n e w l i n eH L , $ l B 3 0 O n l y e r a s e t h e l a s tD E , $ 1 B 3 1 l i n eB C , $ 0 0 4 F b e c a u s e c u r s o r i

o n l a s t l i n eA ( $ 2 4 1 0 ) G e t f i l l c h a r a c t e rA , $ 2 0 a d d 3 b l a n k c h a r a c t e r )

( H L ) , A a n s e f i l l c h a r a c t e rf i l l t h r e s t w i t hf i l l c h a r a c t e r sa n e n t h e r o u t i n e

2 0

Page 218: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 218/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 B 2 D :0 B 3 0 :0 B 3 1 :0 B 3 4 :0 B 3 6 :

0 B 3 8 :0 B 3 9 :

0 B 3 C :

0 B 3 F :0 B 4 0 :0 B 4 1 :0 B 4 4 :0 B 4 5 :0 B 4 6 :0 B 4 9 :0 B 4 A :

0 B 4 C :0 B 4 D :0 B 4 E :0 B 4 F :0 B 5 0 :0 B 5 1 :0 B 5 2 :0 B 5 3 :0 B 5 5 :0 B 5 8 :0 B 5 9 :0 B 5 A :0 B 5 B :

0 B 5 C :0 B 5 D :0 B 5 E :0 B 6 0 :

2 E 3 F 2

D C

2

1 E 1 1 E 2 A E

4 4 E D C E D E 0 E 0 E E

0 C E 1

O

O 1 E

C

0

5

8

5

B 0

B B

O

2

O

1

0

I

0

L P U S HL C J

R E C A L L

L

A D P U S HL A D E L X O

S B

L L E P O P U S HP U S HP U S HL D I RL P O A D E P O

A D P O L D I RJ

H L , $ 0 C 0 CH

E r a s e c u r s o r l i n ea n d m o v e s c r e e n

P u s h r e t u r n a d d r e s s $ 0 C 0 Ct s t a c k

A ( $ 2 4 0 C ) G e t c u r s o r l i n e$ 1 Z , $ O B 1 B

N $ 0 C C 2

H L f $ 1 4 0 0

H L , D EH D E , $ 0 0 5 0H L , D ED E , H LH L , $ 1 B 8 O

H L , D E

B , C , D E f H LD B H D

B C , $ 0 8 0 0H H L f B CD E , H LH

H L , B CB

$ O B 1 B

L a s t l i n e ?Y e s , t h e n o n l y e r a s et h l a s t l i n eO N C e r r o r a n d e n C a l c u l a t e c u r s o r a d d r e s s /r e s t o c h a r sA d o f f s e t f o 8 0 - c h a r a c t e r s i m u l a t o rt c u r s o r a d d r e s sS a v e s o u r c e a d d r e s s t s t a kA d o f f s e t f o r s t a r t o t h f o l l o w i n g l i n eR e s u l t t o D Ea d d r e s s s t a t u s l i n eE r a s e c a r r y f o s u b t r a c t i o n

F i n d n u m b e r o c h a r s t e n o s c r e e nn u m b e rt B S t a r t a d d r e s s - > H LG e S t a r t a d d r c u r s o r l i n eS a v e n u m b e r t s t a c kS a v e s o u r c e a d d r e s t s t a c kS a v e g o a l a d d r e s s t s t a c ka n d e r a s e l i n eA d o f f s e t f o c o l o r R A t t h s o u r c e a d d r e s sR e s u l t t D G e t s t a r t a d d r e s s o s e c o n d - t o - l a s t l i n e o c o l o r R A a l s o a d o f f s e tG e n u m b e ra n d a l s o m o v e c o l o r R A E r a s e l a s t l i n e

2 0

Page 219: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 219/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

• • • a * * * * * * * * * * * * * * * * * * * * * * * * * * < B > : o f f , < C > : t u r n e d o B i t so c h a r a c t e r c o l o r

0 B 6 2 :0 B 6 3 :0 B 6 5 :0 B 6 6 :0 B 6 7 :0 B 6 9 :0 B 6 A :0 B 6 D :0 B 6 E :0 B 6 F :0 B 7 0 :0 B 7 1 :0 B 7 4 :0 B 7 5 :0 B 7 7 :

7 E 4 7 E 4 3 2 B 2 B 3 1 E 3

7

7

O 2

O D 2 4

8 1 2

L A N L L A N L L C P O C P O L R L A N L

A , $ 7 B , A , $ 7 C A

( $

$ 8 ( $

0 B 7 A : C R E

T u r n e d o B i t s t < A E r a s e B i u n d B i t s 0 - R e s u l t t < B G e t h s e B i t sA l s o e r a s e b i t s O , l , 2 , 3 f 4 , 7R e s u l t t

A ( $ 2 4 0 D ) G e a t t r i b u t e c o m p l e m e n ts e t t oe r a s e d c h a r a c t e r i s t i c sc o m p l e m e n t a g a i n a n s e t s e c h a r a c t e r i s t i c s

( $ 2 4 0 D ) , A N o t e t h e n e w a t t r i b u t es h i f t 6 t h B i t i n t o 7 t R e v e r s e c h a r a n m a s k

( $ 2 4 1 0 ) , A V a l u e s $ 0 t h r u $ 8 0 a sf i l l c h a r a c t e r sE n o r o u t i n e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 B 7 B :0 B 7 C :0 B 7 E :0 B 8 0 :0 B 8 2 :0 B 8 4 :0 B 8 7 :0 B 8 8 :0 B 8 9 :0 B 8 A :0 B 8 B :0 B 8 C :0 B 8 D :0 B 8 F :0 B 9 0 :

0 B 9 2 :0 B 9 4 :0 B 9 6 :

7 D F 3 0 C D 7 O O O O E 8 F

3 F 3

2 3 0 3 E 0

O

1

2 2 0

L S U C J L C A L LR E L R R C AR R C AR R C AR R C AA N A D

C

J C J

A , $ 2 $ 3 C , $ 0 B 9 0C , $ 3 0$ 0 C E 5

A ( H L )/ / 2 - / 4/ 2 = / 8/ 2 - / 1 6$ 0 A ,

$ 1

C , $ 0 B B D$ 2 C , $ 0 B A 3

G e o u t p u t c h a r s t o < A c c u >M i n u s A S C I I 3 s m a l l e r t h a n 4 8 Y e s , t h e n j u m pe l s e n o t e 4 a t h n u m b e rf u r t h e r c o d i n gE v e r y t h i n g c l e a rG e c o l o r

M a s k s B i t s 4 - a n a d d < B > t i a g a i nT r a n s f e r i n t o t h h i g hv a l u e N i b b l e ?N o d e f i n e n e c o l o rF r a m e o b a c k g r o u n d c o l o rD e f i n e b a c k g r o u n d c o l o r

2 0

Page 220: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 220/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * S e f r a m e c o l o r

$ 0 M a s k B i t s 7 - ( $ 2 4 0 F ) , A a n n o t e f r a m e c o l o r

B C , $ D 0 2 0 A d d r e s s f o f r a m e c o l o r( C ) , A P a s s f r a m e c o l o r t V I

E n o r o u t i n e

0 B 9 8 :0 B 9 A :0 B 9 D :O B A O :0 B A 2 :

E 3 0 E C

O O 2 7

2 D

A N L L O U

R E

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

0 B A 3 :0 B A 5 :0 B A 8 :O B A B :O B A D :

E 3 0 E C

O 0 2 7

2 D

S e b a c k g r o u n d c o l o r f o 4 0 - c h a r a c t e r

A N $ 0 M a s k B i t s 4 - L ( $ 2 4 0 E ) , A a n n o t e b a c k g r o u n d c o l o rL B C , $ D 0 2 1 A d d r e s s f o b a c k g r o u n d c o l o rO U ( C ) , A P a s s b a c k g r o u n d c o l o r t V I

R E E n o r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

O B A E :0 B B 1 :0 B B 2 :0 B B 5 :0 B B 6 :0 B B 9 :O B B A :O B B C :

3 4 3 4 3 5 E C

0

O

0

O

2

2

2

L L L L L L A N R E

G e t : < B > : b a c k g r o u n d ,< C > : f r a m e ,< D > : c h a r a c t e r c o l o r

A , ( $ 2 4 0 E ) G e t b a c k g r o u n d c o l o rB , n o t e i < B A ( $ 2 4 0 F ) G e t f r a m eC , N o t e i < C A ( $ 2 4 0 D ) G e t c h a r c o l o rD , N o t e i < D $ 0 M a s k u n i m p o r t a n t b i t s 7 -

E n o r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * D e f i n e n e w c o l o r

B , C o d e t < B A ( $ 2 4 0 D ) G e t o l d c o l o r$ F G e t B i t s t

a n d n e w c o l o r( $ 2 4 0 D ) , A S t o r e n e c o l o r

H L , ( $ 2 4 0 9 ) G e t c u r s o r a d d r e s sD E , $ 0 8 0 0 A d o f f s e t f o

R A a t t r i b u t e

O B B D :O B B E :0 B C 1 :0 B C 3 :0 B C 4 :0 B C 7 :O B C A :

4 3 E B 3 2 1

0 F

0 0 0

2

2 2 0

L L A N O L L L

2 0

Page 221: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 221/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O B C D : 1 O B C E : 7

A D L

H L , D E( H L ) , A S e n e w c o l o r

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o p y l i n e f r o m R A t s c r e e n

O B C F : 3 0 2 L A ( $ 2 4 0 4 ) M a r k e r f o r o u t p u t0 B D 2 : 4 L B , i n t o < B 0 B D 3 : B O S e F l a g s0 B D 4 : F 3 0 C A L L M $ 0 C 3 C I b i i s s e t ,

t h e n p a y a t t e n t i o n0 B D 7 : 3 0 2 L A ( $ 2 4 0 2 ) G e t c o l u m n c o n s i d e r e dO B D A : B 8 C e q u a l t 8 0 - c h a r c o l u m n ?O B D B : 3 2 0 4 2 L ( $ 2 4 0 4 ) , m a r k c o l u m nO B D E : 2 2 J R N Z , $ 0 C 0 C d i f f e r e n t , t h e n j u m p0 B E 0 : C C 2 0 C C A L L $ 0 C C 2 C a l c u l a t e c u r s o r p o s i t i o n0 B E 3 : 2 1 0 0 1 4 L H L , $ 1 4 0 0 A d o f f s e t $ 1 4 0 00 B E 6 : 1 A D D H L , D E0 B E 7 : E B E X D E , H L a n m a r k i D 0 B E 8 : 2 0 2 L H L ( $ 2 4 0 2 ) a d t h c o l u m n

b e i n g c o n s i d e r e d0 B E B : 1 A D D H L , D E g i v e s d e s t i n a t i o n a d d r e s s0 B E C : E P U S H H s a v e t o s t a c k0 B E D : 3 0 2 L A ( $ 2 4 0 C ) G e t l i n e0 B F 0 : 6 L L , A a n d i n t o < L 0 B F 1 : C 7 0 C A L L $ 0 C 7 0 C a l c u l a t e l i n e s t a r t

f o 4 0 - c h a r0 B F 4 : E E X D E , H L a n d n o t e i D 0 B F 5 : E P O P H L G e a d d r e s s c o n s i d e r e d0 B F 6 : E P U S H H a n s a v e a g a i n0 B F 7 : D P U S H D s a v e l i n e b e g i n n i n g0 B F 8 : 3 0 L A , $ 0 1 C o p y l i n e0 B F A : C 2 0 C A L L $ 0 C 2 7 C o p y ( $ 1 4 0 0 + S P ) t s c r e e n0 B F D : E P O P H L 4 0 - c h a r a c t e r a d d r e s s b a c k0 B F E : 0 0 E L B C , $ E 4 0 0 O f f s e t f o c o l o r R A 0 C 0 1 : 0 A D H L , B C A d o f f s e t0 C 0 2 : E E D E , H L a n d n o t e i D 0 C 0 3 : E P O H G e s o u r c e a d d r e s s0 C 0 4 : 0 0 0 L B C , $ 0 8 0 0 O f f s e t s c r e e n c o l o r R A 0 C 0 7 : 0 A D D H L , B C A d t s o u r c e a d d r e s s0 C 0 8 : 3 0 L A , $ 0 1 l i n e0 C 0 A : 1 I J $ 0 C 2 7 a n d c o p y

2 0

Page 222: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 222/316

Page 223: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 223/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 C 4 3 : A X O e l s e e r a s e a c c u ( = 0 )0 C 4 4 : E 6 F 8 A N $ F M a s k B i t s 0 - 0 C 4 6 : 3 0 2 L ( $ 2 4 0 2 ) , A N o t e t h c o l u m n

b e i n g c o n s i d e r e d0 C 4 9 : C R E E n o t h r o u t i n e

• • a * * * * * * * * * * * * * * * * * * * * * * * * * * * * C o p y l i n e

0 C 4 A :0 C 4 D :0 C 5 0 :

0 C 5 3 :0 C 5 4 :0 C 5 7 :

C C 3

4 2 7

6 C 0

0

O 0 2

2

C C L

L L L

$ 0 C 6 9 E r a s e $ 2 4 0 6$ 0 B C F C o p y l i n eA ( $ 2 4 0 2 ) G e c o l u m n b e i n g c o n s i d e r e d

B , A W r i t e i < B H L , ( $ 2 4 0 B ) G e t l i n e / c o l u m n

0 C 5 8 : 9 S U

A

0 C 5 9 :0 C 5 B :0 C 5 D :0 C 5 F :0 C 6 0 :0 C 6 2 :0 C 6 3 :

0 C 6 6 :0 C 6 7 :0 C 6 9 :

0 C 6 C :0 C 6 F :

3 F 3 4 0 6 C

0 1 2

2 C

0 2 0

0

7 0

0 0 0 0 0

0 6 2 4

J C J L L L C A L L

A D J L

L R E

C , $ 0 C 6 9$ 2 N C , $ 0 C 6 9C , B $ 0 L , $ 0 C 7 0

H L , B C$ 0 C 6 CH L , $ 0 0 0 0

( $ 2 4 0 6 ) ,

c o l u m n i n t o < A > f o s u b t r a c t i o nm i n u s c o l u m n b e i n gc o n s i d e r e dt o s m a l l , t h e n e r a s e $ 2 4 0 6t o b i g — b i g g e r t h a n 4 0 t h e n e r a s e $ 2 4 0 6c o l u m n i n t o < C >E r a s e H i - B y t e f r o m B < L > = l i n eA n c a l c u l a t e l i n e ■ sS t a r t a d d r e s sa d c o l u m na n n o t e t h a d d r e s sS t a r t a d d r e s s i 1 s P o s i t i o n

' I n o t e t h P o s i t i o nE n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * l i n e M O O f f s e t

0 C 7 0 :0 C 7 2 :0 C 7 3 :0 C 7 4 :0 C 7 5 :0 C 7 6 :

2 0 2 2 2 5 5

L A D A D A D L L

H , $ 0 0H L , H LH L , H LH L , H LD , E ,

E r a s e H i - B y t e* * * 2 = * 8w r i t e t D

2 1

Page 224: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 224/316

A b a c u s S o f t w a r e

0 C 7 7 :0 C 7 8 :0 C 7 9 :0 C 7 A :0 C 7 D :0 C 7 E :

2 2 1 1 0 2 1 C

A D A D A D L A D R E

C - 1 2 8 C P / M U s e r ' s G u i d e

H L , H L * H L , H L * 2 = * 3 2H L , D E * 3 2 + * 8 g i v e s * 4 D E , $ 2 C 0 0 A d o f f s e t f r o m $ 2 C 0 0H L , D E ( b e g i n n i n g o f t e x t )

E n o t h e r o u t i n e

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A d a p t i n g A S C I I — C o d ef o 4 0 - c h a r a c t e r s c r e e n

c h a r a c t e r i n t o < a c c u >I i A S C I I 6 ( @ Y e s , t h e n P o k e - C o d e = 0I s m a l l e r , t h e n e n ds m a l l e r t h a n A S C I I M Z " + 1 ?Y e s , t h e n r e t u r nS u b t r a c t 6 I s i t a a p o s t r o p h e ?Y e s , t h e n c o d es m a l l e r t h a n a a p o s t r o p h em i n u s A S C I I 3 s m a l l l e t t e r ' s b o a r d e rS m a l l e r , t h e n e n c o m p a r e a g a i ns m a l l A S C I I " { " ?s m a l l " I " ?Y e s , t h e n c o d es m a l l " } " ?Y e s , t h e n c o d eI s i t " ~ " ?N o t h e n r e t u r ne l s e c o d e 6 E n o t h e r o u t i n e

0 C 7 F :0 C 8 0 :0 C 8 2 :0 C 8 4 :0 C 8 5 :0 C 8 7 :0 C 8 8 :0 C 8 A :0 C 8 C :0 C 8 E :0 C 9 0 :0 C 9 2 :0 C 9 4 :0 C 9 5 :0 C 9 7 :0 C 9 9 :0 C 9 B :0 C 9 D :0 C 9 F :0 C A 1 :0 C A 3 :0 C A 4 :0 C A 6 :

7 F 2 D F D D F 2 3 D F D F 2 F 2 F 2 F C 3 C

4 3

5

4 2 1 2 2 I

I 1 1 1 I O I

4

L C J R E C R E S U C J J S U C R E C J C J C J C R E L R E

A , $ 4 Z , $ 0 C C 0

$ 5

$ 4 $ 2 Z , $ 0 C A 7C , $ 0 C B 3$ 2 $ 1

$ 1 Z , $ 0 C A A$ 1 Z , $ 0 C A D$ 1 Z , $ 0 C B 0$ 1 N A $ 4

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - C o d e 1 2

0 C A 7 : 3 E 7 E L D A , $ 7 E 1 2 0 C A 9 : C 9 R E E n o t h r o u t i n e

2 1

Page 225: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 225/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - C o d e 1 1

O C A A : 3 E 7 3 L A $ 7 1 1 O C A C : C 9 R E E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - C o d e 9

O C A D : 3 E 5 D L D A , $ 5 D 9 O C A F : C 9 R E E n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - C o d e 1 0

0 C B 0 : 3 E 6 L A $ 6 1 0 0 C B 2 : C 9 R E E n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - C o d e 2

0 C B 3 : F 1 C $ 1 A S C I I 2 8 0 C B 5 : 2 0 J Z , $ 0 C B D Y e s , t h e n a s s i g n0 C B 7 : F I C P $ 1 F A S C I I 3 1 0 C B 9 : C R E N N o t h e n e n w i t h F l a gO C B A : 3 6 L A , $ 6 4 E l s e A S C I I 1 0 0 C B C : C R E E n o t h e r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A s s i g n A S C I I - C o d e 1 2

0 C B D : 3 7 F L A $ 7 1 2 0 C B F : C R E E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * E r a s e < a c c u >

0 C C 0 : A X O R A E r a s e < A c c u >o c c l : C 9 R E E n o t h e r o u t i n e

2 1

Page 226: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 226/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C a l c u l a t e < C > : 7 9 - c o l u m na n C u r s o r p o s .

H L , ( $ 2 4 0 B ) G e t l i n e / c o l u m n$ 0 C C A c o n t i n u eH L ( $ 2 4 1 3 ) G e t l i n e / c o l u m nA $ 4 i n t e g e r

m i n u s c o l u m nC , N o t e i < C ( o t h e r n u m b e r s

u n t i l 8 0

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C a l c u l a t e c u r s o r p o s i t i o n< H > : l i n e , < L > : c o l u m n

0 C C 2 :0 C C 5 :0 C C 7 :O C C A :O C C C :O C C D :

2 1 2 3 9 4

O 0 1 4

2

2

L J L L S U L

O C C E :O C C F :0 C D 00 C D 2 :0 C D 3 :0 C D 4 :0 C D 5 :0 C D 6 :0 C D 70 C D 8 :0 C D 9 :O C D A :O C D B :O C D C :O C D D :O C D F :0 C E 0 :0 C E 2 :

4 6 2 0 2 2 2 2 5 5 2 2 1 E 6 2 0 1 0 0 3

0 C E 3 : C 9

L B , < B e q u a l s c o l u m nL L , < L i n o l i n eL H , $ 0 0 E r a s e H i - B y t eA D H L , H L * A D H L , H L * A D H L , H L * A D H L , H L * 2 = * 1 6L D , H < D E > w i l l b e o c c u p i e d b L E , l i n e t i m e s 1 A D H L , H L * A D H L f H L * g i v e s * 6 A D D H L , D E p l u s * 1 g i v e s * 8 E X D E , H L l i n e t i m e s 8 i n t o < D E >L L , c o l u m n i n t o < L >L H , $ 0 0 E r a s e H i - B y t eA D H L , D E a n d a d d l i n e * 8 0L B , $ 0 0 E r a s e H i - B y t e f r o m < B C >I N < A > : = a c t u a l n u m b e r o

p o s s i b l e c h a r a c t e r sR E E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * A S C I I - D e c o d i n g C o n t ? d

0 C E 4 : 7 L 0 C E 5 : 2 0 F L 0 C E 8 : D 3 S U

A , B c h a r a c t e r t < A c c u >H L , ( $ F D 0 D ) T a b l e p o i n t e r$ 3 M i n u s A S C I I 4 " 0

2 1

Page 227: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 227/316

A b a c u s

O C E A :O C E B :

O C E C :O C E D :O C E E :O C E F :O C F 1 :0 C F 2 :0 C F 4 :O C F 5 :0 C F 6 :0 C F 8 :0 C F 9 :

S o f t w a r e

D B

3 D 4 E O 5 1 6 0 01 7 E 3 4 C

R E C

C C R E L A N L L A D L A N L R E

B , $ 0 E D , $ 0 0H L , D EA , $ 3 B ,

C - 1 2 8 C P / M U s e r ' s G u i d e

S m a l l e r , t h e n e n E l s e c o m p a r e w < C

( v a l u e t a k e n o f f )N e g a t e C a r r y - F l a ga n e n i g r e a t e r t h a n o E l s e c h a r a c t e r i n t o < B M a s k B i t s 0 - L o - B y t e e q u a l s < A c c u >a n e r a s e H i - B y t ea d t t a b l e b a s i sc h a r a c t e r a g a i n i n t o < A c c u >M a s k B i t s 6 , a n 0 - c h a r a c t e r a g a i n i n t o < B E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R i n g i n g o u t h e t o n e

0 C F A :0 C F D :0 D 0 0 :

0 D 0 2 :0 D 0 4 :0 D 0 6 :

0 D 0 9 :0 D 0 A :0 D 0 C :0 D 0 E :0 D 1 00 D 1 3 :0 D 1 5 :0 D 1 7 :0 D 1 9 :

0 1 D 4 L D B C , $ D 4 1 8 S I R e g i s t e r 2 2 1 F L H L , ( $ F D 1 0 ) G e t A t t a c k / D e c a y / V o l u m eE 6 O U ( C ) , H T o t a l l o u d n e s s

s t r e n g t h / F i l t e rC , $ 0 5 D e f i n e R e g i s t e r S I D :

( C ) , L A t t a c k / D e c a yH L , ( $ F D 1 2 ) G e t S u s t a i n /

R e l e a s e / F r e q u e n c yR e g i s t e r o f S I D

( C ) , H D e f i n e S u s t a i n / R e l e a s eC , $ 0 1 R e g i s t e r o S I D : F r e q u e n c y( C ) , L D e f i n e F r e q u e n c y ( H I )

0 0 L E 6 O U 2 1 F L

0 I N E 6 O U 0 0 L E 6 O U 2 1 F L O 0 L E 6 O U E 6 O U C R E

H L , ( $ F D 1 4 ) G e t t u r n o f f / o nC , $ 0 4 R e g i s t e r o f S I D( C ) , H T u r n i n g o t h t o n e( C ) , L E r a s e B i t t o S u s t a i n

E n o t o n e r i n g i n g r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * w i l l b c o p i e d t $ n o o

0 D 1 A : 1 1 0 0 : A 0 0 D 1 C : 1 1 0 2 : 8 0 F 0 D 1 F : 1 1 0 5 : 6 F F

L D # $ 0 0 S e t c o n f i g u r a t i o n b y t eS T $ F F 0 0 ( a l l R O M )J M ( $ F F F C ) R e s e t t h e C - 1 2 8 - M o d e

2 1

Page 228: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 228/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * W i l l b c o p i e d t o $ 3 0 0 0R e a d d i s k b l o c k

S t i l l a r e n ' ta n y e r r o r sL o a d t h B l o c kI n t e r r u p t h a n d i c a pR A a n d S y s t e m I / a c o n f i g u r a t i o n b y t ea n d t u r n o n Z - 8 0E r a s e d e c i m a l f l a gS e f l a g f o v e c t o r se r a s e d ?T u r n o R O a n d S y s t e m I /

E r a s e I M R i V I C - C h i pS t a r t u p r o u t i n e ' s L o - B y t ea n d H i - B y t e t h e s a m eL o - B y t e a I R Q - R o u t i n eH i - B y t e a I R Q - R o u t i n eL o - B y t e a B R K - R o u t i n eH i - B y t e a B R K - R o u t i n eL o - B y t e a N M I - R o u t i n eH i - B y t e a N M I - R o u t i n eC o n t i n u e o n $ 3 0 D 7

0 D 2 2 :0 D 2 4 :0 D 2 7 :0 D 2 A :0 D 2 B :0 D 2 D :0 D 3 0 :0 D 3 3 :0 D 3 4 :0 D 3 7 :0 D 3 9 :0 D 3 B :0 D 3 E :0 D 4 1 :0 D 4 3 :0 D 4 4 :0 D 4 8 :0 D 4 B :0 D 4 E :0 D 5 1 :0 D 5 4 :0 D 5 7 :

3 0 0 0 :3 0 0 2 :3 0 0 5 :3 0 0 8 :3 0 0 9 :3 0 0 B :3 0 0 E :3 0 1 1 :3 0 1 2 :3 0 1 5 :3 0 1 7 :3 0 1 9 :3 0 1 C :3 0 1 F :3 0 2 1 :3 0 2 3 :3 0 2 6 :3 0 2 9 :3 0 2 C :3 0 2 F :3 0 3 2 :3 0 3 5 :

A 8 2 7 A 8 4 D A D A 8 8 A A 8 8 8 8 8 8 4

0 0 1

3 0 D

0 2 0 0 1 6 3 1 1 1 1 1 1 D

F 3

F F

F

F D

0 0 0 0 0 0 3

L D S T J S S E L D S T J M C L L D B N L D S T S T L D L D S T S T S T S T S T S T J M

# $ 0 0$ F D 0 6$ 3 0 1 1

# $ 3 E$ F F 0 0$ F F D 0

$ F D 0 1$ 3 0 3 8# $ 0 0$ F F 0 0$ D 0 1 A# $ 6 3# $ 3 1$ 0 3 1 4$ 0 3 1 5$ 0 3 1 6$ 0 3 1 7$ 0 3 1 8$ 0 3 1 9$ 3 0 D 7

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * R e a d f o r m B l o c k( T r a c k / S e c t o r ) a n

l o a d i m e m o r y

C o p y L o - B y t e ' sd e s t i n a t i o n a d d r e s s

t $ 2 a n H i - B y t e ' s d e s t i n a t i o n a d d rt $ 2 G e t r a c ka n c o p y i d i s k c o m m a n dM a k e o u o < A c c u >

A S C I I " x x "T e n ' s p l a c e T r a c k a n o n e ' s p l a c e T r a c k i

c o m m a n d l i n e

0 D 5 A :

0 D 5 D :0 D 5 F :0 D 6 2 :0 D 6 4 :0 D 6 7 :0 D 6 A :

0 D 6 D :0 D 7 0 :

3 0 3 8 :

3 0 3 B :3 0 3 D :3 0 4 0 :3 0 4 2 :3 0 4 5 :3 0 4 8 :

3 0 4 B :3 0 4 E :

A

8 A 8 A 8 2

8 8

1

2 1 2 0 B 7

B B

F

F

F 3 3

3 3

L D

S T L D S T L D S T J S

S T S T

$ F D 1 8

$ 2 $ F D 1 9$ 2 $ F D 0 3$ 3 1 B F$ 3 1 7 8

$ 3 1 B 1$ 3 1 B 0

2 1

Page 229: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 229/316

Page 230: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 230/316

A b a c u s

0 D C 9 :O D C C :O D C F :O D D 2 :0 D D 5 :0 D D 7 :O D 9 O D D B :O D D E :O D E O :O D E 1 :0 D E 3 :0 D E 5 :0 D E 6 :0 D E 8 :O D E B :O D E D :O D F O :0 D F 1 :0 D F 3 :0 D F 6 :0 D F 9 :O D F B :O D F C :O D F F :O E O 1 :0 E 0 3 :0 E 0 6 :0 E 0 7 :

O E O A :O E O C :O E O F :O E 1 O :0 E 1 3 :0 E 1 50 E 1 70 E 1 9

0 E 1 C0 E 1 F0 E 2 10 E 2 4

S o f t w a r e

3 0 A 7 :3 0 A A :3 0 A D :3 O B O :3 0 B 3 :3 O B 5 :3 0 B 7 :3 0 B 9 :3 0 B C :3 0 B E :3 0 B F :3 O C 1 :3 0 C 3 :3 O C 4 :3 0 C 6 :3 0 C 9 :3 0 C B :3 0 C E :3 0 C F :3 O D 1 :3 0 D 4 :3 0 D 7 :3 0 D 9 :3 0 D A :

O D D :3 0 D F :3 0 E 2 :3 0 E 4 :3 O E 5 :

3 0 E 8 :3 0 E A :3 0 E D :3 0 E E :3 0 F 1 :3 O F 3 :3 0 F 5 :3 0 F 7 :

3 0 F A :3 0 F D :3 0 F F :3 1 0 2 :

2 2 A 2 2 D A 2 9 C D E C D A 2 8 6 A 8 4 A 1 2 A 8 A A 2

A 8 A 2 A A A 2

2 B 2 2 P

C O B 4 O D 0 4 2

F 2

E 0 E 0

O 0 0 O

C O 0 0

B

0 1

6 0 B 3 B

C D B

F D 3 3

3

D

D

F 3

F

F

F

O

F

F

F

F

J S B I L D J S A N B N L D J S S T I N B N I N D E B N L D A N S T R T L D S T J M L D C L J S L D S T L D T A J S

L D S T T A J S L D L D L D J S

J S B C J S R O

$ F F C C$ D C 0 D$ 3 1 B D$ 3 1 4 F# $ 0 E$ 3 0 8 8# $ 0 0$ 3 1 4 F( $ 2 0 ) ,

$ 3 0 B 9$ 2

$ 3 0 B 0$ D D 0 0# $ E F$ D D 0 0

# $ 0 F$ F D 0 6$ 3 0 0 8# $ 0 F

$ F F C 3# $ 0 F$ F D 0 8# $ 0 8

$ F F B A

# $ 0 0$ O A 1 C

$ F F 6 8# $ 0 4# $ B 8# $ 3 1$ F F B D

$ F F C 0$ 3 0 C F$ F F B 7

C - 1 2 8 C P / M U s e r ' s G u i d e

C L R C H ; I / O n o r m a l a g a i nT e s t I C N u m b e r o d a t a b l o c k sG e D a t a b y t e ( F a s t - m o d e )T e s t B i t s 1 - E r r o r s t e pI n d e x t o z e r oG e D a t a b y t e ( F a s t - M o d e )

Y P u t c h a r a c t e r s i R A i n c r e m e n t t h p o i n t e rS t i l l n o t a l t h e c h a r sI n c r e m e n t p o i n t e r ' s H i - B y t eD e c r e m e n t t h b l o c k c o u n t e rF u r t h e r B l o c k sG e P R C I A 2M a s k C L K - B i ta n b a c k a g a i nE n o t h r o u t i n eP u L o g i c a l F i l e n u m b e r 1 i $ F D 0 6T u r n o n Z - 8 0L o g i c a l f i l e n u m b e rE r a s e c a r r y a F l a gT u r n o f f t h e c h a n n e lL o g i c a l f i l e n u m b e rN o t e l o g i c a l f i l e n u m b e rD e v i c e a d d r e s s1 a s e c o n d a r y a d d r e s sS E T L F S ; S e t h l o g i c a l

f i l e p a r a m e t e r sT u r n o f f t h ef l o p p y ' s f a s t m o d eS e b o t h c o n f i g . i n d i c e sf o S E T B N K t z e r oL o n g F i l e n a m eF i l e n a m e ' s L a d d r e s sF i l e n a m e ' s H a d d r e s sS E T N A M ; s e

F i l e n a m e p a r a m e t e rO P E N t h e f i l ee r r o r w a l k , t h e n j u m pg e S t a t u s b y t e I / S h i f t B i t i C a r r y

2 1

Page 231: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 231/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 E 2 5 :0 E 2 7 :0 E 2 A :0 E 2 C :0 E 2 E :0 E 2 F :0 E 3 2 :0 E 3 4 :0 E 3 6 :0 E 3 8 :0 E 3 B :0 E 3 D :0 E 4 0 :0 E 4 1 :0 E 4 4 :0 E 4 6 :0 E 4 8 :0 E 4 A :0 E 4 D :0 E 5 0 :0 E 5 2 :

3 1 0 3 :3 1 0 5 :3 1 0 8 :3 1 0 A :3 1 0 C :3 1 0 D :3 1 1 0 :3 1 1 2 :3 1 1 4 :3 1 1 6 :3 1 1 9 :3 1 1 B :3 1 1 E :3 1 1 F :3 1 2 2 :3 1 2 4 :3 1 2 6 :3 1 2 8 :3 1 2 B :3 1 2 E :3 1 3 0 :

B 2 7 A 1 2 A A A 2 A 8 A 2 A A A 2 2 B 6

C 1 2 O

C O 0 0 B 0 0

6 0 B 3 B C 9

O

F

F

F

F

F F

B C B I B V L D C L J S L D L D L D J S L D S T T A J S L D L D L D J S J S B C R T

$ 3 0 C F$ O A 1 C$ 3 1 3 0# $ 0 B

$ F F C 3# $ 0 B# $ 0 8# $ 0 8$ F F B A# $ 0 0$ F D 0 8

$ F F 6 8# $ 0 1# $ B C# $ 3 1$ F F B D$ F F C 0$ 3 0 C F

e r r o r w a l k , t h e n j u m pT e s t t h e F a s t - S e r i a l - B i tJ u m p i f i t i s e L o g i c a l F i l e n u m b e r 1 E r a s e c a r r y a f l a gC l o s e f i l e 1 L o g i c a l f i l e n u m b e r 1 D e v i c eS e c o n d a r y a d d r e s sS E T L F S ; S t o r e F i l e d a t aL F a n o o p e n e dE r a s e o n $ F D 0 8B o t h c o n f i g u r a t i o n i n d i c e sa r z e r o ; S E T B N KL e n g t h o t h e F i l e n a m eL o - B y t e o t h F i l e n a m e nH i - B y t e o t h F i l e n a m e nS E T N A M ; s e a d d r F i l e n a m eO P E N 1 1 , 8 , 8 , " # " ; o p e n f i l ee r r o r w a l ke l s e E n o t h r o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * T r a c k / S e c t o r0 E 5 3 :0 E 5 6 :

0 E 5 8 :0 E 5 B :0 E 5 E :0 E 5 F :0 E 6 1 :0 E 6 4 :0 E 6 7 :0 E 6 9 :0 E 6 B :0 E 6 E :

3 1 3 1 :3 1 3 4 :

3 1 3 6 :3 1 3 9 :3 1 3 C :3 1 3 D :3 1 3 F :3 1 4 2 :3 1 4 5 :3 1 4 7 :3 1 4 9 :3 1 4 C :

2 A

B 2 8 D 2 2 F A 8 4

A 0

A D

F C 8 0 0 0 C

3

3 F

F 3

F F

J S L D

L D J S D E B N J S J S B E L D S T J M

$ 3 1 A 4# $ 0 D

$ 3 1 A B ,$ F F D 2

$ 3 1 3 6$ F F C C$ 3 1 8 9$ 3 1 4 C# $ 0 D$ F D 0 6$ F F C C

S e c m m n d c h a n n e l t o u t p u tO u t p u t 1 c h a r a c t e r

t f U l : 8 t s s < C R > "Y G e t c h a r s f r o m t a b l e

a n o u t p u tD e c r e m e n t c o u n t e r ,j u m p i t h e r a r m o r e c h a r sC L R C H ; I / i n o r m a l a g a i nO p e n c m m n d c h a n n e l f o r e a dn e r r o r w a l kS e E r r o rm a r k e rC L R C H ; I / O n o r m a l a g a i n

2 1

Page 232: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 232/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * W a i t u n t i l S D ( S e r i a l D a t a R e g i s t e r )i d o n e , t h e n g e d a t a b y t e

P r e v e n t i n t e r r u p t i o n sG e P R C I A 2N e g a t e C l o c k m a n a g e m e n tN e g a t e r u b a c kS D R f u l l / e m p t y - B i tS D i s n ' t f i n i s h e d y e W a i t u n t i l t i m e r i l o G e S D ( S e r i a l D a t a R e g )E n o t h e r o u t i n eE r a s e I n t e r r u p t r e i C I A lE r a s e I n t e r r u p t r e i C I A 2E r a s e I n t e r r u p t r e g i s t e ro t h V I C - C h i pR e m a n u f a c t u r ec o n f i g u r a t i o nR e m a n u f a c t u r eY - R e g i s t e rR e m a n u f a c t u r eX - R e g i s t e rR e m a n u f a c t u r e a c c uE n o t h

I n t e r r u p t - R o u t i n e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * M a k e o u o f < A c c u >A S C I I - C o d e s

0 E 7 1 :0 E 7 2 :0 E 7 5 :0 E 7 7 :0 E 7 A :0 E 7 C :0 E 7 F :0 E 8 1 :0 E 8 4 :0 E 8 5 :0 E 8 8 :0 E 8 B :0 E 8 D :0 E 9 0 :0 E 9 1 :0 E 9 4 :0 E 9 5 :0 E 9 6 :0 E 9 7 :0 E 9 8 :0 E 9 9 :

3 1 4 F :3 1 5 0 :3 1 5 3 :3 1 5 5 :3 1 5 8 :3 1 5 A :3 1 5 D :3 1 5 F :3 1 6 2 :3 1 6 3 :3 1 6 6 :3 1 6 9 :3 1 6 B :3 1 6 E :3 1 6 F :3 1 7 2 :3 1 7 3 :3 1 7 4 :3 1 7 5 :3 1 7 6 :3 1 7 7 :

7 A 4 8 A 2 F A 6 A A A 8 6 8 6 A 6 A 6 4

0 1 0 0 0 F O

0 0 O 1

0

D

D

D

D

D D

D

F

S E L D E O S T L D B I B E L D R T L D L D L D S T P L S T P L T A P L T A P L R T

# $ D D 0 0# $ 1 0$ D D 0 0# $ 0 8$ D C 0 D$ 3 1 5 A$ D C 0 C

$ D C 0 D$ D D 0 D# $ 0 F$ D 0 1 9

$ F F 0 0

0 E 9 A : 3 1 7 8 : D 0 E 9 B : 3 1 7 9 : A 3 0 E 9 D : 3 1 7 B : 3

0 E 9 E : 3 1 7 C : E 9 0 A0 E A 0 : 3 1 7 E : 9 0 0 E A 2 : 3 1 8 0 : E 80 E A 3 : 3 1 8 1 : B F 0 E A 5 : 3 1 8 3 : 6 3

0 E A 7 : 3 1 8 5 : 6

C L L D S E

S B B C I N B C A D

# $ 3 0

# $ 0 A$ 3 1 8 3

$ 3 1 7 C# $ 3 A

R T

E r a s e d e c i m a l f l a gT e n ' s p l a c e i n o " 0 S e c a r r y f l a gf o s u b t r a c t i o nS u b t r a c t t e n ( t e s t )T o m u c h s u b t r a c t e de l s e i n c r e m e n t t e n ' s p l a c ea n d i a g a i nC o r r e c t e r r o r a n d a d dA S C I I - B a s i sE n o t h e r o u t i n e

2 2

Page 233: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 233/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C h e c k i t h e r e a r e r r o r si c o m m a n d c h a n n e l

e r r o r w a l k i c h a n n e l 1 O p e n c o m m a n d c h a n n e l f o r e a d i n g ; C H K I Ne r r o r w a l kB A S I N ; g e t c h a r a c t e rC o m p a r e a c c u w i t h " 0

( t h e n O K E n o t h r o u t i n e

0 E A 8 :O E A B :O E A D :0 E B 0 :0 E B 2 :0 E B 5 :

3 1 8 6 :3 1 8 9 :3 1 8 B :3 1 8 E :3 1 9 0 :3 1 9 3 :

2 A 2 B 2 C

D O C F C 3

3

F

F

J S L D J S B C J S C M

$ 3 0 D 7# $ 0 F$ F F C 6$ 3 1 8 6$ F F C F# $ 3 0

0 E B 7 : 3 1 9 5 : 6 R T

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * P r e p a r e c h a n n e l 1 ( # f o r e a d i n g

E r r o r w a l k i c h a n n e l 1 S e c h a n n e l 1 t i n p u t ; C H K I NE r r o r w a l kE n o t h r o u t i n e

0 E B 8 :0 E B B :0 E B D :0 E C 0 :0 E C 2 :

3 1 9 6 :3 1 9 9 :3 1 9 B :3 1 9 E :3 1 A 0 :

2 A 2 B 6

0 0 C F

3

F

J S L D J S B C R T

$ 3 1 0 A# $ 0 B$ F F C 6$ 3 1 9 6

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * C h a n n e l 1 5 ( c o m m a n d c h a n n e l )t o o u t p u t

0 E C 3 :0 E C 6 :0 E C 8 :

0 E C B :0 E C D :

0 E C E :0 E D 6 :0 E D E :

3 1 A 1 :3 1 A 4 :3 1 A 6 :

3 1 A 9 :3 1 A B :

3 1 A C :3 1 B 4 :3 1 B C :

2 A 2

B 6

0 2 2

D O C

F

7 3 0

3

F

7 3 0

J S L D J S

B C R T

2 0 7 43 5 0 0 0 0

$ 3 0 D 7# $ 0 F$ F F C 9

$ 3 1 A 1

7 4 2 03 4 3 0 5 5

E r r o r w a l k i c h a n n e l 1 C h a n n e l 1 a o u t p u t c h a n e lD e f i n e t h r o u g h

C K O U T - R o u t i n eE r r o r w a l kE n o t h r o u t i n e

3 . s t 0 8 : 1 U O L .

O * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * w i l l b c o p i e d t o $ F F D o

( 8 5 0 2 - C o d e )

0 E E 5 : ( $ F F D 0 ) 7 0 E E 6 : ( $ F F D 1 ) A 3 0 E E 8 : ( $ F F D 3 ) 8 0 F

S E P r e v e n t i n t e r r u p t i o n sL D # $ 3 E S e c o n f i g b y t e t $ 3 S T $ F F 0 0 R A a n S y s t e m I /

2 2

Page 234: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 234/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O E E B :O E E D :O E F O :0 E F 1 :0 E F 4 :

( $ F F D 6 ) A B L D # $ B 0 T u r n o Z - 8 0( $ F F D 8 ) 8 D 0 D S T $ D 5 0 5 i M C ( $ F F D B ) E N O P W a i t w o r k( $ F F D C ) 4 0 0 3 0 J M $ 3 0 0 0 J u m p i n e x t r o u t i n e p a r t( $ F F D F ) E N O B u f f e r

a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * W i l l b c o p i e d t $ F F E 0

C u o f f I n t e r r u p t i o n sA $ 3 E S e t C o n f i g u r a t i o n

( $ F F 0 0 ) , A b y t eB C , $ D 5 0 5 M o d e - C o n f i g . - R e g i s t e rA , $ B 1 a n d t u r n o 8 5 0 2

( C ) , A b s e t t i n g B i t - 0B u f f e r w o r k

$ 0 J u m p i n t o Z - 8 0 p a r t

0 E F 5 :0 E F 6 :0 E F 8 :0 E F B :0 E F E :0 F 0 0 :0 F 0 2 :0 F 0 3 :

( $ F F E 0 )( $ F F E 1 )( $ F F E 3 )( $ F F E 6 )( $ F F E 9 )( $ F F E B )( $ F F E D )( $ F F E E )

F 3 3 0 3 E 0 C

3 0 F 0 D B 7

D L L L L O U N O R S

• a * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * V a r i o u s t a b l e s

0 F 0 4 :0 F 0 C :0 F 1 4 :0 F 1 C :0 F 2 4 :0 F 2 C :0 F 3 4 :0 F 3 C :0 F 4 4 :0 F 4 C :0 F 5 4 :0 F 5 D :0 F 6 4 :0 F 6 C :0 F 7 4 :0 F 7 C :0 F 8 4 :0 F 8 C :0 F 9 4 :0 F 9 C :0 F A 4 :

9 0 0 3 6 0 1 3 1 O 2 0 5 I 4 3 O 2 4 4 3

F 0 0 1 0 0 0 6 1 0 6 0 3 0 6 1 6 1 6 3 0

B 0 0 O 0 0 0 3 1 O 0 0 0 0 2 0 0 1 2 1 0

5 0 0 0 0 0 0 3 1 O 0 4 4 6 1 0 4 6 1 O 0

6 0 0 0 0 7 0 1 1 3 0 7 6 4 1 5 2 4 1 0 0

C E / 0 00 0 0 E / 0 00 0 0 0 0 0 0 0 0 3 3 0 7 0 2 0 4

1 0 6 1 1 3 0 0 0 0 1 6 2 4 1 O 7

6 C / 0 D

O O 6 3 0 3 3 1 O I 0 F 0 0 5 1 6 1 6 3 3

C o l o r t a b l ea d a p t e d f o 4 0 - c h a r a c t e r s c r e e n

2 2

Page 235: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 235/316

A b a c u s

O F A C :0 F B 4 :O F B C :0 F C 4 :O F C C :0 F D 4 :O F D C :0 F E 4 :O F E C :0 F F 4 :O F F C :

S o f t w a r e

7 3 0 0 / 0 0O O O O O 1 0 0 O

1 1 O 1 0 0 0 O 0

7 0 0 0 0 0 0 0 O 0 0

B O 0 0 0 0 O O 0 0 O

O O O O O O O 0 0 O

0 1 1 1 1 1 0 0 O 1

0 0 0 0 0 0 0 O O 0

0 0 0 0 0 0 O 1 0 0

C - 1 2 8 C P / M U s e r ' s G u i d e

M M R e g i s t e r l a y o u ta d a p t e d S e c t o r n u m b e r sa c c o r d i n g t d i f f e r e n t s e c t o r s .I t h i s m a n n e rt h e l a y o u t o t h d i s k w i l lb o p t i m i z e d

2 2

Page 236: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 236/316

Page 237: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 237/316

Page 238: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 238/316

Page 239: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 239/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 C O P Y S Y S

T h i s c o m m a n d n o r m a l l y c o p i e s t h s y s t e m t r a c k s a n C P / M 3 S Y t d i s k e t t e .

I n p u t f o r m a t : C O P Y S Y SD e s c r i p t i o n :

T b o o t f r o m C P / M 3 . d i s k e t t e , b o t h t h s y s t e m t r a c k s a n t h C P M + . S Y S f i l e m u s t b p r e s e n t . D i s k s t h a t a r n o u s e d t b o o t C P / M d n o r e q u i r e e i t h e r . W i t h t h ' 1 2 8 , i t ' s q u i t e e a s y t c h a n g e t h e a c t u a l f o r m a to t h C O P Y S Y S c o m m a n d , s i n c e t h s y s t e m c a n b e t r a n s f e r r e d b c o p y i n gw i t h P I P . I y o u s t h C O P Y S Y S c o m m a n d , m e s s a g e i d i s p l a y e dt e l l i n g y o t h a t t h i s c o m m a n d i n o n f u n c t i o n a l .

2 2

Page 240: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 240/316

Page 241: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 241/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 3 D E V I C ED i s p l a y s a n a l t e r s t h d e v i c e s u s e d t a c c e s s t h e p e r i p h e r a l s .

I n p u t f o r m a t : d e v i c e n a m e sD E V I C E V A L U E SD E V I C E L S T : = X X X X X X [ N O X O N , 1 2 0 0 ]D E V I C E C O N O U T : = x x x , x x xD E V I C E C O N : [ P A G E S ]D E V I C E C O N : [ C O L U M N S = t t t t , L I N E S = m m ]

D e s c r i p t i o n :

T h i s p r o g r a m i u s e d t d i s p l a y a n a s s i g n i n p u t a n o u t p u t d e v i c e s t t h o p e r a t i n g s y s t e m . T h n a m e s o t h e t h r e e l o g i c a l d e v i c e s a r e : C O N : , L S T : ,a n A U X : . l o g i c a l d e v i c e c a a l s o b s e t s e v e r a l p e r i p h e r a l s . F o i n s t a n c e , d a t a m a b s e n t t p r i n t e r a n t h m o n i t o r a t h s a m e t i m e .D E V I C E a l s o c o n t r o l s t h r o w s / c o l u m n s d i s p l a y e d o t h m o n i t o r .

U s e s :T h e n a m e s o t h o u t p u t d e v i c e s a r p r e d e t e r m i n e d b t h C o m m o d o r eC P / M s y s t e m . I D E V I C E i e n t e r e d w i t h t h N A M E S o p t i o n , l i s t w i t h t h n a m e s a n b a u d r a t e s o t h i n d i v i d u a l i d i s p l a y e d . I D E V I C E V A L U E S i e n t e r e d , t h f o l l o w i n g i d i s p l a y e d :

C u r r e n t A s s i g n m e n t s :

C O N I N :C O N O U T :A U X I N :A U X O U T :L S T :

K E Y S4 C O ( o 8 C O L )N u l l d e v i c eN u l l d e v i c eP R T 1

C O I N a n C O N O U T : r e f e r t o c o n s o l e i n p u t ( o k e y b o a r d i n p u t ) , a n c o n s o l e o u t p u t ( o k e y b o a r d o u t p u t . ) C O N : a l o n e r e f e r s t b o t h i n p u t a n o u t p u t . L S T : s t a n d s f o L I S T D E V I C E a n r e f e r s t o t h e p r i n t e r . U s i n gt h P A G E o p t i o n , y o c a f i n d o u h o m a n y r o w s a n c o l u m n s a r p r e s e n t l y b e i n g d i s p l a y e d b t h m o n i t o r .

I s p e c i f i c b a u d r a t e i e n t e r e d i t h f o r m a t [ n n n ] , t h d a t a - e x c h a n g ew i t h t h p a r t i c u l a r p e r i p h e r a l i e x e c u t e d a t t h i s s p e e d . T h c o m m a n dD E V I C E d i s p l a y s D E V I C E N A M E S a n V A L U E S t o g e t h e r .

2 2

Page 242: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 242/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A > D E V I C E

P h y s i c a l D e v i c e s :I = I n p u t , O = 0 u t p u t , S = S e r i a l , X = X o n - X o f fK E Y S N O N E 8 0 C O L N O N E 4 0 C O L N O N EP R T 1 N O N E P R T 2 N O N E 6 5 5 1 9 6 0 0 I O S XR S 2 3 2 3 0 I O S X

C u r r e n t A s s i g n m e n t s :C O N I N : K E Y SC O N O U T : N u l l D e v i c eA U X I N : N u l l D e v i c eL S T : P R T 1

E n t e r n e w a s s i g n m e n t o r h i t R E T U R N

N o t e : T h c o m m a n d D E V I C E r e p l a c e s t h e S T A T D E V : c o m m a n d i C P / M3 . 0 . ( T h e S T A T c o m m a n d o C P / M 2 . w a d i v i d e d , s i n c e i w a t o c o m p l e x ) .

2 3

Page 243: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 243/316

Page 244: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 244/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O p t i o n s :

O p t i o nA T D A T ED I D R I V E = A L LD R I V E = AE X C L U D EF F U L LL E N G T H = nM E S S A G EN O P A G ER R

S I Z ES Y U S E R = A L LU S E R = 5U S E R = ( 3 , 5 )

F u n c t i o nd i s p l a y u s e r - d e f i n e d f i l e a t t r i b u t e sd i s p l a y d a t a w i t h t i m e a n d a t ed i s p l a y n o n - s y s t e m f i l e sd i s p l a y f i l e s i a l d r i v e sd i s p l a y f i l e s i d r i v ed i s p l a y a l l f i l e s e x c e p t t h o n s p e c i f i e ds e n d f o r m f e e d t o p r i n t e rd i s p l a y f i l e s w i t h c o m p l e t e d e s c r i p t i o ns e n d f o r m f e e d a f t e r l i n e ss c r o l l i n g d i s p l a y o d i s k d r i v e s / U S E R a r e a ss c r o l l i n g d i s p l a yd i s p l a y r e a d - o n l y f i l e sd i s p l a y r e a d / w r i t e f i l e s

d i s p l a y s i z e o e a c h f i l ed i s p l a y o n l y s y s t e m f i l e sd i s p l a y f i l e s o a l U S E R a r e a sd i s p l a y f i l e s o t h U S E R a r e a t h a t w a s p e c i f i e dd i s p l a y f i l e s o t h U S E R a r e a s t h a t w e r e s p e c i f i e d

2 3

Page 245: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 245/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 5 D I R S Y S

T h i s c o m m a n d , l i s t s f i l e s s p e c i f i e d a s S Y S T E M f i l e s .

I n p u t f o r m a t : D I R S Y SD I R S Y S B D I R S Y S F i l e n a m e . x x xD I R S Y S A B ? * . *

D e s c r i p t i o n

W i t h t h D I R S Y S c o m m a n d , a l S Y S T E M f i l e s c a b d i p l a y e d . T h i s m a b e a c c o m p l i s h e d u s i n g t h D I w i t h o p t i o n s , b u D I R S Y S i m u c h f a s t e r ,s i n c e i i R e s i d e n t c o m m a n d . T h c o m m a n d c a n b e a b b r e v i a t e d a I R S .T h D I R S Y S c o m m a n d a l s o t e l l s y o w h e t h e r a n y " n o r m a l " f i l e s e x i s t( C P / M r e f e r s t o t h e m a n o n - s y s t e m f i l e s ) . I t h e r e a r e n s y s t e m f i l e s , t h i sm e s s a g e i d i s p l a y e d :

N F i l e

2 3

Page 246: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 246/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 6 D U M P

D i s p l a y s n o n - t e x t f i l e s i h e x a d e c i m a l a n A S C I I f o r m a t .

I n p u t f o r m a t : D U M PD U M P F i l e n a m e . x x x

D e s c r i p t i o n :

D U M P d i s p l a y s t h e c o n t e n t s o f i l e i b o t h h e x a d e c i m a l a n A S C I I f o r m a t

T d i s p l a y A S C I I o n l y t e x t f i l e s y o c a u s t h T Y P E c o m m a n d . B u C O M , R E L , o O V f i l e s , f o e x a m p l e s h o u l d b e x a m i n e d u s i n g d u m pT h l e f t h a n d c o l u m n s c o n t a i n t h r e l a t i v e a d d r e s s o t h f i l e c o n t e n t s . T h m i d d l e c o l u m n s c o n t a i n t h h e x i d e c i m a l c o n t e n t s . T h r i g h t h a n d c o l u m n sc o n t a i n t h c o r r e s p o n d i n g A S C I I c h a r a c t e r s . c h a r a c t e r w h o s e v a l u ec a n n o t b d i s p l a y e d i i n d i c a t e d b p e r i o d ( . ) . Y o c a a l s o s e n d t h d i s p l a y t t h p r i n t e r b p r e s s i n g < C O N T R O L > P

2 3

Page 247: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 247/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 7 E T h C P / M e d i t o r .

I n p u t f o r m a t : E D < f i l e n a m e > ( < f i l e t y p e > )

D e s c r i p t i o n :

T h b u i l t - i n e d i t o r m a b p r a c t i c a l f o v e r y s h o r t t e x t s , b u i h a b a o p e r a t i o n a l r e p u t a t i o n — f o r g o o d r e a s o n . T h e d i t o r i e x t r e m e l yc o m p l i c a t e d a n i d i f f i c u l t t o p e r a t e , e v e n f o e x p e r i e n c e d u s e r s .

W h e n t h f i l e n a m e i e n t e r e d , E c h e c k s i i p r e s e n t l y e x i s t s . I i d o e s , t h ef i l e i l o a d e d i n t o t h E b u f f e r a n b a c k u p f i l e i s c r e a t e d . I t h f i l e d o e sn o p r e s e n t l y e x i s t , t h f o l l o w i n g m e s s a g e i d i s p l a y e d :

E n t e r I n p u t f i l eA f t e r y o e n t e r t h e f i l e n a m e , i d i s p l a y s :

E n t e r O u t p u t f i l eT e x i t t h e d i t o r , e v e n w h e n s a v i n g t h d a t a , s i m p l y e n t e r t h e c o m m a n d E

H e r e ' s l i s t o a l o E D f s c o m m a n d s :C o m m a n d F u n c t i o n

n a p p e n d l i n e s f r o m o r i g i n a l f i l et m e m o r y b u f f e r

a p p e n d f i l e u n t i l b u f f e r i o n h a l ff u l l

# a p p e n d f i l e u n t i l b u f f e r i f u l l ( o e n o f i l e )

B - m o v e c u r s o r p o s i t i o n t t h b e g i n n i n g ( B o b o t t o m ( - B ) o b u f f e r

2 3

Page 248: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 248/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

n C - n

n D , - n D

s t r i n g < C O N T R O L Z

I < R E T U R N >I s t r i n g < C O K Y R O L >

m o v e c u r s o r p o s i t i o n c h a r a c t e r sf o r w a r d ( C o b a c k ( - C ) t h r o u g hb u f f e r

d e l e t e c h a r a c t e r s b e f o r e ( - D ) o f r o m ( D t h c u r s o r p o s i t i o n

s a v e n e f i l e , r e t u r n t C P / Mf i n d c h a r a c t e r s t r i n g

s a v e n e f i l e , r e - e d i t , u s n e f i l e a s o r i g i n a l f i l e

e n t e r i n s e r t m o d ei n s e r t s t r i n g a t c u r s o r p o s i t i o n

J s e a r c h _ s t r < C O K T R O L > i n s _ s t r < C O N T R O L > Z d e l j o _ s t rs w i t c h s t r i n g s

n K - n

n L - r t L , O

n M c o m m a n d sn , - n

n

: n c o m m a n ds t r i n g < C O N T R O L >

d e l e t e l i n e s f r o m t h c u r s o rp o s i t i o n

m o v e c u r s o r p o s i t i o n l i n e s

e x e c u t e c o m m a n d s t i m e sm o v e c u r s o r p o s i t i o n l i n e s a n d i s p l a y t h a t l i n e

m o v e t l i n e

e x e c u t e c o m m a n d t h r o u g h l i n ee x t e n d e d f i n d s t r i n g

r e t u r n t o r i g i n a l f i l e

2 3

Page 249: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 249/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

n P - r i P m o v e c u r s o r p o s i t i o n 2 l i n e sf o r w a r d a n d i s p l a y 2 l i n e s a c o n s o l e

a b a n d o n n e f i l e , r e t u r n t C P / M - 8 6

R < C O N T R O L > Z r e a d X $ $ $ $ $ $ $ . L I B f i l e i n t ob u f f e r

l f i l e n a m e < C O N T R O L > r e a d f i l e n a m e i n t o b u f f e r

S d e l . s t r i n g < £ O N T R O L > Z i n s e r t s u b s t i t u t e s t r i n g

/ I T , - / I T , O

U -

V -

O

r f

o n

t y p e / l i n e s

u p p e r - c a s e t r a n s l a t i o n

l i n e n u m b e r i n g o n / o f f

d i s p l a y f r e e b u f f e r s p a c e

w r i t e l i n e s t n e f i l e

w r i t e u n t i l b u f f e r i h a l f e m p t yw r i t e o r a n n e n d l i n e sp

L I

/ i X / z / e / i a m e < C O N T R O L > w r i t e / l i n e s t f i l e n a m e ; a p p e n di p r e v i o u s c o m m a n d a p p l i e dt s a m e f i l e

0 X < C O N T R O L > Z d e l e t e f i l e X $ $ $ $ $ $ $ . L I B0 X f i l e n a m e < C O N T R O L > d e l e t e f i l e n a m e

n w a i t s e c o n d s

N o t e : t h c u r s o r p o s i t i o n p o i n t s t t h c h a r a c t e r c u r r e n t l y b e i n gr e f e r e n c e d i t h e d i t b u f f e r . U s < C O N T R O L > t s e p a r a t em u l t i p l e c o m m a n d s o t h s a m e l i n e .

2 3

Page 250: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 250/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 8 E R ( S E )

R e s i d e n t c o m m a n d t e r a s e o n e , s e v e r a l , o a l l f i l e s o d i s k e t t e .

I n p u t f o r m a t :

R e s i d e n t c o m m a n d : E R A S EE R A S E F i l e n a m e . x x xE R A S E A B ? * . *

T r a n s i e n t c o m m a n d : E R A S E F i l e n a m e . x x x C O N F I R M ]D e s c r i p t i o n :

T h E R A S E c o m m a n d w i l l e r a s e a s p e c i f i e d f i l e , i t h a t f i l e i n o r e a d - o n l y f i l e , o w r i t e - p r o t e c t e d . Y o c a e r a s e f i l e o n l y w i t h i n t h s a m eU S E R a r e a . I f y o s p e c i f y a f i l e n a m e c o n t a i n i n g o ? y o a r a s k e d t c o n f i r m t h c o m m a n d b e n t e r i n g o N

U s e s :E R A S E m a b a b b r e v i a t e d t E R A . T h o p t i o n C O N F I R M c a b a b b r e v i a t e d t C

2 3

Page 251: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 251/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 9 F O R M A T

F o r m a t s f l o p p y d i s k e t t e .

I n p u t f o r m a t : F O R M A TD e s c r i p t i o n :

A l d i s k e t t e s u s e d w i t h t h C - 1 2 8 m u s t b f o r m a t t e d p r o p e r l y . A l p r e v i o u sd a t a o d i s k e t t e i l o s t d u r i n g f o r m a t t i n g . F O R M A T i n o a s t a n d a r d C P / Mp r o g r a m .

U s e s :

A f t e r d i s k e t t e i F O R M A T e d , y o a r a s k e d t h q u e s t i o n f o r m a ta n o t h e r d i s k ? T h i s a l l o w s y o t f o r m a t s e v e r a l d i s k e t t e s , o n a f t e rt h o t h e r .

N o t e : S e v e r a l d i s k e t t e f o r m a t s a r p o s s i b l e w i t h t h C o m m o d o r e 1 2 8 .B e c a u s e o t h i s , w h e n y o f o r m a t , y o w i l l b e a s k e d w h e t h e r y o w a n t t f o r m a t t h d i s k e t t e a s i n g l e - s i d e d o r d o u b l e - s i d e d . W i t h t h F O R M A Tc o m m a n d , d i s k e t t e s m a o n l y b f o r m a t t e d i d r i v e A

2 3

Page 252: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 252/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 0 6 E N C 0 M

G e n e r a t e s s p e c i a l v e r s i o n o C P / M 3 . 0 .

I n p u t f o r m a t : G E N C O MD e s c r i p t i o n :

I u s e d b y p r o g r a m m e r s t a d a p t a C P / M v e r s i o n , o t o i n t e g r a t e a d d i t i o n a lp r o g r a m - r o u t i n e s i C P / M .

2 4

Page 253: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 253/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 1 G E

G e t s d a t a f r o m f i l e i n s t e a d o t h k e y b o a r d .

I n p u t f o r m a t :

G E C O N S O L E I N P U T F R O M F I L E F i l e n a m e , x x G E C O N S O L E I N P U T F R O M C O N S O L EG E F I L E F i l e n a m e , x x [ N O E C R O ]

D e s c r i p t i o n :

T h G E c o m m a n d e n a b l e s y o t r e a d d a t a f r o m p a r t i c u l a r f i l e i n s t e a d o t h k e y b o a r d .U s e s :

I n t h e f i r s t e x a m p l e , C P / M r e t r i e v e s c o m m a n d s f r o m f i l e n a m e dF i l e n a m e . x x x . I t h e r e a r e n o m o r e c o m m a n d s i t h f i l e , C P / M r e v e r t s t k e y b o a r d i n p u t .

T h t h s e c o n d e x a m p l e , C P / M r e t r i e v e s c o m m a n d s f r o m t h k e y b o a r d .I n t h e t h i r d e x a m p l e , C P / M r e t r i e v e s c o m m a n d s f r o m t h k e y b o a r d . T h e( N O E C H O ) o p t i o n i s p e c i f i e s t h a t t h c o m m a n d s a r n o d i s p l a y e d o t h s c r e e n .

2 4

Page 254: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 254/316

Page 255: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 255/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 3 H E X C O M ( A d d i t i o n a l U t i l i t i e s )

C r e a t e s C O f i l e t h a t c a b e x e c u t e d .

I n p u t f o r m a t : E E X C O M < F i l e n a m e >H E X C O M

D e s c r i p t i o n :

T h i s c o m m a n d c o n v e r t s H E f i l e t C O f i l e . Y o d n o h a v e t s p e c i f yt h f i l e e x t e n s i o n , s i n c e H E X C O M a d d s H E t t h f i l e n a m e .

D o n ! t u s e H E X C O M t c h a n g e R M A C . H E f i l e s i n t o C O f i l e s . H E f i l e sc r e a t e d b R M A C ( t h e r e l o c a t a b l e c o d e - p r o d u c i n g a s s e m b l e r ) , m u s t b p r o c e s s e d b t h L I N K c o m m a n d .

2 4

Page 256: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 256/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 4 I N I T D I R

P r e p a r e s a d i s k e t t e ' s d i r e c t o r y t a c c e p t a t i m e a n d a t e s t a m p .

I n p u t f o r m a t : I N I T D I R B D e s c r i p t i o n :

C P / M 3 . l e t s y o m a r k f i l e s w i t h a t i m e a n d a t e s t a m p . T h i s i n f o r m a t i o ni s t o r e d i s e p a r a t e p a r t o t h d i r e c t o r y . B e c a u s e o t h i s , t h d i r e c t o r ym u s t b p r e p a r e d b u s i n g I N I T D I R . T h e n a t u r e o t h f i l e t y p e s m a b c o n t r o l l e d w i t h t h c o m m a n d S E T .U s e s :

I t i s b e s t t u s I N I T D I R o n e d i s k e t t e , s i n c e t i m e s t a m p s r e q u i r ed i s k e t t e s p a c e . I y o a r u s i n g I N I T D I R o d i s k e t t e c o n t a i n i n g d a t a ,m a k e b a c k u p o t h a t d i s k e t t e f i r s t . I I N I T D I R w e r e i n t e r r u p t e d , t h d a t ao t h a t d i s k e t t e m a b l o s t .

2 4

Page 257: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 257/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 5 K E Y F I G

K E Y F I G e n a b l e s y o t r e a s s i g n t h v a l u e s o f e a c h k e y , a n l e t s y o d e f i n et h f u n c t i o n k e y s .

I n p u t f o r m a t : K E Y F I GD e s c r i p t i o n :

T h K E Y F I G c o m m a n d i m e n u - o r i e n t e d . K E Y F I G p r o v i d e s y o w i t hH E L P s c r e e n s . T h c o m m a n d l e t s y o a s s i g n a n A S C I I v a l u e t a n k e y ,u s i n g < S H I F T > o < C T R L > . I a l s o l e t s y o d e f i n e c o l o r s , a n l e t s y o a s s i g n s p e c i a l f u n c t i o n s t k e y s ( s u c h a r e b o o t i n g o t h s y s t e m , e t c . ) .F i n a l l y , K E Y F I G a l l o w s y o t d e f i n e f u n c t i o n k e y s s u c h a t h H E L P k e y .T h u s t h i s c o m m a n d p r o v e s t b v e r y h e l p f u l .

2 4

Page 258: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 258/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 6 l i ( A d d i t i o n a l U t i l i t i e s )P r o d u c e s a n c h a n g e s " l i b r a r y " o s u b p r o g r a m s .

T n p u t f o r m a t : L I F i l e n a m e . X X X [ O P T I O N S ]D e s c r i p t i o n :

M a n y c o m p i l e r s a n t h a s s e m b l e r s R M A C a n M A C R O - 8 0 u s t h m e t h o do f s u b p r o g r a m s , w h i c h u s u a l l y h a v e t h e x t e n s i o n R E o I R L . L i s t i n g o i m p o r t a n t s u b p r o g r a m s i l i b r a r y i d o n e b u s i n g L I B .

2 4

Page 259: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 259/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 7 l i n k ( A d d i t i o n a l U t i l i t i e s )

P r o d u c e s a f i l e w h i c h c a n b e e x e c u t e d f r o m s u b p r o g r a m m o d u l e s .I n p u t f o r m a t ! I N F i l e n a m e , F i l e n c a n e 2 ^ i l e n a m e 3 , . . . [ O P T I O N S ]D e s c r i p t i o n :

M a n y c o m p i l e r s a n t h a s s e m b l e r s R M A C a n M A C R O - 8 0 c r e a t e R E o I R p r o g r a m s , l i n k l e t s y o c o m b i n e t h e s e f i l e s i n t o s i n g l e C O f i l e .

2 4

Page 260: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 260/316

Page 261: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 261/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 1 9 P A T C H

I n s t a l l s c h a n g e s i C P / M 3 . o o t h e r p r o g r a m sI n p u t f o r m a t : P A T C H F i l e n a m e

P A T C H F i l e n a m eD e s c r i p t i o n :

Y o c a u s t h P A T C H c o m m a n d t m a k e p r o g r a m c h a n g e s i e x i s t i n gC P / M t r a n s i e n t p r o g r a m s . T h i s p r o c e s s i k n o w n a p a t c h i n g , p a t c ha u t o m a t i c a l l y e n t e r s t h c h a n g e s i t h s p e c i f i c p r o g r a m , a n i s e v e r a lp a t c h e s a r m a d e , t h e y a r i d e n t i f i e d w i t h r e f e r e n c e n u m b e r s ( n ) . T h r e f e r e n c e n u m b e r s s t a r t w i t h 1

2 4

Page 262: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 262/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 0 P I

C o p i e s f i l e s a n t r a n s f e r s f i l e s b e t w e e n p e r i p h e r a l s .

I n p u t f o r m a t : P I P I D e s t i n a t i o n f i l e = S o u r c e f i l e o p t i o n sP I B : ^ F i l e n a m e . X X XC O M B F I L E . C t f K T E X T l . T X T , T E X T 2 . T X T . . .P I A B 1 ? * . * = A B 2 ? * . * [ o p t i o n ]

D e s c r i p t i o n :

P I i e a s i l y t h m o s t p o w e r f u l c o m m a n d i C P / M . I l e t s y o c o p y f i l e s ,n o o n l y f r o m o n d i s k e t t e t o a n o t h e r , b u a l s o b e t w e e n v a r i o u s u s e r a r e a s .I c a c o m b i n e s e v e r a l f i l e s i n t o o n e , p r o t e c t f i l e s , c o n v e r t t e x t t o u p p e r c a s e ,r e n u m b e r l i n e s , a n d c h a n g e t h e 8 t h b i t o z e r o . C h a p t e r c o n t a i n s m o r ed e t a i l e d i n f o r m a t i o n o I P

U s e s :I c a b u s e d w i t h o w i t h o u t o p t i o n s . T h I P p r o m p t i a a s t e r i s k i

d i s p l a y e d ( * ) . T h D e s t i n a t i o n f i l e a a e x a c t d u p l i c a t e o t h S o u r c e f i l e ,u n l e s s c h a n g e d b y a o p t i o n . T h b r a c k e t s m u s t i m m e d i a t e l y f o l l o w t h f i l e n a m e w i t h o u t s p a c e s . I s e v e r a l v e r s i o n s o f f i l e a r t b c o p i e d , o i t h e r e a r e u n k n o w n c h a r a c t e r s i t h f i l e n a m e , y o m a u s ? f o r u n k n o w nc h a r a c t e r s o * f o r a l c h a r a c t e r s . T h d e f a u l t d i s k d r i v e i t h l o g g e d d r i v eH e r e a r s o m e e x a m p l e s :

P I B : ^ F i l e n a m e . x x x [ V

T h i s p a r t i c u l a r c o m m a n d c o p i e s t h f i l e F i l e n a m e . x x x f r o m d r i v e t d r i v eB a n v e r i f i e s t h a t c o p y .

I B ^ F i l e n a m e . V

T h i s c o m m a n d c o p i e s s e r i e s o f i l e s w i t h t h n a m e F i l e n a m e , r e g a r d l e s s o e x t e n s i o n , f r o m d r i v e t B

2 5

Page 263: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 263/316

Page 264: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 264/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

G G e f i l e f r o m u s e r a r e a n T h i s o p t i o n m u s t b p o s i t i o n e dd i r e c t l y a f t e r t h f i r s t f i l e n a m e a n s h o u l d b t h o n l y t h i n gw r i t t e n t h e r e . F o e x a m p l e :

P I B : [ G 5 ] = T E X T . T X T . T X T [ G 1 ]

w i l l c o p y t h f i l e T E X T T X f r o m U S E R a r e a t U S E Ra r e a 5

T r a n s f e r h e x a d e c i m a l d a t a . T h i s o p t i o n s h o u l d a l w a y s b ee n t e r e d i y o u w a n t t c o p y H E f i l e s . I w i l l t h e n c h e c kt h f i l e c o n t e n t f o c o r r e c t I N T E L f o r m a t .

I g n o r e t h e n d - o f - f i l e m a r k e r i H E f i l e s . E n t e r t h i so p t i o n f o e v e r y f i l e e x c e p t t h l a s t o n e . A l o n g w i t h t h o p t i o n I t h o p t i o n i e n t e r e d b y I P F o t h l a s t f i l eu s t h p a r a m e t e r H

P I F i l e n a m e . H E X = P R O G 1 . H E X [ I P R 0 G 2 . H E X [ H

S u p p r e s s t h d i s p l a y o f i l e n a m e s d u r i n g c o p y i n g .C h a n g e a l c a p i t a l l e t t e r s t l o w e r c a s e . U s t h i s o p t i o n o n l yf o t e x t f i l e s , a n b s u r e t u s t h p a r a m e t e r f o W o r d S t a r f i l e s .

N u m b e r s t h l i n e s o f i l e c o n t i n u o u s l y . T h n u m b e r ss t a r t w i t h i t h f i r s t l i n e , a n i n c r e a s e b f o e a c h l i n e .T h n u m b e r s c a h a v e m a x i m u m o d i g i t s . U n u s e dd i g i t s w i l l a p p e a r a s p a c e s . T h n u m b e r s w i l l b f o l l o w e db c o l o n a n s p a c e . D n o u s w i t h t h o p t i o n s o N C h o o s e p a r a m e t e r f o W o r d S t a r f i l e s .

N N u m b e r s t h l i n e s f o B A S I C p r o g r a m .T r a n s f e r o o b j e c t - f i l e s . U s e d t t r a n s f e r n o n - t e x t a n n o n - C O M f i l e s . D n o t u s e f o t e x t f i l e s .

P S e t s p a g e l e n g t h . D e f a u l t i 6 l i n e s p e p a g e . E n t e r t h o p t i o n t e r a s e a n < C T R L > ( f o r m f e e d ) m a r k e r s t h a tm a e x i s t . U s o n l y w i t h t e x t f i l e s .

2 5

Page 265: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 265/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

Q x x x x < C T R L > ZQ u i t c o p y i n g a f t e r t h i s c h a r a c t e r s t r i n g . P I w i l l c o p yf i l e u t a n i n c l u d i n g t h e s p e c i f i e d c h a r a c t e r s t r i n g . U s t h c o m m a n d i c o m m a n d l i n e s s t h a t t h s t r i n g w i l l n o b e c h a n g e d t c a p i t a l l e t t e r s . U s o n l y f o t e x t f i l e s :

P I C O = T E X T T X [ H a m l e t

I c o m m a n d i o n l i n e , t h e n t r y a p p e a r s i c a p i t a l l e t t e r s .

C o p y s y s t e m f i l e s . T h e s e f i l e s a r n o l i s t e d b D I R , a n p i d o e s n o u s u a l l y c o p y t h e m . w i l l c a n c e l t h e s er e s t r i c t i o n s .

S x x x x < C T R L > ZS t a r t a t t h i s c h a r a c t e r s t r i n g . P I w i l l b e g i n c o p y i n g a t h i sc h a r a c t e r s t r i n g . B s u r e t w r i t e t h c o m m a n d i t w l i n e s , o t h e r w i s e t h t e x t i c h a n g e d t a l c a p i t a l l e t t e r s .U s o n l y w i t h t e x t f i l e s .

T S e t a b . N o r m a l l y C P / M o p e r a t e s w i t h a 8 - s p a c e t a b . T h i si n o t h c a s e f o h a r d c o p i e s , a n t h u s t h e t a m u s t b d e f i n e d , s p e c i f i e s t h n u m b e r o s p a c e s t h e t a b i s e t .U s w i t h t e x t f i l e s o n l y .C a p i t a l i z e . C h a n g e s a l l o w e r c a s e c h a r a c t e r s t u p p e r c a s e .U s o n l y w i t h t e x t f i l e s . W h e n u s e d w i t h W o r d S t a r , b s u r e t u s t h o p t i o n z

V e r i f y . T h i s p a r a m e t e r v e r i f i e s f i l e s c o p i e d b P I P . I e n s u r e s t h a t t h n e f i l e i i d e n t i c a l t t h o l o n e .

W r i t e o v e r r e a d - o n l y f i l e s . T h e s e f i l e s m a n o r m a l l y b r e a d , b u n o c h a n g e d o e r a s e d . T h o p t i o n c a u s e s t h e s ef i l e s t b e r a s e d w i t h o u t r e c a l l .

E r a s e t h 8 t b i t . A S C I I u s e s o n l y s e v e n b i t s , a n t h e 8 t hb i i u t i l i z e d b m a n y a p p l i c a t i o n s p r o g r a m s f o v a r i o u sf u n c t i o n s . T h o p t i o n i n o t n e c e s s a r y w h e n c o p y i n gA S C I I d a t a , s u c h a C O M : o L S T : .

2 5

Page 266: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 266/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 1 P U

R e d i r e c t s d a t a i n t e n d e d f o t h m o n i t o r t o p r i n t e r o f i l e .

I n p u t f o r m a t :

P U C O N S O L E O U T P U T T F I L E F i l e n a m e . x x x [ o p t i o n ]P U P R I N T E R O U T P U T T F I L E F i l e n a m e . x x [ o p t i o n ]P U C O N S O L E O U T P U T T C O N S O L EP U P R I N T E R O U T P U T T P R I N T E R

D e s c r i p t i o n :

N o r m a l l y C P / M s e n d s d a t a t t h m o n i t o r . T h P U c o m m a n d a l l o w s y o t w r i t e t h d a t a t f i l e o t h p r i n t e r .

U s e s :

T h f i r s t e x a m p l e s d i r e c t C P / M t o p e n f i l e a n w r i t e a l o u t p u t i n t e n d e df o r t h e s c r e e n o p r i n t e r t o t h a t f i l e . O n c e t h o p e r a t i o n i e n d e d , C P / M w i l lr e t u r n t i t n o r m a l m o d e . T h l a s t t w e x a m p l e s t e r m i n a t e t h P U c o m m a n d . F o e x a m p l e , t h e s e c o u l d b u s e d i y o h a S U B M I T f i l eu s i n g t h P U c o m m a n d , a n s h o u l d s u b s e q u e n t l y r e t u r n t n o r m a l m o d e .T h d i s p l a y o t h d a t a o t h m o n i t o r c a n b t e r m i n a t e d w i t h t h c o m m a n dE C H O . T h e o p t i o n f i l t e r c h a n g e s a l c o n t r o l c h a r a c t e r s i n t o p r i n t a b l ef o r m .

T h o p t i o n S Y S T E M c a u s e s t h c o m m a n d s t b e s a v e d a l o n g w i t h t h d a t ai t h n e f i l e .

2 5

Page 267: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 267/316

Page 268: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 268/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 3 F M A C ( A d d i t i o n a l U t i l i t i e s )

M a c r o a s s e m b l e r f o p r o g r a m m i n g i a s s e m b l y l a n g u a g e . C r e a t e s t h r e l o c a t a b l e o b j e c t c o d e , w h i c h m u s t b p r o c e s s e d b l i n k .I n p u t f o r m a t : R M A C F i l e n a m e

R M A C F i l e n a m e o p t i o n s

D e s c r i p t i o n :

T h R M A C m a c r o a s s e m b l y p r o d u c e s t h r e e f i l e s . T h s o u r c e p r o g r a m i l i s t e d w i t h t h e x t e n s i o n A S M , a n t h l i b r a r y w i t h t h e x t e n s i o n L I B . T h a s s e m b l e d p r o g r a m c o d e i l i s t e d w i t h t h e x t e n s i o n R E L , t h s y m b o ls c h e d u l e w i t h S Y a n t h e p r i n t a b l e l i s t i n g w i t h P R N . T h c o m m a n d l i n kc r e a t e s f i l e f r o m t h R E f i l e w h i c h c a b e x e c u t e d .

U s e s :

I n s t e a d o t h u s u a l b r a c k e t s , d o l l a r s i g n s ( $ a r u s e d t i n d i c a t e o p t i o n s .T h o p t i o n m u s t b p r e c e d e d b s p a c e .

2 5

Page 269: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 269/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 4 S A V E

S a v e s t h d a t a ( p r o g r a m ) c u r r e n t l y i n m e m o r y o n t o a d i s k e t t e .

I n p u t f o r m a t : S A V ED e s c r i p t i o n :

T h S A V E c o m m a n d l e t s y o c r e a t e f i l e o d i s k e t t e . T u s t h i s c o m m a n d ,y o e n t e r S A V E < R E T U R N > . S A V E t h e n m a k e s p r e a p a r a t i o n s o t h a t C P / Mw i l l b a b l e t s a v e t h s u b s e q u e n t p r o g r a m .

U s e s :

S A V E i a u t o m a t i c a l l y p l a c e d a t h u p p e r e n o t h m e m o r y , a n r e t u r n sc o n t r o l t C P / M a f t e r i i l o c a t e d t h e r e . N e x t e n t e r t h p r o g r a m n a m e o t h p r o g r a m t b s a v e d . A f t e r i i l o a d e d , S A V E w i l l r e g a i n c o n t r o l a n y o a r a s k e d f o r t h e f i l e n a m e a n t h s t a r t i n g a n e n d i n g a d d r e s s e s .

2 5

Page 270: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 270/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 5 S E

S e t s t h f i l e a t t r i b u t e s , e n a b l e s t h e i n p u t o f a p a s s w o r d , a s s i g n s d i s k l a b e l s ,a n c h o o s e s t h f o r m a t o f t h t i m e a n d a t e s t a m p s .

I n p u t f o r m a t : S E F i l e n a m e . x x x [ o p t i o n ]S E A B ? * . * [ o p t i o r i ]S E B - . [ o p t i o n ]S E T [ o p t i o n ]

D e s c r i p t i o n :

T h S E p r o g r a m s e r v e s s e v e r a l p u r p o s e s . I t m o s t i m p o r t a n t t a s k s a r e :s e t t i n g t h a r c h i v e m o d e a n d e c l a r i n g d i s k e t t e s o d r i v e s a r e a d - o n l y o w r i t e - o n l y .

E a c h d i s k e t t e c a n b e a s s i g n e d i t o w n a m e , a n d p a s s w o r d s c a b a s s i g n e dt t h w h o l e d i s k e t t e a n d / o r i n d i v i d u a l f i l e s . T h d i s k e t t e l a b e l s m a b d i s p l a y e d u s i n g S H O W .A l s o , s u c h f i l e s m a b e q u i p p e d w i t h t i m e a n d a t e s t a m p s .

S E f i l e n a m e . C O S Y a l l o w s t h f i l e t b a c c e s s e d f r o m a n u s e ra r e a .

F o m o r e d e t a i l e d i n f o r m a t i o n , s e e C h a p t e r 5

2 5

Page 271: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 271/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 6 S E T D E F

D i s p l a y s a n d e f i n e s t h o r d e r o d i s k d r i v e s e a r c h a n t u r n s t h s c r e e no u t p u t o o o f f .

I n p u t f o r m a t : S E T D E FS E T D E F B S E T D E F [ o p t i o n ]

D e s c r i p t i o n :

N o r m a l l y , t r a n s i e n t p r o g r a m s a r s t a r t e d b t y p i n g t h n a m e a n p r e s s i n g< R E T U R N > . I t h p r o g r a m i t b l o a d e d f r o m d i f f e r e n t d r i v e , d r i v em u s t b s p e c i f i e d a l o n g w i t h t h n a m e .F o i n s t a n c e , i y o a l w a y s w o r k o d r i v e a n d y o u r C P / M s y s t e m f i l e sa r o d r i v e A y o c a t e l l C P / M o t s e a r c h d r i v e f i r s t . T h i s i k n o w na s p e c i f y i n g s e a r c h o r d e r . T h i s w a y o c a t e l l C P / M t s e a c h f i r s t o d r i v e A t h e n o d r i v e C : a n o n l y t h e n o t h e d e f a u l t d r i v e .

2 5

Page 272: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 272/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 7 S H O W

D i s p l a y s t h o p t i o n s o d i s k e t t e .

I n p u t f o r m a t : S R O W [ o p t i o n ]S H O W B - . [ o p t i o n ]

D e s c r i p t i o n :

S H O W d i s p l a y s t h t e c h n i c a l d a t a o d i s k e t t e d i r e c t o r y . T h d i s k ' s f r e es p a c e , t h e n u m b e r o e n t r i e s i t h d i r e c t o r y , t h n u m b e r o a c t i v e U S E Ra r e a s , a n t h c h o s e n U S E R a r e a n u m b e r , t h t o t a l d i s k e t t e c a p a c i t y , b l o c ks i z e , s e c t o r s i z e , a n n u m b e r o s e c t o r s p e t r a c k , a n t h n a m e o d i s k e t t ea r d i s p l a y e d .

S H O W i a c t u a l l y u s e f u l a d d i t i o n t D I R . W i t h S H O W y o c a a l s o f i n d o u i t h d i s k e t t e a n d / o r i n d i v i d u a l f i l e s a r p r o t e c t e d b p a s s w o r d s .

O p t i o n s a r e :

S P A C EL A B E LU S E R SD I D R I V E

2 6

Page 273: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 273/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 8 S I ( S y m b o l i c I n t e r a c t i v e D e b u g g e r )

d e b u g g i n g p r o g r a m t l o a d , c h a n g e , a n t e s t a s s e m b l e r p r o g r a m s .

I n p u t f o r m a t : S I S I F i l e n a m e . x x xS I F i l e n a m e . x x x T E X T . S Y

D e s c r i p t i o n :

S I l e t s y o l o a d C O a n H E f i l e s i n t o m e m o r y , a n t h e n v i e w a n e d i tt h e m . T h p r o g r a m m a b r u w i t h e n h a n c e d c o n t r o l i S Y f i l e i l o a d e d . S I c a a l s o c h a n g e e x e c u t a b l e p r o g r a m s i n t o I N T E L 8 0 8 0m n e m o n i c s .U n f o r t u n a t e l y t h i s p r o g r a m i a v a i l a b l e o n l y o t h A d d i t i o n a l U t i l i t i e sd i s k e t t e . I i f u r t h e r d e v e l o p m e n t o t h D D p r o g r a m i C P / M 2 . 2 .

2 6

Page 274: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 274/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 2 9 S U B M I T

E n a b l e s c o m m a n d i n p u t f r o m f i l e , i n s t e a d o t h k e y b o a r d

I n p u t f o r m a t : S U B M I T f i l e n a m e , p a r a m e t e r l , p a r m 2 . . . , p a r m

D e s c r i p t i o n :

s e r i e s o c o m m a n d s u s u a l l y e n t e r e d t h r o u g h t h k e y b o a r d c a a l s o b w r i t t e n t S U B M I T f i l e , a n t h e n b e x e c u t e d a u t o m a t i c a l l y . W h e n t h f i l eo c o m m a n d s i c o m p l e t e d , c o n t r o l i r e t u r n e d t C P / M .W i t h e a c h p o w e r - u p , C P / M c h e c k s f i l e c a l l e d p r o f i l e S U a n a u t o m a t i c a l l y e x e c u t e s a n c o m m a n d s i n t h a t f i l e ( i f t h f i l e i f o u n d ) .

U s e s :

T w r i t e S U B M I T f i l e w i t h y o u r t e x t p r o g r a m , s i m p l y w r i t e t h d e s i r e dc o m m a n d s e a c h o l i n e . T h e x t e n s i o n f o t h i s f i l e m u s t b S U B — o t h e r w i s e i n o t r e c o g n i z e d b S U B M I T .

2 6

Page 275: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 275/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 3 0 U S E R

C h a n g e s t h e c u r r e n t u s e r a r e a .

I n p u t f o r m a t : U S E RU S E R n

D e s c r i p t i o n :

E a c h d i s k e t t e m a b d i v i d e d i n t o 1 d i f f e r e n t u s e r a r e a s . T h u s y o u c a h a v e s e p a r a t e u s e r a r e a s f o v a r i o u s j o b s , i w h i c h t h n e c e s s a r y f i l e s a n p r o g r a m s a r s t o r e d . S y s t e m f i l e s , l o c a t e d i t h u s e r l e v e l 0 m a b r e a df r o m a n u s e r a r e a .

U s e s :

T h c u r r e n t u s e r a r e a i d i s p l a y e d i t h C P / M p r o m p t ( 1 B > ) , a n m a b c h a n g e d w i t h t h U S E R c o m m a n d . I y o d n o s p e c i f y t h n e a r e a , t h p r o g r a m w i l l a s y o f o i t T h p r o g r a m S H O W w i l l d i s p l a y t h a c t i v e u s e ra r e a s .

2 6

Page 276: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 276/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

1 0 . 3 1 x r e f ( A d d i t i o n a l U t i l i t i e s )

C r e a t e s c r o s s - r e f e r e n c e l i s t i n g f o a s s e m b l e r p r o g r a m s .

I n p u t f o r m a t : X R E F F i l e n a m eX R E F F i l e n a m e $

D e s c r i p t i o n :

T h M A a n R M A C a s s e m b l e r s p r o d u c e a a l p h a b e t i c a l l i s t o a l s y m b o l su s e d a n t h e i r v a l u e s i p r o g r a m . X R E F i m o r e p r a c t i c a l , s i n c e i a d d i t i o n t t h s y m b o l s i d i s p l a y s t h e p r o g r a m l i n e s t h o s e s y m b o l s a r f o u n d i n X R E F r e q u i r e s S Y f i l e s a n P R f i l e s . X R E F p r o d u c e s a na s s e m b l e r l i s t c a l l e d < F i l e n a m e > . X R ( s i m i l a r t < F i l e n a m e > . P R N ) a n i n c l u d e s d e t a i l e d l i s t i n g o a l s y m b o l s p r e s e n t , a n t h l i n e n u m b e r s a w h i c h t h o s e s y m b o l s a p p e a r i t h p r o g r a m .

2 6

Page 277: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 277/316

A p p e n d i c e s

A p p e n d i x A A S C I I a n N u m b e r C o n v e r s i o n T a b l eA p p e n d i x B C P / M C o n t r o l C o d e sA p p e n d i x C p i p ' s p a r a m e t e r sA p p e n d i x D s e t ' s p a r a m e t e r sA p p e n d i x E 8 0 8 0 I n s t r u c t i o n S e F O G : T h C P / M E x p e r t

Page 278: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 278/316

Page 279: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 279/316

Page 280: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 280/316

A b a c u s S o f t w a r e

D e c i m a l2 2 2 2 2 3 3 3 3 3 3 3 3 3 3 4 4 4 4 4 4 4 4 4 4 5 5

H e x a -d e c i m a l

1 1 I 1 I I I 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 3 3 3 3

B i n a r v0 0 1 0 0 10 0 1 1 0 1 00 0 1 0 1 10 0 1 1 1 0 00 0 1 1 1 0 10 0 1 1 1 00 0 1 1 1 10 1 0 0 0 00 1 0 0 0 0 10 1 0 0 0 1 00 1 0 0 0 1 10 1 0 1 0 00 1 0 1 0 10 1 0 1 1 00 1 0 0 1 1 10 1 1 0 0 00 1 1 0 0 10 1 1 0 1 00 1 0 1 0 1 10 1 0 1 1 0 00 1 1 1 0 10 1 1 1 1 00 1 1 1 1 1O i 0 0 0 0O i 0 0 0 1O i l 0 0 1 0O i 0 0 1 1

- 1 2 8 C P / M U s e r ' s G u i d e

a s c i iE

S U E S

F G R V S

2 6

Page 281: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 281/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D e c i m a lH e x a

d e c i m a l B i n a r y A s c n5 5 5 5 5 5 5 5 6 6 6 6 6 6 6 6 6 6 7 7 7 7 7 7 7 7 7

3 3 3 3 3 3 3 3 3 3 3 3 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4

O i l 0 1 0 0O i 0 1 0 1O i 0 1 1 0O i 0 1 1 1O i l 1 0 0 0O i 1 0 0 1O i l 1 0 1 0O i l 1 0 1 1O i l 1 1 0 0O i 1 1 0 1O i 1 1 1 0O i l 1 1 1 11 0 0 0 0 01 0 0 0 0 11 0 0 0 1 01 0 0 0 1 11 0 0 1 0 01 0 0 1 0 11 0 0 1 1 01 0 0 1 1 11 0 1 0 0 01 0 1 0 0 11 0 1 0 1 01 0 1 0 1 11 0 0 1 1 0 01 0 1 1 0 11 0 0 1 1 1 0

2 6

Page 282: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 282/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

p r i m a lH e x a -

d e c i m a l B i n a r v A s c n7 8 8 8 8 8 8 8 8 8 8 9 9 9 9 9 9 9 9 9 9

1 0 1 0 1 0 1 0 1 0 1 0

4 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 6 6 6 6 6 6 6 6 6 6

1 0 1 1 1 11 0 0 0 0 01 0 0 0 0 11 0 0 0 1 01 0 0 0 1 11 0 0 1 0 01 0 0 1 0 11 0 0 1 1 01 0 0 1 1 11 0 1 0 0 01 0 1 0 0 11 0 1 0 1 01 0 1 0 1 11 0 1 1 0 01 0 1 1 0 11 0 1 1 1 01 0 1 1 1 11 1 0 0 0 01 1 0 0 0 11 1 0 0 1 01 1 0 0 1 11 1 0 1 0 01 1 1 1 0 11 1 0 1 1 01 1 0 1 1 11 1 1 0 0 01 1 1 0 0 1

2 7

Page 283: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 283/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

H e x a -— D e c i m a l d e c i m a l B i n a r y A s c n1 0 1 0 1 0 1 0 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 1 2 1 2 1 2 1 2 1 2 1 2 1 2

6 6 6 6 6 6 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7

1 1 1 0 1 01 1 1 0 1 11 1 1 1 0 01 1 1 1 0 11 1 1 1 1 01 1 1 1 1 11 1 0 0 0 01 1 0 0 0 11 1 0 0 1 01 1 0 0 1 11 1 0 1 0 01 1 0 1 0 11 1 0 1 1 01 1 0 1 1 11 1 1 0 0 01 1 1 0 0 11 1 1 0 1 01 1 1 0 1 11 1 1 1 0 01 1 1 1 0 11 1 1 1 1 01 1 1 1 1 1 D E

2 7

Page 284: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 284/316

Page 285: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 285/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A p p e n d i x B C P / M C o n t r o l C o d e s

C o n t r o l C h a r a c t e r

< C O N T R O L >< C O N T R O L >

< C O N T R O L > C

< C O N T R O L > E

< C O N T R O L >< C O N T R O L >

< C O N T R O L >< C O N T R O L >< C O N T R O L >

< C O N T R O L >

< C O N T R O L > M< C O N T R O L > P< C O N T R O L >< C O N T R O L >

< C O N T R O L >

F u n c t i o n

m o v e s c u r s o r o n c h a r a c t e r t t h l e f t

m o v e s c u r s o r f r o m b e g i n n i n g t e n o c o m m a n dl i n e a n b a c k w i t h o u t a f f e c t i n g c o m m a n ds t o p s e x e c u t i n g p r o g r a m w h e n e n t e r e d a t h s y s t e m p r o m p t o a f t e r < C O N T R O L >f o r c e s a p h y s i c a l c a r r i a g e r e t u r n w i t h o u t s e n d i n gc o m m a n d t C P / Mm o v e s c u r s o r o n c h a r a c t e r t o t h e r i g h t

d e l e t e s c h a r a c t e r a c u r r e n t c u r s o r p o s i t i o n i i t h m i d d l e o f l i n e

s a m e a t h T A k e

d e l e t e c h a r a c t e r t t h l e f t o c u r s o r

m o v e s c u r s o r t t h l e f t o t h c o m m a n d l i n e a n s e n d s c o m m a n d t C P / M 3 L i n e f e e d , h a s a m ee f f e c t a s c a r r i a g e r e t u r n

d e l e t e s c h a r a c t e r a c u r s o r a n a l c h a r a c t e r s t t h r i g h t

s a m e a s c a r r i a g e r e t u r n

e c h o e s c o n s o l e o u t p u t t t h l i s t d e v i c er e s t a r t s s c r e e n s c r o l l i n g a f t e r < C O N T R O L >r e t y p e s t h e c h a r a c t e r s t t h l e f t o t h c u r s o r o n e l i n e ; u p d a t e s t h c o m m a n d l i n e b u f f e rs t o p s s c r e e n s c r o l l i n g

2 7

Page 286: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 286/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

< C O N T R O L > u p d a t e s t h c o m m a n d l i n e b u f f e r t c o n t a i n t h c h a r a c t e r s t t h l e f t o t h c u r s o r ; d e l e t e s c u r r e n tl i n e .

< C O N T R O L > r e c a l l s p r e v i o u s c o m m a n d l i n e i c u r r e n t l i n e i e m p t y ; o t h e r w i s e m o v e s c u r s o r t e n o l i n e .< C O N T R O L > J , - M , - R , - U a n < R E T U R N >u p d a t e t h c o m m a n d l i n e b u f f e r f o r e c a l l w i t h< C O N T R O L > W

< C O N T R O L > d e l e t e s a l c h a r a c t e r s t t h l e f t o t h c u r s o r .

2 7

Page 287: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 287/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

A p p e n d i x C p i C o m m a n d

O p t i o n s F u n c t i o n

A r c h i v e f u n c t i o n . C o p i e s o n l y t h o s e f i l e s t h a t w e r e c r e a t e d o c h a n g e d s i n c e t h l a t e s t a r c h i v e u p d a t e . T h t i m e a n d a t es t a m p f u n c t i o n m u s t b s e

C o n f i r m . C P / M w i l l c h e c k a f t e r e a c h f i l e t c o n f i r m t h a t i m a b c o p i e d

D E r a s e a f t e r c o l u m n s . P I w i l l e r a s e a l c h a r a c t e r sp o s i t i o n e d a f t e r c o l u m n s i t h f i l e . U s e d f o t e x t f i l e s o n l yE c h o t e x t o t h m o n i t o r . T h c o n t e n t o t h f i l e s b e i n gc o p i e d a r d i s p l a y e d o t h s c r e e n . N o t b u s e d w i t h t h p a r a m e t e r N U s e d f o t e x t f i l e s o n l y

P F o r m f e e d . S o m e p r i n t e r s r e q u i r e < C T R L > t f e e d t h n e x t p a g e . I t h i s i n o t h e c a s e , u s t e r a s e t h e m

G G e f i l e f r o m u s e r a r e a n T h i s o p t i o n m u s t b p o s i t i o n e dd i r e c t l y a f t e r t h f i r s t f i l e n a m e a n s h o u l d b t h o n l y t h i n gw r i t t e n t h e r e . F o e x a m p l e :

P I B : [ G 5 ] = T E X T . T X T . T X T [ G 1 ]w i l l c o p y t h f i l e T E X T T X f r o m U S E R a r e a t U S E Ra r e a 5

T r a n s f e r h e x a d e c i m a l d a t a . T h i s o p t i o n s h o u l d a l w a y s b e n t e r e d i y o w a n t t c o p y H E f i l e s . P I w i l l t h e n c h e c kt h f i l e c o n t e n t f o r c o r r e c t I N T E L f o r m a tI g n o r e t h e n d - o f - f i l e m a r k e r i H E f i l e s . E n t e r t h i s o p t i o nf o e v e r y f i l e e x c e p t t h l a s t o n e . A l o n g w i t h t h o p t i o n I t h o p t i o n i e n t e r e d b P I P . F o t h l a s t f i l e u s t h p a r a m e t e r H

P I F / f e r t t f m e . H E X = P R O G l . H E X [ I ] , P R 0 G 2 . H E X [ H

2 7

Page 288: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 288/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

S u p p r e s s t h d i s p l a y o f i l e n a m e s d u r i n g c o p y i n gC h a n g e a l c a p i t a l l e t t e r s t l o w e r c a s e . U s t h i s o p t i o n o n l yf o r t e x t f i l e s , a n b s u r e t u s t h p a r a m e t e r f o W o r d S t a r f i l e s

N u m b e r s t h l i n e s o f i l e c o n t i n u o u s l y . T h n u m b e r s s t a r tw i t h i t h f i r s t l i n e , a n i n c r e a s e b f o e a c h l i n e . T h n u m b e r s c a h a v e m a x i m u m o d i g i t s . U n u s e d d i g i t s w i l la p p e a r a s p a c e s . T h n u m b e r s w i l l b f o l l o w e d b a c o l o na n s p a c e . D n o t u s e w i t h t h o p t i o n s o r N . C h o o s ep a r a m e t e r f o W o r d S t a r f i l e s

N N u m b e r s t h l i n e s f o B A S I C p r o g r a mT r a n s f e r o o b j e c t - f i l e s . U s e d t t r a n s f e r n o n - t e x t a n n o n - C O M f i l e s . D n o u s f o t e x t f i l e s

P S e t s p a g e l e n g t h . D e f a u l t i 6 l i n e s p e p a g e . E n t e r t h o p t i o n t e r a s e a n < C T R L > ( f o r m f e e d ) m a r k e r s t h a t m a e x i s t . U s o n l y w i t h t e x t f i l e s

Q x x x x < C T R L > ZQ u i t c o p y i n g a f t e r t h i s c h a r a c t e r s t r i n g . P I w i l l c o p y f i l eu t a n i n c l u d i n g t h e s p e c i f i e d c h a r a c t e r s t r i n g . U s t h c o m m a n d i c o m m a n d l i n e s s t h a t t h s t r i n g w i l l n o b c h a n g e d t c a p i t a l l e t t e r s . U s o n l y f o t e x t f i l e s :

P I C O N : = T E X T . T X T [ H a m l e t ]

I c o m m a n d i o n l i n e , t h e e n t r y a p p e a r s i n c a p i t a l l e t t e r s

C o p y s y s t e m f i l e s . T h e s e f i l e s a r n o l i s t e d b D I R , a n P I d o e s n o u s u a l l y c o p y t h e m . w i l l c a n c e l t h e s er e s t r i c t i o n s

S x x x x < C T R L > ZS t a r t a t h i s c h a r a c t e r s t r i n g . P I w i l l b e g i n c o p y i n g a t t h i sc h a r a c t e r s t r i n g . B s u r e t w r i t e t h c o m m a n d i t w l i n e s ,o t h e r w i s e t h t e x t i c h a n g e d t a l c a p i t a l l e t t e r s . U s o n l yw i t h t e x t f i l e s

2 7

Page 289: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 289/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

T S e t a b . N o r m a l l y C P / M o p e r a t e s w i t h a 8 - s p a c e t a b . T h i s i n o t h c a s e f o r h a r d c o p i e s , a n t h u s t h e t a m u s t b d e f i n e d .

s p e c i f i e s t h n u m b e r o s p a c e s t h t a i s s e t . U s w i t h t e x tf i l e s o n l y

C a p i t a l i z e . C h a n g e s a l l o w e r c a s e c h a r a c t e r s t u p p e r c a s e .U s o n l y w i t h t e x t f i l e s . W h e n u s e d w i t h W o r d S t a r , b e s u r et u s t h o p t i o n

V e r i f y . T h i s p a r a m e t e r v e r i f i e s f i l e s c o p i e d b P I P . I e n s u r e s t h a t t h n e f i l e i i d e n t i c a l t o t h o l o n W r i t e o v e r r e a d - o n l y f i l e s . T h e s e f i l e s m a n o r m a l l y b r e a d ,b u t n o t c h a n g e d o e r a s e d . T h o p t i o n c a u s e s t h e s e f i l e s t b e r a s e d w i t h o u t r e c a l l

E r a s e t h 8 t b i t . A S C I I u s e s o n l y s e v e n b i t s , a n t h 8 t b i i u t i l i z e d b m a n y a p p l i c a t i o n s p r o g r a m s f o v a r i o u sf u n c t i o n s . T h o p t i o n i n o n e c e s s a r y w h e n c o p y i n gA S C I I d a t a , s u c h a C O M : o L S T :

2 7

Page 290: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 290/316

Page 291: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 291/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

O p t i o n

R R

S Y

D I

A R C H I V E = O F F

A R C H I V E = O N

A p p e n d i x D S E C o m m a n dA t t r i b u t e s

s e t s t h f i l e a t t r i b u t e t R e a d - O n l y

s e t s t h f i l e a t t r i b u t e t R e a d - W r i t e

s e t s t h f i l e a t t r i b u t e t S Y S ; m e a n s t h a t t h f i l e i a v a i l a b l e f r o m a n U S E R a r e a

s e t s t h f i l e a t t r i b u t e t D I m e a n s f i l e h a s n o t b e e n b a c k e d u ( a r c h i v e d )

m e a n s t h a t t h f i l e h a b e e n b a c k e d u p ( a r c h i v e d ) .T h A r c h i v e a t t r i b u t e c a b t u r n e d o b S E o b P I w h e n c o p y i n g g r o u p o f i l e s w i t h t h P I [ A o p t i o n . S H O W a n D I d i s p l a y t h A r c h i v e o p t i o n

t u r n s o o o f t h u s e r - d e f i n a b l e f i l e a t t r i b u t e F

t u r n s o o o f t h u s e r - d e f i n a b l e f i l e a t t r i b u t e F t u r n s o o o f t h u s e r - d e f i n a b l e f i l e a t t r i b u t e F

t u r n s o o o f t h u s e r - d e f i n a b l e f i l e a t t r i b u t e F t u r n s o C R E A T E t i m e s t a m p s o t h d i s k i t h d e f a u l t o s p e c i f i e d d r i v e . T r e c o r d t h e c r e a t i o nt i m e o f i l e , t h C R E A T E o p t i o n m u s t b t u r n e do b e f o r e t h f i l e i c r e a t e d

t u r n s o A C C E S S t i m e s t a m p s o t h d i s k i t h d e f a u l t o s p e c i f i e d d r i v e . A C C E S S a n C R E A T Eo p t i o n s a r m u t u a l l y e x c l u s i v e ; o n l y o n c a n b e i e f f e c t a t i m e . I y o t u r n o t h A C C E S S t i m es t a m p o d i s k t h a t p r e v i o u s l y h a C R E A T E t i m es t a m p , t h C R E A T E t i m e s t a m p i a u t o m a t i c a l l yt u r n e d o f f

F 1 = O N | O F FF 2 = 0 N | O F F

F 3 = 0 N | 0 F F

F 4 = 0 N | 0 F FC R E A T E = O N

A C C E S S I O N

2 7

Page 292: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 292/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

U P D A T E = O N

P R O T E C T = O N

P R O T E C T = O F F

P R O T E C T = R E A D

t u r n s o U P D A T E t i m e s t a m p s o t h d i s k i t h d e f a u l t o s p e c i f i e d d r i v e . U P D A T E t i m e s t a m p sr e c o r d t h t i m e t h f i l e w a l a s t m o d i f i e d

t u r n s o p a s s w o r d p r o t e c t i o n f o a l t h f i l e s o t h d i s k . Y o m u s t t u r n o p a s s w o r d p r o t e c t i o nb e f o r e y o c a a s s i g n p a s s w o r d s t f i l e s

D i s a b l e s p a s s w o r d p r o t e c t i o n f o r t h e f i l e s o y o u rd i s k

T h p a s s w o r d i r e q u i r e d f o r e a d i n g , c o p y i n gw r i t i n g , d e l e t i n g o r e n a m i n g t h f i l e

P R O T E C T = W R I T E T h p a s s w o r d i r e q u i r e d f o w r i t i n g , d e l e t i n g o r e n a m i n g t h f i l e . Y o d n o n e e d p a s s w o r d t r e a d t h f i l e

P R O T E C T = D E L E T E T h p a s s w o r d i o n l y r e q u i r e d f o r d e l e t i n g o r e n a m i n g t h f i l e . Y o d n o n e e d p a s s w o r d t r e a d o m o d i f y t h f i l e

P R O T E C T = N O N E N p a s s w o r d e x i s t s f o r t h e f i l e . I p a s s w o r dp a s s w o r d e x i s t s , t h i s m o d i f i e r c a n b e u s e d t d e l e t e t h p a s s w o r d

2 8

Page 293: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 293/316

Page 294: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 294/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r f s G u i d e

C n n n n

D n n n n

F n n n n

2

3

B F - B E

D n n n n

C n n n n

F n n n n

E n n n n

F E n n

E n n n n

C A L L n n n n

C n n n n

C n n n n

C M

C M C M A -

C N C n n n n

C N n n n n

C n n n n

C P n n n n

C P I n n

C P O n n n n

U n c o n d i t i o n a ls u b r o u t i n e c a l l t a d d r e s s n n n n

C o n d i t i o n a ls u b r o u t i n e c a l l t a d d r e s s n n n n , c a r r yf l a g s e

C o n d i t i o n a ls u b r o u t i n e c a l l t oa d d r e s s n n n n , s i g nf l a g s e

P e r f o r m o n e ' sc o m p l e m e n t o a c c u l u l a t o rC o m p l e m e n t c a r r y f l a gC o m p l a r e b y t e p o i n t e dt b y r e g i s t e r w i t ha c c u m u l a t o r

C o n d i t i o n a l s u b r o u t i n ec a l l C a r r y f l a g s e C o n d i t i o n a l s u b r o u t i n ec a l l Z e r o f l a g r e s e tC o n d i t i o n a l s u b r o u t i n ec a l l S i g n f l a g s e C o n d i t i o n a l s u b r o u t i n ec a l l P a r i t y f l a g s e

C o m p a r e n t a c c u l u m a t o r

C o n d i t i o n a l s u b r o u t i n ec a l l P a r i t y f l a g r e s e t

2 8

Page 295: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 295/316

A b a c u s S o f t w a r e

C n n n n

2

0 9 - 3 9

3 D - 3 50 B - 3 B

F

C

D A

D A

D C D C

D

n n n n

B - S P

A -

B - S P

O 1 Z 5 t r / M u s e r s u u i a e

C o n d i t i o n a l s u b r o u t i n ec a l l Z e r o f l a g s e

D e c i m a l a d j u s ta c c u m u l a t o r

A d s p e c i f i e d d o u b l er e g i s t e rD e c r e m e n t r e g i s t e rD e c r e m e n t d o u b l er e g i s t e r

D i s a b l e t h i n t e r r u p t s y s t e m

F

7

D n

3 C - 3 4

0 3 - 3 3

D n n n n

E E n a b l e t h i n t e r r u p ts y s t e m

H L T H a l t t h e 8 0 8 0p r o c e s s o r

I n L o a d r e g i s t e r w i t hd a t a f r o m p o r t e

I N A -

I N B - S P

S i n g l e p r e c i s i o ni n c r e m e n t r e g i s t e rD o u b l e p r e c i s i o ni n c r e m e n t r e g i s t e rp a i r

J n n n n C o n d i t i o n a l j u m p t a d d r e s s n n n n w h e r ec a r r y f l a g s e

F n n n n J M n n n n C o n d i t i o n a l j u m p t oa d d r e s s n n n n w h e r es i g n f l a g s e

2 8

Page 296: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 296/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

D n n n n

C n n n n

F n n n n

E n n n n

E n n n n

C A n n n n

3 n n n n

0 A - 1 A

2 n n n n

0 1 - 3 1 n n n n

7 F - 7 5

J N

J N

J

J P

J P

J

L D

n n n n

n n n n

n n n n

n n n n

n n n n

n n n n

n n n n

L D A X B -

L H L D n n n n

C o n d i t i o n a l j u m p t oa d d r e s s n n n n w h e r ec a r r y f l a g r e s e t

C o n d i t i o n a l j u m p t oa d d r e s s n n n n w h e r ez e r o f l a g r e s e t

U n c o n d i t i o n a l j u m pt a d d r e s s n n n nC o n d i t i o n a l j u m p t oa d d r e s s n n n n w h e r ep a r i t y f l a g s e

C o n d i t i o n a l j u m p t oa d d r e s s n n n n w h e r ep a r i t y f l a g r e s e tC o n d i t i o n a l j u m p t a d d r e s s n n n n w h e r ez e r o f l a g s e

L o a d r e g i s t e r f r o ms p e c i f i e d a d d r e s sL o a d r e g i s t e r f r o mc o m p u t e d a d d r e s sL o a d H d i r e c t f r o ms p e c i f i e d l o c a t i o n

3 E - 3 6 n

L X B , S P , n n n n L o a d s e p i c i f i e dd o u b l e r e g i s t e r w i t hn n n n

M O A , A - M , L M o v e d a t a t l e f t m o s t e l e m e n tf r o m r i g h t m o s te l e m e n t

M V A , n n - M L o a r r e g i s t e r w i t h n

2 8

Page 297: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 297/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

0 N O N o p e r a t i o n i p e r f o r m e d b t h e C P U

B 7 - B 6 O R A - L o g i c a l " a n d " r e w i t h A

F n n O R I n n P e r f o r m l o g i c a l O w i t h t h a c c u m u l a t o r

t h e b y t e n

D n O U n S e n d d a t a f r o mr e g i s t e r t s p e c i f i e d p o r t

E P C H L F i l l p r o g r a m c o u n t e rw i t h d a t a f r o m H L

C l - F l P O P B - P S W L o a d r e g i s t e r p a i rf r o m s t a c k , s e t S

C 5 - F 5 P U S H B - P S W S t o r e r e g i s t e r p a i ri n t o s t a c k , s e t S

1 R A L R o t a t e c a r r y / Ar e g i s t e r t o l e f t

I R A R o t a t e c a r r y / Ar e g i s t e r t o r i g h t

D R C o n d i t i o n a l r e t u r nf r o ms u b r o u t i n e , c a r r yf l a g s e

C R E T R e t u r n f r o ms u b r o u t i n e

0 R L R o t a t e b i t s l e f t ,s e c a r r y a s i d ee f f e c t

2 8

Page 298: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 298/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

F R M C o n d i t i o n a l r e t u r nf r o m s u b r o u t i n e ,s i g n f l a g s e

D R N C o n d i t i o n a l r e t u r nf r o ms u b r o u t i n e , c a r r yf l a g r e s e t

C R N C o n d i t i o n a l r e t u r nf r o m s u b r o u t i n e , z e r of l a g r e s e t

F O R P C o n d i t i o n a l r e t u r nf r o m s u b r o u t i n e , s i g nf l a g r e s e t

E R P C o n d i t i o n a l r e t u r nf r o ms u b r o u t i n e , p a r i t yf l a g s e

E R P C o n d i t i o n a l r e t u r nf r o m s u b r o u t i n e ,p a r i t y f l a g r e s e t

O R R C R o t a t e b i t s r i g h t ,r e s e t c a r r y a s i d ee f f e c t

C 7 - F F R S T 0 - T h e s e r e s t a r ti n s t r u c t i o n sg e n e r a t e o n e - b y t es u b r o u t i n ec a l l s , g i v e n i t h Z - 8 0 o p e r a n d .

C 8 R Z C o n d i t i o n a l r e t u r nf r o m s u b r o u t i n e ,z e r o f l a g r e s e t

2 8

Page 299: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 299/316

Page 300: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 300/316

Page 301: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 301/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

F O G — T H E C P / M E X P E R T

Y o u V e r e a d t h b o o k a n n o w i l l h a v e g o o d , s o l i d w o r k i n g k n o w l e d g eo y o u r C o m m o d o r e 1 2 8 . A y o b e c o m e m o r e e x p e r i e n c e d , y o w i l l f i n do u h o m u c h y o c a d w i t h C P / M ( a n d h o w m u c h i c a d f o y o u ) o y o u r C o m m o d o r e . B u w o r k i n g w i t h c o m p u t e r s i n e v e r p l a i n s a i l i n g . I fy o f i n d y o n e e d a n m o r e h e l p o c l a r i f i c a t i o n , t h e r e ' s a o r g a n i z a t i o nw i t h s p e c i a l i s t ' s k n o w l e d g e o C P / M — F O G .F O i u s e r s ' g r o u p f o p e o p l e u s i n g o r i n t e r e s t e d i c o m p u t e r s . T h b u l k o i t s u p p o r t i t t h C P / M o p e r a t i n g s y s t e m . M o r e t h a n 1 6 , 0 0 0p e o p l e w o r l d w i d e s u b s c r i b e t t h m o n t h l y p u b l i c a t i o n F O G H O R N , w h i c hr e g u l a r l y r u n s t 8 p a g e s a n i w h o l l y d e v o t e d t C P / M . R e p r i n t s o a l b a c k i s s u e s a r e a v a i l a b l e f o a v a r y i n g c h a r g e ( d e p e n d i n g o t h i s s u e ) a n t w " b e s t o v o l u m e s h a v e b e e n c o m p i l e d . E a c h y e a r w i l l s e t h r e l e a s e o n e " b e s t o i s s u e .

m e m b e r s h i p i F O i $ 2 p e y e a r , a n g i v e s y o a c c e s s t a l F O s e r v i c e s . A w e l l a r e c e i v i n g t h F O G H O R N e a c h m o n t h , m e m b e r s c a d r a w f r o m a e x t e n s i v e F O G / C P M D i s k L i b r a r y c o n t a i n i n g m o r e t h a n 3 0 d i s k s a n t h o u s a n d s o f p u b l i c d o m a i n p r o g r a m s . O t h e r s e r v i c e s i n c l u d e a R C P / M n e t w o r k t h a t h a m o r e t h a n 4 R B B S - R C P / M s y s t e m s i o p e r a t i o n ,m o s t o w h i c h a c c e p t b o t h 3 0 b a u d a n d 1 2 0 0 b a u d . I a d d i t i o n , n e t w o r ko F O G - a f f i l i a t e d l o c a l g r o u p s m e e t a m o r e t h a n 3 0 l o c a t i o n s . S p e c i a li n t e r e s t g r o u p s o r g a n i z e d t a u g m e n t t h l o c a l g r o u p m e e t i n g s c o v e r s u c ha r e a s a d A S n h a r a d i o o p e r a t o r s , a n P e r s o n a l P e a r l .

A n o t h e r v a l u a b l e F O s e r v i c e i i t t e c h n i c a l h o t l i n e — a p h o n e s e r v i c ep r o v i d e d b F O G ' s c o m p u t e r e x p e r t s w h g i v e a d v i c e a n a s s i s t a n c e t c a l l e r s . T h h o t l i n e o p e r a t e s M o n d a y t F r i d a y 1 0 a m t 5 . 3 0 p m P S T . T h p h o n e n u m b e r i ( 4 1 5 ) 7 5 5 - 2 0 0 0 .F O w a f o u n d e d i O c t o b e r , 1 9 8 1 b a s m a l l b a n d o e a r l y b u y e r s o t h O s b o r n e 1 T h p r i m a r y p u r p o s e w a t o r g a n i z e l i b r a r y o p u b l i c d o m a i ns o f t w a r e t r u o t h O - l . n e w s l e t t e r ( w h i c h d e v e l o p e d i n t o t h F O G H O R N ) w a q u i c k l y b e c a m e t h e f o c a l p o i n t f o r t h e g r o u p ' s a c t i v i t i e s .

T o d a y , a M S - D O S s y s t e m s b e c o m e m o r e p r e v a l e n t i t h b u s i n e s s w o r l d ,a n a m a n y m e m b e r s h a v e d i v e r s i f i e d t h e i r i n t e r e s t s t b o t h C P / M a n M S - D O S o p e r a t i n g s y s t e m s , F O r e c e n t l y b e g a n s u p p o r t i n g 1 6 - / 3 2 - b i ts y s t e m s t h r o u g h n e p u b l i c a t i o n , t h e F O G L I G H T , a n a n o t h e r d i s kl i b r a r y .

2 8

Page 302: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 302/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

F O i h e a d q u a r t e r e d i D a l y C i t y , n e a r S a F r a n c i s c o . T h p o s t a l a d d r e s si s

F O B o 3 4 7 4D a l y C i t y 9 4 0 1 5 - 0 4 7 4

T h o f f i c e l o c a t i o n i s

F O 2 9 8 9 t h S t S u i t e 3 0 D a l y C i t y C 9 4 0 1 5 .

2 9

Page 303: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 303/316

I n d e x

Page 304: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 304/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

2 9

Page 305: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 305/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

A d d i t i o n a l U t i l i t i e s d i s k e t t e , 1 2 a r c h i v e f l a g , 9 A S C E c o d e , 1 3 , 9 5

c h a n g i n g v a l u e / k e y b o a r d , 1 0 c o n v e r s i o n t a b l e , 2 6

a s s e m b l e r s ( m a c / r m a c ) , 1 2 a s t e r i s k , 3 7 4 1 - 4 2

b a c k u p s , 1 a u t o m a t i c , 9

B D O S , 2 2 1 4 r o u t i n e s , 1 4

b i n a r y , 1 0 - 1 1B I O S , 2 2 1 4 b i t , 1

8 t b i t , 9 b o o t i n g , 2

c a r r i a g e r e t u r n ( C R ) , 2 C O f i l e s , 4 c o m m a n d , 2 7 , 4 6C o m m o d o r e 1 2 ( u n d e r C P / M ) , 1 0 c o m p u t e r ,c o n c a t e n a t i o n , 8 C o n s o l e C o m m a n d P r o c e s s o r , ( C C P ) , 1 4 2C O N T R O L c o d e s , 2 7 C O P Y S Y S , 2 2 C P / M , 2

c o m m a n d s , 2 2 5 - 2 6 4v e r s i o n 2 . 2 , 2 v e r s i o n 3 . 0 , 2

C P U , 1 d a i s y w h e e l p r i n t e r s ,D A T E , 2 2 D E V I C E , 2 2 D i g i t a l R e s e a r c h , 1 2 4 - 1 2 5D I R , 5 1 2 3 d i r e c t o r y , 2

d i s p l a y i n g , 3 D I R S Y S , 2 3

2 9

Page 306: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 306/316

A b a c u s S o f t w a r e C - 1 2 8 C P / M U s e r ' s G u i d e

d i s k d r i v e s , 1 4 7 2 - 7 51 5 4 1 a n 1 5 7 1 , 1 0 1 , 1 0

d o m a t r i x p r i n t e r s ,D U M P , 2 3

e c h o , 1 0 E D 2 3 e n d - o f - f i l e i n d i c a t o r , 8 E R A S E , 5 e x t e n s i o n s , 3 8 - 3 4 0f i l e s , 3

m e r g i n g , 8 9n o n - t e x t , 8 o v e r w r i t i n g , 9 t e x t , 8

f i l e n a m e s , 3 8 - 3 9f l o p p y d i s k e t t e s , 1 4 7

c o p y i n g , 8 f o r m a t s , 1 0 M F f o r m a t , 1 0 5 , 1 1 5

F O ( C P / M r e s o u r c e ) , 2 8 F O R M A T , 2 3 f o r m a t ( p r i n t e r p a g e ) , 9 f o r m a t t i n g , 1 5 3 2 3 f u n c t i o n k e y s , 1 1

s p e c i a l f u n c t i o n s , 1 1

G E N C O M , 2 4 G E T , 2 4

h a r d c o p y , 9 h a r d d i s k d r i v e , 1 H E L P , 7 9 2 4 H E X C O M , 2 4 I N I T D I R , 2 4 i n k - j e t p r i n t e r s ,

k e y b o a r d , 4 1 0 K E Y F I G , 2 4

2 9

Page 307: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 307/316

Page 308: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 308/316

Page 309: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 309/316

Page 310: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 310/316

Page 311: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 311/316

C - 1 2 8 R E Q U I R E DZ w R E A D I N G

D e t a i l e d g u i d e p r e s e n t s t h e 1 2 8 ' so p e r a t i n g s y s t e m , e x p l a i n s g r a p h i cc h i p s . M e m o r y M a n a g e m e n t U n i t , 8 c o l u m n g r a p h i c s a n c o m m e n t e dR O l i s t i n g s . 5 O 0 p p $ 1 9 . 9 5

G e a l t h e i n s i d e i n f o r m a t i o n o B A S I C 7 . 0 . T h i s e x h a u s t i v e h a n db o o k i c o m p l e t e w i t h c o m m e n t e dB A S I C 7 . R O l i s t i n g s . C o m i n gS u m m e r ' 8 6 . $ 1 9 . 9 5

F i l l e d w i t h i n f o f o r e v e r y o n e . C o v e r s8 c o l u m n h i - r e s g r a p h i c s , w i d o w i n g , m e m o r y l a y o u t , K e r n a lr o u t i n e s , s p r i t e s , s o f t w a r e p r t e c t i o n , a u t o s t a r t i n g . 3 0 0 p p $ 1 9 . 9 5

I n s i d e r s ' g u i d e f o n o v i c e a d v a n c e d u s e r s . C o v e r s s e q u e n t i a lr e l a t i v e f i l e s , d i r e c t a c c e s s c o m -m a n d s . D e s c r i b e s D O r o u t i n e s ,C o m m e n t e d l i s t i n g s . $ 1 9 . 9 5

L e a r n f u n d a m e n t a l s o C A w h i l ed e v e l o p i n g y o u r o w s y s t e m . D e s i g no b j e c t s o y o u r s c r e e n t d u m p t p r i n t e r . I n c l u d e s l i s t i n g s f o r ' 6 w i t hS i m o n ' s B a s i c . 3 0 0 p p $ 1 9 . 9 5

I n t r o d u c t i o n t o p r o g r a m i n g ; p r o b l e m P r e s e n t s d o z e n s o p r o g r a m m i n g E s s e n t i a l g u i d e f o e v e r y o n e i n t e r -a n a l y s i s ; t h o r o u g h d e s c r i p t i o n o a l q u i c k - h i t t e r s . E a s y a n d u s e f u l e s t e d i C P / M o t h e 1 2 8 . S i m p l eB A S I C c o m m a n d s w i t h h u n d r e d s o t e c h n i q u e s o t h e o p e r a t i n g s y s t e m ,

' " " t i t e x a m p l e s : m o n i t o r c o m m a n d s ; u t i li t i e s ; m u c h m o r e . $ 1 6 . 9 5

p y s t a c k s , z e r o - p a g e , p o i n t e r s , t h eB A S I C i n t e r p r e t e r a n m o r e . $ 1 6 . 9 5

e x p l a n a t i o n o t h e o p e r a t i n g s y s t e m ,m e m o r y u s a g e , C P / M u t i l i t y p r g r a m s , s u b m i t f i l e s m o r e . $ 1 9 . 9 5

A N A T O M Y O C - 6 4 I n s i d e r ' s g u i d e t t h ' 6 4 i n t e r n a l s . G r a p h i c s , s o u n d , I / O , k e r n a l ,m e m o r y m a p s , m o r e . C o m p l e t e c o m m e n t e dR O l i s t i n g s . 3 0 0 p p $ 1 9 . 9 5A N A T O M Y O 1 5 4 X & D R I V E B e s th a n d b o o k o n V f t ^ ^ K r o l a i i a s a l l . M a n ye x a m p l e s a n Q M » H » * f f l y c o m m e n t e d1 5 4 1 R O l i s t i n g s ^ 5 0 0 p p $ 1 9 . 9 5M A C H I N E L A N G U A G E C - 6 4 L e a r n6 5 1 0 c o d e w r i t e f a s t p r o g r a m s . M a n y s a p l e s a n l i s t i n g s f o c o m p l e t e a s s e m b l e r ,m o n i t o r , s i m u l a t o r . 2 0 0 p p $ 1 4 . 9 5G R A P H I C S B O O K C - 6 4 b e s t r e f e r e n c ec o v e r s b a s i c a n d a d v a n c e d g r a p h i c s .S p r i t e s , a n i m a t i o n . H i r e s , M u l t i c o l o r ,l i g h t p e n , 3 D - g r a p h i c s , I R Q , C A D , p r j e c t i o n s , c u r v e s , m o r e . 3 5 0 p p $ 1 9 . 9 5

T R I C K S T I P S F O C - 6 4 C o l l e c t i o n o e a s y - t o - u s e t e c h n i q u e s : a d v a n c e d g r a p h i c s ,i m p r o v e d d a t a i n p u t , e n h a n c e d B A S I C ,C P / M , m o r e . 2 7 5 p p ~ $ 1 9 . 9 51 5 4 1 R E P A I R M A I N T E N A N C EH a n d b o o k d e s c r i b e s t h d i s k d r i v e h a r dw a r e . I n c l u d e s s c h e m a t i c s a n t e c h n i q u e st k e e p 1 5 4 1 r u n n i n g . 2 0 0 p p $ 1 9 . 9 5A D V A N C E D M A C H I N E L A N G U A G EN o t c o v e r e d e l s e w h e r e : v i d e o c o n t r o l l e r ,i n t e r r u p t s , t i m e r s , c l o c k s , I / O , r e a l t i m e !e x t e n d e d B A S I C , m o r e . 2 1 0 p p $ 1 4 . 9 5P R I N T E R B O O K C - 6 4 / V I C - 2 0 U n d e rs t a n d C o m m o d o r e . E p s o n - c o m p a t i b l e p r i n te r a n d 1 5 2 0 p l o t t e r . P a c k e d : u t i l i t i e s ; g r p h i c s d u m p ; 3 0 - p l o t ; c o m m e n t e d M P S 8 0 1R O l i s t i n g s , m o r e . 3 3 0 p p $ 1 9 . 9 5

A b a c u s

S C I E N C E / E N G I N E E R I N G O C - 6 4 I d e p t h i n t r o t o c o m p u t e r s i s c i e n c e . T o p i c s :c h e m i s t r y , p h y s i c s , b i o l o g y , a s t r o n o m y ,e l e c t r o n i c s , o t h e r s . 3 5 0 p p $ 1 9 . 9 5C A S S E T T E B O O K C - 6 4 / V I C - 2 0C o m p r e h e n s i v e g u i d e ; m a n y s a m p l ep r o g r a m s . H i g h s p e e d o p e r a t i n g s y s t e mf a s t f i l e l o a d i n g a n s a v i n g . 2 2 p $ 1 4 . 9 5I D E A S F O U S O C - 6 4 T h e m e s :a u t o e x p e n s e s , c a l c u l a t o r , r e c i p e f i l e , s t o c kl i s t s , d i e t p l a n n e r , w i n d o w a d v e r t i s i n g ,o t h e r s . I n c l u d e s l i s t i n g s . 2 0 0 p p $ 1 2 . 9 5C O M P I L E R B O O K C - 6 4 / C - 1 2 8 A l y o n e e d t k n o w a b o u t c o m p i l e r s : h o t h e yw o r k ; d e s i g n i n g a n w r i t i n g y o u r o w n ;g e n e r a t i n g m a c h i n e c o d e . W i t h w o r k i n ge x a m p l e c o m p i l e r . 3 0 0 p p $ 1 9 . 9 5

C - 1 2 8 a n d C - 6 4

A d v e n t u r e G a m e w r l t e r ' s H a n d b o o kS t e p - b y - s t e p g u i d e t d e s i g n i n g a n w r i t i n gy o u r o w a d v e n t u r e g a m e s . W i t h a u t o m a t e da d v e n t u r e g a m e g e n e r a t o r . 2 0 0 p p $ 1 4 . 9 5P E E K S & P O K E S F O R T H E C - 6 4I n c l u d e s i n - d e p t h e x p l a n a t i o n s o P E E K ,P O K E . U S R , a n o t h e r B A S I C c o m m a n d s .L e a r n t h " i n s i d e " t r i c k s t g e t t h e m o s t o u o y o u r " 6 4 . 2 0 0 p p $ 1 4 . 9 5O p t i o n a l D i s k e t t e s f o b o o k sF o r y o u r c o n v e n i e n c e , t h p r o g r a m sc o n t a i n e d i e a c h o o u b o o k s a r a v a i la b l e o d i s k e t t e t s a v e y o u t i m e e n t e r i n gt h e m f r o m y o u r k e y b o a r d . S p e c i f y n a m e o b o o k w h e n o r d e r i n g . $ 1 4 . 9 5 e a c h

o C o m m o d o r e B u s i n e s s M a c h i n e s I n c .

r a S o f t w a r eP . O . B o 7 2 1 9 G r a n d R a p i d s , M 4 9 5 1 0 T e l e x 7 0 9 - 1 0 1 P h o n e { 6 1 6 ) 2 4 - 5 5 1 0

C a l l n o f o t h n a m e o y o u r n e a r e s t d e a l e r . O t o r d e r d i r e c t l y b c r e d i t c a r d , M C A M E X o V I S A c a l l ( 6 1 6 )2 4 1 - 5 5 1 0 . O t h e r s o f t w a r e a n d b o o k s a r a v a i l a b l e - C a l l a n a s f o y o u r f r e e c a t a l o g . A d $ 4 . 0 0 f o s h i p p i n gp e o r d e r . F o r e i g n o r d e r s a d $ 1 0 . 0 0 p e b o o k . D e a l e r i n q u i r e s w e l c o m e - 1 4 0 0 + n a t i o n w i d e .

Page 312: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 312/316

U L A RT h c o m p l e t e c o m p i l e ra n d d e v e l o p m e n t p a c ka g e . S p e e d u y o u r p r g r a m s 5 t 3 5 x . M a n yo p t i o n s : f l e x i b l e m e m o r ym a n a g e m e n t ; c h o i c e o c o m p i l i n g t m a c h i n ec o d e , c o m p a c t p - c o d e o b o t h . ' 1 2 8 v e r s i o n : 4 o 8 c o l u m n m o n i t o r o u t p u ta n F A S T - m o d e o p e r at i o n . ' 1 2 8 C o m p i l e r ' s e t e n s i v e 8 0 - p a g e p r g r a m m e r ' s g u i d e c o v e r sc o m p i l e r d i r e c t i v e s a n o p t i o n s , t w l e v e l s o f

o p t i m i z a t i o n , m e m o r y u s a g e , I / h a n d l i n g , 8 c o l u m n h i - r e s g r a p h i c s , f a s t e r ,h i g h e r p r e c i s i o n m a t h f u n c t i o n s , s p e e d a n d s p a c e s a v i n g t i p s , m o r e . g r e a tp a c k a g e t h a t n s o f t w a r e l i b r a r y s h o u l d b w i t h o u t . 1 2 C o m p i l e r $ 5 9 . 9 5

6 4 C o m p i l e r $ 3 9 . 9 5

F o r s c h o o l o s o f t w a r ed e v e l o p m e n t . L e a r n o y o u r C o m m o d o r e w i t h o u i n d e p t h t u t o r i a l . C o m p i l e p r g r a m s i n t o f a s t m a c h i n el a n g u a g e . C - 1 2 8 v e r s i o n h a a d d e d f e a t u r e s : U n i x ™ - l i k eo p e r a t i n g s y s t e m ; 6 0 R A d i s k f o r f a s t e d i t i n g a n c o m p i l i n g L i n k e r c o m b i n e su t 1 m o d u l e s ; C o m b i n eM / L a n d u s i n g C A L L ; 5 1 a v a i l a b l e f o o b j e c t c o d e ;

F a s t l o a d i n g ( s e c . 1 5 7 1 , 1 s e c . 1 5 4 1 ) ; T w s t a n d a r d I / l i b r a r y s p l u st w a d d i t i o n a l l i b r a r i e s — m a t h f u n c t i o n s ( s i n , c o s , s q r t , e t c . ) 2 0 g r a p h i cc o m m a n d s ( l i n e , f i l l , d o t , e t c . ) . C - 1 2 8 $ 7 9 . 9 5

C - 6 4 $ 7 9 . 9 5

R e m a r k a b l y e a s y - t o - u s ei n t e r a c t i v e d r a w i n g p a c ka g f o a c c u r a t e g r a p h i cd e s i g n s . N e d i m e n s i o ni n f e a t u r e s t c r e a t ee x a c t s c a l e d o u t p u t t a l m a j o r d o t - m a t r i x p r i n t e r s .E n h a n c e d v e r s i o n a l l o w sy o t i n p u t v i a k e y b o a r do h i g h q u a l i t y l i g h t p e n .T w g r a p h i c s c r e e n s f o C O P Y i n g f r o m o n t t h o t h e r . D R A W , L I N E , B O X ,C I R C L E , A R C , E L L I P S Ea v a i l a b l e . F I L L o b j e c t sw i t h p r e s e l e c t e d P A T -

T b H N S ; a d T E X T ; S A V E a n R E C A L L d e s i g n s t o / f r o m d i s k . D e f i n e y o u r o w l i b r a r y o s y m b o l s / o b j e c t s w i t h t h e e a s y - t o - u s e O B J E C T M A N A G E M E N TS Y S T E M - s t o r e u t 1 0 s e p a r a t e o b j e c t s . C - 1 2 8 $ 5 9 . 9 5

C - 6 4 $ 3 9 . 9 5

<

i P R I C

\ A > \ \ \

J R n H

1 ! E

-

L J G E^ • X «

u M * t d i r . « l

E

M u t .

l 4 V . ( 1 0 S H - o * i i u w M O .n U u k c a

0 - c M r O .

/ i n nA , . t * , l u l . l « h 0 .

C o m p i l e r a n d S o f t w a r eD e v e l o p m e n t S y s t e m

N o j u s t c o m p i l e r , b u c o m p l e t e s y s t e m f o d e v e l o pi n g a p p l i c a t i o n s i P a s c a lw i t h g r a p h i c s a n s o u n df e a t u r e s . E x t e n s i v e e d i t o rw i t h s e a r c h , r e p l a c e , a u t o ,r e n u m b e r , e t c . S t a n d a r d

c o m p i l e r t h a t g e n e r a t e sf a s t m a c h i n e c o d e . I y o w a n t t l e a r n P a s c a l o r t od e v e l o p s o f t w a r e u s i n g t h b e s t t o o l s a v a i l a b l e - S U P E RP a s c a l i y o u r f i r s t c h o i c e .

C - 1 2 8 $ 5 9 . 9 5C - 6 4 $ 5 9 . 9 5

E a s i l y c r e a t e p r o f e s s i o n a lh i g h q u a l i t y c h a r t s a n g r a p h s w i t h o u t p r o g r a m m i n g .Y o c a i m m e d i a t e l y c h a n g et h s c a l i n g , l a b e l i n g , a x i s ,b a r - f i l l i n g , e t c . t s u i t y o u rn e e d s . A c c e p t s d a t a f r o mC a l c R e s u l t a n M u l t i P l a n .C - 1 2 8 v e r s i o n h a 3 t h r e s o l u t i o n o t h ' 6 4 v e r s i o n .O u t p u t s t m o s t p r i n t e r s .

C - 1 2 8 $ 3 9 . 9 5C - 6 4 $ 3 9 . 9 5

O T H E R T I T L E S A V A I L A B L E :T e c h n i c a l A n a l y s i s S y s t e m

S o p h i s t i c a t e d c h a r t i n g a n t e c h n i c a l a n a l y s i s s y s t e m f o s e r i o u s i n v e s t o r s . C h a r t i n g a n a n a l y z i n g p a s t h i s t o r y o fs t o c k , T A c a h e l p p i n p o i n t t r e n d s p a t t e r n s a n p r e d i c ts t o c k ' s f u t u r e . E n t e r d a t a f r o m t h k e y b o a r d o f r o m o n l i n ef i n a n c i a l s e r v i c e s . C - 6 4 $ 5 9 . 9 5

P e r s o n a l P o r t f o l i o M a n a g e rC o m p l e t e p r o t f o l i o m a n a g e m e n t s y s t e m f o t h i n d i v i d u a l o p r o f e s s i o n a l i n v e s t o r . E a s i l y m a n a g e y o u r p o r t f o l i o s , o b t a i nu p - t o - t h e - m i n u t e q u o t e s a n n e w s , a n p e r f o r m s e l e c t e da n a l y s i s . E n t e r q u o t e s m a n u a l l y o a u t o m a t i c a l l y t h r o u g hW a r n e r C o m p u t e r S y s t e m s . C - 6 4 $ 3 9 . 9 5

X p e rX P E R i t h f i r s t " e x p e r t s y s t e r r t ' f o t h C - 1 2 8 a n d C - 6 4 . W h i l eo r d i n a r y d a t a b a s e s y s t e m s a r g o o d f o r e p r o d u c i n g f a c t s ,X P E R c a d e r i v e k n o w l e d g e f r o m m o u n t a i n o f a c t s a n h e l py o m a k e e x p e r t d e c i s i o n s . L a r g e c a p a c i t y . C o m p l e t e w i t he d i t i n g a n r e p o r t i n g . C - 6 4 $ 5 9 . 9 5

C - 1 2 8 a n C - 6 4 « t r a d e m a r k s o C o m m o d o r e B u s i n e s s M a c h i n e s I n c .U n i x i a t r a d e m a r k o B e L a b o r a t o r i e s

S o f t w a r eP . O . B o x 7 2 1 9 G r a n d R a p i d s , M 4 9 5 1 0 - T e l e x 7 0 9 - 1 0 1 - P h o n e ( 6 1 6 ) 2 4 1 - 5 5 1 0

C a l l n o f o t h n a m e o y o u r n e a r e s t d e a l e r . O t o r d e r d i r e c t l y b c r e d i t c a r d , M C A M E X o V I S A c a l l ( 6 1 6 )2 4 1 - 5 5 1 0 . O t h e r s o f t w a r e a n b o o k s a r e a v a i l a b l e - C a l l a n a s f o y o u r f r e e c a t a l o g . A d $ 4 . 0 0 f o s h i p p i n gp e o r d e r . F o r e i g n o r d e r s a d $ 1 2 . 0 0 p e r i t e m . D e a l e r i n q u i r e s w e l c o m e - 1 4 0 0 + n a t i o n w i d e .

P o w e r P l a nO n o t h m o s t p o w e r f u l s p r e a d s h e e t s w i t h i n t e g r a d e dg r a p h i c s . I n c l u d e s m e n u o k e y w o r d s e l e c t i o n s , o n l i n e h e l ps c r e e n s , f i e l d p r o t e c t i o n , w i n d o w i n g . t r i g f u n c t i o n s a n m o r e .P o w e r G r a p h , t h g r a p h i c s p a c k a g e , i i n c l u d e d t c r e a t ei n t e g r a t e d g r a p h s c h a r t s . C - 6 4 $ 3 9 . 9 5

$ 3 9 . 9 5$ 3 9 . 9 5$ 3 9 . 9 5

C O B O L C o m p i l e r f o t h C - 6 4A d C o m p i l e r f o t h C - 6 4V i d e o B a s i c L a n g u a g e f o t h C - 6 4

A b a c u s

Page 313: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 313/316

R E Q U I R E D R E A D I N GI N T E R N A L S

E s s e n t i a l g u i d e t o l e a r n i n g t h eI n s i d e i n f o r m a t i o n o t h S T D e t a i l e d d e s c r i p t i o n s o s o u n d

g r a p h i c s c h i p s , i n t e r n a lh a r d w a r e , v a r i o u s p o r t s , G E M .C o m m e n t e d B I O S l i s t i n g . A i n d i s p e n s i b l e r e f e r e n c e f o y o u r l i b r a r y . 4 5 0 p p . $ 1 9 . 9 5

G E P r o g r a m m e r ' s R e f .F o s e r i o u s p r o g r a m m e r s i n e e d o d e t a i l e d i n f o r m a t i o no G E M . W r i t t e n w i t h a e a s y - t o - u n d e r s t a n d f o r m a t . A l G E e x a m p l e s a r w r i t t e n i

a n a s s e m b l y . R e q u i r e dr e a d i n g f o t h e s e r i o u s p r og r a m m e r . 4 5 0 p p . $ 1 9 . 9 5

T R I C K S T I P SF a n t a s t i c c o l l e c t i o n o p r g r a m s a n d i n f o f o r t h S T C o m p l e t e p r o g r a m s i n c l u d e :s u p e r - f a s t R A d i s k ; t i m e -s a v i n g p r i n t e r s p o o l e r ; c o l o rp r i n t h a r d c o p y ; p l o t t e r o u t p u th a r d c o p y . M o n e y s a v i n g t r i c k sa n t i p s . 2 0 p p $ 1 9 . 9 5

G R A P H I C S & S O U N DD e t a i l e d g u i d e t u n d e r s t a n di n g r a p h i c s s o u n d o t h S T 2 3 f u n c t i o n p l o t t e r s ,M o i r e p a t t e r n s , v a r i o u s r e s ol u t i o n s a n g r a p h i c m e m o r y ,f r a c t a l s , w a v e f o r m g e n e r a t i o n .E x a m p l e s w r i t t e n i C L O G O ,B A S I C a n M o d u l a 2 . $ 1 9 . 9 5

B A S I C T r a i n i n g G u i d eI n d i s p e n s i b l e h a n d b o o k f o b e g i n n i n g B A S I C p r o g r a mm e r s . L e a r n f u n d a m e n t a l s o p r o g r a m m i n g . F l o w c h a r t i n g ,n u m b e r i n g s y s t e m , l o g i c a lo p e r a t o r s , p r o g r a m s t r u c t u r e s ,b i t s b y t e s , d i s k u s e . c h a p t e rq u i z z e s . 2 0 0 p p . $ 1 6 . 9 5

P R E S E N T I N G T H S G i v e s y o u a n i n - d e p t hl o o k a t h i s s e n s a t i o n a ln e c o m p u t e r . D i s c u s s e st h a r c h i t e c t u r e o t h S T w o r k i n g w i t h G E M ,t h m o u s e , o p e r a t i n gs y s t e m , a l t h v a r i o u si n t e r f a c e s , t h 6 8 0 0 0c h i p a n i t i n s t r u c t i o n s ,L O G O . $ 1 6 . 9 5

M A C H I N E L A N G U A G EP r o g r a m i t h f a s t e s tl a n g u a g e f o y o u r A t a r iS T L e a r n t h 6 8 0 0 0a s s e m b l y l a n g u a g e , i t n u m b e r i n g s y s t e m , u s o r e g i s t e r s , t h s t r u c t u r e

i m p o r t a n t d e t a i l s o f t h i n s t r u c t i o n s e t , a n d u s e o t h i n t e r n a l s y s t e mr o u t i n e s . 2 8 0 p p $ 1 9 . 9 5

L O G OT a k e c o n t r o l o y o u rA T A R I S b l e a r n i n gL O G O - t h e e a s y - t o - u s e ,y e p o w e r f u l l a n g u a g e .T o p i c s c o v e r e d i n c l u d es t r u c t u r e d p r o g r a m m i n g ,g r a p h i c m o v e m e n t , f i l eh a n d l i n g a n m o r e . A e x c e l l e n t b o o k f o k i d s a w e l l a a d u l t s . $ 1 9 . 9 5

P E E K S & P O K E SE n h a n c e y o u r p r o g r a m sw i t h t h e e x a m p l e s f o u n dw i t h i n t h i s b o o k . E x p l o r e su s i n g t h d i f f e r e n t l a n gu a g e s B A S I C , C L O G Oa n d m a c h i n e l a n g u a g e ,u s i n g v a r i o u s i n t e r f a c e s ,m e m o r y u s a g e , r e a d i n ga n s a v i n g f r o m a n t d i s k , m o r e . $ 1 6 . 9 5

B E G I N N E R ' S G U I D EF i n a l l y b o o k f o t h o s en e t t h S w a n t i n g t u n d e r s t a n d i n g S b a s i c s .T h o r o u g h l y u n d e r s t a n dy o u r S a n i t m a n yd e v i c e s . L e a r n t h f u n d am e n t a l s o B A S I C , L O G Oa n m o r e . C o m p l e t e w i t hi n d e x , g l o s s a r y a n i l l u st r a t i o n s . + 2 0 0 p p $ 1 4 . 9 5

B A S I C T O I y o a r e a l r e a d y f a m i l i a rw i t h B A S I C , l e a r n i n gw i l l b a l t h a t m u c he a s i e r . S h o w s t h e t r a n si t i o n f r o m a B A S I Cp r o g r a m , t r a n s l a t e d s t e pb s t e p , t t h f i n a lp r o g r a m . F o a l u s e r si n t e r e s t e d i t a k i n g t h en e x t s t e p . $ 1 9 . 9 5

T h e A T A R I l o g o a i A T A R I S e r f r a t e m w k s o f A t a r i C o r p .

A b a c u s l i S o f t w a r eP . O . B o 7 2 1 9 G r a n d R a p i d s , M 4 9 5 1 0 - T e l e x 7 0 9 - 1 0 1 - P h o n e ( 6 1 6 ) 2 4 1 - 5 5 1 0O p t i o n a l d i s k e t t e s a r e a v a i l a b l e f o a l b o o k t i t l e s a $ 1 4 . 9 5C a l l n o f o t h n a m e o y o u r n e a r e s t d e a l e r . O o r d e r d i r e c t l y f r o m A B A C U S w i t h y o u r M a s t e r C a r d , V I S A , o A m e x c a r d . A d $ 4 . 0 0 p e o r d e r f o p o s t a g e a n h a n d l i n g . F o r e i g n a d $ 1 0 . 0 0 p e r b o o k . O t h e r s o f t w a r e a n b o o k s c o m i n g s o o n . C a l l o w r i t e f o r y o u r f r e e c a t a l o g . D e a l e r i n q u i r i e s w e l c o m e - o v e r 1 4 0 0 d e a l e r s n a t i o n w i d e .

Page 314: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 314/316

Page 315: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 315/316

Page 316: Commodore 128 Book 8 CPM User's Guide

8/6/2019 Commodore 128 Book 8 CPM User's Guide

http://slidepdf.com/reader/full/commodore-128-book-8-cpm-users-guide 316/316