CCS System 300, Supplementary Manual

Page 1: ...System 300 CP M SUPPLEMENTARY MANUAl It CaUfomia COlDpater SystelDs ...

Page 2: ...sion of California Computer Systems The information contained in this manual is believed to be correct at the time of pUblication However CCS assumes no liability resulting from the use of this manual Publication History Preliminary version print March 1981 Revision A printed June 1981 Revision B printed September 1981 CP M is a trademark of Digital Research Inc ...

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

Page 4: ...EM 300 UTITLITY PROGRAMS CC30GEN CC30INIT Documentation Conventions 3 4 1 Description 3 4 2 Requirements Restrictions 3 4 3 Operat ion 3 4 4 Error Messages CC30COPY Description Requirements Restrictions Operation Error Messages Description Requirements Restrictions Operation Error Messages 3 1 3 2 3 2 3 2 3 3 3 5 3 9 Description 3 9 Operation 3 9 3 10 3 10 3 10 3 10 3 12 3 14 3 14 3 14 3 15 3 16 3...

Page 5: ...nt System CCS has made the necessary modifications to the operating system for it to work with CCS s System 300 and has expanded its drive handling capabilities As distributed the System 300 CP M supports the following Single sided and double sided 8 floppy disk drives Single sided 5 25 floppy disk drives Single and double density diskettes conforming to the IBM 3740 and System 34 formats and cont...

Page 6: ...e BIOS and the system loaders are described in the next chapter Chapter 3 describes the utility programs To aid the customizing of the software the appendices describe how to tailor the software for different applications ...

Page 7: ...e memory configuration then the space available for the TPA in CCS s version is 2K less than in a normal CP M load This is true even when a transient program overlays the CCP the beginning address of the system load in this case FBASE is also negatively offset 2K from the standard CP M load Please note that the entry points into the BIOS will also be offset by 2K or 800h 2 2 RESERVED PAGE 0 RAM Pa...

Page 8: ... address of the BOOS and hence the lowest address in memory used by CP M if the CCP is overlaid The first five of the seven Z 80 restart loca tions are not u ed by CP M The sixth restart location 0030H 0032H is held reserved for future use The seventh restart location 0038H 003AH contains a jump instruction into the DDT or SID when programmed breakpoints are used in the debug mode These locations ...

Page 9: ... floppy diskettes of varying formats it uses a modified version of CP M s sector deblocking algorithms CC30BIOS also implements the Intel MDS IOBYTE as described in Section 2 4 6 below and in Digital Research s IICP r l 2 2 Al teration Guide II 2 4 1 Diskette Compatibility CC30BIOS is designed to be compatible with 8 11 and 5 25 11 soft sectored unrecorded diskettes that conform to the IBM 3740 an...

Page 10: ...576 000 1 1 1 1 1 1 1 1 Double 1 1024 I 5 25 11 I 5 i 163 840 i 1 I 1 8 i 8 1 614 400 1 User capacity figures based on single sided drives and on 5 25 drives with 35 tracks Table 2 2 Compatible Diskette Formats CC30BIOS has been designed to read recorded diskettes of the standard 128 byte sector single density single sided format that have been formatted by a disk controller chip of the 179x famil...

Page 11: ...eration forces the contents of the buffer to be written out to disk An occasional result of this holding operation is that a reboot operation can be initiated without the memory buffer being emptierl first Thus the final writes of data never get transferred from memory to disk and are lost To ensure your software is compatible with the deblocking mode you can do one of the following 1 For new soft...

Page 12: ...ories according to basic function Console primary channel of communication between user and system List output list devices such as printers Reader paper taper reader and Punch paper tape punch It allows one of four physical devices to be assigned to a logical device category at anyone time As shipped CC30BIOS supports the following physical to logical device assignments I Logical Physical Actual ...

Page 13: ...tioned in Section 2 4 4 above the basic I O routines in CC30BIOS drive ports SIOA SlOB and PIOA The following corrolation is made between the BDOS jump targets and the BIOS basic I O routines I BDOS Jump Basic I O Routine Function I I Targets Routines I I I I CONST CSTS Console Status I I CONIN CI Console Input I I CONOUT CO Console Output I I LIST LO List Output I I PUNCB PO Punch Output I I READ...

Page 14: ...ssignments it does not support are equated to the IOER routine see Table 2 5 below The IOER routine outputs the 10 ASGT ERROR message and sets the physical to Iogical assignments to the Teletype in all categories see Section 2 4 7 below See Appendix A for instructions on adding peripheral drivers The following table lists the basic I O routines for each logical device the peripheral drivers select...

Page 15: ...ut driver RUSTI status UR2 Assignment RUSI2 input driver RUST2 status TTYIN Equate IOER Equate IOER Equate IOER Equate IOER Equate IOER Equate IOER Equate LOGICAL PUNCH DEVICE PO output TTY Assignment TTYPNCH output PUN Assignment HSP output driver HSPST status UPI Assignment PUSOI output driver PUSTI status TTYOUT Equate IOER Equate IOER Equate lOER Equate lOER Equate ...

Page 16: ... reboot your system I O ASSIGNMENT ERROR You can use the CP M STAT command as described in the Digital Research manual II An Introduction to CP M Features and Facilities ll to alter the contents of IOBYTE and thus change the physical to logical I O device assignments CC30BIOS contains driver routines only for the teletype TTY device in each logical device categories and for the CRT and Line Printe...

Page 17: ... of job the bisk Timeout error message DISK TIMEOUT is displayed and control is returned to the BDOS BOOT ERROR During a warm boot of CP M the warm boot routine outputs the message BAD BOOT and rings the console bell if it cannot read the system after ten tries If you hit the carriage return key the routine will try ten more times to read in the system ...

Page 18: ...NIT CC30GEN or CC30COPY is executing it does not access the the printer driver routines in the the BIOS This means that the console displays cannot be routed to the printer Also note that the above programs work directly with CCS s disk controller boards and thus cannot work in systems using other manufacturer s boards 3 1 DOCUMENTATION CONVENTIONS The following documentation conventions are in ef...

Page 19: ...format a single track only allowing the data on a diskette with one bad track to be saved This facility can also be used to reformat Track 00 in any format supported by CC30INIT However CC30BOOT and the ROM bootstrap loader will then be unable to read the diskette After formatting a track CC30INIT automatically verifies the track For the details of the formats used by CC30INIT refer to the Program...

Page 20: ...ole dialog is as follows WHICH DRIVE A D IEnter the drive letter of the diskette Ito be formatted and or verified When ICC30INIT is finished it repeats this Iquestion allowing additional diskettes Ito be formatted or verified A cr Ireturns you to CP M SINGLE OR DOUBLE SIDED 0 OR l SINGLE OR DOUBLE DENSITY S D 10 specifies single sided 11 specifies double sided IIf you respond with a 1 ICC30INIT fo...

Page 21: ...format land verify the disk enter 1 to verify the disk only IA cr causes CC30INIT to restart at the first question IIf you specify init with verify CC30INIT responds with WARNING CONTENTS OF DISK WILL DESTROYED CONTINUE Y N BE IEnter Y if you wish the disk Ito be formatted Any other Iresponse causes a repeat of Ithe previous question NUMBER OF TRACKS 35 40 80 1 IThis question appears if the Iselec...

Page 22: ...uring a disk operation They identify the nature of the operation in which the error occurred specify the physical location of the error drive unit diskette side track number sector number and display the contents of the disk controller s status register Numerical values are in hex For a definition of the status register see the 1793 Data Sheet in the 2422 Floppy Disk Controller manual HOME ERROR D...

Page 23: ...ive door closed ready this message is the question WHICH DRIVE properly inserted and SEEK ERROR After the drive has been specified CC30INIT does a preliminary restore of the drive seek to Track 00 and reads status If the Track 00 flag is not set it displays this error message and restarts with the vffiICH DRIVE A D question DISKETTE IS WRITE PROTECTED PLEASE FIX If CC30INIT enounters a write prote...

Page 24: ... control is returned to CP M It usually indicates a hardware malfunction STATUS IS LOST DATA PROGRAM IS ABORTED This message is displayed in conjunction with the Init Error Message whenever the DRQ flag or the Lost Data flag is set in the status register after a track read or write This error message usually indicates problems with the data transfer rate If it occurs during data verification of an...

Page 25: ...ASE REPLY Y ES N O CC30INIT sets the watchdog timer for each disk operation If the watchdog timer times out before the disk controller signals end of job INTRQ bit set CC30INIT displays this message A response of Y causes CC30INIT to restart with the source drive request A response of N or any other entry causes control to be returned to CP M This error condition usually is caused by hardware malf...

Page 26: ...ffsets the system load 2K from the standard CP M load Note that the image it places into memory is the System 300 CP M as distrlbuted by CCS If you have altered CC30BIOS you need to patch the altered BIOS onto the system image as described in Appendix A 3 3 2 MOVCPM operation The System commands N 10VCPM cr N MOVCPt 1 n cr 30n l 10VCPM supports the following two ICauses an image of the current mem...

Page 27: ...e same diskette formats as CC30BIOS Digital Research s standard SYSGEN program has also been included on the distribution diskette 3 4 2 CC30GEN Requirements Restrictions CC30GEN requires 24K of requirement the System 300 memory size of 32K or greater user CP M memory to meet this must be configured for a If the size and format of the destination diskette results in system tracks having a smaller ...

Page 28: ...arlve unit lletter or cr A cr causes control Ito be returned to CP M leaving the Isystem image in memory If you specify ia drive CC30GEN examines the drive for Ireadiness It the asks for confirma ltion of the destination drive DESTINATION ON n THEN TYPE RETURN IIf n is the correct Idestination drive hit I cr CC30GEN will then lbegin writing the system limage out to disk veri Ifying what is written...

Page 29: ...j STATUS n After a restore command has been issued CC30GEN checks the disk controllerls status It will output the above error message and restart with the source drive request if the selected drive is not ready if a seek or CRC error is detected source drive only or if the destination drive is write protected READ ERROR DRIVE nj SIDE nj TRACK ni SECTOR nj STATUS n After the disk controller has fin...

Page 30: ...ATA After CC30GEN has completed writing the system to the destination disk it issues this warning message if the capacity of the system tracks on the destination disk is less than required by the System 400 CP M CC30GEN then returns to the source drive request instead of the destination drive request as it normally does Type two carriage returns if you wish to return to CP M Note that if you reduc...

Page 31: ...skette for data density and bytes per sector duplicating their formats on the corresponding tracks of the destination diskettes It then assumes that the rest of the tracks have the same format as Track 02 If you specify the same diskette as the source and the destination CC30COPY reformats the diskette preserving the data This facility can be useful for recovering data on diskettes with soft error...

Page 32: ...ive unit letter in response to leither of these questions A A C returns control to ICP M CC30COPY examines the specified drives for com IpatibilitYi if they are compatible it then asks DO YOU WISH TO VERIFY DATA IIf you do enter Yi any other lentry is taken as negative IIf both drives are minis ICC30COPY asks IS IT DOUBLE SIDED IEnter Y if both minis are double Isided Any other entry is negative M...

Page 33: ...User entries are underlined N CC30COPY CCS DISK COpy PROGRAM VERS 1 1 SOURCE DRIVE OR CONTROL C TO ABORT B DESTINATION DRIVE OR CONTROL C TO ABORT C DO YOU WISH TO VERIFIY DATA Y WARNING CONTENTS OF DESTINATION DISKETTE WILL BE LOST DO YOU WISH TO CONTINUE Y VERIFYING TRACK 77 SOURCE DRIVE OR CONTROL C TO ABORT A C 3 5 4 CC30COPY Error Messages INVALID DRIVE DRIVE OR CONTROL C TO ABORT If you ente...

Page 34: ... drive and hit the carriage return key Any other response returns you to the first question in the dialog CANNOT READ SOURCE If for some reason CC30COPY cannot read the source diskette it displays this error message and returns to the first question in the dialog Possible causes for this error message include an unformatted diskette or one formatted by a 1771 disk controller chip BAD SOURCE SECTOR...

Page 35: ...tion disk does not match the data read from the source disk CC30COPY displays this error message and query Type Y to continue Any other response causes CC30COPY to restart with the first question of the console dialog TIMEOUT ON DISK OPERATION ABORT CC30COPY sets the watchdog timer for each disk operation If the timer times out before the disk controller signals end of job CC30COPY displays this m...

Page 36: ...er peripheral drivers Section 2 5 1 on the IOBYTE contains the background information you need to do so vfuen writing your driver routines please keep the following points in mind a Modification of existing driver routines generally involves changing the contents of the peripheral driver only leaving the IOBYTE handling routines and the driver routine name unmodified For example to bring up a defa...

Page 37: ...tion of the responsibilities of each entry point subroutine Your drivers must fulfill these responsibilities Generally speaking output drivers find the character in register C while input drivers pass it to registex A d Console input List output Punch output and Reader input routines require corresponding status routine For example if you are adding a peripheral for the User Line Printer I assignm...

Page 38: ... type STEPS EQU 3 STEP8 EQU I The optimal step rate for a drive s read write head differs from drive to drive Shugart drives require an 8 ms 3 ms and 25 ms step rate for the SA800 SA850 and SA450 respectively MPI 51 52s require a 5 ms step rate Memorex 550 requires a 6 ms step rate The STEP equates set the step rates to 6 ms for single sided 8 11 drives and 30 ms for 5 25 11 drives see Table A I b...

Page 39: ...em reconfigured for another memory size use the command A MOVCPM n cr where n equals the memory size desired in kilobytes 8 Save the system image on the new diskette A SAVE 40 B CPMn COM n is the system memory size in Kbytes The MOVCPM program displays the actual command you should use 9 Now in preparation for patching your new BIOS onto the system load in CPMn COM using DDT A DDT B CPMn COM DDT V...

Page 40: ... is the hex value of the difference in Kbytes between your CP M system size and 20K b NOW use the hex command undocumented in the DDT manual to subtract the BIOS origin from lF80H HlF80 nnnn nnnn BIOS origin ssss dddd ssss and dddd are the sum and difference The difference is the offset 11 Read CC30BIOS into place specifying the offset and exit DDT ICC30BIOS HEX Rdddd dddd offset nnnn pppp G0 Note...

Page 41: ... CC30GEN A CC30GEN CCS SYSTEM GENERATION PROGRAM 1 1 COPYRIGHT 1980 CALIFORNIA COMPUTER SYSTEMS SOURCE DRIVE cr DESTINATION DRIVE B DESTINATION DRIVE ON B THEN TYPE RETURN cr SYSTEM COPY AND VERIFICATION ENDED NO ERRORS 14 You now have a customized system on the diskette Insert the diskette into Drive A reset the system and you are now up and running on your customized version of CP M ...

Page 42: ...ided drive capabilities A The reverse side of each diskette can be treated as an extension of the obverse side In its easiest form this method treats each track on side 1 as an extension of the corresponding track on side 0 these associated tracks are often called cylinders For example a track on a l28 byte per sector single density 8 diskette would logically consist of sectors 1 26 on side 0 and ...

Page 43: ...0 0 1 1 Blocks Per Disk 143 159 127 231 143 159 No Dir Entries 63 63 63 63 63 63 ALLOC 0 192 192 192 192 128 128 ALLOC 1 0 0 0 0 0 10 Dir Check Vector Size 16 16 16 16 16 16 System Track Offset 3 3 3 3 3 3 Note For disks formatted in 512 byte single density sectors and in 11024 byte double density sectors the software uses Tables DP5S1 and DP5S2 respectively Table B 1 Double sided Mini Parameters ...

Page 44: ... of the these drives added capacity METHOD In the case of single sided drives only the disk parameter tables in CC30BIOS need to be changed The necessary changes to the tables are shown below In the case of the double sided drives the changes identified in Appendix B for installing double sided drives also need to be made In addition some of the drives can support a faster step rate see Appendix A...

Page 45: ... DB 7 15 15 31 DB 1 1 3 DW 133 138 133 138 DW 63 63 63 127 DB 192 128 128 128 DB 0 0 0 DW 16 16 16 32 DW 3 3 3 3 DP5Dl DW 36 36 72 72 DB 3 4 4 5 DB 7 15 15 31 DB 0 1 1 3 DW 165 172 165 172 DW 63 63 63 127 DB 192 128 128 128 DB 0 0 O 0 DW 16 16 16 32 DW 3 3 3 3 DP5D2 DW 40 40 80 80 DB 3 4 4 5 DB 7 15 15 31 DB 0 1 1 3 DW 184 192 184 192 DW 63 63 63 127 DB 192 128 128 128 DB 0 0 0 0 DW 16 16 16 32 DW...

Page 46: ...w factor of six so that the next logical sector is the sixth subsequent physical sector while a 5 25 single density diskette with 256 byte sectors is given a skew factor of 3 Since programs differ in the amount of processing time they require changing the sector skew factors may incre aae disk access speed For example a program requiring extensive process1ng between sector reads or writes may not ...

Page 47: ... skew table is the number of sectors per track one side only and remains constant The third value is the sector skew factor and can be modified to any number between 1 and the first value The second number is the result of the first value divided by the greatest common denominator GCD of the first and third values It must be changed if the new skew factor results in a different GCD For example if ...