Page 1

Runs CP/M 2.2 Programs on Your IBM PC

ZRP/M

Operating

System

MicroMethods,, Inc, PO Box 909,, Warrenton,, OR 97146

Copyright 1987,1988,1989 by MicroMethods, Inc.

ALL RIGHTS RESERVED

Information in this manual is subject to change without notice and does not represent a commitment on

the part of MicroMethods, Inc. The software described in this publication is furnished under license

agreement and/or nondisclosure agreement. The software may be used or copied only in accordance

with the terms of the agreement. It is against the law to copy this software on any medium for any

purpose other than the purchaser's personal use.

WARRANTY

The physical diskette is warranted to be free of defects in materials and workmanship for 30 days from

the date of purchase. Remedy shall be limited to replacement and shall not include any other damages

or claims. MicroMethods Inc. specifically disclaims all other warranties, expressed or implied, including

but not limited to, implied warranties of merchantability and fitness for a particular purpose. In no event

shall MicroMethods, Inc. be liable for any loss of profit or any other damage, including but not limited to

special, incidental, consequential or other damages.

ZRP/M Operating System

Users Guide

Introduction to ZRP/M

ZRP/M is the best way to add Z80 CP/M 2.2 program running capability on your IBM PC/XT/AT

compatible computer. Why is ZRP/M better than a DOS program used to run CP/M programs?

ZRP/M is a genuine OPERATING SYSTEM with real CP/M 2.2 compatible environment, built-in

commands and utilities. ZRP/M is pre-installed, ready-to-run. It boots from the DOS release diskette

(and may be copied to and operated entirely from the hard disk). It is pre-configured to use DOS

and CP/M86 format diskettes, and with the SETDISK utility, one floppy drive can be set to

read/write over 90 CP/M 51/4" SSDD and DSDD disk formats. The "CP/M environment" is selectable:

terminal types, colors, keyboard configurations, function key phrases, logical disk assignments,

etc. These options are selectable on-line for changing the environment as needed by a CP/M

program.

ZRP/M is fully CP/M 2.2 compatible, enhanced with file date and time stamping, common access to

disk user zero files, multiple commands on a line, paged type, automatic disk relog, program

chaining, improved batch options, IOBYTE character 1/0 redirection, access to 16-bit IBM ports

from CP/M programs, selectable disk path, etc. A modem file transfer program is included (with

source for a Kaypro companion). An optional CP/M terminal is supported on a serial port.

This manual is organized alphabetically for easily finding the ZRP/M procedures, built-in

commands and utility programs associated with running CP/M programs on your IBM PC/XT/AT or

compatible computer. ZRP/M is ready-to-run from the release diskette (but you should make a

working copy and archive the release diskette). No installation is required unless you want to

create a ZRPM subdirectory on your hard disk and copy the files from the release disk to it. The

environment needed by a CP/M program is configured on-line with ZRP/M utilities, and may be

automated with a batch file. To get started, refer to the pages in this manual about "Backup disks",

Copying ZRP/M to hard disk, and "Booting ZRP/M". CP/M programs not requiring terminal

emulation or media conversion are runnable as soon as ZRP/M is booted. See RTERM for

configuring CP/M terminals, and SETDISK for disk media conversion.

For CP/M information, consult appropriate CP/M manuals and texts.

ZRP/M Operating System

Users Guide

1

ALT-CTRL-DEL

Pressing these three keys simultaneously causes a cold boot of the computer. ZRP/M does not

cold boot; It must be run from DOS (see Booting ZRP/M, and RPMSYS). From ZRP/M, the

recommended way to return to DOS is GODOS[enter].

Alternate Console

see CONSOLEX utility for connecting a terminal via COM1 or COM2 as the ZRP/M (CP/M)

console.

ASCII[enter]

Will display the hex key code as you press any key. Press CTRL-C to exit the program.

ASM (ZRP/M Assembler is RASM)

RASM m:filename.xyz 1:[enter]

where x=source drive, y=hex output drive, z=list output drive, and 1: is source drive for library

files accessed by RDLIB pseudo-op (or current disk if not specified). The list output may be

directed to the display by specifying X. The list and hex outputs may be suppressed by

specifying Z. The include pseudo-op must occur in the original source file with syntax:

RDLIB 'filename.typ'

ASSIGN I=p[enter] (ZRP/M utility program) Assigns logical disk letter I (which may be ABCDEFGHIJKLMNOP) to

physical floppy drive p (A or B). This is useful for accornodating unique CP/M program requirements. To display

current ZRP/M disk assignments: ASSIGN *[enter]

ASSIGN A=C[enter] (DOS command; see your DOS manual) Before booting ZRP/M from DOS, this command is useful

for keeping all CP/M operations on the hard disk (if that is desired). To remove the assignment after finished with

ZRP/M: ASSIGN[enter]

Auto Relog message.

Disk error on d: Swap ok?

When ZRP/M detects a swapped disk, it marks the disk read only. A subsequent write will cause

the above message. The new disk is automatically logged in, then ZRP/M pauses for your

decision. Press CTRL-C if you do NOT want to write on the disk. Press [enter] or any other key

to go ahead and write on it (continue processing).

AUTOCALL

Modifies the RPM.SYS file to change the command line executed during startup. DOS file

RPMSYS.COM must be renamed to RPM.SYS before it may be modified by AUTOCALL.

AUTOCALL looks for RPM.SYS on the current disk.

AUTOCALL[enter]

Type in the command:

command[enter]

New autocall command installed in RPM.SYS; rename RPM.SYS back to RPMSYS.COM

ZRP/M Operating System

Users Guide

2

Backup Disk

KCOPY A: B:[enter] with DOS.

may be optionally verified with:

KCOMP A: B:[enter] with DOS.

Batch Processing Methods

ZRP/M supports three batch processes:

SUBMIT (you supply; invokes CP/M batch)

CALL (ZRP/M version of SUBMIT)

DO (CALL version using the M: disk)

Booting ZRP/M

Make the release disk with the ZRP/M system files the current disk, then:

RPMSYS dX:option[enter]

where d are DOS disk drives to be accessed by ZRP/M, and option is the built-in command or

program to be executed immediately upon booting ZRP/M. Up to eight d DOS drives may be

specified and the last d is set as the current disk. Including the X letter in the DOS drive list will

cause the ZRP/M session to automatically end and return to DOS at the first warmboot (CTRL-C

or JMP 0). Use this to run a CP/M program and return immediately to DOS. If :option is omitted,

DOSTIME is invoked to set the ZRP/M date and time from DOS. To boot ZRP/M from hard disk

and keep CP/M processing on the hard disk:

ASSIGN A=C[enter]

RPMSYS AC[enter]

To boot from hard disk, run one CP/M program and return immediately to DOS:

ASSIGN A=C[enter]

RPMSYS ACX:DO batch[enter]

typically batch will be a SUB file which configures and runs the CP/M program. If the CP/M

program requires no special configuration, call it directly:

RPMSYS ACX:cpmproglenter]

To boot from hard disk and assign all disks to DOS:

RPMSYS ABC[enter] or RPMS ABC:option[enter]

To boot from hard disk and assign all floppy drives to ZRP/M, mount a ZRP/M formatted disk in

drive A: and

RPMSYS C[enter] or RPMSYS C-.option[enter]

To boot ZRP/M from a floppy drive:

RPMSYS A[enter] single floppy drive.

RPMSYS A[enter] B: is ZRP/M drive

RPMSYS B[enter] A: is ZRP/M drive

RPMSYS BA[enter] current disk A:

RPMSYS AB[enter] current disk B:

To boot ZRP/M and invoke a batch process:

RPMSYS A:DO batch[enter]

where batch is a filename.sub batch file on the current disk. The batch file may configure and

run a CP/M program. During ZRP/M startup from DOS, the ZRP/M banner will first be displayed,

followed by ZMA, ZMB and ZM1 object module loading messages, then one asterisk, then

(default) DOSTIME will set the date and time from DOS and finally the ZRP/M prompt d> awaits

your command type-in. To conclude ZRP/M (CP/M) processing and return to DOS:

GODOS[enter] exits ZRP/M and returns control to the DOS prompt. If DOS floppies had been

assigned to C:

ASSIGN[enter]

ZRP/M Operating System

Users Guide

3

Booting Messages

************CP/M 2.2 Compatible

**

** ZRP/M Operating System for IBM PC, Ver 2.2

**

(C) 1987 by MicroMethods, Inc.

**

*************** Z280 EMULATOR **************************

* Loading ZMA.OBJ *

* Loading ZMB.OBJ *

* Loading ZM1.OBJ

yy-mm-dd hh:mm:ss (date and time)

A> Prompt awaiting your type-in, a command or program to be executed.

Booting Problem

The ZRP/M release disk is individually booted and tested before shipment. Unless it was

somehow damaged during shipment (which hasn't occurred to date), it should boot. In case of

difficulty, the problem is usually hardware related, or a procedural misunderstanding. An

example of a procedural difficulty is that ZRP/M is an operating system rather than an

application program and may not co-exist with a particular DOS program (coexistence is not

assured).

CALL A[enter]

Invokes the batch procedure contained in the file AA$.SUB, which was created by SUBREN

Aname.SUB[enter]. See SUBREN.

CALL x crn[enter]

Uses the system flag to conditionally CALL the batch procedure xx$.SUB.

c =flag condition: T (true) non-zero, F (false) zero, X or space= CALL unconditionally.

n a number (0 thru 9)

r set or reset flag: S = Set flag (default 1), R = Reset flag to zero.

n the Set value (1 thru 9)

Examples:

CALL A XS[enter] Calls A and sets error flag = 1.

CALL A XC[enter] Calls A and clears error flag = 0.

CALL A XSO[enter] Calls A and sets error flag = 0.

CALL A 2S3[enter] Calls A if error flag = 2, and sets error flag = 3. See Error Flag.

CATALOG d:filename.ext c:[enter]

Catalog disks utility.

First label disks to be cataloged with 4-characters, like A001, A002, etc. Reads the filename.ext

(which may be all files *.*) on disk d: and creates CATALOG.TMP file on the c:drive specified

(which may be the same as d:).

CD \path[enter]

Changes the DOS directory path from ZRP/M. A space is required between CD and \.

Change current disk. d:[enter] to change current disk. The current disk letter is displayed in the ZRP/M

ZRP/M Operating System

Users Guide

4

prompt d>.

CH[enter]

Clears the display screen and positions the cursor at the upper left comer (home).

Chaining to the next program from within a program.

With registers HL pointing to a properly formatted command string, a call to RCP+6 (use

MEMMAP to obtain RCP location) will cause RCP to load the string into Its command buff er. A

jump to RCP will then execute the command.

Character 1/0 Redirection.

ZRP/M supports character VO redirection via IOBYTE. (See appendix.)

COLOR[enter]

Displays a menu for selecting the background, text and border colors.

COLOR *[enter]

Selects the default display colors: red border, blue background, gray-white text.

COLOR b:BC.TC C $typein[enter]

selects display colors and program chaining from the command arguments, where:

b: is the border color letter (A thru P, @ or blank same as background) A=black, B=blue,

C=green, D=cyan, E=red, F=magenta, G=amber/brown, H=gray-white, I=dark gray, J=lt blue, K=lt

green, L=ft cyan, M=ft red, N=lt magenta, O=yellow, P=white, omitted or @ same as background.

BC = background color (only capitalized part need be used): Black, BLUe, Green, Cyan, Red,

Magenta, Amber, GRAy-white.

.TC = text/foreground color (only capitalized part need be used): Black, BLUe, Green, Cyan,

Red, Magenta, Amber, GRAy-white, DGray, I-Blue, I-Green, I-Cyan, I-Red, I-Magenta, Yellow,

White

C = chain to commands/program in COLOR.COM chaining buffer.

$typein = chain to commands/program typed in after the $ sign in calling arguments.

COLOR E:BLUe.GRAy[enter]

Red border, blue background, gray-white text.

COLOR Green.Black C[enter]

"Green monitor", chain to DIR (default).

COLOR A.B $DIR *.COM DIR *.DOC[enter]

"Amber monitor", chain to two DIR commands, using the type ahead multiple commands on a line

feature.

.COM files

ZRP/M executes CP/M COM files (do NOT rename them to CMD files). To keep CP/M COM files

separate from DOS COM files, use separate diskettes and separate hard disk subdirectories.

ZRP/M Operating System

Users Guide

5

Command line continuation.

To continue a command line beyond 80 characters, press Control-E.

Communications & file transfers.

See the MODEMPC utility included with ZRP/M.

Comparing two disk f iles.

To compare the contents of two files and display the differences, if any:

RPMPIP oopyfile.ext::orgfile.ext[E][enter]

The [E] option echoes any differences in hex and ASCII to the display.

Concatenate (link) files.

RPMPIP bigfile.ext=smaill.ext,smaII2.ext....

See the RPMPIP utility included with ZRP/M.

Control-C

Warmboots ZRP/M.

Control-E

Continues a command line beyond 80 characters

Control-P

Toggles sending displayed lines to the printer.

Control-Prtsc

Same as Control-P; toggles sending displayed lines to the printer. (Shift-Prtsc prints what is

currently on the display screen.)

Control-R

Re-displays the current command line. This is useful to look at the command after

corrections are made.

Control-S

Stops/restarts displaying output on the screen.

Control-U

Retrieves the contents of the command buff er. This is useful for re-using the previous

command.

Control-X

Deletes the current command line.

ZRP/M Operating System

Users Guide

6

CONSOLEX COMn.yz baud.p

Transfers the console to a terminal on serial port n.

n = 1 (COM11) or 2 (COM2)

y = # bits in a character

z = # stop bits

baud = speed (1100,300,600,1200,2400,4800,9600)

p = N or blank for NONE, E for EVEN, 0 for ODD. Examples:

CONSOLEX COM1.81 9600.N

CONSOLEX COM2.81 9600.N

Transfers console to terminal connected on COM1 or COM2 with 8 data bits and I stop bit, at

9600 bps, no parfty.

CONSOLEX[enter]

with no arguments shuts off afternate console redirection; returns the console to the IBM PC

display screen and keyboard.

Copying files.

See RPMPIP for details.

RPMPIP d:newname.ext=a:oldfile.ext[VO][enter]

Copies file using a new f ilename.

RPM PIP d:=a:filename.ext[VO][enter]

Copies a file using the same filename.

RPM PIP d:=a:*.*[VO][enter]

Copies all files from the A: disk.

If the verify option [V] is used, also include the no edit [0] option.

Copying Diskettes with DOS. DISKCOPY A: B:[enter] then DISKCOMP A: B:[enter] (optional verify).

Copying ZRP/M to Hard Disk, with DOS.

Create a subdirectoy on the hard disk to receive the ZRP/M files with MD\name[enter]. Change

path to new subdirectory, CD\namelenter]. Mount the ZRP/M release disk marked "DOS" in the

A: drive, then:

COPY A:*.* C:[enter]

CP/M Disks

See the ZRP/M utility program SETDISK for CP/M disk reading/writing. SETDISK is provided for

media conversion; for copying your CP/M files to either DOS or RP/M (CP/M86) diskettes.

Program execution should be either from ZRP/M diskettes (choice for best CP/M compatability),

or from DOS disks (either diskettes or the hard disk).

CP/M Terminals

See the ZRP/M utility, RTERM for list of CP/M terminals emulated.

ZRP/M Operating System

Users Guide

7

Customizing ZRP/M

ZRP/M provides keyboard translations (see KEYBD) and terminal emulation selections (see

FITERM) for many CP/M program configurations. ZRP/M supports character VO redirection via

IOBYTE (see appendix).

Data Entry (To create a disk file without an editor.)

RPMPIP filename.ext-CON:[enter]

At the hypen prompt, data may be typed in from the keyboard which will be written to

filename.ext. Press CTRL-Z to end the data entry session. See RPMPIP. This is useful for

creating very small text files, such as a batch file.

DOSTIME[enter] sets the date and time from DOS.

DTIME 0[enter]

to set the date and time from keyboard input. It displays this request:

Enter the date and time:

yy-mm-dd hh:mm[enter]

DTIME[enter] displays the ZRP/M date & time.

Date & Time File Stamps: FISTAT d:*.* D[enter] displays an alphabetically arranged disk directory

with the date & time stamps.

Delete current command line. Press Control-X to delete the command line.

DIRectory listings.

DIR d:filename.ext[enter] for particularfile.

DIR d:*.*[enter] for all files.

Displays directory contents with filesize in number of 256-byte pages, or a + sign for very large

(CP/M disks). For DOS disks, DIR displays filenames only.

Directory Utility, RSTAT.

FISTAT d:filename.ext D[enter] for a particular file.

FISTAT d:*.* D[enter] for all files.

Displays CP/M directory contents in alphabetical order with filesize, date and time. For DOS

disks, FISTAT displays filenames only.

DOS Disk Access

DOS disk access is normally established when booting ZRP/M (see RPMSYS). After ZRP/M is

up, DOS disk access may be added, changed or removed with DOSDISK:

DOSDISK d[enter]

Sets d drive(s) for processing by DOS.

ZRP/M Operating System

Users Guide

8

DOSDISK[enter]

without arguments removes processing of DOS disks.

DOSDISK C[enter] for using the hard disk.

DOSDISK BC[enter] sets B and C for DOS access.

DOSDISK ABC[enter] sets all drives for access via DOS.

Hard disks must be accessed via DOS.

96 TPI floppy drives may be accessed thru a DOS device driver. (Any disk that is supported by

DOS may be accessed from ZRP/M via DOSDISK access. This includes CP/M disk format

access via a DOS driver such as the UNIFORM software product.)

Disk Access, CP/M.

Floppy drives that are not assigned for DOS processing at RPMSYS boot time, or by DOSDISK,

are defaulted to the ZRP/M floppy disk format, which is CP/M86 DSDD. One floppy disk drive

may be set to process other CP/M 5-inch disk formats via the resident system extension

SETDISK.

SETDISK *[enter] displays a list of CP/M disk format selections in alphabetic order. SETDISK

*.N[enter] displays a list of CP/M disk format selections in numeric order. SETDISK d:nnn[enter]

sets the d: floppy disk drive to CP/M disk format selection nnn. SETDISK[enter] removes the

SETDISK rsx.

See SETDISK for CP/M disk selection list.

Disk Assignments, CP/M.

ASSIGN I=p[enter] See the ZRP/M ASSIGN command. Logical ZRP/M disks

ABCDEFGHIJKLMNOP may be assigned to the physical ZRP/M diskette drives, to accomodate

unique program configuration requirements.

Disk Assignments, DOS.

ASSIGN A=C[enter] See the DOS user's manual. May be used to assign the A: drive to the hard

disk before booting ZRP/M from DOS.

Disk Auto Relog (when a CP/M disk is swapped). Disk error on d: Swap ok?

When ZRP/M detects a swapped disk, it marks the disk read only. A subsequent write will cause

the above message. The new disk is automatically logged in, then ZRP/M pauses for your

decision. Press CTRL-C if you do NOT want to write on the disk. Press [enter] or any other key to

go ahead and write on it (continue processing).

Disk Check (ZRP/M disk). See the FLAWTBL and LOCKOUT utilities.

Disk Copying, using DOS.

DISKCOPY A: B:[enter]

then optionally verify result with

DISKCOMP A: B:[enterl

ZRP/M Operating System

Users Guide

9

Disk Copying CP/M diskettes.

RPMPIP d:filename.ext.slilename.ext[enter]

See the RPMPIP command.

RPM PIP d:=s:*.*[enter]

copies all files from the s: source disk to the d: destination disk.

Disk Errors - Disk Problems - Resetting the disks.

See Disk Swap, Auto Relog. Try DRESET[enter], to reset disks, which may help.

Disk Formatting, ZRP/M (CP/M86) diskettes.

Use the RFORMAT utility to format a ZRP/M (CP/M86 DSDD) diskette.

Disk Reset

DRESET[enter] resets the disks. Immediately after changing disk configuration with DOSDISK,

DOSTERM or SETDISK, do a DRESET. This will prevent disk access problems that may

otherwise occur following disk configuration changes. See DO DOSDISK, DO DOSTERM and

DO SETDISK, which do the configuration change and DRESET in batch files.

Disk Status Request (RSTAT utility).

RSTAT[enter] displays logged in disks and disk space.

RSTAT d:[enterl displays space available on disk d:

RSTAT X S:[enter] displays disk size and characteristics.

RSTAT d:*.* D[enter] displays files with size, attributes and date & time stamps.

RSTAT d:*.* U[enter] displays users on disk D: and space.

RSTAT X V:[enter] displays a help file, with a list of RSTAT functions.

Disk Swap (CP/M Auto Relog).

Disk error on d: Swap ok?

When ZRP/M detects a swapped disk, it marks the disk read only. A subsequent write will cause

the above message. The new disk is automatically logged in, then ZRP/M pauses for your

decision. Press CTRL-C if you do NOT want to write on the disk. Press [enter] or any other key

to go ahead and write on It (continue processing).

Disk Write Protect.

Attaching a write protect tab to the floppy disk Itself is the safest method of write protecting ft. A

CP/M (not DOS) diskette may also be ZRP/M write protected with:

RSTAT d: $R/O[enter]

A particular CP/M file may be ZRP/M write-protected with: RSTAT dlilename.ext $R/O[enter]

To remove the file write-protection:

RSTAT d1ilename.ext $R/W[enter]

See File Attributes and RSTAT.

RSTAT X V:[enter] for a help file, listing the RSTAT functions.

Display Emulation.

See the RTERM utility, which configures the emulation of various CP/M terminal types.

ZRP/M Operating System

Users Guide

10

Display text file from disk.

TYPE filename.ext[enter], (see TYPE) or

RPMPIP CON:.filename.ext[enter] (see RPMPIP)

DO batch[enter]

DO is a special version of SUBREN which creates the xx$.SUB file on the M: disk and then CALLs (executes) it. Le.,

DO executes the batch.SUB command file from the M: disk, regardless of where batch.SUB file is located. This

permits executing a batch command file located on a DOS disk. By including the DO in the RPMSYS arguments, you

may configure and run a CP/M program from a batch file on the DOS disk, and optionally return to DOS when the

CP/M program completes. (see Booting ZRP/M, and RPMSYS).

DO DOSDISK d c[enter]

Configures DOS disks d, sets current disk to c, and does a disk reset. See DOSDISK and DRESET.

DO DOSTERM d c[enter]

Configures DOS disks d, sets current disk to c, invokes DOS terminal emulation, and does a disk reset. See

DOSTERM and DRESET.

DO SETDISK d:nnn c[enter] Configures CP/M disk format nnn on floppy drive d, sets current disk to c, and does a disk

reset. If c (current disk) is omitted, sets the current disk to the M: disk, as that is where the DO batch program is

executed. See SETDISK and DRESET.

DOSDISK d[enter]

Sets d drive(s) for processing by DOS.

DOSDISK C[enter] for using the hard disk.

DOSDISK BC[enter] sets B and C for DOS access.

DOSDISK ABC[enter] sets all drives for access via DOS.

Do DRESET[enter] after immediately changing configuration with DOSDISK. (See DO DOSDISK, which includes the

DRESET.) Hard disks must be accessed via DOS.

96 TPI floppy drives may be accessed thru a DOS device driver. (Any disk that is supported by DOS may be

accessed from ZRP/M via DOSDISK access. This includes CP/M disk format access via a DOS driver such as the

UNIFORM software product.)

DOSDISK[enter] without arguments removes processing of DOS disks.

DOSTERM d[enter]

is identifical to DOSDISK with the additional feature of directing the terminal/display functions to

DOS for processing. At least one DOS disk drive must be selected to invoke DOS terminal

processing. See DOSDISK. Do DRESET[enter] immediately after changing configuration with

DOSTERM. (See DO DOSTERM, which includes the DRESET.)

DOSTERM[enter]

removes DOSTERM.

ZRP/M Operating System

Users Guide

11

DOSTIME[enter]

sets the ZRP/M date & time from DOS. RPMSYS on the ZRP/M release disk autocalls

DOSTIME.

DTIME[enter] displays the ZRP/M date & time.

DTIME Q[enter]

sets the date & time from keyboard input. It displays the message:

Enter the date and time:

yy-mm-dd hh:mm[enter]

Type in the date in two-digit year-month-day and time in hours-minutes sequence. These ten

digits may be entered with or without the hyphen or colon separaters.

DTIME 0 C[enter]

after requesting date & time from the keyboard, chains to FISTAT *.* D which displays the disk

files with their date & time stamps.

Dump File

See the XDUMP utility, which dumps file in hex and ASCII.

ERA dlilename.ext[enter] Erases named file on disk d:

ERA *.*d:*.*[enter]

ERAd:*.*d:*.*[enterl

Erases all files on disk d: If the first d: is stated, the d:'s must match (a check to assure you want

to erase all files).

Errors, disk.

see Disk Errors, Auto Relog, DRESET, FLAWTABLE, LOCKOUT.

Error Flag.

ZRP/M has a system error flag defined on memory page zero at location 003EH. Any program

may set or clear this flag byte (the ZRP/M operating system doesn't modify it). Under control of

this error flag, command procedures may be conditionally invoked by CALL. (see CALL,

Conditional).

File Attributes, displaying and setting them.

RSTAT d:*.* D[enter] Displays files with size, file attributes, and date and time stamps.

RSTAT d:filename-ext $R/O[enter] Sets file attribute to Read Only.

RSTAT W ilename ext $R/W[enter] Sets file attribute to Read/Wdte.

FISTAT d:filename.ext $SYS[enter] Sets file attribute to System.

RSTAT d:filename.ext $DIR[enter] Removes previously set System.

RSTAT d: $R/O[enter] Write protects all disk files.

RSTAT d:filename.ext $ALL[enter] Clears file attributes.

ZRP/M Operating System

Users Guide

12

RSTAT d:filename.ext $SFn[enter] Alternate set file attribute n.

RSTAT d:filename.ext $CFn[enter] Alternate clear file attribute n.

RSTAT X V:[enter] Help file lists RSTAT functions.

File Comparing.

To compare the contents of two files and display the differences, if any:

RPMPIP copyfile.ext::orgfile.ext[E][enter]

The [E] option echoes any differences in hex and ASCII to the display.

File Concatenation (combining files). To concatinate several files into one: RPMPIP bigfile.ext=smalll.ext,sma112.ext.... See

RPMPIP.

File Conversions.

see SETDISK for converting files from various CP/M disk media formats.

File Copying.

See RPM PIP for details.

RPMPIP d:newname.ext=a:oldfile.ext[VO][enter] Copies file using a new filename.

RPMPIP d:=a1iIename.ext[VO][enter] Copies a file using the same filename.

RPMPIP d:=a:*.*[VO][enter] Copies all files from the A: disk.

If the verify option [V] is used, also include the no edit [0] option.

File text displaying. TYPE filename.ext[enter] (See TYPE command), or RPMPIP CON:=filename.ext[enter] (See RPMPIP).

File Dump.

See the XDUMP utility, which dumps a disk file in hex and ASCII.

File Modifications.

see RPMPIP and File Translations.

RPMPIP delete. ext= report.prn[ D35-45][enter] Deletes columns 35-45 during copy.

RPMPIP chop.ext=report.prn[D40] Deletes from column 40 to end of each line.

RPMPIP part.ext=all.ext[Shere"ZQthere AZ][enter] Copies from start of string 'here' to but not

including string 'there'.

File Transfers by Modem. See the MODEMPC utility.

File Translations.

see RPMPIP.

RPMPIP d:deleteff.ext=a:report.prn[F][enter] Deletes form-feeds from a file.

RPMPIP d: lower. ext=a:report.prn[L][enter] Translates all text to lowercase.

RPM PIP d:upper.ext=a:report.prn[U][enter] Translates all text to uppercase.

RPMPIP d:sevenbft.ext=a:eightbft.ext[Z][enter] Translates text to 7-bit (clear ASCII).

ZRP/M Operating System

Users Guide

13

FLAVVTBL d:[enter] Tests CP/M diskette d: and reserves unusable blocks in a flaw table on disk. The flaw table is marked

"system"so Is not displayed by DIR, but can be displayed by RSTAT d:*.* or RSTAT d:*.TBL Also see LOCKOUT.

Format ZRP/M (CP/M86) diskette. Use RFORMAT to format a ZRP/M (CP/M86 DSDD) disk.

Function Key Definitions and Installation. The use of program function keys (and special keys) for commands and phrases

is implemented by NEWPFK which creates/modifies command/phrase storage (.PFK) files, and SETPFK which

installs a selected PFK file. Each PFK file contains 128 commands or phrase records of up to 127 characters each.

Records are chainable for over 127 chars. Commands and phrases are stored and retreived by function/special keys,

or ALT+numbers 128 through 255. Sample.PFK files on the release disk are: EXAMPLE.PFK with ZRP/M

commands, PHRASE.PFK with example phrases, and WS.PFK, an example for Wordstar. The PFK file must be

copied to the M: disk before it may be used. It is then installed with SETPFK. To use the EXAMPLE.PFK file:

RPMPIP M:=d:EXAMPLE.PFK[enter]

SETPFK EXAMPLE[enter]

Now pressing the F1 function key will result in DIR[enter], a directory display of the current disk. To list the contents

of the PFK file on the M: disk, NEWPFK M:filename *[enter].

See appendix for EXAMPLE.PFK list.

To remove the current. PFK file,

SETPFK[enter] without arguments.

See NEWPFK for.PFK file creation details.

GODOS[enter]

Terminates ZRP/M session and returns to the DOS prompt.

IOBYTE display.

To display the four two-bit fields of IOBYTE (LST, PUN, RDR, CON):

RSTAT X T:[enter]

IOBYTE setting.

To set IOBYTE:

RSTAT dev T:n[enter]

where:

dev = LST, PUN, RDR or CON

n = 0, 1, 2 or 3

ZRP/M supports character VO redirection via IOBYTE. See appendix.

KEYBD[enter] displays a menu of keyboard selections.

KEYBD A[enter] for AMERICAN (US) keyboard, which is the default when ZRP/M is booted.

KEYBD B[enterj for BRITISH (UK) keyboard. KEYBD D[enter] for DVORAK keyboard. KEYBD F[enter] for FRENCH

keyboard.

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

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

ZRP/M Operating System

Users Guide

14

KEYBD G[enter] for GERMAN keyboard.

KEYBD I[enter] for ITALIAN keyboard.

KEYBD S[enter] for SPANISH keyboard.

The numeric keypad keys are NOT translated. See the appendix for these keyboard layouts.

KEYBD k C[enter] selects keyboard k and chains to the ASCII program to check it out.

KEYBD ?[enter] displays current keyboard type.

Loadonly feature of ZRP/M.

filename.ext[enter]

Loads filename.ext into memory (transient program area), but doesn't execute ft. This is useful in

conjunction with the SAVE command on single disk drive systems. Including the file extension is

what invokes loading only.

LOCKOUT d:[enter]

The ZRP/M operating system saves the "Disk error on d: Bad sector" block whenever that error

is encountered. Use LOCKOUT d:[enter] to put that block in the disk flaw table that was

previously created. See the FLAVVTBL utility.

MEMMAP[enter]

Displays the various ZRP/M operating system memory locations within the 64K ZRP/M segment.

RCP is the ZRP/M equivalent of CP/M's CCP. RDOS is the ZRP/M equivalent of CP/M's BDOS.

Memory Disk.

The M: memory (RAM) disk is a pre-installed CP/M86 format virtual disk, and is available for

scratch disk or working disk space at all times. On a 640K computer, the M: disk space is

equivalent to a floppy disk, or nearly so (depending on what else is taking memory space when

running with DOS). Any data on the M: disk should be copied to a floppy disk before ending the

ZRP/M session, as the M: disk is not saved between sessions.

MODEMPC

is a Christensen protocol file transfer utility using the IBM PC serial port COM1. Source code for

a Kaypro companion Is included on the release disk, and a diagram for a cable connecting the

IBM PC to a Kaypro computer is included in the appendix.

MODEMPC dlilename.ext x:nnnn.pc[enter]

where:

d: = disk drive of file to send or receive

x = R to receive a file, S to send a file, T for console message mode as DTE (terminal), 0 for

console message mode as DCE (computer)

nnnn - data rate in bits per second (110, 150, 300, 600, 1200, 2400, 4800 or 9600)

p = N no partly, E even parity, 0 odd parity

c = 5 for 5 Mhz CPU (clock rate), 8 for 8 Mhz CPU

for example:

MODEMPO DB.BAS R:1200[enter] receives a file at 1200 bps, no parity, and writes ft to disk file

DB.BAS

MODEMPC TESTJMP S:300[enter] sends file TEST.TMP at 300 bps.

ZRP/M Operating System

Users Guide

15

Conversation and switch procedure: MODEM PC d:filename.ext T:1 200[enter] After

conversation, press Control-E for switch to file transfer mode, answering S to Send and R to

Receive the named file.

Multiple Commands on One Line.

ZRP/M will process multiple built-in commands on a line, each separated by a space. The last

command on the line may call a program or utility.

NEWPFK filename[enter]

to create or modify a function key definition file, as follows: Press Function Key or Aft 128-255

(Ctd-C to Exit): Press the function key you want to define, or keep the Aft key pressed while

entering a number 128 through 255. For example, press F1.

Write New Record? Y/N: Yfenter]

Enter new text (-M=cr, -J=ff, comments after A@):

DIR-MA@

[Fl] DIR(enter) [enter]

When entering new phrases, use the - tilde character to specify the CTRL key. For example, -A

for CTRLA -J for line-feed and -M for enter. To continue a phrase on another record, end the

continued phrase with a I followed immediately by pressing ALT+number of continuation record.

To end the new/modif ied phrase, press CTRL-@, after which you may type in a comment or a

description about the phrase, as in the above example. Example program function key files are

on the release disk: EXAMPLE.PFK, WS.PFK and PHRASE.PFK, which may be listed as follows:

RPMIP M:=filename.PFK[enter] to be displayed NEWPFK M:filename *[enter]

will display the contents of filename.PFK

See appendix for listing of EXAMPLE.PFK file, which was printed this way (CTRL-P pressed prior

to NEWPFK M:EXAMPLE *[enter]), and other detail.

OUT[enter] or OUT IBM[enter]

Sets output to 8-bit IBM character set, including non-ASCII extended special characters (the

default at startup).

OUT ASCII[enter] or OUT WS[enter]

Limits output to 7-bit ASCII characters; thereby Wordstar files will be output in clear text.

PAGE n[enter]

Sets page size for the TYPE command to display n pages and stop (default is 24 lines). The n

count enables paging the display.

PAGE O[enter] Zero lines disables paging.

Path Change to DOS disk from ZRP/M.

CD \path[enter] Note: Unlike the DOS command, there must be a space between CD and V

Changes DOS directory path from ZRP/M.

ZRP/M Operating System

Users Guide

16

Path Change to CP/M disk.

REN =d:[enter]

Changes disk to be searched for finding files.

Path Display, CP/M disk.

REN =*[enter] displays current ZRP/M disk path.

Phrase Storage (phrases invoked with function keys).

The use of program function keys (and special keys) for commands and phrases is implemented

by NEWPFK which creates/modifies command/phrase storage (.PFK) files, and SETPFK which

installs a selected.PFK file. See NEWPFK and SETPFK, and appendix.

PIP

See RPMPIP.

Port IN/OUT, 16 bits

ZRP/M supports 16-bit port IN/OUT so any IBM PC port may be accessed by a CP/M program

written or modified to take advantage of this feature:

LXIB,PORT ;16-bitportinBC

MVI D,OP ;012H IN, 013H OUT CALLOF133H ;CaIICBIOSEP11 Sends or returns byte in A

register. Alternately, ZRP/M has direct 16-bit port access via Z280 instructions.

Print Screen

Shift-Prtsc prints what is on the screen.

Printer Toggle.

Control-P or Control-Prtsc toggles sending displayed lines to the printer.

Program Chaining from within CP/M programs.

With HL pointing to a properly formatted command string, a call to RCP+6 (use MEMMAP to

obtain RCP location) will cause RCP to load the string into its command buffer. A jump to RCP

will then execute the command.

Program Running Problem.

ZRP/M runs most well-behaved commercial CP/M programs. Some require terminal emulation

(use RTERM), and some demand a CP/M disk be used rather than a DOS disk. Some CP/M

programs require modification (see program patching examples in the appendix). Because

ZRP/M is a genuine CP/M 2.2 compatible operating system, ZRP/M has a good record of running

CP/M programs that could not be run on CP/M emulators.

RAM disk. See memory disk (M: disk).

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

ZRP/M Operating System

Users Guide

17

RASM m:filename.xyz 1:[enter]

(ZRP/M Assembler) where x=source drive, y=hex output drive, z=list output drive, and 1: is

source drive for library files accessed by RDLIB pseudo-op (or current disk N not specif ied). The

list output may be directed to the display by specifying X. The list and hex outputs may be

suppressed by specifying Z. The Include pseudo-op must occur in the original source file with

syntax:

RDLIB 'filename.typ'

Note: RASM.COM works with the CP/M LOAD.COM (which you supply).

Redirect Character VO.

See IOBYTE.

Re-display command line.

Control-R re-displays the current command line. This is useful to look at a command, after

corrections.

REN newfile.ext=oldfile.ext[enter] Renames the file on the CP/M current disk.

REN d:newfile.ext=d:oldfile.ext[enter] Renames the file on CP/M disk d: The d: disks must match.

RENAME d:oldf'le'ext newfile.ext[enter] From ZRP/M, renames oldfile on DOS disk d: to newfile

name.

RESTOR diiiename.ext[enter]

Attempts to recover the specified CP/M disk file that has been erased; usually successful 9 called

before any more writing has been done. For ZRP/M (CP/M) disks only.

Retrieve command buffer.

Control-U retrieves the contents of the command buffer. This is useful for repeating a command.

RFORMAT ZRP/M (CP/M86) Diskettes.

RFORMAT formats, verif ies, and initializes the directory of a new ZRP/M (CP/M86 DSDD) disk in

one step. (Do not use this for DOS or SETDISK disks.)

RFORMAT '[enter] for a menu.

RFORMAT A:[enter] formats a new disk in A: RFORMAT B:[enterl formats a new disk in B:

RFORMAT d:V[enter] verifies the disk In d:

RPMPIP file copying utility.

RPMPIP is the ZRP/M version of PIP, the file copying utility. Also see RPMPIP options.

RPMPIP[enter] called without parameters, displays an asterisk * prompt and waits for parameters

to be typed, in "console mode". Press [enter] at the * prompt to exit RPMPIP. The general syntax

is.

ZRP/M Operating System

Users Guide

18

RPMPIP destination=source[enter].

The destination may be the disk drive d:, the display screen (CON:) or printer (PRN: or LST:).

The source may be the disk drive d: or the keyboard (CON:).

RPMPIP d:newfile.ext=d:oldfile.ext[enter]

Copies oldfile to new file with a new filename.

RPMPIP d:=a:oldfile.ext[enter]

Copies oldf He to another disk d: using the same f ilename.

RPMPIP b:=a:*.*[VO][enter]

Copies all files on the A: disk to the B: disk. If the [V] verify option is used, also Include the no

edit [01 option.

RPMPIP b:=a:*.*[C][enterl

Selective copy all. This copies all files, but with the [C] confirmation option, RPMPIP stops with

each filename and asks if you want to copy that file. Reply Y or N.

RPMPIP copyfile.ext::orgfile.ext[EI[enter]

Compares the original file with the copied file, and echoes (displays) any differences in hex and

ASCII. The two colons :: in the place of the equal sign = invoke comparison instead of copying.

RPMPIP bigfile.ext-smalll.ext,sma112.ext....

Concatinates (combines) several files into one file.

RPM PIP filename.ext=CON:[enter]

At the hypen prompt, type in text from the keyboard, which will be written to filename.ext on disk.

Useful for creating short text files, such as a batch command file.

RPMPIP detele.ext=report.prn[D35-45][enter]

Deletes columns 35 through 45 during the file copy.

RPMPIP echo.txt=report.prn[E][enter]

The [E] option echoes (displays) the file contents to the screen during the copy.

RPMPIP nofeeds.ext=report.prn[F][enter]

The [F] option deletes form-feeds during the copy.

RPMPIP ignore.ext=report.prn[IstringAZ][enter]

The [1] option ignores the specified string during the copy. End the string with a CTRL-Z.

RPM PIP Iinenum.ext=report.prn[L][enter]

Prefixes line numbers to each line of a text file during the copy. This is the default when PRN: is

the destination. Use LST: destination when no line numbers are desired.

ZRP/M Operating System

Users Guide

19

RPMPIP PRN:.report.pm[enter]

Sends the file to the printer. Each line will be preceded with a line number, tabs will be expanded

spaced 8, and a form-feed will be sent every 60 lines (unless specified different with the [Pnn]

option).

RPMPIP PRN:=report.pm[P60-3][enterJ

Print file option set to 60 lines per page, and start printing with page 3.

RPM PIP LST:-report.prn[NTP60][enter]

Sends the file to the printer exactly the same as RPMPIP PRN:=report.prn[enter]. Without the

options, LST: prints lines without line numbers, does not expand tabs, and does not issue

form-feeds unless they occur in the file itself. Choose options to format printout as desired.

RPMPIP part.ext=all.ext[Shere AZQthere AZ][enter]

The [S] option starts deleting text with the specified string. The [Q] option ends deleting text at the

specified string. Copies from the start of string 'here' to but not including string 'there'. End each

string with a CTRL-Z.

RPM PIP lower.ext=report.pm[L][enter]

The [L] option translates the text to lowercase during the copy.

RPMPIP upper.ext=report.pm[U][enter]

The [U] option translates the text to uppercase during the copy.

RPMPIP sevenbit.ext=eightbft.ext[Z]Ienter]

The [Z] option clears the parity bit (high order bit 7) during the copy. Limfts text to ASCII subset

(clear text).

RPMPIP chop.ext-report.prn[D40][enter]

Deletes column 40 through the end of each line (truncates each line) during the copy.

RPMPIP noedft.ext=verbatim.ext[O][enter]

The [0] option copies the file verbatim, with no editing. This is recommended in conjunction with

[V] verity during copy call, e.g. RPMPIP a:=b:*.*[VOI[enter]

RPMPIP verffy.ext=exact.extM[enter]

The [V] option reads back and verifies the data as it is copies. Using the no edit [0] option with

this [VO] is recommended.

RPMPIP option parameters.

See examples of use above.

[C] confirmation Y or N during copy all. Selection file copy option.

[Dn-m] delete columns n through m. If -m omitted, delete n thru end-of-line.

[E] echo (display) contents on screen.

ZRP/M Operating System

Users Guide

20

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

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

[F] filter out (delete) form-feeds.

[is] ignore (delete) string s through cr,ff

[L] translate text to lowercase

[N] precede text lines with line numbers. (Default when destination is PRN:)

[0] object code mode - no editing done

[pn-m] page size set to n lines. If -m included, start printing with page m (skipping pages until m).

[0s] quit deleting at string s.

[Ss] start deleting with string s.

[Tn] expand tabs spaced n

[U] translate text to uppercase (caps)

[VI verify disk copy (recommended combined use with [0])

[Z] clear parity bit (high order bit 7) of each character.

RPMSYS dX:option[enter]

where d are the DOS disk drives to be accessed by ZRP/M, X is optional and causes a return to

DOS at the first warmboot (Control-C or JMP 0), and option is the command or program to be

executed first (if omitted, DOSTIME is invoked to set the ZRP/M date and time from DOS). For

further details, see "Booting ZRP/M". To return to DOS from ZRP/M, GODOS[enter].

RSTAT X V:[enter] Help file, displays calling formats.

RSTAT[enter] Displays logged in disks and space.

RSTAT d:[enter] Displays space available on disk d:

RSTAT d:*.* D[enter] Displays alphabetical list of files, file sizes, attributes, with date and time

stamps.

RSTAT d:*.* U[enter] Displays users on d: and their disk space.

RSTAT d:filename.ext $R/O[enter] Set file to read only.

RSTAT d:f ilename.ext $R/Menter] Set file to read/write.

RSTAT d:filename.ext $SYS[enter] Set file to SYSTEM attribute.

RSTAT d:filename.ext $DIR[enter] Remove SYSTEM attribute.

RSTAT d:filename.ext $SFn[enter] Set file attribute Fn (1 -7).

RSTAT d:filename.ext $Cfn[enter] Clear file attribute Fn (1 -7).

RSTAT d:filename.ext $STn[enter] Set file attribute Tn (1 -3).

RSTAT d:filename.ext $CTn[enter] Clear file attribute Tn (1 -3).

RSTAT d: $R/O[enter] Write protect drive d:

RSTAT X S:[enter] Display disk size & characteristics.

RSTAT X T:[enter] Display IOBYTE.

RSTAT (LST,PUN,RDR,CON) T:n[enter] Set IOBYTE to n (0-3).

See appendix, file control block contents regarding attribute bytes.

RTERM[enter]

Displays a menu of terminal types for which emulation may be installed. Emulated terminal

functions are cursor positioning, clear/home, erase to end of line/screen, insert line, delete line,

reverse video, etc. Terminal Selections:

@ - ANSI terminal / DEC VT-1 00 ANSI

A - ADDS Viewpoint/Superbrain I/Intertec

B - Beehive 15x,l 6x / Cromemco 3100

C - DEC VT-52, VT-100

D - Hazeltine 1 (1400-1500) bias OOH

E - Hazeltine 2 (1400-1500) bias 60H

F - HDS Concept 100

G - Heath-Zenith 19,89,90 / Flashwriter

ZRP/M Operating System

Users Guide

21

H - Hewlett-Packard 2621

1 - IBM 3101 Terminal

J - Infotron 1-100 / Visual 200

K - Kaypro 1, 11, IV, 10, 84

L - Lear-Seigier ADM-3A, ADM-31

M - Microline ACT-IV

N - Northstar Advantage

0 - Osborne 1

P - Perkin-Elmer Bantam 550 / Fox 1100

0 - Processor Technology SOL

R - Soroc 10-120,140 / Zentec / Apple 11

S - Superbrain 2

T - Televideo 900 Series

U - Teleray 1061 / Wyse

V - TRS-80 11 Lif eboat, P&T CP/M

W - VS Mindless Terminal

X - Xerox 820

Y - Xitec SCT- 100

Z - Zenith 19, 89, 90

? - Display current emulated terminal.

0 - Shut off terminal emulation.

#nn - Set bottom (scroll) line.

[enter] or CTRL-C to exit RTERM.

RTERM t[enter]

directly installs emulation for terminal t specif ied from the above selection.

RTERM ?[enter] displays current emulation mode.

RTERM O[enter]

shuts off terminal emulation. CH[enter] to clear screen and home cursor.

SAVE n filename.ext[enter]

Saves n number of 256-byte pages to disk in filename.ext.

n may be decimal (as in a DIR display), or hexadecial in the format:

SAVE H:n dlilename.ext[enter]

Save is useful in conjunction with Loadonly to copy files on a single disk drive system (press

ENTER in response to the "Swap OK?" message.)

SAVE H:adrs *[enter]

Temporarily re-defines the start of the TPA (Transient Program Area) to the hexadecimal

address location given. This permits starting saves from anywhere in the TPA. (Temporary until

the next SAVE or program load operation).

ZRP/M Operating System

Users Guide

22

SETDISK

One floppy drive may be set to process a CP/M format via the resident system extension (RSX)

SETDISK. To avoid a disk error situation, it is important to mount the CP/M disk in the SETDISK drive

before Invoking SETDISK (on a single diskette drive system, copy programs to the M: disk and Invoke

SETDISK from there). SETDISK is limited to a single drive, and is provided for media conversion rather

than running programs, inasmuch as some CP/M disk formats are accessed inefficiently via the IBM PC,

and no formatting capability is provided (except for ZRP/M format, which is CP/M86). SETDISK is a

resident system extension (memory resident, taking up room in the user's Transient Program Area,

reducing the memory available to your CP/M program). Although programs may run directly from the

SETDISK drive, this is not recommended. Use SETDISK to configure one drive to the format of the CP/M

disk, then use RPMPIP to copy the files to either a DOS or ZRP/M (CP/M86) diskette. Many programs will

run from DOS disks. Others require the structure of a CP/M disk, so should be copied to a ZRP/M

(CP/M86) diskette (use FIFORMAT first to create a blank ZRP/M (CP/M86) diskette). Following are the

SETDISK commands/features:

SETDISK *[enter]

displays a list of CP/M disk format selections in alphabetic order, as listed below.

SETDISK *.N[enter]

displays a list of CP/M disk format selections in numeric order.

SETDISK d:nnn[enter]

sets the d: floppy disk drive to the CP/M disk format selection nnn.

It is important to mount the CP/M disk before SETDISK is entered.

DRESET[enter] immediately after changing configuration with SETDISK (Or use the batch

procedure, DO SETDISK d:nnn c[enter], which includes the DRESET. c is the current disk.)

The CP/M disk selections nnn are:

nnn

15 Access SSDD

17 Actrix SSDD

43 Actrix DSDD

106 Ampro CP/M DSDD

33 Avatar TC1 0 DSDD

65 Bondwell 12 SSDD

66 Bondwell 14 DSDD

67 BMC if800 m20 DSDD

68 CAL-PC DSDD

49 Cassio FP1000 DSDD

50 Chameleon CP/M DSDD

51 Columbia MPC CP/M DSDD

69 Columbia Commander 964 DSDD

70 Compugraphic SSDD

12 Cromemco CDOS SSDD

71 Cromemco CDOS DSDD

13 Cromemco w/Intl Term SSDD

52 Cromerrico w/Intl Term DSDD

72 Cykey DSDD

73 Datavue DV80 DSDD

53 Davidge CP/M DSDD

ZRP/M Operating System

Users Guide

23

14 DEC VT180 SSDD

54 Digilog CP/M DSDD

74 Direct 1025 DSDD

55 Epson Multifond DSDD

56 Epson OX-10 DSDD

75 Epson OX-10 DSDD

76 Epson QX-10 European DSDD

57 Fujitsu Micro 16a DSDD

58 Groupil III CP/M DSDD

28 Heath w/Magnolia CP/M SSDD

79 Heath w/Magnolia CP/M SSDD

80 Heath w/Magnolia CP/M DSDD

8 Heath Z90 I K Blk SSDD

27 Heath Z90 2K Blk SSDD

26 Heath Z100 CP/M SSDD

59 Heath Z1 00 CP/M DSDD

78 Hewlett-Packard HP-125 DSDD

I IBM PC CP/M86 SSDD

48 IBM PC CP/M86 DSDD (ZRP/M default)

29 Idea Bitelex SSDD

81 IMS 5000 SSDD

30 Insight Dev 10-120 SSDD

34 ISM CP/M DSDD

6 Kaypro 11 SSDD

105 Kaypro 2X DSDD

103 Kaypro IV DSDD

35 Kaypro 4 Media Master DSDD

104 Kaypro 10 DSDD

31 LNW-80 CP/M SSDD

16 Lobo Max80 SSDD

83 Magic Computer DSDD

36 Micral 9050 DSDD

98 Micromint SB180 DSDD

85 Molecular Series 9 DSDD

5 Morrow MD2 SSDD

38 Morrow MD3 DSDD

37 Morrow MD1 1 DSDD

39 NCR Decision Mate DSDD

7 NEC PC-8001 SSDD

40 NEC PC-8001A DSDD

86 OKI WO Mod 20 DSDD

87 Olivetti DSDD

88 Olivetti Mercator 3500 DSDD

18 Olympia ETX 11 SSDD

41 Olympia EX100 DSDD

89 Osborne 1 SSDD

42 Osborne 4 DSDD

90 Osborne Executive SSDD

43 Otrona CP/M DSDD

91 Otrona Attache DSDD

44 PMC Micromate DSDD

19 Reynolds & Reynolds SSDD

45 Sanyo CP/M DSDD

ZRP/M Operating System

Users Guide

24

92 Seequa Cameleon CP/M DSDD

93 STI) 700e CP/M DSDD

10 Superbrain Jr. SSDD

95 Superbrain Jr. SSDD

96 Superbrain 40 track SSDD

46 Superbrain DSDD

20 Systel 11 CP/M SSDD

47 Systel 111200/300 DSDD

94 Tektronix 4170 DSDD

25 Teletek 40 Track SSDD

77 Televideo 802/803 DSDD

62 Televideo TurboDos DSDD

9 TI Professional CP/M86 SSDD

60 TI Professional CP/M86 DSDD

61 ToshibaT100DSDD

21 TRS-80 FEC CP/M SSDD

22 TRS-80 FEC T805 SSDD

23 TRS-80 III w/Hurr. Labs SSDD

4 TRS-80 III w/Memory Merchant SSDD

97 TRS-80 Mod. 3 Mern Merch CP/M SSDD

24 TRS-80 IV Mont. Micro SSDD

99 TRS-80 Mod. 4 MT CP/M SSDD

100 TRS-80 Mod. 4 CP/M SSDD

63 Wang MAWS CP/M DSDD

3 Xerox 11820 SSDD

8 Zenith Z90 1 K Blk SSDD

27 Zenith Z90 2K Blk SSDD

26 Zenith Z1 00 CP/M SSDD

59 Zenith Z1 00 CP/M DSDD

64 Zorba DSDD

DRESET[enter] immediately after invoking SETDISK, or use the batch procedure which includes

the DRESET:

DO SETDISK d:nnn clenter]

d: is the diskette drive, nnn the format number, c the current drive desired.

SETDISK[enter] removes the SETDISK rsx.

SETPFK - To install a program function key (.PFK) file, first copy it to the M: disk and then invoke ft with

SETPFK:

RPMPIP M:=diilename.pfk[enter]

SETPFK filename[enter]

SETPFK responds with: Requested PFK File Installed.

To remove a program function key (.PFK) file:

SETPFK[enter]

ZRP/M Operating System

Users Guide

25

SETPFK responds with: PFK File Removed.

Shift-PrtSc

Prints the current contents of the display screen.

Start/Stop Display.

Control-S stops/starts displaying output on the screen.

STAT

see RSTAT

Subdirectory change (DOS disks) from ZRP/M. CD \path[enter] There must be a space between CD

and V Changes the current directory of a DOS disk.

Subdirectory change (CP/M disk user area).

USER n[enter]

See the USER command. Disk user areas are CP/M equivalent of DOS subdirectories.

SUBMIT

The standard CP/M batch submission process which is supported by ZRP/M (but not part of

ZRP/M; you supply SUBMIT). ZRP/M has an enhanced batch processes (see SUBREN, CALL

and DO). SUBREN is the ZRP/M version of the SUBMIT batch process.

SUBREN d:xname argl,arg2 argn[enter]

d: = disk drive letter

xname = name of SUB batch command file

args = correspond to $1, $2, etc. in the xname.SUB file.

The first character of the xname.SUB file is used by SUBREN to name to executable batch file

xx$.SUB, which may then be invoked by CALL (see CALL).

Terminal Emulation.

See the RTERM utility, which configures emulation of various CP/M terminal types.

TYPE dlilename.ext[enter]

Displays the contents of filename.ext on the screen, paged if paging is enabled (see PAGE).

Press CTRL-S to stop/start display. If paged, any key pressed except CTRL-C or CTRL-P will

display the next page. Two quick ENTERs will end the display. CTRL-P will toggle the list flag to

print what is displayed. CTRL-C will warmboot.

Type ahead feature.

ZRP/M will process multiple built-in commands on a line, each separated by a space. The last

command on the line may call a program or utility.

ZRP/M Operating System

Users Guide

26

USER n[enter]

(CP/M disks only)

A disk user area is the CP/M equivalent to a DOS subdirectory. User number n is decimal from 0

to 15. The default user number is zero. Under ZRP/M, all users have access to user 0 files.

Numbered users have access to only their own user area, plus user 0 files. When the user

number is non-zero, it is displayed in the system prompt. For example, user 15 will display 15A>

when the current disk is A.

Warmbooting

A CTRL-C pressed on the keyboard, or a JMP 0 in a program causes an ZRP/M warmboot.

Warmboot reloads RCP, displays the current DOSDISK or SETDISK status if either interface is

present, and the system prompt d>, d being the current disk letter.

XDUM P dlilename.ext[enter]

Displays or prints hex and ASCII dump of the specified disk file. If displayed, press CTRL-Sto

stop/restart the displaying.

Z280-Z80-8080 EMULATOR

A Z280 16-bit CPU emulator, which includes the 8-bit Z80 and 8080 instruction sub-sets, is

loaded and used by ZRP/M (the ZMA, ZMB and ZM1 messages during startup). Refer to the Zilog

Z280 Technical Manual for details of the Z280 instruction set. The Z80 and 8080 instruction sets

are widely documented.

ZRP/M Operating System

Users Guide

27

Appendix

EXAMPLE CP/M PROGRAM PATCHES

Some CP/M programs may require modification before they will

run (CP/M program patching is responsibility of purchaser). These are

examples of programs which need modification. Use CP/M DDT or DOS DEBUG

to install modifications.

Perfect Filer

The Kaypro II version of Perfect Filer

patches

clobbers four bytes in the operating system.

To remedy this problem, modify as follows:

FILER.COM

100H JMP 3303H change to JMP 3313H

CREATE.COM

100H JMP 7883H change to JMP 7893H

XSUB patch

The CP/M XSUB.COM needs to be patched as

follows:

XSUB.COM

0216H OOH

0217H OOH

0218H OOH

0316H OOH

0317H 24H

0318H 3FH

0319H 14H

The patched version of XSUB is

always disabled at warmboot, and therefore

must be called anew immediately preceding any

program, the console input requests of which

are to be filled from the text supplied by the

procedure file.

ZRP/M Operating System

Users Guide

28

MODEMPC

CABLE

(Kaypro Example)

MODEMPC is a Christensen protocol file transfer utility interfaced to the ABM PC serial-port COM1. The

COM1 port can be connected to a modem . for telephone line transfers, or connected directly to the serial - port-

of - another . computer.. The schematic diagram for a cable that*can be used-to connect the IBM PC , to a

KAYPRO .11, for example,- i-s shown below.

ZRP/M Operating System

Users Guide

29

FUNCTION KEYS AND PHRASE STORAGE / RETRIEVAL

The use of program function keys and special keys for commands and phrases is implemented by two

utilities: NEWPFK creates or modifies phrase (.PFK) files, and SETPFK installs a selected phrase file. Each

PFK file contains 128 commands or phrase records of up to 127 characters each, and records are chainable

for lengths over 127 characters.

Commands and phrases are stored and retrieved by function /special keys, or by Alt`128 through Alt255.

Sample PFK files are included on the release disk. EXAMPLE.PFK contains the RP/M built-in commands and

programs, callable by a function key. PHRASES.PFK includes a multi-fine name and address phrase record,

and an example of chaining phrase records. WS.PFK is an example phrase file for WORDSTAR with function

keys and keypad keys as used by the DOS version. Use NEWPFK to modify these sample files, or create new

phrase files customized for your own requirements. They will save much typing.

NEWPFK filename[enter] to create or modify the filename.PFK phrase file.

NEWPFK filename *[enter] to display the filename.PFK contents.

When entering new phrases, use the tilde character (1v) to specify the Control key, to store control-key

bytes in the record, e.g., 'YA = Control-A. Use 'J for line-feed, and 'M for carriage- return.

To continue a phrase on another record, end the continued phrase with a character preceding an Alt nnn

corresponding to the continuation record.

To end the new phrase, press Control-@ (a null character) , after which you may type in a comment or

description of what the phrase is for (recommended) .

Installing a PFK file is a two-step process. The commands or phrases are invoked from the M: (RAM)

disk, so the PFK file(s) must be first copied to the M: disk with RPMPIP, then the desired file selected by

SETPFK:

RPMPIP M:=d:*.PFK [enter]

copies the PFK files to M:

SETPFK filename[enterl

installs the selected PFK file

M) 14: NEWPFK YOUMN

Press Function Key or Alt 128-255 (Ctrl-C to Exit):

[F1] pressed

1

Write New Record? (Y/N): Y

Enter new text ('M--cr, 'J=lf, continuation IIAIU28, comments after A@):

DIR~M^@

[F1] DIR[enter] Display Directory of Current Disk.

M> SETPFK YOUROWN

Requested PFK File Installed.

[F1] pressed for DIR

M)DIR

M: RPMPIP COM 27 : EXAMPLE PFK + 1

NEWPFK

COM 9 : WS PFK + 1

M: PHROES PFK + 1 : YOUROWN PFK + 1

SETPFK

C014 2

M)

N)M:SETPFK

PFK File Removed.

ZRP/M Operating System

Users Guide

30

To install this example for lising function keys:

RPMPIP M:=A: EXAMPLE. PFK [enter]

SETPFK EXAMPLE[enterl

M>M::NEWPFK EXAMPLE *

EXAMPLE PFK

ASCIIII~M

[FI] Example Function Key Assignments, Alphabetic Order

CALL

[F2] CALL B]enter] invokes commands in file BB

CATALOG

[F3] CATALOG d:filename.ext c: creates CATALOG.TMP file.

CD

[F4] CD pathstring[enter] changes DOS current disk.

CH~M

[F5] CH[enter] clears screen, homes cursor (resets display).

CONSOLEX COM

[F6] CONSOLEX COMx.yz baud.p[enter]

COLOR~M

[F7] COLOR[enter] for color display selection menu.

COLOR

[F8] COLOR *[enter] default or COLOR b:BC.TC[enter], etc.

DIR~M

[F9] DIR[enterl display directory on current disk.

DIR

[F10] DIR d:filename.ext[enter] specific directory display.

DOSDISK

Shift [F1] DOSDISK ddd[enter] to set, DOSDISK[enter] to remove.

DOSTERM

Shift [F2] DOSTERM ddd[enter] to set, DOSTERM[enter] to remove.

DOSTIME"M

Shift [F3] DOSTIME[enterl sets date & time from DOS.

DTIME

Shift [F4] DTIME Q[enter] to set, DTIME[enterl to display.

ERA

Shift [F5] ERA Wilename.ext[enter], ERA d:*.* d:*.* for all.

FLAML

Shift [F6] FLAWTBL d:[enter] tests disk, reserves bad blocks.

GODOrM

Shift [F7] GODOS[enter] terminates RP/M & returns to DOS.

INITDIR

Shift [F8] INITDIR d:[enter] inits directory for date/time stamps.

KEYBD

Shift [F9] KEYBD[enter] for menu, KEYBD klenterl for selection.

LOCKOUT

Shift [F10] LOCKOUT d:[enter] enters bad block in flaw table.

MEMMAP'M

Ctrl [FI] MEMMAP[enterl displays memory map of PC RP/M2.

MODEMPC

Ctrl [F2] MODEMPC Wilename.ext x:nnnn.pc[enterl file transfer.

NEWPFK

Ctrl [F3] NEWPFK filename[enterl creates/modifies PFK file.

OUT

Ctrl [F4] OUT ASCII[enterl for 7 bits, or OUT IBM[enterl 8 bits.

PAGE

Ctrl [F5] PAGE nnIenterl pages TYPE nn lines; PAGE 01enterl off.

PCPIP

Ctrl [F6] PCPIP d:newfile.ext=d.oldfile.ext[enterl, etc.

RDISK

Ctrl [F7] RDISK[enterl for menu to format disks.

REN

Ctrl [F8] REN newname=oldnamelenterl

RPMPIP

Ctrl [F9] RPMPIP d:newfile.ext=d:oldfile.ext[eriterl, etc.

RSTAT

Ctrl [F10] RSTAT Wilename.ext DEenterl, etc.

RTERM

Alt [FI] RTERM[enterl for menu, RTERM t1enterl emulation on/off.

SAVE

Alt [F2] SAVE n d:filename.ext[enterl, etc.

SETDISK

Alt [F3] SETDISK *[enter] for menu, SETDISK d:nn[enterl installs.

SETPFK

Alt [F4] SETPFK filerkimlenterl installs PFK file from M: disk.

SUBREN

Alt [F5] SUBREN d:xfile argl,arg2 argn (see SUBREN.DOC).

TYPE

Alt [F6] TYPE d:filename.ext[enterl displays an ASCII file,

USER

Alt [F7] USER n1enterl selects user area 0-15 (0 common access).

XDUMP

Alt [F8] XDUMP d:filename.ext[enterl display/print file contents.

RENAME

Alt [F9] RENAME d:oldname newname[enter]

RFORMAT

Alt [F10] RFORMAT *Eenterl for menu to format RP/M disks.

Press Function Key or Alt 128-255 (Ctrl-C to Exit):

SETPFK[enter] to remove use of phrase file.

ZRP/M Operating System

Users Guide

31

EXAMPLE OF INSTALLING FUNCTION/CURSOR POSITION KEYS

A)newpfk ws

WS

PFK

EXAMPLE FUNCTION KEY ASSIGNMENTS FOR WORDSTAR IN WS.PFK FILE

Alt176

To modify WS.PFK for your own needs, NEWPFK WS[enterl

Alt177

To install, RPMPIP M:=d:WS.PFK[enter], then SETPFK WS[enter]

Alt178

================================================================== Alt179

WS.PFK FILE - EXAMPLE WORDSTAR FUNCTION KEY STRINGS

Alt180

These follow the IBM PC DOS version of Wordstar key assignments.

Alt181

--------------------------------------------------------------------------------------------------------------------- Alt182

~JH

[F1] ^JH = Wordstar set help level.

~OG

[F2] ^OG = Indent paragraph to tab.

~QL~[

[F3] ^OL Esc = Set left margin at cursor position.

~OR~[

[E4 )^OR Esc = Set right margin at cursor position.

~PS

[F5] ^PS = Underline.

~PB

[F6] ^PB = Boldface.

~KB

[F7] ^KB = Mark beginning of block.

~KK

[F8] ^KK = Mark end of block.

~QR

[F9] ^QR = Move cursor to beginning of file.

~QC

[F10] ^QC = Move cursor to end of file.

~QE~QS Home ^QE^QS = Move cursor to top left of screen.

~E

Up Arrow ^E = Move cursor up.

~R

PgUp ^R = Display previous screen (scroll down).

~S

Left Arrow ^S = Move cursor left.

~D

Right Arrow ^D = Move cursor right.

~Qx

End ^QX = Move cursor to bottom of screen.

~X

Down Arrow ^X = Move cursor down.

~C

PgDn ^C Display next screen (scroll up).

~V

Ins ^V Insert.

***********************Alt255

Press Function Key or Alt 128-255 (Ctrl-C to Exit):

A) WS.PFK is an example on the release disk.

Use NEWPFK filename[enter] to set up your own cursor positioning key assignments, which vary from program to

program, and terminal to terminal.

ZRP/M Operating System

Users Guide

32

IBM Numeric Keypad

The operation of the numeric keypad (at the right end of the key

board) is controlled by the Num Lock toggle. To enter numbers, press

the Num Lock key. To use the edit functions, press the Num Loc key

again.

Edit functions on numeric keypad will not operate with "Ctrl" key depressed.

Adapted from WordStarfor the IBM PC, 0 1992 MicroPro International Corporation. Reprinted by permission.

ZRP/M Operating System

Users Guide

33

Appendix : Functions (RDOS)

RP/M2 RDOS FUNCTIONS

FNC HEX Function name

INPUTS

OUTPUTS

0 00 System reset

none

none

1 01 Console input

none

A=char

2 02 Console output

E=char

none

3 03 Reader input

none

A=char

4 04 Punch output

E=char

none

5 05 List output

E=char

none

6 06 Direct console 1/0

see def

see def

7 07 Get iobyte

none

A=(0003)

8 08 Set iobyte

E=iobyte

none

9 09 Console buffer out

DE=.buffer see def

10 OA Console buffer in

DE=.buffer string

11 OB Get console input status none

A=status

12 OC Get CP/M version number

none

HL=0022H

13 OD Reset disk system

none

A=drive code

14 OE Select disk

E=disk

see def

15 OF Open file

DE=.fcb

A=dir code

16 10 Close file

DE=.fcb

A=dir code

17 11 Search for first occurence

DE=.fcbA=dir code

18 12 Search for next occurence

none A=dir code

19 13 Delete file

DE=.fcb

A=dir code

20 14 Read sequential record

DE=.fcb

A=err code

21 15 Write sequential record

DE=.fcb

A=err code

22 16 Create new file

DE=.fcb

A=dir code

23 17 Rename file

DE=.fcb

A=dir code

24 18 Return-login vector

none

HL=login vector

25 19 Return current disk

none

A=disk number

26 1A Set DMA address

DE=dma

HL=previous dma

27 1B Get RBR address

none

HL=.RBR

28 1C Write protect disk

none

see def

29 1D Get read-only vector

none

HL=R/O vector

30 1E Set file attributes

DE=.fcb

see def

31 1F Get DPB address

none

HL=.DPB

32 20 Set or get user number

see def

see def

33 21 Read random record

DE=.fcb

A=err code

34 22 Write random record

DE=.fcb

A=err code

35 23 Compute file size

DE=.fcb

r2,rl,rO=size

36 24 Set random record

DE=.fcb

r2,rl,rO=rec adr

37 25 Log out selected drives. DE=drv vector see def

38 26 Set display page size

E=lines/page

none

39 27 No operation

40 28 Write random with zero fill DE=fcb

A=err code

see def = see full definition

ZRP/M Operating System

Users Guide

34

Appendix : File Control Block

File control block (fcb) format.

0 1 2 3 4 5-6 7 8 9 A B C D E F

FNT 00

dr fl f2 f3 f4 f5 f6 f7 f8 tl t2 t3 ex sl s2 rc

RBT 10

bO bl b2 b3 b4 b5 b6 b7 b8 b9 bA bB bC bD bE bF

20

cr r0 rl r2

dr fcb drive code

00 no selection, current drive

01 drive A

02 drive B, etc.

dr dir

E5 erased entry

00 = file assigned to user 0

On = file assigned to user n

21 = date-and time stamp

fI-f8 file name

fx' high order bit of each byte is a file "attribute"

fi'48'

(spare)

tl-t3 file type

W set = file R/O

t2' set = system file

t3' set = file has been archived

ex low eight bits of the logical extent

sl (spare~

s2 high seven bits of the logical extent

rc record-count, of current logical extent;

takes on values 00 through 80 hex

bO~bF 16 RBT bytes, or 8 RBT words

cr current record, sometimes called "next" record

,indicates next record to be accessed in the

,~current logical extent

rO-r2

record ordinal for random access ordered r2,r1,rO msb to lsb

Disk directory entry and file control block structures.

ZRP/M Operating System

Users Guide

35

Appendix

10BYTE

IOBYTE Character 1/0 Redirection

IGBYTE is located at 0003H in the RP/M Segment, and has the following

format: LST 1 PUN 1 RDR 1 CON 1 Q bits each)

PC RP/W CBIOS will redirect the five character 1/0 functions Console In, Console Out, Reader In, Punch

Out and Printer But. Each of these five functions has its own 4-byte redirection table corresponding

to the 2 bit IOBYTE setting (index or ordinal into the 4-byte redirection table). The 4-byte

redirection tables may be set up with any of the following ordinals for character 1/0 redirection, but

the direction of 1/0 should normally match the function such that an output character goes to an

output device and input should come from an inout device.

The redirection ordinals that may be.selected are;

CRTIO EQU OOH ;Console CRT Disolay character OUT.

KEYII EQU 01H ;Keyboard character IN.

LPTIO EQU 02H ;Parallel Port I character OUT.W

LPT20 EQU 03H ;Parallel Port 2 character OUT.

LPT30 EGU 04H ;Parallel Port 3 character OUT.

COMII EQU 05H ;Serial Comm Port I character IN.

COMIG EQU 06H ;Serial Cow Port I character OUT.

COM21 EQU 07H ;Serial Comm Port 2 character IN.

COWO EQU 08H ;Serial Con Port 2 character BUT.

COMIS EGU 09H ;Serial Comm Port I Setup byte OUT.

COVS EDU OAH ;Serial Comm Port 2 Setuo byte OUT.

COMIT EDU OBH ;Serial Comm Port I Test Status.(2)

COVOT EQU OCH ISerial Comm Port 2 Test Status.

NULOP EGU OFH -No Operation

(1) Parallel Port status byte is in PSTAT, 010CH in Common.

(2) Comm Serial Port Status word is in COMSTS, 006AH in Common.

IOBYTE is initialized to zero by PC RPIW.2 CBIOS80 cold boot, which

matches the following default character 1/0 redirection tables.

The contents of IOBYTE and the ordinals in these default tables

may be changed to accomodate an existing software character 1/0

redirection requirement, but with caution as your access to

the operating system via keyboard/dis.play is dependent upon

legitimate IOBYTE and redirection table ordinal contents.

The RSTAT command provides a standard way of,changing the contents of

IGBYTE to redirect character input/output. The number following

the T: is set into the soecified LST, PUN, RDR or

ZRP/M Operating System

Users Guide

36

CON bits.

For example, the command RSTAT LST T:I will redirect printer

characters out to parallel port 2. RSTAT LST T:O will

restore output to parallel Port I (assuming the default

redirection table contents as follows).

CONUE IN Redirection Table (Default) - RDOS function I (A regis. IN)

IOBYTE = :LST!PUN:RDR:CON:

COW

EQU 006CH

.1 00: ;Byte 01H KEYII, keyboard char IN.

EQU 006DH

1 01: ;Byte 01H KEYII, keyboard char IN.

EDU 006EH

1 10! Byte 01H KEYII, keyboard char IN.

EOU 006FH I III ;Byte 01H KEYII, keyboard char IN.

CONSOLE OUT Redirection Table (Default) - RDOS function 2 (E recis. OUT)

IOBYTE = !LST:PUN:RDR:CON:

CONO EQU 0070H 1 001;Byte OOH CRTIO, display char OUT.

EQU 0071H 1 011 ;Byte OOH CRTIO, display char OUT.

EQU 0072H 1 101 ;Byte OOH CRTIO, display char OUT.

EQU 0073H 1 111 ;Byte OOH CRTIO, display char OUT.

READER IN Redirection Table (Default) - RDOS function 3 (A regis. IN)

IODYTE = :LSTIPUN!RDRICON:

RDRI EQU 0074H 1 0011 Byte OBH COMIT, serial port I Status.

EOU 0075H 1 01: Byte OCH COMZIT, serial port 2 Status.

EOU 0076H 1 101 Byte 05H COMII, serial port I IN.

EQU 0077H 11: Byte 07H COM2I, serial port 2 IN.

PUNCH OUT Redirection Table (Default) - RDOS function 4 (E regis. OUT)

IOBYTE = 1LSTIPUNIRDR:CONI

PUND EQU 0078H 1' 001' Byte 09H COMIS, serial port 1 SETUP.

EW 0079H 1 011 Byte OAH COK29, serial port 2 SETUP.

EQU 007AH 1 101 Byte 06H COMM, serial port I OUT.

EOU 007BH 1 11: Byte 08H COMM, serial port 2 OUT.

LIST OUT Redirection Table (Default)

- RDOS function 5 (E regis. OUT)

IOBYTE = !LSTIPUNIRDR:CONI

LSTO EQU 007CH 1 0011 Byte 02H LPTIO, parallel Dort I OUT.

EgU 007DH 1 011 Byte 03H LPT20, parallel port 2 OUT.

EgU 007EH 1 101 Byte 04H LPT30, parallel port 3 OUT.

EQU 007FH III Byte OOH CRTIO, display char OUT.

ZRP/M Operating System

Users Guide

37

ZRP/M Operating System

Users Guide

38

ZRP/M Operating System

Users Guide

39

PC RP/M2 Assembler

The RP/M2 assembler reads source code from disk and produces 8080 machine code in Intel hex

format. The assembler is called by a console command of the form

RASM m:filename.xyz 1:

where x = source drive, y = hex output drive, z = list output drive, and 1 = source drive for library files

accessed by the RDLIB pseudo-op. The assembler will read filename.ASM from the disk in drive x, write the

object code in Intel hex format to the file filename.HEX on the disk in drive y, and put the list file filename.PRN

on the disk in drive z. Files named in RDLIB pseudo ops will be read from the disk in drive 1. Drive m when

stated, will provide temporary space for creation of a cross reference map.

The listing can be directed to the console by a command of the f orm

RASM filename.ABX

This command directs the assembler to read source code from drive A, put the hex file on drive B, and send the

list file to the console. RDLIB directives will be filled from the current disk. List and hex files can be suppressed.

The command

RASM filenane.BZZ

reads source from drive B, and skips generation of hex arid list files.

The source program format is compatible with the Digital Research CP/M 2.2 assembler ASM. There

are certain extensions which make RASM somewhat more useful. Only these extensions are documented here,

since it is assumed that the user is familiar with ASM.

RDLIB library include directive

The RDLIB pseudo-op can be used to access source code library files, may only appear in the original

source file, and takes the form

RDLIB

‘filename.typl "

The argument is a string expression stating both the file primary narne and the file extension. The filename and

extension should be stated in upper case. For example,

RDLIB

'AWT.LIBI

RDLIB

IDIV.MTHI

will cause the assembler to read source code from the files AWT.LIB and DIV.MTH on the disk specified in the

calling command, or from the current disk if no such specification was made.

ZRP/M Operating System

Users Guide

40

r%Pjj=1j%A1.%

Character Set

==========================================

ZRP /M ASCII & EXTENDED CODES TABLE

==========================================

Use ASCII program to display hex key codes

(1A)

[ 5B

{ 7B

ESC

1B -

from your particular computer hardware, as

(2B)

\ 5C

| 7C

FS

1C -

there may possibly be some variations.

(1B)

] 5D

} 7D

GS

1D -

==========================================

(29)

‘ 60

~ 7E

(OE)

08

<-- Backspace

Hexadecimal values via ZRP/M console in.

(OF) 09

Tab

Standard ASCII codes are 00-7F.

(1C) OD <–‘ Enter/CR

Extended codes are 80-FF.

(1D)

Ctrl

(tNN) indicates keyboard code translated.

(2A)

Left Shift

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

(36)

Right Shift

(Scan) KEY

+SHIFT +CONTROL +ALT

(37) * 2A PrtSc -

10 (Tf2

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

(38) Alt

( 1) Esc 1B

1B

1B

1B

(39) space2O space2O space2O space20

(28) ‘ 27

“ 22

-

-

(3A)

Cap Lock

(33) , 2C

< 3C

-

-

(3B) Fl BB

F1 D4 FI DE F1 ED

(OC) - 2D

_ 5F US 1F

82

(3C) F2 BC F2 D5

F2 DF F2 E9

(34) . 2E

> 3E

-

-

(3D) F3 BD

F3 D6 F3 EO F3 EA

(35) / 2F

? 3F

-

-

(3E) F4 BE

F4 D7 F4 El F4 ED

(OB) 0 30

) 29

-

81

(3F) F5 BF

F5 D8 F5 E2 F5 EC

(02) 1 31

! 21

-

F8

(40) F6 CO

F6 D9 F6 E3 F5 ED

(03) 2 32

@ 40

NUL 00(T83)F9

(41) F7 CI

F7 DA F7 E4 F7 EE

(04) 3 33

# 23

-

FA

(42) FB C2

F8 DB F8 E5 F8 EF

(05) 4 34

$ 24

-

FB

(43) F9 C3

F9 DC F9 E6 F9 FO

(06) 5 35

% 25

-

FC

(44) F1O C4 F1O DD F10 E7 F1O F1

(07) 6 36

^ 5E

RS 1E

FD

(45)

Numeric Lock

(08) 7 37

& 26

-

FE

(46)

Scroll Lock

(09) 8 38

* 2A

-

FF

(47)

C7 - Home

F7

(OA) 9 39

( 28

-

80

(48)

C8 = up

(27) ; 3B

; 3A

-

-

(49)

C9 = Pq Up

84

(OD) = 3D

+ 2B

-

83

(4A)

- 2D

(IE) A 41

a 61 SOH 01

9E

(4B)

CD = Left

F3

(30) B 42

b 62 STX 02

BO

(4C)

5 35 w/Num Lock

(2E) C 43

c 63 ^Brk/ETX03 AE

(4D)

CD = Right

F4

(20) D 44

d 64

EOT 01

AO

(4E)

+ 2B

(12) E 45

e 65

ENO 05

92

(4F)

CF = End

F5

(21) F 46

f 66

ACK 06

Al

(50)

DO = Down

(22) G 47

g 67

BELL 07

A2

(51)

D1 = Pg Dn

F6

(23) H 48

h 68

<–BS 08

A3

(17) 1 49

i 69 -> HT 09

97

(52)

D2 = Insert

(24) J 4A

j 6A

LF 0A

A4

(52)0 30 w/Num Lock

(25) K 4B

k 6B

VT OB

A5

(26) L 4C

l 6C

FF 0C

A6

(53)

7F = Delete(tD3)

(32) M 4D

m 6D <–‘CR OD

B2

(53) 2E w/Num Lock

(31) N 4E

n 6E SO 0E

B1

(18) 0 4F

o 6F

SI OF

98

(19) P 50

p 70 ^Psc/DLEIO 99

MicroMethods, Inc.

(10) Q 51

q 71

DCI

11

90

118 S.W. First Street

(13) R 52

r 72

DC:2

12

93

P. 0. Box 909

(IF) S 53

s 73

DC3

13

9F

Warrenton, Oregon 97146

(14) T 54

t 74

DC4

14

94

(16) U 55

u 75

NAK

15

96

--

(2F) V 56

v 76

SYN

16

AF

(503) 861-1765

(11) W 57

w 77

ETB

17

91

(2D) X 58

x 78

CAN

10

AD

Copyright 1985 by MicroMethods, Inc.

(15) Y 59

y 79

EM

19

95

(2C) Z 5A

z 7A

SUB

1A

AC

ZRP/M Operating System

Users Guide

41

* RP/M is a genuine OPERATING SYSTEM, fully CP/M 2.2 compatible. .

* Better than CP/M 2.2 - RP/M has file date & time stamping, paged TYPE, common access to user

O files, auto disk relog, enhanced batch systems, etc.

* RP/M operating system -

Loads and runs with DOS.

* Runs most CP/M 80 programs.

* Access to all DOS disks (the hard disk, floppy disks, any disk that access is provided via DOS).

* Read/writes over 90 CP/M disk formats, for media conversion.

* Fast RAM disk (“M: drive") with floppy disk capacity on a 640K IBM PC.

* MODEMPC file transfer utility, with source for Kaypro companion.

* Function Keys for commands and phrases - saves typing.

* Color display menu selected: border, background and text.

* Display emulation of many CP/M computers and terminals.

* Keyboard selections: American, British, French, German, Italian, Spanish and Dvorak.

* IOBYTE supported for character I/0 redirection.

ZRP/M Operating System

Users Guide

42

CP/M Disk Selections

Access SSDD

Micromint SB1 80 DSDD

Actrix SSDD

Molecular Series 9 DSDD

Actrix DSDD

Morrow MD2 SSDD

Ampro CP/M DSDD

Morrow MD3 DSDD

Avatar TC1 0 DSDD

Morrow MD1 1 DSDD

Bondwell 12 SSDD

NCR Decision Mate DSDD

Bondwell 14 DSDD

NEC PO-8001 SSDD

BMC lf800 m20 DSDD

NEC PG-8001 A DSDD

CAL-PC DSDD

OKI 11`800 Mod 20 DSDD

Cassio FP1000 DSDD

Olivetti DSDD

Chameleon CP/M DSDD

Olivetti Mercator 3500 DSDD

Columbia MPC CP/M DSDD

Olympia ETX 11 SSDD

Columbia Commander 964 DSDD

Olympia EXI 00 DSDD

Compugraphic SSDD

Osborne I SSDD

Cromemoo CDOS SSDD

Osborne 4 DSDD

Cromemco CDOS DSDD

Osborne Executive SSDD

Cromemoo wAntl Term SSDD

Otrona CP/M DSDD

Cromemco wAntl Term DSDD

Otrona Attache DSDD

Cykey DSDD

PMC Micromate DSDD

Datavue DV80 DSDD

Reynolds & Reynolds SSDD

Davidge CP/M DSDD

Sanyo OP/M DSDD

DEC VT1 80 SSDD

Sesqua Cameloon CP/M DSDD

Digilog CP/M DSDD

STD 700e CP/M DSDD

Direct 1025 DSDD

Superbrain Jr. SSDD

Epson Multifond DSDD

Superbrain Jr. SSDD

Epson OX-10 DSDD

Superbrain 40 track SSDD

Epson QX-10 DSDD

Superbrain DSDD

Epson QX-1 0 European DSDD

Systel 11 CP/M SSDD

Fujitsu Micro 16a DSDD

Systel 111200/300 DSDD

Groupil III OP/M DSDD

Tektronix 4170 DSDD

Heath w/Magnolia OP/M SSDD

Teletek 40 Track SSDD

Heath w/Magnolia CP/M SSDD

Televidoo 8021803 DSDD

Heath w/Magnolia CP/M DSDD

Televideo TurboDos DSDD

Heath Z90 I K Blk SSDD

TI Professional CP/M86 SSDD

Heath Z90 2K Blk SSDD

TI Professional CP/M86 DSDD

Heath Z1 00 CP/M SSDD

Toshiba T1 00 DSDD

Heath Z1 00 OP/M DSDD

TRS-80 FEC CP/M SSDD

Hewlett-Packard HP-125 DSDD

TRS-80 FEC T805 SSDD

IBM PC CP/M86 SSDD

TRS-80 III w/Hurr. Labs SSDD

IBM PC CP/M86 DSDD (ZRP/M default)

TRS-80 III w/Memory Merchant SSDD

Idea Bitelex SSDD

TRS-80 Mod. 3 Mom Merch CP/M SSDD

IMS 5000 SSDD

TRS-80 IV Mont. Micro SSDD

Insight Dev 10-120 SSDD

TRS-80 Mod. 4 MT CP/M SSDD

ISM CP/M DSDD

TRS-80 Mod. 4 CP/M SSDD

Kaypro 11 SSDD

Wang MAWS OP/M DSDD

Kaypro 2X DSDD

Xerox II 820 SSDD

Kaypro IV DSDD

Zenith Z90 I K Blk SSDD

Kaypro 4 Media Master DSDD

Zenith Z90 2K Blk SSDD

Kaypro 10 DSDD

Zenith ZI 00 CP/M SSDD

LNW-80 CP/M SSDD

Zenith Z1 00 CP/M DSDD

Lobo Max80 SSDD

Zorba DSDD

Magic Computer DSDD

Micral 9050 DSDD

ZRP/M Operating System

Users Guide

43

Terminal Selections

ANSI terminal / DEC VT- 100 ANSI

ADDS Viewpoint/ Superbrain 1 / Intertec

Beehive 15x, 16x / Cromemco 3100

DEC VT-52, VT-100

Hazeltine 1 (1400-1500) bias OOH

Hazeltine 2 (1400-1500) bias 60H

HDS Concept 100

Heath-Zenith 19,89,,90 / Flashwriter

Hewlett-Packard 2621

IBM 3 101 Terminal

Infolron 1- 100 / Visual 200

Kaypro /, fl, IV, 10, 84

Lear-SeiglerADM-3A, ADM-31

Microline ACT-IV

Northstar Advantage

Osborne 1

Perkin-Elmer Bantam 550 / Fox 1100

Processor Technology SOL

Soroc 1Q- 120,140 / Zentec /Apple

Superbrain 2

Televideo 900 Series

Teleray 1061 / Wyse

TRS-80 // Lifeboat, P& T CP/M

VS Mindless Terminal

Xerox 820

Xitec SCT- 100

Zenith 19, 89, 90

-- - --- ----- . . .." ------ ------------------------- ------- -- ---- -

microMethods, Inc, A 0. Box 909, Warrenton, OR 97146