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

7.6.32 @FNAME SVC-80
This SVC will recover the file name and extension from the directory for the referenced
directory code and drive. It is used by the system to recover the filespec when closing a
file. Although @FNAME can be used for a "directory" function, @DODIR or @RAMDIR are
better candidates for performing that function.
Registers Affected: AF.
Entry:
DE Buffer to receive file name/ext
B DEC of file desired
C drive number of drive containing the file
7.6.33 @FSPEC SVC-78
This SVC will fetch a file or device specification from an input buffer. Conversion of
lower case to upper case will be made.
Registers Affected: AF, HL.
Entry:
HL A pointer to the buffer containing file specification.
DE A pointer to the 32-byte File Control Block.
Exit:
HL Points to the terminating character found.
A Will contain the terminating character.
Z Set if valid file specification found.
7.6.34 @GET SVC-03
This SVC will fetch a byte from a logical device or a file. Note that if the DCB
references the *KI device, an NZ condition with error code of 0 (A=0) will indicate that
no character was available.
Registers Affected: AF.
Entry:
DE A pointer to the DCB or FCB for the device/file.
Exit:
A Byte fetched or error return code.
Z Set if byte was fetched without error.
7.6.35 @GTDCB SVC-82
This SVC will locate the address of the Device Control Block (DCB) associated with the
device name passed in the invocation.
Registers Affected: AF, HL.
Entry:
DE 2-character device name (E has 1st char, D has 2nd char). Note: If DE=0,
then a pointer to the first available DCB will be returned.
Exit:
HL Address of the Device Control Block.
Z set on no error, else error 8 (device not avail).
7-24