The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

More documents

Recommendations

Info

Error 18: Directory write error This error is similar to error-17 but the error condition is sensed while attempting to write a directory sector back to the disk. The integrity of the directory is now suspect. Error 19: Illegal file name The file specification provided to the system contains a character not conforming to the file specification syntax. Error 20: GAT read error Disk errors sensed while reading the Granule Allocation Table will cause this error. It could be media failure, hardware failure, or program crashes. Error 21: GAT write error This error is similar to the error-20 except that the error was sensed during a WRITE request. The integrity of the GAT is suspect. Error 22: HIT read error This error is similar to error-20 but occurred during a READ of the Hash Index Table. Error 23: HIT write error This error is similar to error-21 but occurred during a WRITE of the Hash Index Table. Error 24: File not in directory This error indicates that a file specification was referenced for OPEN that could not be located in the directory. Note that if the request was to LOAD a program load module file, the error code returned would be "Program not found". Most likely the cause was a misspelled filespec. Error 25: File access denied This indicates that an access request was made for a file that was password protected and the access protection level was NONE. Error 26: Directory space full An open of a new file was requested and the target disk either was not available or its directory was entirely in use. Use another diskette or remove uneeded files. Error 27: Disk space full While a file was being written, all available space on the disk was allocated before the file was completely written. Whatever space was already allocated to the file will still be allocated although the file's end of file pointer will not be updated. It may be useful to remove the file to recover the space after writing the file to another diskette. 8-11
Error 28: End of file encountered The end of a file was reached during a read or position access. The file was probably smaller than the application expected. This error can also be used within an application to determine the end of a sequentially read file. Error 29: Record number out of range A request was made to read a sector of a file where the Next Record Number of the sector was beyond the Ending Record Number. Error 30: Directory full - can't extend file This error will result when the system must allocate an extended directory entry (FXDE ) to a file because it has used all extent fields of its last directory entry record and no spare directory slot is available. All available directory entry records are in use. The solution would be to repack the disk by individually copying its files to a freshly formatted diskete. Error 31: Program not found The execution of a CMD program file could not be completed because the file was not located in the directory. Either the filespec was misspelled or the disk that contained the file was not mounted. Error 32: Illegal drive number This error will occur whenever a reference is made to a disk drive that is not included in your system. It may be disabled, or the drive requested was not ready for access (no diskette, drive door open, etc.). Error 33: No device space available This error will generally be returned by the SET command when you enter a request to establish a new device in the system and all of the resident system area reserved for Device Control Block tables is already in use. It is suggested that you use the "DEVICE (B=Y)" command to see if any currently defined non-system devices can be eliminated by using RESET. Error 34: Load file format error This error will be returned by the system loader when an attempt is made to LOAD a file that does not conform to the load module format structure. Most likely, the file referenced is a data file or a BASIC program file. Error 35: Memory fault This error indicates that a memory cell malfunctioned during the process of loading a program file. Error 36: Attempted to load read only memory This error would be returned if the program file being loaded referenced a memory cell that could not be altered. Either the cell was part of the read only memory (ROM), or the address was referencing an area of the machine not containing any read/write memory (RAM). Do not expect to see this error. 8-12
Page 1 and 2:
MISOSYS, INC. The Programmer's Guid
Page 3 and 4:
1. Introduction Many thousands of u
Page 5 and 6:
language (i.e. BASIC, C, PASCAL, ..
Page 7 and 8:
NAME START END DESCRIPTION LOWCORE
Page 9 and 10:
ackup utility provides exceptional
Page 11 and 12:
3. Device Input/Output Interfacing
Page 13 and 14:
3.2.2 VECTOR Field - This field in
Page 15 and 16:
FILTER *PR USING *S0 the operating
Page 17 and 18:
===================================
Page 19 and 20:
===================================
Page 21 and 22:
ENTRY JR BEGIN ;Branch around linka
Page 23 and 24:
DATA1 EQU $-DATA$ DB 0 ;Data storag
Page 25 and 26:
Offset Contents +0 Contains the las
Page 27 and 28:
image of the serial port UART statu
Page 29 and 30:
called TRACKs. Each track is then d
Page 31 and 32:
The DCT contains the information re
Page 33 and 34:
accessed a single-sided diskette, t
Page 35 and 36:
containing the disk's directory. Th
Page 37 and 38:
Command Purpose RESTORE Recalibrate
Page 39 and 40:
available from Logical Systems, Inc
Page 41 and 42:
exceeds this capacity, then it must
Page 43 and 44:
is two physical cylinders. Although
Page 45 and 46:
5. The DOS Directory Structure 5.1
Page 47 and 48:
===================================
Page 49 and 50:
5.2.8 PACK NAME - This field conta
Page 51 and 52:
The position of a file's hash code
Page 53 and 54:
5.4 THE DIRECTORY RECORD STRUCTURE
Page 55 and 56:
Bit 3 Specifies the visibility; if
Page 57 and 58:
the first granule in use is the sec
Page 59 and 60:
travels the turnpike. In this manne
Page 61 and 62:
The @FSPEC SVC will transfer the fi
Page 63 and 64:
A high level language permits you t
Page 65 and 66:
does exist, @RENAME should return e
Page 67 and 68:
Next, it would be very useful if th
Page 69 and 70:
LD HL,FCBX+9 ;Point to the LRL fiel
Page 71 and 72:
operating system for such a purpose
Page 73 and 74:
position where the last character i
Page 75 and 76:
ecord. If a file has more than four
Page 77 and 78:
DE Contains a pointer to the File C
Page 79 and 80: @RENAM SVC-56 Rename a file on disk
Page 81 and 82: @FNAME SVC-80 Obtain filespec given
Page 83 and 84: @WRSEC SVC-53 Write a disk sector @
Page 85 and 86: 7.6 SUPERVISOR CALL DETAILS 7.6.1 @
Page 87 and 88: Note: @EXIT in SYS1 automatically r
Page 89 and 90: 7.6.10 @CLOSE SVC-60 This SVC will
Page 91 and 92: 7.6.18 @DCSTAT SVC-40 This SVC pass
Page 93 and 94: Directory to Buffer Entry: B 1; Fun
Page 95 and 96: 7.6.31 @FLAGS$ SVC-101 This SVC wil
Page 97 and 98: NFLAG$ This "network" flag is used
Page 99 and 100: 7.6.32 @FNAME SVC-80 This SVC will
Page 101 and 102: 7.6.40 @HEX8 SVC-98 This SVC will c
Page 103 and 104: 7.6.48 @KLTSK SVC-32 This SVC will
Page 105 and 106: 7.6.57 @OPEN SVC-59 This SVC will o
Page 107 and 108: Registers Affected: AF, BC. Entry:
Page 109 and 110: 0-14 FILENAME/EXT:D - left justifie
Page 111 and 112: 7.6.71 @REMOV SVC-57 This SVC will
Page 113 and 114: Entry: DE A pointer to the FCB cont
Page 115 and 116: Exit: A Error return code, if any.
Page 117 and 118: CURSOR CHARACTER Registers Affected
Page 119 and 120: Exit: A Will contain the error code
Page 121 and 122: esident routine into its execution
Page 123 and 124: CKPAWS LD A,@FLAGS$ ;Get Flags poin
Page 125 and 126: ===================================
Page 127 and 128: The TYPE=0A indicates that it is th
Page 129: Error 08: Device not available A re
Page 133 and 134: 8.5 HEADER PROTOCOL OF MEMORY MODUL
Page 135 and 136: This is obviously an extremely usel
Page 137 and 138: LD (IX+2),15 JR TASKA By firmly und
Page 139 and 140: 8.7.3 Details of Low Memory Page 2
Page 141 and 142: actual bank switching. As previousl
Page 143 and 144: set. Thus, the Z-flag will be indic
Page 145 and 146: 8.10 SYSTEM DISK BOOT TRACK The ope
Page 147 and 148: 14 DEBUG 72 PURGE 1B VERIFY 71 DUMP
Page 149 and 150: 8.13 USING @PARAM The @PARAM SuperV
Page 151 and 152: DW LPARM+1 DB 'FEED ' ;Line feed pa
Page 153 and 154: ;*=*=* PPARM LD BC,0 ;Zero because
Page 155 and 156: 8.14 TRAP Filter Illustrated ;TRAP/
Page 157 and 158: 8.15 SLASH0 Filter Illustrated ;SLA
Page 159 and 160: 8.16 DMP-500 BOLDFACE Filter Illust
Page 161 and 162: NOMEM$ DB 'High memory is not avail
Page 163 and 164: @ @ABORT..........7-2, 7-4, 7-8, 7-
show all

The Programmer's Guide to TRSDOS Version 6 - Tim Mann's Home ...

Create successful ePaper yourself

Delete template?

Save as template?