;
RECORDe� 4.0
Copyrigh� (c� 198� Alph� Systems
Al� right� reserved
1� Introductio� 3� Syste� Requirements
2� Usin� RECORDe� 4� Ho� i� Works
Pres� numbe� fo� desire� topic
(Control-� Quit� HELP)
Alph� System� Corporation
71� Chatswort� Place
Sa� Jose� California 95128
(408)297-5594
:1
Introductio� t� RECORDe� 4.0
RECORDe� wil� allo� yo� t� direc� consol� outpu� t� � particula� fil� a� wel� �
a� �t� �th� console� I� wil� als� allo� yo� t� direc� printe� �outpu� �t� �� �
particula� �fil� �instea� �o� t� th� printer� An� numbe� �o� �file� �ma� �b� �
create� t� hol� thes� dat� an� an� tw� o� the� ma� b� ope� t� receiv� consol� �
an� printe� outpu� a� i� occurs.
Consol� recordin� i� usefu� i� tha� CONSOLE.FI� hold� al� th� character� sen� �
t� �CONOU� �withou� �regar� t� an� formattin� o� deletion� don� �b� �th� �DO� �
functions� CONSOLE.FI� i� � faithfu� reproductio� o� everythin� sen� t� �th� �
Consol� (excep� 1Ah� whethe� throug� DO� o� directl� throug� BIOS.
Printe� �recordin� �capture� al� character� sen� t� LIS� (excep� �1Ah� �int� �
PRINTER.FI� �rathe� tha� sendin� the� directl� t� th� printer� Thi� i� �muc� �
faste� tha� actua� printing� PRINTER.FI� ca� b� printe� late� wit� an� Prin� �
progra� o� i� th� backgroun� wit� BPRINTe� IOP.
:2
Usin� RECORDe� 4.0
RECORDe� �consist� �o� tw� files� RECORD.CO� whic� i� th� �comman� �fil� �an� �
loade� an� RECORDER.RE� whic� i� th� actua� IO� whic� doe� th� work.
Whe� �RECOR� i� invoke� fo� anythin� bu� specifi� Help� i� wil� chec� t� �se� �
whethe� �RECORDER.RE� i� loade� a� th� IO� and� i� not� clos� u� th� �curren� �
IO� �an� searc� an� loa� RECORDER.RE� fro� alon� th� Path� the� �execut� �th� �
comman� �(Typ� �RECOR� //<CR� fo� specifi� o�-lin� Help)� � Ther� �ar� �eigh� �
command� t� perfor� variou� setup� an� functions:
RECOR� � [DIR:][FILE.TYP]
Defin� Consol� outpu� fil� specification� Th� defaul� consol� outpu� fil� i� �
CONSOLE.FI� �i� th� curren� directory� Yo� ma� direc� tha� fil� �t� �anothe� �
director� an�/or chang� it� name�
RECOR� � [DIR:][FILE.TYP]
Defin� Printe� outpu� fil� specification� Th� defaul� i� PRINTER.FI� i� �th� �
curren� �directory� A� wit� th� Consol� file� yo� ma� pu� i� wher� yo� �lik� �
an�/or chang� it� name.
RECOR� D
R�-establis� �th� �defaul� �outpu� fil� �specification� �a� �CONSOLE.FI� �an� �
PRINTER.FI� i� th� curren� directory.
RECOR� F
Displa� �th� �currentl� declare� outpu� fil� specifications� Us� C� � �o� �� �
command� t� chang� the� i� necessary.
RECOR� ON
Ope� �th� curren� Consol� Outpu� fil� (o� creat� i� i� i� doesn'� exist� �an� �
sen� �consol� outpu� t� th� fil� a� wel� a� t� th� console� I� th� �fil� �i� �
r�-opened� outpu� i� concatenate� t� it� Consol� outpu� i� sen� verbati� �t� �
th� �fil� �excep� �tha� �Cntr�-� (1Ah� character� �ar� �filtere� �out� � Sto� �
Consol� recordin� wit� th� RECOR� OF� command.
RECOR� OFF
Writ� th� las� recor� o� th� Consol� Outpu� fil� an� clos� it� Th� fil� �ma� �
b� �r�-opene� wit� th� RECOR� O� command� A� thi� poin� yo� ma� �defin� �ye� �
anothe� �Consol� �Outpu� �fil� wit� th� � command� i� yo� �wish� �an� �direc� �
consol� outpu� t� i� afte� th� nex� RECOR� O� command.
RECOR� O� P
Ope� (o� create� th� curren� Printe� Outpu� fil� an� sen� LIS� outpu� t� �th� �
fil� �instea� o� t� th� printer� I� th� Printe� Outpu� fil� alread� �exists� �
LIS� outpu� wil� b� concatenate� t� it� LIS� outpu� i� sen� verbati� t� �th� �
fil� �excep� �tha� Cntr�-� (1Ah� character� ar� filtere� out� � Sto� �Printe� �
recordin� wit� th� RECOR� OF� � command.
RECOR� OF� P
Writ� �th� las� recor� an� clos� th� curren� Printe� Outpu� file� � Th� �fil� �
ma� �b� r�-opene� wit� th� RECOR� O� � comman� o� yo� ma� no� defin� �anothe� �
Printe� �Outpu� �fil� �wit� th� � command� Subsequen� LIS� �outpu� �wil� �b� �
directe� t� th� ne� fil� afte� th� nex� RECOR� O� � command.
:3
Syste� Requirements
RECORDe� require� � Z8� base� �-Syste� (ZRDO� 1.� o� ZSDO� 1.0� wit� a� leas� �
1.5� IOP� Ther� i� n� advantag� i� declarin� a� IO� large� tha� 1.5� bytes.
RECORDe� use� th� reentran� capabilitie� o� ZRDO� o� ZSDO� whil� writin� �th� �
record� o� CONSOLE.FI� and/o� PRINTER.FI� t� disk� Standar� DR� BDO� 2.� �o� �
othe� DO� replacement� ar� no� reentran� an� wil� fail�
:4
Ho� i� Works
RECORDe� �trap� �characte� �outpu� call� t� CONOU� an� �LIS� �an� �send� �th� �
characte� t� th� appropriat� Outpu� buffe� befor� passin� i� t� th� BIOS� I� �
th� �cas� �o� LIS� output� th� characte� i� no� sen� t� th� BIO� a� �al� �an� �
w� simpl� retur� t� th� caller� A� th� Consol� and/o� Printe� buffer� �fill� �
the� ar� writte� t� th� Outpu� file(s� o� disk� Th� OF� an� � command� �wil� �
writ� th� las� record(s� an� clos� th� appropriat� outpu� file(s).
Becaus� �o� th� wa� ZRDO� an� ZSDO� reentranc� works� RECORDer'� �writin� �t� �
dis� i� th� backgroun� ma� interfer� wit� applicatio� program� writin� t� th� �
sam� �dis� i� th� foreground� especiall� i� th� applicatio� i� �usin� �Rando� �
Write�
Thi� potentia� conflic� ma� b� avoide� i� CONSOLE.FI� and/o� PRINTER.FI� �ar� �
directe� t� � differen� drive� I� you� applicatio� i� writin� variou� �file� �
i� driv� A� yo� migh� assig� CONSOLE.FI� o� PRINTER.FI� t� driv� � an� �avoi� �
an� chanc� o� conflict.