Files
Digital-Research-Source-Code/MPM OPERATING SYSTEMS/MPM II/MPM II SOURCE/TEX/MPM2OEM.TEX
Sepp J Morris 31738079c4 Upload
Digital Research
2020-11-06 18:50:37 +01:00

326 lines
10 KiB
TeX
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.po 4
MP/M II V2.0
OEM REDISTRIBUTION GUIDE
Copyright (C) 1981
Post Office Box 579
801 Lighthouse Avenue
Pacific Grove, CA 93950
(408) 649-3896
TWX 910 360 5001
All Rights Reserved
     Noteº  Thió documenô  containó  Digitaì <20>
         Researcè proprietarù information¬ anä musô noô <20>
           copieä   distributeä  foò  anù  purposå <20>
         whatsoever¬   withouô  writteî  permissioî <20>
         Digitaì Research.
Š (Company Name ____________________________ Origin # _______)
1. Introduction.
Thió  documenô  accompanieó  thå MP/Í  IÉ  OEÍ  Distributioî <20>
Disketteó  (Controì  1/² ¦ 2/² anä Serialization© anä  serveó <20>
summarizå   thå  diskettå  serializatioî  procesó  whicè   allowó <20>
constructioî  anä  verificatioî   MP/Í  disketteó  whicè   arå <20>
distributeä bù thå OEM.
Notå  thaô  alì  thå programó includeä oî  thå  OEÍ  Controì <20>
redistributioî  disketteó  1/² ¦ 2/² maù bå distributeä   youò <20>
customers®  Notå  alsï  thaô thå programó includeä   thå  OEÍ <20>
Serializatioî  redistributioî  diskettå musô noô bå  includeä <20>
youò  distributioî  diskette®  Further¬  notå thaô thå  symboliã <20>
debuggeò (SID¬  RSID¬  oò ZSID)¬  anä anù otheò Digitaì  Researcè <20>
softwarå  productó noô provideä oî youò OEÍ Controì disketteó 1/² <20>
¦  2/²  arå  noô tï bå distributeä   yoõ  unlesó  specificallù <20>
covereä bù separatå redistributioî agreements.
Á  workinç  knowledgå  oæ thå standarä  MP/Í  IÉ  alteratioî <20>
procesó  anä  thå  generatioî oæ á custoí  XIOÓ   assumed¬ <20>
describeä iî thå "MP/Í IÉ Systeí Guide."
2. System Serialization under CP/M
Á prograí ió provideä oî thå OEÍ Serializatioî  distributioî <20>
diskettå  foò serializatioî anä verificatioî oæ diskettes®  Thió <20>
program¬   calleä  MPM2SRL¬   provideä   botè  sourcå  anä <20>
assembleä  form®  Thió serializatioî prograí ió  configureä  foò <20>
executioî  undeò  thå CP/Í operatinç system®  Iô ió  recommendeä <20>
thaô  yoõ  perforí thå serializatioî anä  verificatioî  functionó <20>
whilå  executinç undeò CP/Í (refeò tï sectioî ³ oæ thió guidå <20>
yoõ   noô  havå accesó tï CP/Í oò foò otheò reasonó  musô  uså <20>
MP/M IÉ  foò  youò systeí  serialization)®
Thå MPM2SRÌ prograí readó aî "origiî number¢ assigneä tï thå <20>
distributoò   Digitaì Researcè (giveî oî thå sectioî  ±  titlå <20>
linå  oæ thió guide)¬  alonç witè á startinç seriaì number®  Thå <20>
prograí  promptó thå operatoò foò thå diskettå tï bå  serialized¬ <20>
eitheò  1/2¬  2/2¬  oò á combineä diskettå oæ 1/² anä  2/2®  Thå <20>
prograí  alsï  promptó thå operatoò tï specifù whetheò oò  noô  á <20>
"systeí  disk¢ serializatioî ió tï bå performed¬  specifying thaô <20>
the system tracks need to be copied and serialized.
Thå distributor'ó customizeä controì disë (1/2¬  2/2¬ oò 1/² <20>
anä  2/²  combined©  ió theî placeä intï drivå   anä  á  blanë <20>
formatteä diskettå ió placeä intï drivå B® Iæ á "systeí disk¢ ió <20>
   generated¬  thå firsô twï systeí  trackó  containinç  thå <20>
MPMLDÒ  arå  theî  copieä  froí thå sourcå diskettå   thå  ne÷ <20>
diskette¬  anä internallù serializeä witè thå origiî anä  currenô <20>
seriaì  number®  Thå copù operatioî proceedó tack-by-tracë untiì <20>
thå firsô fulì tracë oæ 0E5È byteó (whicè ió thå initiaì valuå oæ <20>Šaî IBÍ compatiblå diskettå track)® Eacè tracë ió theî re-reaä tï <20>
ensurå thaô thå copù operatioî waó correct®
Thå  lasô steð iî thå diskettå serializatioî prograí  <20>
perforí  á  CP/Í disë reseô anä theî tï placå origiî  anä  seriaì <20>
numberó  intï thå fileó specifieä iî aî FCÂ tablå bù openinç anä <20>
theî  readinç  anä  writinç thå  files®  Thå  seriaì  numbeò <20>
automaticallù incremented¬  anä thå consolå ió prompteä tï inserô <20>
anotheò  diskette®  Thå  operatioî continueó untiì thå  operatoò <20>
performó á colä start.
  maù bå necessarù tï modifù thå MPM2SRÌ prograí iæ  drivå <20>
parameteró  arå  altereä oò iæ therå arå changeó iî thå  standarä <20>
fileó  requirinç serializationº consulô thå sourcå  prograí  foò <20>
drivå  dependenô  operationó aó welì aó foò thå FCÂ tablå  whicè <20>
specifieó thå individuaì fileó requirinç serialization.
The following files are specified in the FCB table:
Disk 1/2: MPM .SYS
XDOS .SPR
RESBDOS .SPR
MPMLDR .COM
GENSYS .COM
Disk 2/2: RMAC .COM
LINK .COM
LIB .COM
3. System Serialization under MP/M
  shoulä   understooä thaô Digitaì  Researcè  doeó  noô <20>
recommenä diskettå serializatioî anä verificatoî whilå  executinç <20>
undeò thå MP/Í IÉ operatinç system®  Thå reasoî foò thió ió thaô <20>
botè  serializatioî anä verificatioî requirå direcô calló tï  thå <20>
BIOS/XIOÓ  disë  primitives®  Makinç direcô  calló  violateó  thå <20>
MP/M IÉ  implementatioî  oæ á seriallù reusablå BDOÓ  unlesó  thå <20>
MXDisë  queuå  ió properlù manageä tï makå certaiî thaô nï  otheò <20>
procesó   alloweä accesó tï thå BDOÓ  whilå  serializatioî <20>
verificatioî ió takinç place®
Thió  sectioî  oæ thå guidå ió intendeä foò OEMó  thaô  wilì <20>
perforí  diskettå serializatioî anä verificatioî whilå  executinç <20>
undeò  thå MP/Í operatinç system®  Therå arå twï changeó tï  thå <20>
MPM2SRL program which must be made:
A. Direct XIOS Disk Function Access
  ordeò  tï directlù accesó XIOÓ disë  functionó  (aó <20>
requireä bù MPM2SRL)¬  onå additionaì leveì oæ  indirectioî <20>
must be used as follows:
Š Change-
wboot equ 1
To-
Awboot equ 1
Following-
start:
lxi sp,stack
Add-
lhld Awboot
inx h
mov e,m
inx h
mov d,m
xchg
shld wboot
Add- to beginning of 'miscellaneous data areas'
wboot: ds 2
B. Force MXDisk Queue Message Ownership
Thå  seconä  changå requireä foò thå  MPM2SRÌ  prograí <20>
     ensureó  thaô   otheò disë activitù ió initiateä   thå <20>
     MP/M IÉ systeí whilå serializatioî ió beinç performed® Thió <20>
     steð  caî bå eliminateä iæ yoõ caî guaranteå thaô   otheò <20>
     disë  operationó wilì bå performeä (i.e®  nï otheò  operatoò <20>
     wilì  attempô tï ruî anù prograí aô anotheò console©  durinç <20>
     serialization.
Following-
start:
lxi sp,stack
Add-
mvi c,openque ;openque equ 135
lxi d,uqcb
calì  bdoó  ;opeî MXDisë queue
inr a
jz notMPM ;must not be MP/M
mvi c,readque ;readque equ 137
lxi d,uqcb
call bdos ;read MXDisk que msg
Š Change-
endcopy:
call srlfile
To-
endcopy:
mvi c,writeque ;writeque equ 139
lxi d,uqcb
call bdos ;write MXDisk que msg
call srlfile
mvi c,readque ;readque equ 137
lxi d,uqcb
call bdos ;read MXDisk que msg
Add- to beginning of 'miscellaneous data areas'
uqcb:
ds 2 ;ptr filled by open
dw 0 ;bfr ptr (not used)
db 'MXDisk ' ;queue name- 8 chrs
Further¬  notå  thaô thå serializatioî prograí caî theî <20>
       terminateä  witè á ctl-Ã (^C© characteò entereä   thå <20>
     console.
4. MP/M II OEM Redistribution Packing List
Thå  followinç  lisô summarizeó thå itemó  whicè  shoulä <20>
included in the OEM redistribution of MP/M II.<2E>
o (2) Diskettes, marked 1/2 & 2/2
-or-
(1) Diskette (if 1/2 & 2/2 combined- double density)
o MP/M II User's Guide
MP/M II Programmer's Guide
MP/M II System Guide (Optional)
o Link-80 Operator's Guide
o MAC Language Manual and Applications Guide
o MP/M II Application Notes 01 to 14
o RMAC 1.1 Application Note 01
o Registration Card
o Cover Letter
o MP/M II Product Brief
Š5. MP/M II OEM Redistribution Files
Thå  followinç lisô itemizeó thå fileó whicè caî bå includeä <20>
iî thå OEÍ redistributioî oæ MP/Í II.
DISK 1/2:
BNKBDOÓ  SPÒ  BNKXDOÓ  SPÒ RESBDOÓ  SPÒ  TMÐ SPR
XDOS SPR ABORT SPR MPMSTAT RSP SCHED RSP
SPOOL RSP MPMSTAT BRS SCHED BRS SPOOL BRS
ABORT PRL ASM PRL CONSOLE PRL DIR PRL
DSKRESET PRL DUMP PRL ED PRL ERA PRL
ERAQ PRL MPMSTAT PRL PIP PRL PRINTER PRL
PRLCOM PRL RDT PRL REN PRL SCHED PRL
SDIR PRL SET PRL SHOW PRL SPOOL PRL
STAT PRL STOPSPLR PRL SUBMIT PRL TOD PRL
TYPE PRL USER PRL DDT COM GENHEX COM
GENMOD COM GENSYS COM LOAD COM MPMLDR COM
DISK 2/2:
LINK COM LIB COM RMAC COM XREF COM
I8085 LIB Z80 LIB INTER LIB TREADLES LIB
BUTTONS LIB SIMPIO LIB SEQIO LIB STACK LIB
DISKDEF LIB DSTACK LIB COMPARE LIB NCOMPARE LIB
WHEN LIB DOWHILE LIB SELECT LIB DISK DOC
Z80 DOC LDRBIOS ASM BOOT ASM DEBLOCK ASM
TODCNV ASM RESXIOS ASM DUMP ASM EXTRN ASM
Thå  followinç lisô itemizeó thå fileó whicè arå includeä oî <20>
thå  MP/Í  IÉ  V2.° OEÍ Serializatioî diskettå anä  musô  noô <20>
includeä iî thå OEÍ redistributioî oæ MP/Í II.
MPM2SRL ASM MPM2SRL COM
Š