NEWDOS/80 Version 2 REFERENCE

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)

DOS COMMANDS

General statements for DOS commands:

The user should refer to chapter 2 of the manual for more detail as needed;
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,file1,TO,file2

Append the contents of file1 to the end of file2.

    APPEND,NEW/DAT:0,TO,OLD/DAT:1
    APPEND NEW/DAT:0 OLD/DAT:1

ATTRIB,file1,options

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.

    ATTRIB CNTRLDAT/CMD,UPD=KKKJJJ,PROT=READ

AUTO,doscmd

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.

    AUTO,BASIC,RUN"MYPROG/BAS:0"

BASIC2

(Model I only) Enter Level II non-disk BASIC (no DOS, no disk BASIC).

    BASIC2

BLINK,yn

Enable/disable cursor blinking.

    BLINK,N

BOOT

RE-boot the DOS system.

    BOOT

BREAK,yn

Enable/disable the BREAK key.

    BREAK,N

CHAIN,file1,sectionid

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.

    CHAIN MYCMDS/DAT:1

CHNON,option

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.

    CHNON,Y

CLEAR,START=addr1,END=addr2,MEM=addr3

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.

    CLEAR,START=7000H,MEM=BFFFH
    CLEAR

CLOCK,yn

Turn on/off the time display on the screen.

    CLOCK,N

CLS

Clear the display.

CLS

COPY,file1,TO,file2,options

Single file copy. Only options SPDN and DPDN allowed.

    COPY,XXX/DAT:0,TO,YYY/DAT:1

COPY,$file1,TO,file2,options

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.

    COPY,$XXX/DAT:0,TO,YYY/DAT:1

COPY,dn1,file1,TO,file2,options

Single drive, two diskette single file copy. Only options SPDN and DPDN allowed.

    COPY,1,XXX/DAT,YYY/DAT

COPY,dn1,TO,dn2,date,options

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 specified
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 date
BDU --- Bypass Directory Update. Make a mirror image copy without any adjustments to destination control or directory information.

    COPY,0,1,10/06/81,FMT,NDMW
    COPY,0,0,SN=OLDDISK,ODN=NEWDISK

COPY,dn1,dn2,date,CBF,options

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 diskette directory
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 lump ln1
DDGA=gc1 --- Format will allocate gc1 granules to the directory.

    COPY,0,1,01/24/82,CBF,NFMT,CFWO,USR

CREATE,file1,LRL=sz1,REC=count1,ASE=yn,ASC=yn

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.

    CREATE,XXX/DAT:1,REC=100

DATE

Display the current date.

    DATE

DATE,date1

Set date1 as the computer's current date.

	DATE 02/19/82

DEBUG,yn

Enable/disable debug entry at user program start.

    DEBUG,Y

DIR,dn1,options

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.

    DIR,0,A,/DAT,U

DO,file1,section

Performs identical to CHAIN.

    DO SOMEFILE,TEST

DUMP,file1,startaddr,endaddr,entryaddr,retaddr

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 respectively.

    DUMP,PROGFILE/CMD:0,5200H,63F3H,5530H

ERROR,xx

Display error message for DOS error xx.

    ERROR,24

FORMAT,dn1,dname,date,dpwd,options

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.

    FORMAT,0,AAA0,08/01/81,PSWD,Y
    FORMAT,1,,,,Y

FORMS,WIDTH=xxx,LINES=yyy

Model III only. Set the printer characters per line = xxx and lines per page = yyy. If a parameter is missing its value is not changed.

    FORMS,WIDTH=80,LINES=60

FREE

Display the number of free granules and free directory entries for each diskette mounted.

HIMEM

Display HIMEM value.

HIMEM,addr1

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.

    HIMEM,65000

JKL

Copy the contents of the screen to the printer.

KILL,file1

Delete file1 from the diskette mounted either on the drive specified or if none specified the lowest numbered drive containing that file.

    KILL,XXX/DAT:1

LC,yn

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.

    LC,Y

LCDVR,yn1,yn2

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.

    LCDVR,Y,Y

LIB

Display DOS library commands.

LIST,file1,startline,linecount

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.

    LIST,TEXTFILE/PT1:0

LOAD,file1

Load the machine language program file file1 into main memory but do not execute it.

    LOAD,OVERLAY/OBJ:0

MDBORT

Terminate MINI-DOS and go to DOS READY.

MDCOPY,file1,TO,file2

This single file COPY is legal under MINI-DOS, no filespec truncation options or diskettes swaps allowed.

    MDCOPY,XXX:1,TO,YYY/DAT:0

MDRET

Exit MINI-DOS and return to the main program continuing its execution where left off when DFG was pressed.

PAUSE,msg

Display message msg and wait on the operator to press ENTER.

    PAUSE,MOUNT INVENTORY DISKETTE ON DRIVE 1

PDRIVE,pwdn1

Display PDRIVE table.

PDRIVE,pwdn1,dn2,options

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.

    PDRIVE,0
    PDRIVE,0,2,TI=A,TD=E,TC=40,SPT=18,TSR=3,GPL=6,DDSL=17,DDGA=2
    PDRIVE,0,1,TI=BH,TD=B,TC=77,SPT=12,A

PRINT,file1,startline,linecount

Format and execution the same as LIST except output to printer.

PROT,pwdn1,options

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.

    PROT,1,NAME=NEWNAME

PURGE,pwdn1,options

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).

    PURGE,1,USR

R

Repeat the previous DOS command.

RENAME,file1,TO,file2

Change the name and name extension of file1 to that of file2. file2 must not contain a password or drive number.

    RENAME,OLDNAME/DAT:1,TO,NEWNAME/PTA

ROUTE

Display existing routes.

ROUTE,CLEAR

Clear all routes.

ROUTE,xxx

Clear routes for device xxx.

ROUTE,xxx,yyy(s)

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.

    ROUTE,PR
    ROUTE,DO,DO,PR

SETCOM,options

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 OFF specified.

    SETCOM,WORD=8,BAUD=300,PARITY=1,WAIT
    SETCOM,OFF

STMT,msg

Display the message msg.

    STMT,PHASE ONE COMPLETED

SYSTEM,pwdn1,options

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. Options are:

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);

    SYSTEM,0,AL=4,AA=Y,AU=Y,AV=20,AT=Y
    SYSTEM,0

TIME

Display the current time.

TIME,time1

Set time1 as the current time.

    TIME,09:30:00

VERIFY,yn

Force verify read after every sector write.

    VERIFY,N

WRDIRP,dn1

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.

    WRDIRP,1