NEWDOS/80 Version 2 REFERENCE
For use with the TRS-80 Model III Emulator for the Atari ST series
This is a copy of the NEWDOS/80 Version 2 REFERENCE CARD. This card
is a short reference guide for the manual provided by Apparat with NEWDOS/80
Version 2 released in August 1981.
LaTeX version by Sander Berents (Januari 1996)
HTML version by Pete Cervasio (February 1996)
General statements for DOS commands:
- The user should refer to chapter 2 of the manual for more detail as
- If your NEWDOS/80 does not use passwords then the parameter is not
needed in file specifications and the parameter is not needed in PDRIVE,
PROT, PURGE or SYSTEM;
- Commas may be replaced by spaces, except where two consecutive commas
are used to indicate a null parameter between them;
- The word TO is always optional;
- Commands may be in either lower or upper case or a combination thereof.
Lower case usage in non-DOS commands is dependent upon the function involved.
Append the contents of file1 to the end of file2.
APPEND NEW/DAT:0 OLD/DAT:1
Change the specified attributes (at least one required) of file1.
The following defines the valid values for options:
- INV - DIR will not display the file unless parameter
I is specified
- VIS - DIR will display the file
- PROT=xxx - Assign file protection level xxx,
where xxx can be one of
- LOCK - No access
- EXEC - Execute
- READ - Execute or read
- WRITE - Execute, read or write
- RENAME or NAME - Execute, read, write or rename
- KILL - Execute, read, write, rename or kill
- FULL - All operations
- ACC=fpwd1 - fpwd1 becomes the file's access password
- UPD=fpwd2 - fpwd2 becomes the file's update password
- ASE=y or n - Enable automatic allocation of additional file space
- ASC=y or n - Enable automatic de-allocation of excess file space
- UPD=y or n - Turn on/off the file's updated flag.
The DOS command doscmd is stored in the system diskette's directory
for automatic execution at subsequent re-boots. AUTO alone eliminates this
automatic re-boot action.
(Model I only) Enter Level II non-disk BASIC (no DOS, no disk BASIC).
Enable/disable cursor blinking.
Re-boot the DOS system.
Enable/disable the BREAK key.
Enter keyboard input chaining mode, starting at the beginning of file1
if sectionid is not specified or the beginning of the section sectionid
of file1 if section was specified. JCL is assumed as the name extension
if none was specified in file1.
Alter chaining state. Options are:
- N --- Chaining is temporarily suspended and the current DOS-CALL level,
if any, is exited.
- Y --- Chaining is resumed at the point in the chain file where it left
off. Current DOS-CALL level, if any, is exited.
- D --- Same as Y except the current DOS-CALL level, if any, is not exited.
Clear all routes, dequeue all timer and * name routines, set HIMEM to
addr3 or to highest memory address, zero user memory from 5200H
or addr1 to HIMEM or addr2.
Turn on/off the time display on the screen.
Clear the display.
Single file copy. Only options SPDN and DPDN allowed.
Single file copy with system diskette conflict. Only options SPDN and
DPDN allowed. $ indicates if at least one of file1 or file2
specifies drive 0, that diskette is not the current system diskette. If
both files use drive 0, they are on the same diskette.
Single drive, two diskette single file copy. Only options SPDN and DPDN
Sector by sector full diskette copy. Both diskettes must have the same
granules per lump, otherwise the CBF (Copy By File) type of COPY must be
used. Options are:
- FMT --- Format the destination diskette. FMT if the default if NDMW
- NFMT --- Do not format the destination diskette
- Y --- User doesn't care what was previously on the destination diskette.
Y is the default if none of N, ODN, ODPW, DDND, KDN or KDD are specified
- N --- Reject COPY if destination diskette contains data
- NDMW ---No diskette Mount Waits. All diskettes are already mounted,
the system is not to ask for them. If an error occurs terminate the COPY
- SPDN=dn3 --- The PDRIVE specifications used for source I/O are those
listed for drive dn3 in the PDRIVE display
- DPDN=dn4 --- The PDRIVE specifications used for destination I/O are
those listed for drive dn4 in the PDRIVE display
- SN=name3 --- If the Source diskette's Name is not name3}, the operator
is asked whether or not to continue;
- SPW=dpwd1 --- the Source diskette's Password must be dpwd1 or format/copy
will not be done
- ODN=name1 --- If the destination diskette's old name is not name1,
the operator is asked whether or not to continue
- DDND --- Display the Destination diskette's old Name and Date and ask
the operator whether or not to continue
- KDN --- The destination diskette is to retain its old name
- KDD --- The destination diskette is to retain its old date
- NDN=name2 --- name2 is the destination diskette's new name
- USD --- The destination diskette is to receive the source diskette's
- BDU --- Bypass Directory Update. Make a mirror image copy without any
adjustments to destination control or directory information.
Multiple file copy. Distinguished from full diskette copy by the CBF
(Copy By File) parameter. One, some or all of the files, excluding BOOT/SYS
and DIR/SYS, of the source diskette are copied to the destination diskette.
All excluded files and all non-allocated granules are not copied. If a
NEWDOS/80 system disk is being created, FMT must be specified. All of the
above options except BDU, are useable by this copy. If a system file is
to be copied and it is not already in the destination diskette, FMT should
be specified. Additional options are:
- USR --- Copy only user files (system and invisible files are excluded)
- /ext --- Copy only files with name extension ext}
- UPD --- Copy only files flagged as updated
- ILF=file3 --- Copy only files listed in file file3
- XLF=file4 --- Exclude all files listed in file file4
- DFO --- Copy only those source files already represented in the destination
- CFWO --- Check Files With Operator. The operator is asked whether or
not to copy files which otherwise qualify for the copy
- ODPW=dpwd2 --- The destination diskette's old password must be dpwd2
or the format/copy will not be done
- DDSL=ln1 --- Formatting will start the directory at the beginning of
- DDGA=gc1 --- Format will allocate gc1 granules to the directory.
Create new file file1 or use old file file1 as the new
file. The file record size is set to sz1, space for count1
records is allocated, the record filled with zeroes and EOF set to the
end of those records. Automatic space allocation and deallocation set according
to the ASE and ASC options respectively. Defaults for LRL, REC, ASE and
ASC are 256, 0, Y and Y respectively.
Display the current date.
Set date1 as the computer's current date.
Enable/disable debug entry at user program start.
Display the user files accounted for in the directory of the diskette
mounted on drive dn1. Options are:
- A --- Display space allocation, record size and count, and attribute information;
- S --- Display system files;
- I --- Display invisible files;
- U --- Disply only updated files;
- /ext --- Display only those files with name extension ext;
- P --- Send the output to the printer instead of the display.
Performs identical to CHAIN.
Dump the contents of memory locations startaddr thru endaddr
to disk file file1. If entryaddr =0FFFFH, the file is readable
via SUPERZAP, DBDM mode, otherwise the file is stored as a load module
with load addresses offset by the value reladdr-startaddr.
Defaults for entryaddr and reladdr are 402DH and startaddr
Display error message for DOS error xx.
Format the diskette on drive dn1 and set up the directory, boot
and control information using name dname, date and password
dpwd. Defaults for dname, date and dpwd are
NOTNAMED, the current date and PASSWORD respectively.
Options Y, N, NDMW, DDND, ODN, KDN, KDD, BDU, DDSL, DDGA and DPDN are
defined under COPY. Additional options are:
- PFST=tn3 --- Partial Format Starting Track. Start format at track tn3. Directory and boot information are not set up;
- PFTC=tc3 --- tc3=the number of tracks to format under partial format. Default=1;
- RWF --- RaW Format. Format all tracks of the diskette ignoring all formatting errors and leave off system information.
Model III only. Set the printer characters per line = xxx and
lines per page = yyy. If a parameter is missing its value is not
Display the number of free granules and free directory entries for each
Display HIMEM value.
Set addr1 as HIMEM value. DOS maintains a highest memory value
HIMEM to be used as an memory upper limit by user programs so that programs
loaded above that value will be protected.
Copy the contents of the screen to the printer.
Delete file1 from the diskette mounted either on the drive specified
or if none specified the lowest numbered drive containing that file.
If yn=Y the keyboard will accept lower case a..z.
If yn=N the keyboard will convert lower case a..z
to upper case.
If yn1=Y the keyboard driver is enabled and the lower case function
LC is set according to yn2. If yn1=N the keyboard driver
is disabled and the LC function is inoperative.
Display DOS library commands.
List text file file1 on the display, starting at line startline
and displaying linecount number of lines. The defaults for startline
and linecount are 1 and 65535 respectively.
Load the machine language program file file1 into main memory
but do not execute it.
Terminate MINI-DOS and go to DOS READY.
This single file COPY is legal under MINI-DOS, no filespec truncation
options or diskettes swaps allowed.
Exit MINI-DOS and return to the main program continuing its execution
where left off when DFG was pressed.
Display message msg and wait on the operator to press ENTER.
PAUSE,MOUNT INVENTORY DISKETTE ON DRIVE 1
Display PDRIVE table.
Update drive dn2's data and display drive dn1 diskette's
PDRIVE table. Options are:
- TI=type1 --- Type of Interface, consisting of one or more of the following (see manual for proper combinations):
- A --- Standard TRS--80 disk interface;
- B --- Model I only OMIKRON mapper;
- C --- Model I only PERCOM double interface;
- D --- Model III only Apparat disk controller;
- E --- Model I only LNW type disk interface;
- H --- Head settle delay is to be done on drive change. Required for 8" drives;
- I --- Sector 1 is lowest numbered sector on each track;
- J --- Track 1 is the lowest numbered track on the diskette;
- K --- Track 0 is formatted in opposite density from the rest of the tracks and is usable only during boot;
- L --- Two step pulses between tracks are used;
- M --- Model III TRSDOS or Model I TRSDOS 2.3B or higher diskettes to be mounted.
- TD=type --- Type of Drive where type values are:
- A --- 5 inch, single density, single sided;
- B --- 8 inch, single density, single sided;
- C --- 5 inch, single density, double sided;
- D --- 8 inch, single density, double sided;
- E --- 5 inch, double density, single sided;
- F --- 8 inch, double density, single sided;
- G --- 5 inch, double density, double sided;
- H --- 8 inch, double density, double sided.
- TC=tc1 --- tc1 is the number of tracks on diskettes mounted on the drive;
- SPT=sc1 --- sc1 is the number of sectors per track;
- TSR=rc1 --- rc1 is the track stepping rate code. 0=5ms, 1=10ms, 2=20ms, 3=40ms;
- GPL=gc2 --- gc2 is the number of granules (2 to 8) per lump;
- DDSL=ln1 --- ln1 is the number of the lump whose first sector is the directory's first sector. Used only during formatting;
- DDGA=gc1 --- gc1 is the number of granules (2 to 6) assigned to the directory. Used only during formatting;
- A --- If the display shows no errors, activate the PDRIVE attributes
as the current attributes in main memory. Subsequent I/O will use these
attributes. If A not specified, subsequent I/O (except that via SPDN or
DDPN (see COPY)) will not use any new attributes until re-boot.
Format and execution the same as LIST except output to printer.
Alter diskette control information. Options (one required) are:
- NAME=name1 --- Diskette name is changed to name1;
- DATE=date1 --- Diskette date is changed to date1;
- RUF --- Reset (turn off) the Update Flag for all the diskette's files;
- PW=dpwd2 --- Diskette password is changed to dpwd2;
- LOCK --- The diskette password is set as both the access and update password for all of the diskette's user files;
- UNLOCK --- All the diskette's user files are set having to access or update passwords.
For each qualifying file the operator is asked whether or not the file
is to be killed. If so, it is killed immediately. BOOT/SYS and DIR/SYS
are excluded. Options are:
- /ext --- Only files with name extension ext qualify;
- USR --- Only user files qualify (excludes system and invisibles).
Repeat the previous DOS command.
Change the name and name extension of file1 to that of file2.
file2 must not contain a password or drive number.
Display existing routes.
Clear all routes.
Clear routes for device xxx.
Clear routes for device xxx and set routing for device xxx
to the one or more devices/routines specified. Device codes are KB (keyboard),
DO (display), PR (printer), RI (RS-232 in, Model III only), RO (RS-232
out, Model III only) and NL (nothing transfered). A yyy routine
is expressed in the form MM=addr1 (see manual). Input devices may
not be routed to output devices.
Model III only. Set RS-232 interface parameters. Only the parameters
specified are changed. Options are:
- WORD=w1 --- w1 is the number of bits per transmission
byte: 5, 6, 7 or 8;
- BAUD=br --- br is the baud rate for both sending and
receiving: 50, 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 2400, 3600,
4800, 7200, 9600 and 19200;
- STOP=sb --- sb is the number of stop bits: 1 or 2;
- PARITY=pp --- pp is the parity: 1 = odd, 2 = even and
3 = no parity;
- WAIT or NOWAIT --- Indicates whether or not the RS-232 is to wait on
transmission/receiving of each byte;
- OFF --- Turn off the RS-232 interface. No other options allowed if
Display the message msg.
STMT,PHASE ONE COMPLETED
Change and/or display the system options in the control sector of the
system diskette mounted on drive dn1. These options determine the system
configuration at subsequent re-boots when this diskette is the system diskette.
- AA=yn --- Passwords enabled?
- AB=yn --- Run only mode enabled?
- AC=yn --- Keyboard debounce enabled? (Model I only);
- AD=yn --- JKL for screen print enabled?
- AE=yn --- 123 for debug enabled?
- AF=yn --- DFG for MINI-DOS enabled?
- AI=yn --- Lower case mode installed? (Model I only);
- AJ=yn --- DOS's keyboard intercept routine enabled? If N, see manual for side effects, especially Chaining;
- AL=al --- al = the number (1 to 4) of physical drives in the system;
- AM=am --- am = disk I/O tries (i.e. 10) before error declared;
- AN=an --- The DIR command default drive number is an};
- AO=ao --- Drive ao is first and lowest drive used when creating a new file where a drive is not specified;
- AP=ap --- Default HIMEM address;
- AQ=yn --- CLEAR key enabled?
- AR=yn --- COPY formats 5 and 6 allowed without diskette password checking?
- AS=yn --- BASIC input text strings forced to upper case? (Model I only);
- AT=yn --- Chaining in byte mode instead of record?
- AU=yn --- Use clock driven repeat key function?
- AV=av --- If AU=Y delay av 25ms intervals before key's first repeat;
- AW=aw --- Number (i.e. 3) of write with verify disk I/O tries before declaring error;
- AX=ax --- ax is the highest ASCII code for the printer;
- AY=yn --- Ask for date and time at DOS unrecognizable reboots?
- AZ=yn --- Ask for date and time at DOS recognizable boots?
- BA=yn --- Set ROUTE,DO,NL state?
- BB=yn --- Clock interrupts 50 times per second instead of 60? (Model III only);
- BC=yn --- Operator allowed to pause or cancel chaining?
- BD=yn --- Hold down ENTER during reboot overrides AUTO command?
- BE=yn --- DOS command R enabled?
- BF=yn --- Set LCDVR,yn state (Model I only);
- BG=yn --- Set LC,yn state;
- BH=yn --- Set BLINK,yn state;
- BI=bi --- Set cursor character = bi (i.e. 176);
- BJ=bj --- bj is integer CPU speed multiple (i.e. 1, 2, 3) to help DOS cope with a faster CPU;
- BK=yn --- WRDIRP command and DIRCHECK functions W and C enabled?
- BN=yn --- Write directory sectors readable by Model III NEWDOS/80 instead of by Model I TRSDOS (Model I only);
Display the current time.
Set time1 as the current time.
Force verify read after every sector write.
Write directory sectors protected. On the Model III rewrite the directory
sectors for the diskette mounted on drive dn1 to have address mark
F8. On the Model I rewrite the directory sectors to have address mark FA
(if SYSTEM option BN=N) to make the diskette useable on all Model I systems
(including NEWDOS/80 Versions 1 or 2) or F8 (if SYSTEM option BN=Y) to
make the diskette useable interchangeably on Model I and III under NEWDOS/80
Version 2. The actual directory data is not changed in any way.
The TRS-80 Home Page created and maintained by Pete Cervasio
Copyright © 1997 Pete Cervasio