                        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 conversion by Pete Cervasio (February 1996)
ASCII conversion by Sander Berents (July 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
        o LOCK - No access
        o EXEC - Execute
        o READ - Execute or read
        o WRITE - Execute, read or write
        o RENAME or NAME - Execute, read, write or rename
        o KILL - Execute, read, write, rename or kill
        o 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):
        o A --- Standard TRS--80 disk interface;
        o B --- Model I only OMIKRON mapper;
        o C --- Model I only PERCOM double interface;
        o D --- Model III only Apparat disk controller;
        o E --- Model I only LNW type disk interface;
        o H --- Head settle delay is to be done on drive change. Required
          for 8'' drives;
        o I --- Sector 1 is lowest numbered sector on each track;
        o J --- Track 1 is the lowest numbered track on the diskette;
        o K --- Track 0 is formatted in opposite density from the rest of
          the tracks and is usable only during boot;
        o L --- Two step pulses between tracks are used;
        o 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:
        o A --- 5 inch, single density, single sided;
        o B --- 8 inch, single density, single sided;
        o C --- 5 inch, single density, double sided;
        o D --- 8 inch, single density, double sided;
        o E --- 5 inch, double density, single sided;
        o F --- 8 inch, double density, single sided;
        o G --- 5 inch, double density, double sided;
        o 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

----------------------------------------------------------------------------

