cp-m plus programmers guide

? in filename error, 2-30

$$$ filetype, 1-27

A

absolute module, 3-73 access

date and time stamp, 3-21 stamp types, 2-24

ACCESS DRIVE, 3-57 address, maximumm, 1-5 allocation vector, 2-27 , 3-41 , 3- 75

ambiguous file reference, 1-13, 2-16, 3-24, 3-27

archive attribute, 2-17 ASCII character file, 1-18 ASM , 2-11

assembler source, 2-11 associated command files, 1-18 asterisk, 1-13, 2-11

attribute bits, 2-16 attributes

set file, 2-22 automatic submit, 1-19 Auxiliary Input, 3-4

Auxiliary Input Status, 3-9 Auxiliary Output, 3-5 Auxiliary Output Status, 3-10 AUXIN, 2-2, 2-6, 3-4, 3-9 AUXO(JT, 2-2, 2-6, 3-5, 3-10

B

backspace, 3-2 BAK, 2-11 Bank 0, 1-3

in context, 1-3 switched in, 1-3

Bank 1, 1-3, 1-4 banked, 1-2, 1-11 memory, 1-3

operating system module, 1-3

Index

Basic Disk operating System See BDOS

Basic Input/Output System See BIOS

basic record size, 2-7 BDOS, 1-6, 1-8, 1-11, 1-14

calling conventions, 2-1 Call Resident System Extension (RSX), 1-24 chain to program call, 1-23 directory codes, 2-32 directory functions, 2-7 drive-related functions, 2-7 error codes, 2-31

error flags, 2-33 error mode, 2-29

extended error codes, 2-34 file access functions, 2-7 file system, 2-7, 2-11 miscellaneous functions, 2-7 physical errors, 2-34

read character, 2-3 write character, 2-3

BDOS_base, 1-8 to 1-11 bell character, 3-12

binary zero terminator, 3-12 BIOS, 1-6, 1-7, 1-14, 2-29

cold start, 1-15

DEVRBL entry point, 2-2 entry points, 1-7 Parameter Block, 3-72 warm start, 1-15

BIOS_base, 1-8, 1-10, 1-15 BIOSPB, 3-72

bit map, B-1 bit vector, 3-43

blocking, record, 3-63 block size, 2-11 Boolean fields, 2-16 buffers, 1-4

disk, 1-2

built-in command, 1-8, 1-16 byte, 2-1

Index-1

system, 1-3

version requirements, 1-5 bank-switching, 1-4 bank-switched memory, 1-1, 1-3 BAS, 2-11

base address, 1-21

base extent, 3-48, 3-50 basic console I/O, 2 -3

calling program, 2-15 return to, 2-28

carriage return, 2-13, 3-2 CCB, 3-94, 3-95

CCP

description 1-7, 1-8, 1-11, 1-13

location, 1-6, 1-15 operation, 1-16 to 1-28 user number, 2-18

CCP.COM, 1-15

CCP command form, 1-16 chain flag, 3-67

Chain To Program, 3-67 change default drive, 1-16 character block, 2-2 Character Control Block

See CCB character echo, 2-3

character string, 2-2 check-sum vector, 2 -27

command,

drive field, 2-37 field, 1-20 keyword, 1-17

Command File, 2-11 command line, 1-17 characters, 2-38 command tail, 1-16

Index

byte count, 2-28

C

Call BIOS, 1-22

Call Resident System

Extension (RSX), 3-74

input, 2-3, 3-2 output, 2-3, 3-3 page length, 3-70 status, 2-3, 3-8 string output, 2-3 width, 3-70

Console Command Processor, See CCP

Console Input, 3-2 Console Mode, 2-5, 3-91

default state, 3-2 Console Output, 3-3 control character ('), 2-5 COPY, 4-1

copy file, 1-12, 4-1 CP/M, 1-1, 1-2

CP/M 2, 1-28, 2-1 CPM3.SYS file, 1-14 CPMLDR, 1-14, 1-15 CPMLDR BDOS, 1-14 CPU registers, 1-22

cr field, 3-29, 3-31, 3-34 create

date and time stamp, 3-35 directory entry, 3-34 directory label, 3-78 stamp types, 2-24

XFCB, 3- 34 CTRL-A, 3-14 CTRL-B, 3-14 CTRL-C, 1-22, 2-4, 2-5,

3-13, 3-14 reboot, 3-13

CTRL-E, 3-13, 3-14, 3-15 end of line, 3-13

Index-2

parsing, 1-17

common memory, 1-3, 1-5 base address, 3-71

region, 1-3 common region, 1-3

size, 1-5 compatibility, 1-22, 1-28

compatibility between CP/M 3 and MP/M, 3-61, 3-62 Compute File Size, 2-28, 3-53

conditional command, 1-23 conditional status, 2-6 configured memory size, 1-7 CONIN, 1-7, 2-2, 2-3, 3-2,, 3-16 CONOUT, 2-2, 2-3, 3-3 console,

block output, 2-3 characteristics, 1-27 column position, 3-70 I/O functions, 2-3

CTRL-X, 3-13, 3-15 beginning of line, 3-13

CTRL-Z, 2-3, 2-13 curly brackets, 3-96 current record, 2-15

current record field of the FCB, 3-20

current record position, 2-36 current user number, 1-28

D

DAT, 2-11, 3-85 data

area, 1-12, 1-13, 2-12 block, 2-11, 2-12, 3-75

data base management system, 4-19

Data File, 2-11 data tracks,

directory area, 1-12 data area, 1-12

date and time stamping, 2-20 ,

CTRL-J, 3-13, 3-15 line feed, 3-13

CTRL-K, 3-15 CTRL-M, 3-13, 3-15

CTRL-P, 2-4, 2-5, 3-2, 3-3, 3-13, 3-15

list device, 3-13

CTRL-Q, 2-4 , 2-5, 3 -2, 3-3 CTRL-R, 3-13, 3-15

retype line, 3-13

CTRL-S, 2-4, 2 -5, 3- 2, 3- 3 CTRL-U, 3-13, 3-15

remove line, 3-13 CTRL-W, 3-15

functions, 2-8

hash tables, 1-2, 1-4 space, 1-13

directory label, 2-19, 2-20, create, 3-78

data byte definition, 3-78, 3-80

password, 2-21 update, 3-78

DIRLBL.RSX, 1-25, 2-21, 3-78 DIRSYS, 1-18

disk, 1-11 access, 1-12 change, 2-27 current, 3-71

default, 1-15, 3-19 directory area, 2-12 drive organization, 1-12 formatting program, 1-22 I/O error, 2-28, 2-29 record buffers, 1-2, 1-4 select, 2-29

space, 1-13 Index-3

2-23, 2-25, 3-35,

3-81, 3-85 DATE utility, 2-25 default

disk, 1-15, 3-19 DMA buffer, 2-35 drive, 1-16, 1-28 FCB, 2-37

mode, 3-64

output delimiter, 3-93 password, 2-23, 3-87 Default Error Mode, 3-64

Delete File, 2-17, 2-22, 3- 27 delimiter, 1-17, 2-10,

3-11, 3-93

file specification, 3- 97 DEVICE utility, 2-2 differences: banked and

nonbanked, 1-2 DIR, 1-18

DIR.COM utility, 1-18 Direct BIOS Calls, 1-22, 3-72 Direct Console I/O, 3-7 Direct Memory Address

(DMA), 3-40 directory

area, 1-12

check-sum vector, 2-27 codes, 2-30, 2-32 entries, 2-15

E

ED Source Backup, 2-11 edit control characters,

banked CP/M 3, 3-14 nonbanked CP/M 3, 3-13

empty directory entry, 2-16 end-of-file, 1-26, 2-3

entry values, 2-1 environment, 1-7 ERASE, 1-18 errors, 2-30, 2-31

? in filename, 2-30

Index

Disk Parameter Block (DPB), 3-46

Disk Reset, 2-27 DMA, 3-40

address, 3-71 buffer, 2-35

default address, 2-38 DPB (Disk Parameter

Block), 3-46 drive,

access, 3-57 allocation vector, 2-27 capacity, 2-12

chain, 1-20 code, 2-14

default, 1-16, 1-28 functions, 2-8 read-only, 3-43 reset, 3-56

search chain, 3-71 select code, 2-9, specification, 1-17, 1-20 specifier, 2-9

support, 1-11 drive-related functions,

2-7, 2-8 dump program, 4-5

dynamic allocation, 1-13

size, 1-12, 2-12, 3-53 space allocation, 1-13 specification, 2-9 types of, 2-11

file access functions, 2-7 File Control Block

See FCB default, 2-36

File Dump, 4-5

File Exists error, 2-30 filename, 1-13, 1-17, 2-9,

2-11, 2-15 ambiguous, 2-11

Index-4

extended, 2-29, 2-34 file exists, 2-30 flag, 2-33

handling, 2-28 invalid drive, 2-29 messages, 2-29, 2-30

mode, 2-29, 3-64, 3-71 physical, 2-28, 2-29, 2-34 program code, 3-89 read-only, 2-30

return code, 3-70 extend operating system

functions, 1-9, 1-23 extended error codes, 2-29,

2-30, 2-34, extended FCB, 2-19 extent 0, 3-48, 3-50

extent field format, 3-83 extent number, 2-14

F

false status, 2-6 FCB, 3-20

default, 2-36, 2-37 extent number field, 3-35 format, 2-18, 3-98 length, 2-13

parsed, 1-21

random record field, 3-55 field, 1-19

file

access functions, 2-7 attributes, 2-16

byte count, 2-28, 3-44 directory elements, 2-15 format, 2-13

ident if icat ion, 1 -1 2 naming conventions, 2-11 organization, 2-11 passwords, 2-21

password error, 2-30

Index

parse, 3-96 filespec, 1-17

filetype, 1-13, 1-17, 2-9, 2-11, 2-15

floppy disk, 1-11 Flush Buffers, 2-25,

2-33, 3-68

Free Blocks, 2-33, 3-75 Free Drive, 3-58

free space, 1-13, 3-65 Function Calls-.

0:System Reset, 3-1

1:Console Input, 3-2

2:Console Output, 3-3

3:Auxiliary Input, 3-4

4:Auxiliary Output, 3-5

5:List Output, 3-6

6:Direct console I/O, 3-7

7:Auxiliary Input Status, 3-9

8:Auxiliary Output Status, 3-10

9:Print String, 3-11

10:Read Console Buffer, 3-12

11:Get Console Status, 3-16

12:Return Version Number, 3-17

13:Reset Disk System, 3-18

14:Select Disk, 3-19

15:Open File, 3-20

16:Close File, 3-22

17:Search For First, 3-24

18:Search For Next, 3-26

19:Delete File, 3-27

20:Read Sequential, 3-29

21:Write Sequential, 3-31

22:Make File, 3-34

23:Rename File, 3-36

24:Return Login Vector, 3-38

25:Return Current Disk, 3-39

26:Set @ Address, 3-40

27:Get ADDR(ALLOC), 3-41

28:Write Protect Disk, 3-42

29:Get Read-Only Vector, 3-43

30:Set File Attributes, 3-44

31:Get ADDR(DPB PARMS), 3-46 3 2 : Set/Get User Code, 3-47

3 3: Read Random, 3-48

34:Write Random, 3-50

38:Access Drive, 3-57

39:Free Drive, 3-58

40:Write Random with Zero Fill, 3- 59

41:Test and Write Record, 3-60

42:Lock Record, 3-61

43Unlock Record, 3-62

44:Set Multi-Sector Count, 3-63

45:Set BDOS Error Mode, 3-64

46:Get Disk Free Space, 3-65

47:Chain To Program, 3-67

48:Flush Buffers, 3-6B

49:Get/set system control Block, 3-69

50:Direct BIOS Calls, 3-72

5 9: Load Overlay, 3-73

60:Call Resident System

Extension, 3-74

98:Free Blocks, 3-75

99:Truncate File, 3-76

100:Set directory Label, 3-78

101:Return Directory Label Data, 3-80

102:Read File Date Stamps and Password Mode, 3-81

103:Write File XFCB, 3-83

104:Set Date and Time, 3-85

105:Get Date and Time, 3-86

112: List Block, 3-95

152: Parse Filename, 3-96

G

GENCOM, 1-9, 1-24, 2-6 GENCPM, 1-2, 1-16 generic filetypes, 2-11 Get

ADDR(ALLOC), 2-34, 3-41 ADDR(DPB PARMS), 3-46 COM, 1-24, 1-26

Console Status, 3-16

Date and Time, 3- 86

Disk Free Space, 2-33, 3-41, 3-65

Output Delimiter, 3-93 Program Return Code, 3-89 Read-Only Vector, 3-43 RSX, 2-6

.RSX, 1-24 User Code, 3-47

utility, 1-24, 1-26 Get/Set

Console Mode, 2-5, 3-91

Output Delimiter, 3-93

Program Return Code, 1-23, 3-89, 3-90

System Control Block, 3-69 User Code, 3-47

graphic characters, 3-2

H

hash table, 1-4, 2-27 directory, 1-2

HEX, 2-11

Hex Machine Code, 2-11 highest memory address, 2-35

host computer's environment, 1-7