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

7.6.71 @REMOV SVC-57
This SVC will remove a file. The FCB must be in an open condition prepared by @OPEN or
@INIT. The file's directory will be updated by resetting the activity bit (bit-4 of
DIR+0), the corresponding Directory Entry Code (DEC) in the Hash Index Table (HIT ) will
be set to zero, and the space occupied by the file will be deallocated from the Granule
Allocation Table (GAT). The 32-byte FCB will be set to zeroes upon successful commpletion
of the file's removal. If the control block contained data appropriate to an opened
device, the @REMOVE SVC will treat the request as if it were an @CLOSE request. Devices
can only be removed via the RESET library command.
Registers Affected: AF.
Entry:
DE A pointer to the open File Control Block (FCB) of the file.
Exit:
A Will contain an error code if an error is encountered.
Z Set if no error is detected.
7.6.72 @RENAM SVC-56
This SVC can be used to change the filename or extension fields of a file stored on disk.
The access protection level must permit renaming for the operation to be successful.
Registers Affected: AF.
Entry:
DE A pointer to the File Control Block (FCB) containing the filespec of the
file to be renamed.
HL A pointer to the FCB containing the new filename/extension.
Exit:
A Will contain an error code if an error is encountered.
Z Set if no error is detected.
7.6.73 @REW SVC-68
This SVC will rewind a file to its beginning and reset the 3-byte NRN pointer to 0. The
next record that will be transferred for I/O with a @READ/@WRITE request will be the
first record of the file.
Registers Affected: AF.
Entry:
DE A pointer to the FCB for the file that you want to rewind.
Exit:
A Will contain an error return code if an error was encountered.
Z Set if the operation was successful.
7.6.74 @RMTSK SVC-30
This SVC will remove an interrupt level task from the Task Control Block Vector Table
(TCBVT). See Chapter 8, Appendix, on TASK PROCESSOR for detailed information on the use
of this SVC.
Registers Affected: AF, DE, HL.
Entry:
C Contains the task assignment slot (0-11) to remove.
7-36