Radio Shack 4 User manual

Radie /haeK
Model
4
Quick
fl:
•
Reference
Guide
©Copyright 1983 by Radio Shack,
ADivision oi Tandy Corporation

Contents
Start-Up ^
TRSDOS -'l|J
Commands and Utilities ^4
Error Messages ^
BASIC ^
Statements and Functions .
.
^
Control Keys ^
Operators ^
Edit Commands ^
Special Characters ^4
Error Messages ^u|
Internal Codes ^

Start-Up
Make sure all floppy disk drives are empty and all equip-
ment is off.
1
.
Turn on all peripheral equipment (such as aprinter),
except the hard disk.
2. Hard disk users: Turn on the primary hard disk drive.
3. Turn on the computer.
4. Insert asystem diskette into Drive and close the
drive door. TRSDOS displays its start-up message.
5. TRSDOS prompts you for the date. Enter it in the
mm/dd/yy format.
6. The following system prompt will appear on your
screen:
TRSDOS Ready
Now, you can type in aTRSDOS command.
7. To start BASIC, type:
BASIC (ENTER)
and you see the BASIC prompt:
Ready
represents avalue that you supply. Information within
brackets is optional.
Now, you can type in aBASIC command.
This Quick Reference Guide is divided into two sections:
TRSDOS and BASIC.
Information which is non-shaded (like this) pertains to:
•TRSDOS intermediate commands and utilities
•BASIC statements
Information which is shaded like this pertains to:
•TRSDOS advanced commands and utilities
•BASIC functions

Commands and Utilities
Those parts of the command line that you must enter are
hiahliqhted. Information that is upper-case should be
typed in exactly as is. Information that is lower-case
represents avalue that you supply. Information within
brackets is optional.
APPEND source [TO] destination [(ECHO.STRIP)]
Adds one disk file onto the end of another.
ATTRIB iile (USER ="password"OWNER ="password"
PROT =level, VIS.INV)
Changes the protection of afile. The /eve _can be
EXEC READ UPDATE, WRITE, RENAME, REMOVE,
or FULL. ,,..,.. „„
ATTRIB CUSTFILE/DATsi (USER= >
OWNER="BOSSMAN" ,PROT =READ tVIS)
ATTRIB [drive] (LOCK,UNLOCK,MPW ="password",
NAME ="disk name", PW =["password"])
Changes the protection of files on adrive n
ATTRIB -.1 (NAME="DATA" ,PW="SECRET .
MPW="BOSSMAN" )
AUTO [drive, ?;drive, =drive] [*] [command line]
Stores acommand line for automatic execution each
time TRSDOS starts up. (AUTO by itself deletes the
current AUTO command line.)
AUTO BASIC AUTO *D0 INIT/JCL.l
BACKUP [filel source drive [TO] destination drive
5MPW=1?assword",SYS,INV,MOD,QUERY =YES,OLD,
NEW, X, DATE ="date")]
Duplicates asystem or data diskette, (file can be a
partial name.)
BACKUP ;si
BACKUP (MOD. QUERY, MPW= "SECRET "
)
BOOT [(CLEAR)- (ENTER), 3D]
Resets the system.
BOOT
BUILD iile [(HEXAPPEND)] xocnnQ
Creates an input file for JCL, KSM, and other TRSDOS
commands.
BUILD MYPROGA/FI>(;0
BUILD DISPLAY/BLD (HEX)
CLICK/FLT
SET device [TO] CLICK/FLT
FILTER *KI device
Establishes the key-click filter.
II

COM/DVR
SET *CL [TO] COM/DVR
Prepares the Communications Line (*CL) for use.
COMM device[(XLATES =X'aabb',XLATER =X'aabb',
XON -X'cc', XOFF =X'cc', NULL =OFF)]
Lets two computers communicate via adevice.
CONV [ffie]:source drive [:destination drive] [(VIS,
INV, SYS, NEW, OLD, QUERY=NODIR)]
Converts files from aTRSDOS 1.3 (Model III) diskette
onto aTRSDOS Version 6formatted diskette, (file can
be apartial name.)
CONY :1 ;0 <0IS,Q=N0>
COPY source [TO] destination [(LRL =nnn,
CLONE =NO, ECHOX)]
Copies data from one file or device to another.
COPY TEST/DAT TO :1
COPY *KI TO *PR (ECHO)
CREATE file [(LRL =number, REC =number,
SIZE =number)]
Creates afile and reserves space on the disk for future
use.
CREATE INVENT/DAT (SIZE=20)
DATE [mmydd/yy]
Sets or displays the current date.
DATE 08/09/82 DATE
DEBUG [(ON, OFF)] [(EXT)]
Sets up the debug monitor for testing and debugging
machine-language programs.
DEBUG DEBUG (OFF)
DEVICE [(D =NQB =YES,S =NO,P =YES)]
Displays the current status of each drive and the
options in use.
DEVICE DEVICE (B=YES)
DIR [file] [: drive] [(ALL,INV,M0d,NON,PRT, SYS, DATE
DATE ="date',' SORT =NO)]
Lists the directory of adrive or file, (.file can be apartial
name.)
DIR :i DIR <DATE="10/01/81-")
DO [S, =,*] tile [((&label,parm =value)] [;]
Compiles and executes aDO file.
DO DRIUE/JCL DO =DRIUE/JCL

DUMP file (START =address, END =address,
TRA =address, ASCII, ETX =value)
Copies an area of memory to adisk file.
DUMP ROUTINE/CMD
<START=X'700Q' .END =X'8Q0Q ' .
TRA=X'7000')
FILTER device [USING] phantom device
Filters data to or from adevice, using afilter program.
FILTER *PR USING *DU
FORMAT :drive (ABS.NAME ="disk name",
MPW="password", SDEN.DDEN, CYL =number,
QUERY =NO)
Formats ablank or old disk for use.
FORMAT
FORMAT :1(NAME= "DATA3" .
MPW="SECRET"
)
FORMS [(DEFAULT, ADDLF.CHARS =number.FFHARD,
INDENT =number, LINES =number,
MARGIN =number, PAGE =number, QUERY, TAB,
XLATE=X'aabb')]
Sets up printer options.
FORMS (MARGIN=10.CHARS=80.INDENT=G)
FORMS/FLT
SET *PF [TO] FORMS/FLT
FILTER *PR *PF
Prepares the Printer Filter (*PF) for use.
FREE [: drive] [(PRT)]
Lists free space and number of files on each disk; if
drive is specified, displays space map of that disk.
FREE FREE :0 (PRT)
JOBLOG
ROUTE *JL [TO] file
ROUTE *JL [TO] device
Establishes the Joblog device (*JU, which sends
certain information to afile or device.
ROUTE *JL TO LISTER/JBL
ROUTE *JL TO *PR
KSM/FLT
SET device KSM/FLT [USING] file
[(ENTER =value)]
FILTER *KI device
SET *DU KSM/FLT USING ROUTINE/KSM
FILTER *KI *DU

LIB
Displays library commands.
LIB
LINK device 1[TO] device2
Links two logical devices, :
LINK #D0 *PR
LIST Me [(ASCII8,NUM,HEX, TAB =number, PRT,
LINE =number, REC =number, LRL =number)]
Lists contents of afile to the display or printer
LIST TESTFILE:0
LIST MONITOR/CMD (PRT)
LOAD [(X)] file
Loads aprogram file into memory.
LOAD STATUS/CMD
LOAD (X) PROGRAM/CIM
MEMDISK7DCT
SYSTEM (DRIVE =drive.DRIVER ="MEMDISK")
Adds to the system apseudo floppy drive which keeps
its files in memory.
SYSTEM (DRIUE=2»DRIUER="MEMDISK")
MEMORY [(CLEAR =value, HIGH =address,
LOW=address, ADD =address, WORD =word
BYTE =byte, GO =address)]
Reserves aportion of memory, sets or displays current
HIGHS and LOW$, modifies amemory address, or
jumps to aspecified memory location.
MEMORY
MEMORY <ADD =X'E100' ,WORD=X '3E0A '
)
PATCH file (patch commands)
,Changes the contents of adisk file.
PATCH MONITOR/CMD (X'E100'=C3 SB 00)
PATCH file! USING Iile2 [(YANK,REMOVE)]
Makes changes contained in file2 to filet
PATCH BACKUP/CMDsB USING SPECIAL/FIX
PURGE [file]:drive [(QUERY=NO,MPW ="password"
INVSYS, DATE ="date")]
Deletes files, (fife can be apartial name.)
PURGE :0 (MPW="SECRET")
PURGE /BAS:1 (Q=N)
REMOVE iile [file] ...
Deletes files from the directory.
REMOVE ALPHA/DAT :0 BREAKER/DAT :

REMOVE device [device] ...
Removes devices from the device table.
REMOVE *LU
RENAME filel [TO] file2
RENAME device 1[TO] device2
Changes the name of afile or device.
RENAME TEXT/DAT :0 TO OLD/DAT
RENAME *UD TO *TX
REPAIR :drive
Updates system information on disks which were
formatted under Model ITRSDOS.
REPAIR :1
RESET device
RESET me
Returns adevice to its original start-up condition.
Closes an open file.
RESET *PR RESET PRINTER/DAT
ROUTE device 1[TO] device2
ROUTE device [TO] file [(REWIND)]
ROUTE device (NIL)
Routes adevice to another device, to adisk file, or to
nothing (NIL).
ROUTE *PR *D0
ROUTE #PR TO PRINTER/DAT
[RUN] [(X)] file [(command text)]
Loads and executes aprogram, command text is
optional values the program may require.
RUN CONTROL/CMD CONTROL/CMD
SET device [TO] driver file [(parameters)]
Assigns adriver program to adevice, parameters are
optional values the driver program may require.
SET *SP TO SERIAL/DRV
SET phantom device [TO] filter file [USING]
[parameters]
Assigns afilter program to aphantom device.
parameters are optional values the filter program may
require.
SET #LC TO TRAP/FLT
SETCOM [(DEFAULT, BAUD -number, WORD -
number, STOP =number, PARITY -switch, QUERY,
BREAK=value.EVEN.ODD)]
Sets up RS-232C communications or display status.
SETCOM <BAUD=300 ,W0RD=8 ,STOP=i .
PARITY=OFF)

SETKI [(DEFAULT, RATE =number, WAIT= number
QUERY)]
Sets keyboard repeat values. (SETKI by itself displays
current values.)
SETKI <DELAY=15)
SPOOL [device] [TO] [file] (NO, MEM =number,
BANK =number, DISK =number, PAUSE
RESUME.CLEAR)
Establishes an output buffer for adevice.
SPOOL *PR TO TEXTFILE:0
<MEM=5»DISK=15> SPOOL *PR (NO)
SYSGEN [(switch)] [(DRIVE =drive)]
Stores current system options in afile (CONFIG/SYS)
on drive. If switch is NO, the configuration file is
removed.
SYSGEN (YES) (DRIVE=4) SYSGEN (NO)
SYSTEM (parameters)
Selects certain options of yourTRSDOS system. In
the following SYSTEM commands, switch is YES or
NO.
SYSTEM (ALIVEf switch])
Displays amoving character when task processor is
running.
SYSTEM (BLINK =siv/fcW
SYSTEM (BLINK --number)
SYSTEM (BLINK,[LARGE,SMALL])
Control the cursor character.
SYSTEM (BREAK[ switch])
Enables or disables BREAK key.
SYSTEM (DATE[ =switch])
Turns on or off the start-up date prompt.
SYSTEM (DRIVE =drive, [CYL =number,
DELAY=NO/YES, DISABLE, ENABLE,
DRIVER = "file", WP%yjw/fcn]3
Sets parameters for drive.
SYSTEM (SYSRES =number)
Adds TRSDOS system overlays into high memory
SYSTEM (SYSTEM
=
drive)
Assigns drive as system drive.
SYSTEM (TIME[ =siv/fch])
Turns on or off the start-up time prompt.
SYSTEM (TRACE[=sMch])
Displays contents of Program Counter.
SYSTEM (TYPE[ =switch])
Turns on or off the Kf/DVR type-ahead feature.
10

TAPE 100
TAPE100 filel [TO] Iile2 (READ.WRITE)
Reads aModel 100 cassette tape file and writes it to a
disk file, or reads adisk file and writes it to cassette
tape.
TAPE100 PRNTER TO PR INT/DAT :(READ)
TIME [hh:mm:ss] [(CLOCK =YES/NO)]
Sets the time or displays current time.
TIME TIME 12:23:34
VERIFY [(switch)]
Sets VERIFY function on or off.
VERIFY (YES) VERIFY (NO)