29.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

7.6.75 @RPTSK SVC-31<br />

This SVC must be invoked only from an executing task. It will exit the task process<br />

currently executing and replace the task's vec<strong>to</strong>r address in the Task Control Block<br />

Vec<strong>to</strong>r Table (TCBVT) with the address following the SVC instruction. Return is made <strong>to</strong><br />

the foreground application that was interrupted. See the TASK PROCESSOR section in<br />

Chapter 8, the Appendix, for detailed information on the use of this SVC.<br />

Registers Affected: Not applicable..<br />

7.6.76 @RREADSVC-69<br />

This SVC will cause a reread of the current sec<strong>to</strong>r providing the file was opened with an<br />

LRL between 1 and 255 or the file was accessed via character I/O (@GET/@PUT). Its most<br />

probable use would be in applications that reuse the disk I/O buffer for multiple files<br />

and want <strong>to</strong> reload the buffer with the proper file sec<strong>to</strong>r.<br />

Registers Affected: AF.<br />

Entry:<br />

DE A pointer <strong>to</strong> the FCB for the file <strong>to</strong> reread.<br />

Exit:<br />

A Will contain an error return code if an error was encountered.<br />

Z Set if the operation was successful.<br />

7.6.77 @RSLCT SVC-47<br />

<strong>The</strong> SVC is used <strong>to</strong> pass a function code 7 <strong>to</strong> a disk driver. This function will perform a<br />

test of the selected drive <strong>to</strong> see if it is in a busy state (i.e. if the disk controller<br />

is still executing a command). If busy, the drive will be re-selected until it is no<br />

longer busy. See chapter 4 for additional information.<br />

Registers Affected: AF [Note: DOS saves BC, IY; drivers should save any other<br />

registers they use].<br />

Entry:<br />

C Should contain the logical drive number.<br />

7.6.78 @RSTOR SVC-44<br />

This SVC will res<strong>to</strong>re a disk drive <strong>to</strong> cylinder 0 by passing a function 4 <strong>to</strong> a disk<br />

driver. See chapter 4 for additional information.<br />

Registers Affected: AF [Note: DOS saves BC, IY; drivers should save any other<br />

registers they use].<br />

Entry:<br />

C Logical drive number (0-7).<br />

Exit:<br />

A Contains an error return code, if any.<br />

Z Set if the operation was successful.<br />

7.6.79 @RUN SVC-77<br />

This SVC will load and execute a program file. Your FCB should not be located in the<br />

memory region that will be loaded with the file you want <strong>to</strong> execute.<br />

Registers Affected: AF, BC [Note: HL alterted on an error].<br />

7-37

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!