;

                               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.