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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Registers Affected: AF, BC.<br />

Entry:<br />

BC delay count<br />

7.6.60 @PEOF SVC-65<br />

This SVC will position an open file <strong>to</strong> the end-of-file position. If the SVC is<br />

successful, an error 28 - "End of file encountered" will be returned.<br />

Registers Affected: AF.<br />

Entry:<br />

DE A pointer <strong>to</strong> the FCB of the file <strong>to</strong> position.<br />

Exit:<br />

A Will return the error return code.<br />

7.6.61 @POSN SVC-66<br />

This SVC will position a file <strong>to</strong> a logical record. This will be useful for positioning <strong>to</strong><br />

records of a random access file. When the @POSN routine is used, Bit 6 of FCB +1 is<br />

au<strong>to</strong>matically set <strong>to</strong> ensure that the EOF will be updated when the file is closed only if<br />

the NRN exceeds the current ERN. This action will guard against any inadvertant<br />

deallocation of space in the random access file. A file can be extended by positioning <strong>to</strong><br />

its EOF (see @PEOF) then writing <strong>to</strong> it.<br />

Registers Affected: AF.<br />

Entry:<br />

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

BC Contains the logical record number for the positioning.<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.62 @PRINT SVC-14<br />

This SVC will output a message string <strong>to</strong> the printer device, *PR. <strong>The</strong> message string must<br />

conform <strong>to</strong> the syntax specified under @DSPLY.<br />

Registers Affected: AF, DE.<br />

Entry:<br />

HL A pointer <strong>to</strong> the message <strong>to</strong> be output.<br />

Exit:<br />

A Will contain an error code if the SVC was unsuccessful.<br />

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

7.6.63 @PRT SVC-06<br />

This SVC will output a byte <strong>to</strong> the printer device, *PR. All character codes are passed<br />

unaltered <strong>to</strong> the device unless the forms filter is filtering the device. If the *PR<br />

device is not available, the SVC will time out after approximately 10 seconds and return<br />

a "Device not available" error.<br />

Registers Affected: AF, DE.<br />

7-32

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

Saved successfully!

Ooh no, something went wrong!