Brotikasten/BROTCD01.iso/cpm/22nice/lnk128.sda/XLINK.DOC

Text File | 1994-07-25 | 15KB | 281 lines

                             ├╥╧╙╙ ╠╔╬╦ 2.1

                   FOR ╔┬═-╨├ <> ├-128 FILE TRANSFERS

                  <C> BY ═. ╟ARAMSZEGHY  86-04-15
                         (REV 1: 86-06-01)

                        67 ├ALLENDER ╙TREET
                          ╘ORONTO ╧NTARIO
                           ├┴╬┴─┴ ═6╥ 2╚2


                        ****╨╠┼┴╙┼ ╬╧╘┼****


            ╨ERMISSION IS HEREBY GRANTED TO REPRODUCE THIS PROGRAM
            AND DOCUMENTATION FILE FOR PERSONAL USE ONLY.  ╘HIS
            MATERIAL IS ╬╧╘ ╞╧╥ ╙┴╠┼ UNDER ANY CIRCUMSTANCES!!
            ╔ ENCOURAGE COPYING AND DISTRIBUTION, SUBJECT TO
            THE ABOVE RESTRICTIONS.  ╨LEASE ADDRESS ALL COMMENTS,
            SUGGESTIONS, ETC TO ME AT THE ABOVE ADDRESS OR
            AT THE ╘╨╒╟ ┬┬╙ [phone] [╨UNTERNET ╬ODE 2]


├╥╧╙╙ ╠╔╬╦ IS A SHORT ┬┴╙╔├ 7 PROGRAM FOR USE ON THE ├-128 WITH A
1571 DRIVE.  ╔T ALLOWS YOU TO READ A FILE INTO A 45 K ╥┴═ BUFFER FROM ANY ONE
OF THE FOLLOWING SEVEN DISK FORMATS:

    ╙┼╤ - ┴╙├╔╔
    ╙┼╤ - WITH ╨┼╘╙├╔╔ <> ┴╙├╔╔ CONVERSION
    ╨╥╟ - ┴╙├╔╔
    ╨╥╟ - WITH SCREEN CODE <> ┴╙├╔╔ CONVERSION
    ├-128 ├╨/═ SINGLE SIDED
    ├-128 ├╨/═ DOUBLE SIDED
    ╔┬═ ╨├-─╧╙ DOUBLE SIDED, 9 SECTORS/TRACK

╘HE BUFFER CAN THEN BE WRITTEN TO ANOTHER DISK IN ANY OF THE SAME LIST OF
FORMATS OR TO A PRINTER.  (╔T SHOULD BE NOTED THAT THE ╔┬═ ╨├-─╧╙ DOUBLE
SIDED FORMAT IS ╬╧╘ THE SAME AS THE "╔┬═-─╙" WHICH IS SUPPORTED BY ├-128 ├╨/═
MODE.  ╘HE LATTER FORMAT IS USED BY ├╨/═-86 WHICH IS THE 16 BIT VERSION OF
├╨/═ DESIGNED TO RUN ON THE ╔┬═-╨├ INSTEAD OF ╨├-─╧╙.  ╨├-─╧╙ AND ├╨/═-86
ARE NOT COMPATIBLE.)  ├╥╧╙╙ ╠╔╬╦ IS SIMPLE TO USE, JUST FOLLOW THE PROMPTS ON
THE SCREEN.  ╧NE WORD OF CAUTION, HOWEVER.  ┬ECAUSE THE 1571 IS NOT A TRUE
╨├-─╧╙ DISK DRIVE, NEVER WRITE ╨├-─╧╙ FILES TO AN ORIGINAL, IRREPLACEABLE
DISK.  ╨LAY IT SAFE, ALWAYS USE SCRATCH DISKS FOR WRITING FILES.  (┴LTHOUGH
╔ HAVE HAD NO PROBLEMS WITH DISKS FROM THREE DIFFERENT ╔┬═-╨├S AND TWO ╨├
COMPATIBLES, THE POSSIBILITY DOES EXIST FOR MIS-MATCHED SECTOR TIMING, ETC.
╘HIS COULD HOPELESSLY CORRUPT THE DISK BEING WRITTEN TO.)

├╥╧╙╙ ╠╔╬╦ USES BURST MODE ON THE 1571 TO READ AND WRITE ╨├-─╧╙ AND ├╨/═
FILES, CONSEQUENTLY IT IS QUITE FAST.  (┴ DETAILED DESCRIPTION OF 1571
BURST MODE AND HOW TO USE IT IS PRESENTED IN A SERIES OF ARTICLES BY
THIS AUTHOR IN ╘╨╒╟ MAGAZINE, STARTING IN ═AY 1986.)  ┴ TYPICAL CONVERSION
OF A 16K (65 ╙┼╤ BLOCK) TEXT FILE FROM ╙┼╤ ╨┼╘╙├╔╔ TO ╨├-─╧╙ TAKES ABOUT
65 SECONDS, INCLUDING ABOUT 25 SECONDS OF "OVERHEAD" REQUIRED TO
DECODE AND RECODE THE ╨├-─╧╙ DIRECTORY AND FILE ALLOCATION TABLE (╞┴╘).
╬OTICE THAT ╔ SPECIFY THE CONVERSION OF A TEXT FILE.  ╘HIS BRINGS UP A
GENERAL CAVEAT: PROGRAM FILES WRITTEN TO RUN UNDER ╨├-─╧╙ (I.E. WITH A FILE
TYPE OF .┼╪┼ OR .├╧═) WILL NOT WORK IN ├-128 MODE OR ├╨/═ MODE (THE ├╨/═
EXECUTABLE FILE ALSO HAS A FILE TYPE OF .├╧═, BUT THE TWO ARE NOT
INTERCHANGEABLE) OR VICE VERSA.  ╚OWEVER, IF YOU DOWNLOAD A ├╨/═ PROGRAM TO
A ╨├-─╧╙ DISK AND THEN CONVERT THE FILE TO ├╨/═ FORMAT, THE PROGRAM WILL
WORK IN ├╨/═ MODE ON THE ├-128.  ╘HIS IS USEFUL, FOR EXAMPLE, IF YOU DO NOT
HAVE A MODEM ON YOUR ├-128 BUT HAVE ACCESS TO ONE ON AN ╔┬═-╨├ WHERE YOU
WORK.  ╘HE SAME GOES FOR DOWNLOADING TO A ├-128 PROGRAM TO ╨├-─╧╙ THEN
CONVERTING TO A ╨╥╟ ┴╙├╔╔ FILE OR DOWNLOADING TO ╙┼╤ FORMAT IN ├-128
MODE AND THEN CONVERTING TO ├╨/═ FORMAT.  (╘HE ORIGINAL ├╨/═ SYSTEM FILES
FOR THE ├-128 DID NOT SUPPORT A MODEM.  ╘HE UPGRADED VERSION NOW DOES.)
╘EXT AND DATA FILES, ON THE OTHER HAND, FROM ONE MACHINE CAN USUALLY BE
USED WITHOUT TROUBLE ON THE OTHER.  ╘EXT FILES TRANSFERRED USING SCREEN
CODE ╨╥╟ FILES MAY REQUIRE REFORMATTING ON THE TARGET WORD PROCESSOR.
╙CREEN CODE FILES WRITTEN BY ├╥╧╙╙ ╠╔╬╦ MAY NOT WORK WITH ALL ├-128
WORD PROCESSORS.  ╙OME WP'S, SUCH AS ╨APERBACK ╫RITER 128, INCLUDE A
HEADER BLOCK AT THE BEGINNING OF THE FILE.  ╘HE HEADER CONTAINS INFO
ON THE FILE CHARACTERISTICS SUCH AS MARGINS ETC.  ╔F IT IS NOT PRESENT,
THE WP MAY NOT BE ABLE TO READ THE FILE CORRECTLY.  ╘HESE WP'S CAN
USUALLY READ ╙┼╤ FILES AS WELL, HOWEVER, SO IT IS BETTER TO WRITE
A ╙┼╤ FILE WITH ├╥╧╙╙ ╠╔╬╦ FOR USE ON MOST WP'S.  ├╥╧╙╙ ╠╔╬╦ CAN
READ ╨╥╟ TEXT FILES WITH HEADERS, BUT YOU MUST DELETE THE HEADER BLOCK
WITH THE TARGET WP.   ┬┴╙╔├ PROGRAM LISTINGS CREATED ON ONE MACHINE
CAN OFTEN BE USED ON ANOTHER WITH ONLY MINOR EDITING.  ├-128 ┬┴╙╔├ 7.0,
├╨/═ ═┬┴╙╔├ AND ╔┬═-╨├ ┬┴╙╔├, AS WELL AS MOST OTHER TYPES OF ┬┴╙╔├,  ARE
ALL VERSIONS OF ═ICROSOFT ┬┴╙╔├, THUS THE COMMANDS AND SYNTAX ARE VERY
SIMILAR.  ╘O TRANSFER THE LISTINGS FROM ONE MACHINE TO ANOTHER, THE
PROGRAM MUST BE FIRST SAVED AS AN ┴╙├╔╔ TEXT FILE ON THE ORIGINAL MACHINE.
(╘HE TOKENIZED PROGRAMS FOR THE VARIOUS ┬┴╙╔├S ARE NOT COMPATIBLE IN
BOTH FORMAT AND KEYWORD TOKENS.)  ╔N ╔┬═ AND ├╨/═ ┬┴╙╔├, THIS IS DONE
BY APPENDING AN ",┴" TO THE END OF THE ╙┴╓┼ STATEMENT:

      ╙┴╓┼ "FILENAME",┴

╔N ├-128 ┬┴╙╔├ 7.0, IT IS DONE USING THE FOLLOWING SEQUENCE OF STEPS
IN DIRECT MODE:

     ╧╨┼╬ 8,8,8,"0:FILENAME,S,W"
     ├═─8:╠╔╙╘
     ╨╥╔╬╘#8:├╠╧╙┼8

╘HIS FILE SHOULD BE READ IN BY ├╥╧╙╙ ╠╔╬╦ AS A ╙┼╤-╨┼╘╙├╔╔ FILE.
╬ON STANDARD CHARACTER CODES EMBEDDED IN PROGRAM TEXT (SUCH AS COLOR
CODES, REVERSE VIDEO AND CURSOR CONTROLS) SHOULD BE EDITED OUT, EITHER
BEFORE OR AFTER CONVERSION, BECAUSE THEY MAY CAUSE ╔┬═ AND ├╨/═ ┬┴╙╔├
TO BEHAVE IN ODD MANNERS.  ╘O LOAD AN ┴╙├╔╔ FILE WITH ╔┬═ OR ├╨/═ ┬┴╙╔├,
THE NORMAL ╠╧┴─"FILENAME" COMMAND IS USED.  ┴ ╙┼╤ TEXT FILE CAN ALSO
BE LOADED AS A PROGRAM ON THE ├-128.  ╘HIS IS DONE IN THE FOLLOWING
MANNER (MANY THANKS TO COLLEAGUE ╩IM ┬UTTERFIELD FOR DEMONSTRATING
THIS TRICK TO ME):

     ─╧╨┼╬ #1,"FILENAME"
     ╙┘╙ 65478,0,1
     ─├╠╧╙┼

(╔NCIDENTALLY, THIS IS NO MAGICAL ╥╧═ ROUTINE, BUT THE NORMAL ╦┼╥╬┴╠
├╚╦╔╬ FUNCTION AT HEX $╞╞├6 WHICH HAS BEEN ENHANCED ON THE 128.)
╘HE FILE TO BE READ IN SHOULD BE SAVED AS A ╙┼╤-┴╙├╔╔ FILE WITH ├╥╧╙╙
LINK.  ╘HIS ROUTINE READS IN THE TEXT FILE LISTING AND CONVERTS IT TO A
PROGRAM, JUST AS IF YOU HAD ENTERED EACH LINE DIRECTLY FROM THE KEYBOARD.
┬ECAUSE OF THIS, IT WILL NOT ERASE THE PROGRAM CURRENTLY IN MEMORY.  ╘HE
NEW PROGRAM WILL BE MERGED WITH ANY THAT IS CURRENTLY IN MEMORY.  ╔T
CAN THEREFORE ALSO BE USED TO MERGE TWO OR MORE ├-128 PROGRAMS.  ┘OU
MAY GET A "SYNTAX ERROR" OR "OUT OF DATA" MESSAGE AFTER THE PROGRAM
LISTING HAS BEEN READ IN.  ╘HIS IS CAUSED BY ANY EXTRANEOUS TEXT WHICH
MAY BE INCLUDED AT THE END OF THE LISTING FILE.  ╬ORMALLY, HOWEVER, IT
HAS NO EFFECT ON THE LOADING OF THE PROGRAM.  ╘HE FORMAT OF THE ┬┴╙╔├
LISTING IS IMPORTANT FOR FILES TO BE USED WITH ╔┬═ OR ├╨/═ ┬┴╙╔├.  ├-128
┬┴╙╔├ 7.0 DOES NOT REQUIRE SPACES BETWEEN KEYWORDS AND ARGUMENTS, WHILE
BOTH ╔┬═ AND ├╨/═ ┬┴╙╔├ DO.  ╞OR EXAMPLE, THE STATEMENT:

     10 ╞╧╥╔=1╘╧10

IS LEGITIMATE IN ┬┴╙╔├ 7.0.  ╞OR ╔┬═ AND ├╨/═ ┬┴╙╔├ IT MUST BE CHANGED
TO:

     10 ╞╧╥ ╔=1 ╘╧ 10

╔T IS ALSO IMPORTANT TO REMEMBER THAT THE NUMBER OF SIGNIFICANT CHARACTERS
IN ┬┴╙╔├ 7.0 VARIABLE NAMES IS LIMITED TO 2, WHILE BOTH ╔┬═ AND ├╨/═
┬┴╙╔├ HAVE NO SUCH RESTRICTION.  ╓┴╥╔┴┬╠┼1 AND ╓┴╠╒┼2 ARE DISTINCT
VARIABLE NAMES IN ╔┬═ AND ├╨/═ ┬┴╙╔├, WHILE IN ┬┴╙╔├ 7.0, THEY ARE BOTH
EQUIVALENT TO "╓┴".


╘HE MACHINE LANGUAGE PORTION OF THE PROGRAM IS A FILE NAMED "╪╠.═╠3" WHICH IS
AUTOMATICALLY LOADED BY THE MAIN PROGRAM.  ╘HE ═╠ ROUTINE, WHICH IS LOCATED
IN THE CASSETTE AND ╥╙ 232 BUFFERS, CONTAINS SEVERAL ENTRY POINTS.  ╘HESE
ARE:

    HEX     DEC               FUNCTION

   0B69    2921              BURST SECTOR READ (FOR ├╨/═ AND ╨├-─╧╙)
   0B9C    2972              READ ╙┼╤ OR ╨╥╟ FILE, NO CONVERT
   0BD0    3024              WRITE ╙┼╤, ╨╥╟ FILE OR PRINTER, NO CONVERT
   0C02    3074              BURST SECTOR WRITE (FOR ├╨/═ AND ╨├-─╧╙)
   0C45    3141              WRITE ╙┼╤ OR PRINTER , CONVERT ┴╙├╔╔ TO ╨┼╘╙├╔╔
   0CE0    3296              READ ╙┼╤ FILE, CONVERT ╨┼╘╙├╔╔ TO ┴╙├╔╔
   0D7D    3453              READ ╨╥╟ FILE, CONVERT SCREEN CODE TO ┴╙├╔╔
   0DDF    3551              WRITE ╨╥╟ FILE, CONVERT ┴╙├╔╔ TO SCREEN

╔F YOU ARE INTERESTED, YOU CAN DISASSEMBLE THE MACHINE LANGUAGE WITH
THE ├-128'S BUILT IN MONITOR.


┴S YOU CAN SEE, THERE ARE NO ╥┼═ STATEMENTS IN THE MAIN ┬┴╙╔├ PROGRAM.