textfiles/apple/DOCUMENTATION/echo.txt

         ECHO 1.0 DOCUMENTATION
        ------------------------

CHANGING PARAMETERS
-------- ----------
- THE CURSOR WILL FLASH OVER THE DIGIT 
YOU ARE ABOUT TO CHANGE.
- TYPING RETURN WILL MOVE THE CURSOR DO
WN TO THE NEXT PARAMETER.
- THE TWO ARROW KEYS MOVE THE CURSOR FR
OM DIGIT TO DIGIT.
- WHEN YOU GET TO THE FRAME BITS PARAME
TER THE RETURN KEY WILL START
    THE COPY.


PARAMETER DEFINITIONS
--------- -----------
SOURCE SLOT:      RANGE: 1-7  DEFAULT: 
6

SOURCE DRIVE:     RANGE: 1-2  DEFAULT: 
1
     
TARGET SLOT:      SAME AS SOURCE EXCEPT
 TARGET DISK

TRACK PHASE:      RANGE: 0-2  DEFAULT:0
      DEFINITION: WHEN SET TO 0 ECHO ON
LY READS WHOLE TRACKS.
                  WHEN SET TO 1 ECHO RE
ADS HALF TRACKS.
                  WHEN SET TO 2 (SEE SP
ECIAL FEATURES) ECHO TRIES TO
                    FIGURE OUT WHAT TO 
READ.
 
TRACK START:      RANGE: 0-23  DEFAULT:
 00
      DEFINITION: FIRST TRACK THAT ECHO
 WILL COPY.

TRACK END:        RANGE: 0-23  DEFAULT:
 22
      DEFINITION: LAST TRACK THAT ECHO 
WILL COPY.

TRACK COUNT:      RANGE: 1-23  DEFAULT:
 1
      DEFINITION: NUMBER TO INCREMENT B
Y
      EXAMPLE: TRACK 1-12  TRACK COUNT:
3
               COPY: 1-4-7-10 ETC.

ENABLE SYNC:      RANGE: 0-1  DEFAULT: 
0
      DEFINITION: IF IT'S A 1, ECHO SYN
CS THE TRACK 
                  (SEE SPECIAL FEATURES
)

ENABLE COUNT:     RANGE: 0-1  DEFAULT: 
0
      DEFINITION: IF IT'S A 1 NIBBLE CO
UNTING IS SELECTED.
                  (SEE SPECIAL FEATURES
)

FRAME BITS:      RANGE: 0-2  DEFAULT: 1
     DEFINITION: THE NUMBER OF '0' BITS
 ECHO WILL WRITE AFTER
                   EACH SYNC BYTE.  IF 
'0' IS SELECTED ECHO ENABLES
                   IT'S LENGTH KILL FEA
TURE  (SEE SPECIAL FEATURES)
.NP
ECHO'S MESSAGES
------ --------
IN THE LOWER RIGHT HAND BOX WHEN COPYIN
G YOU WILL SEE SOMETHING IN A
  FORMAT LIKE THIS:
                          TT SSSS LLLL 
      E
    TT   = TRACK NUMBER
    SSSS = NUMBER OF SYNC BYTES ON THE 
TRACK
    LLLL = LENGTH OF THE TRACK
    E    = ERROR CODE

THE TWO LONG BOXES ON THE RIGHT HAND SI
DE ARE THE TRACK INFORMATION
  FIELDS.  IN THEM YOU WILL SEE SOMTHIN
G LIKE THIS:
                           TT  +NN
                             OR
                           TT  -NN
TT = TRACK #   NN = DIFFERENCE BETWEEN 
SOURCE AND TARGET INFORMATION.

IN THE PHASE FINDER MODE, THE TWO BOXES
 WILL FORMAT LIKE THIS:
                           TT  N
TT = TRACK #   N  = WHOLE TRACK IF IT'S
 A 0, HALF TRACK IF IT'S A 1


ERROR CODES
----- -----
ERROR 0:  ECHO HAD NO PROBLEM COPYING T
HIS TRACK
ERROR 1:  ECHO COULDN'T DETERMINE LENGT
H OF TRACK WHEN IT WAS READ.
          > THIS ERROR IS FATAL.  IF YO
U GET IT TRY AGAIN AND HOPE!
ERROR 2:  ECHO COULD NOT DETERMINE THE 
START OF THE TRACK.  THE TRACK
            MAY OR MAY NOT HAVE BEEN CO
PIED CORRECTLY
ERROR 3:  IF YOU GET THIS ERROR YOU BET
TER GET ANOTHER COPY OF ECHO
            1.0 BECAUSE THIS ERROR IS N
OT BEING USED YET.
ERROR 4:  TARGET DISK IS WRITE PROTECTE
D
ERROR 5   ECHO COULD NOT VERIFY THE TRA
CK THAT IT WROTE. THE TRACK
            MAY OR MAY NOT HAVE BEEN CO
PIED SUCCESSFULLY.
ERROR 6   TRACK LENGTH IS DIFFERENT THE
N THE ORIGINAL. THIS ERROR
            ONLY HAPPENS WHEN YOU USE E
NABLE COUNT.  ECHO WILL
            CONTINUE TO WRITE THE TRACK
 UNTIL THE LENGTHS ARE THE
            SAME.
ERROR 7:  ECHO COULDN'T SYNC THE TRACK.


SPECIAL FEATURES
------- --------
PHASE FINDER
   DEFINITION: DISPLAYS A 0 IF IT'S A W
HOLE TRACK AND A 1 IF IT'S A
   HALF. THIS IS ONLY A STATISTICAL E
VALUATION AND MAY BE UNRELIABLE.
SYNC MODE
   DEFINITION: SYNCS THE DISK. IF YOU G
ET EITHER AN ERROR 2 OR AN
   ERROR 7 THEN ECHO 1.0 CAN'T SYNC THE
 TRACK.
COUNT MODE
   DEFINITION: ENABLES NIBBLE COUNING. 
TRY NOT TO NIBBLE COUNT UNLESS
   ALL ELSE FAILS.
LENGTH KILL
   DEFINITION: IF THE FRAME BITS PARA
METER IS SET TO 0 THEN THE
   LENGTH KILL FEATURE IS IN EFFECT.  T
HIS SHOULD ONLY BE USED IF YOU
   CANNOT OVERCOME THE ERROR 5'S.
EXIT
   DEFINITION: IF YOU TYPE THE ESC KEY 
FROM ALMOST ANYWHERE IN THE
   PROGRAM IT WILL RETURN YOU TO THE CH
ANGE PARAMETER MODE.
.NP
TROUBLE SHOOTING
------- --------
ERROR 0'S:   IF THE COPY DOESN'T WORK T
RY SYNC OR NIBBLE COUNT.  IF
               IT STILL DOESN'T WORK TR
Y 0 OR 2 FRAME BITS.

ERROR 1'S:   TRY READING AGAIN. IF IT H
APPENS AGAIN TRY ANOTHER
               COPIER.  THIS ERROR IS R
ARE.

ERROR 2'S:   TRY A FEW TIMES - THE CO
PY MAY STILL WORK.

ERROR 3'S:   IF YOU GET THESE GET ANOTH
ER COPY OF ECHO. 

ERROR 4'S:   THE TARGET DISK IS WRITE P
ROTECTED.

ERROR 5'S:   TRY SEVERAL TIMES OR SET
 FRAME BITS TO 0.

ERROR 6'S:   IF THE TRACK LENGTH NEVER 
GETS TO 0 TRY SETTING FRAME
               BITS TO 2 AND TRY AGAIN.

ERROR 7'S:   TRY COPYING TRACK 0 PHASE 
0 FIRST.  IF ALL ELSE FAILS
               DON'T SYNC THE TRACK.