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,NEW/DAT:0,TO,OLD/DAT:1

    APPEND NEW/DAT:0 OLD/DAT:1

ATTRIB,file1,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

    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

• 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

HIMEM

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

KILL,file1

    KILL,XXX/DAT:1

LC,yn

    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

LIST,file1,startline,linecount

    LIST,TEXTFILE/PT1:0

LOAD,file1

    LOAD,OVERLAY/OBJ:0

MDBORT

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

PAUSE,msg

    PAUSE,MOUNT INVENTORY DISKETTE ON DRIVE 1

PDRIVE,pwdn1

PDRIVE,pwdn1,dn2,options

• 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

PROT,pwdn1,options

• 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

• /ext --- Only files with name extension ext qualify;
• USR --- Only user files qualify (excludes system and invisibles).

    PURGE,1,USR

R

RENAME,file1,TO,file2

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

ROUTE

ROUTE,CLEAR

ROUTE,xxx

ROUTE,xxx,yyy(s)

    ROUTE,PR

    ROUTE,DO,DO,PR

SETCOM,options

• 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

    STMT,PHASE ONE COMPLETED

SYSTEM,pwdn1,options

• 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

TIME,time1

    TIME,09:30:00

VERIFY,yn

    VERIFY,N

WRDIRP,dn1

    WRDIRP,1

This page is being maintained by Pete Cervasio. If you know of things I've left out, that need to be changed because I don't remember correctly, know of Web links I can add that would be interesting to TRS-80 users or have other comments, go ahead and send me mail. This page wouldn't be possible without the dedication and hard work of Javier Henderson, who also maintains the FTP site.

Back to the Model 1 Hardware Page

Back to the TRS80 Home Page