home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64Telecom / HIGGYTERM-DOCUMENT-(ORIG < prev    next >
Text File  |  2019-04-13  |  32KB  |  1,317 lines
  1. "
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. "            64TERM - A smart terminal program for the Commodore-64.
  23.  
  24.  
  25.  
  26.  
  27. "                Author of program and manual: Paul Higginbottom.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. "    Preliminary TERM-64 manual                                     Page...2
  68.  
  69.  
  70. "                                   Contents:
  71.  
  72. "    Section    Description                              Page
  73. "    --------------------------------------------------------
  74. "       1.      Getting started                            XX
  75. "       2.      The tools                                  XX
  76. "       3.      Terminal mode                              XX
  77. "       4.      The status line                            XX
  78. "       5.      Disk directory                             XX
  79. "       6.      Examine/alter protocols                    XX
  80. "       7.      Print file/buffer to screen/printer        XX
  81. "       8.      Examine/alter function keys                XX
  82. "       9.      Load or save parameters                    XX
  83. "      10.      Send a file to the modem                   XX
  84. "      11.      Save memory buffer                         XX
  85. "      12.      Exit program                               XX
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. "    8/2/83                                            By Paul Higginbottom
  128.  
  129.  
  130.  
  131.  
  132.  
  133. "    Preliminary TERM-64 manual                                     Page...3
  134.  
  135.  
  136. "                                Getting started
  137.  
  138. "    To make sure no previous programs, or programming of your  Commodore-64
  139. "    will affect the running of this program, turn the computer OFF,  if  it
  140. "    is currently on.
  141. "
  142. "    Now turn ON the computer and your  disk  unit,  and  with  the  program
  143. "    diskette in the drive, type:
  144. "
  145. "    LOAD'TERM64',8,1
  146. "
  147. "    and press RETURN.
  148. "
  149. "    The program will automatically run;  the  screen  will  go  blank,  and
  150. "    shortly, the menu will appear as follows:
  151. "
  152. "    ---------------------------------------
  153. "    Smart Terminal Program
  154. "    By Paul Higginbottom
  155. "
  156. "    (c)1983 Commodore Business Machines Ltd.
  157. "
  158. "
  159. "    1. Enter terminal mode
  160. "    2. Disk directory
  161. "    3. Examine/alter protocols
  162. "    4. Print file/buffer to screen/printer
  163. "    5. Examine/alter function keys
  164. "    6. Load or save parameters
  165. "    7. Send file to modem
  166. "    8. Save memory buffer
  167. "    9. Exit program
  168. "
  169. "    Press '1' to '9' to select function
  170. "
  171. "    ---------------------------------------
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. "    8/2/83                                            By Paul Higginbottom
  194.  
  195.  
  196.  
  197.  
  198.  
  199. "    Preliminary TERM-64 manual                                     Page...4
  200.  
  201.  
  202. "    ***********************************
  203. "    *                                 *
  204. "    * NNN  NN    OOO   TTTTTT  EEEEEE *
  205. "    * NNNN NN   OO OO    TT    EE     *
  206. "    * NN NNNN  OO   OO   TT    EEEE   *
  207. "    * NN  NNN   OO OO    TT    EE     *
  208. "    * NN   NN    OOO     TT    EEEEEE *
  209. "    *                                 *
  210. "    ***********************************
  211. "
  212. "    FROM ANY POINT IN THE PROGRAM (#1) TO RETURN TO THE MENU, SIMPLY  PRESS
  213. "    THE 'STOP' KEY.
  214. "
  215. "    (#1 - IN TERMINAL MODE, IT'S  SHIFTED  'STOP'  SO  THAT  IT  CANNOT  BE
  216. "    PRESSED ACCIDENTALLY).
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259. "    8/2/83                                            By Paul Higginbottom
  260.  
  261.  
  262.  
  263.  
  264.  
  265. "    Preliminary TERM-64 manual                                     Page...5
  266.  
  267.  
  268. "                                   The tools
  269.  
  270. "    This section is provided to outline what this program can  do,  and  an
  271. "    overview of how it can be done.
  272. "
  273. "    When using this program, there are 3 forms of interaction you can  have
  274. "    with it. They are:
  275. "
  276. "    1. Menu function selection, and supplying the information for  a  given
  277. "    option.
  278. "
  279. "    2.  Command  function  from  terminal  mode,  to  change  a  'mode'  of
  280. "    operation.
  281. "
  282. "    3. Interaction with another computer.
  283. "
  284. "    The menu shows you the options available to you, but provided below  is
  285. "    a wider explanation of each option:
  286. "
  287. "    1. Enter terminal mode - This puts you in a communications environment,
  288. "    wherein, each  character  you  type  will  be  transmitted  to  another
  289. "    computer, and each character sent to you, by the other computer you are
  290. "    communicating with, will be displayed on  your  screen.    In  terminal
  291. "    mode, the screen displays a status line (the tope line of  the  screen)
  292. "    and the remaining 24 lines of the screen are the  'terminal's  screen.'
  293. "    Certain key combinations will alter the various status 'indicators'  on
  294. "    the status line.
  295. "
  296. "    These key functions allow you to modify the terminal  environment  (for
  297. "    example,  enabling  'word-wrap'   which   commands   the   program   to
  298. "    automatically avoid words  being  split  at  the  end  of  a  line,  by
  299. "    'pushing' them onto the next line.)
  300. "
  301. "    2. Disk directory - This will display the directory of the diskette  in
  302. "    the drive which you would usually see by doing:
  303. "
  304. "    LOAD'$',8
  305. "
  306. "    LIST
  307. "
  308. "    3. Examine/alter protocols - This option allows you to examine,  and/or
  309. "    alter the communications protocols required for the  particular  modem,
  310. "    and/or remote computer.  An example of a  'protocol'  is  'baud  rate',
  311. "    which is the speed at which data is transfered between  the  computers'
  312. "    modems.  Most inexpensive modems are '300 baud'  which  is  a  transfer
  313. "    rate of roughly 30 characters per second.
  314. "
  315. "    4. Print a file/buffer to screen/printer - This allows you  to  display
  316. "    on the screen or print  on  the  printer,  the  text  captured  in  the
  317. "    computers memory with this program, or a file on the disk.
  318. "
  319. "    5. Examine/alter function keys - The Commodore 64 has 4 function  keys.
  320. "    This package allows you to make them send to another computer,  one  or
  321.  
  322.  
  323.  
  324.  
  325. "    8/2/83                                            By Paul Higginbottom
  326.  
  327.  
  328.  
  329.  
  330.  
  331. "    Preliminary TERM-64 manual                                     Page...6
  332.  
  333.  
  334. "    more character(s) by just one single keypress.  For example, most  data
  335. "    bases have a 'HELP' command.  You might want to have one key press send
  336. "    'HELP' and a <RETURN> to  the  remote  computer.   Or,  similarly,  any
  337. "    frequently used command/string of text can  be  assigned  to  a  single
  338. "    keypress.
  339. "
  340. "    6.  Load  or  save  parameters  -  The  protocols,  the  function   key
  341. "    definitions, and even the screen, text,  and  border  colours,  may  be
  342. "    loaded or saved as a 'parameter file' on  disk.   This  is  useful  for
  343. "    communicating with different systems,  with  differing  protocols,  and
  344. "    commonly used commands which you have defined in the function keys.  An
  345. "    example of two parameter files might be 'Source' and 'Compuserve.'
  346. "
  347. "    7. Send file to modem - This is a simple file transfer option.  A  file
  348. "    on the diskette in the drive can be transmitted to the remote computer.
  349. "    This for example, could be used to send  electronic  mail  prepared  on
  350. "    your computer when you weren't communicating with the remote computer.
  351. "
  352. "    8. Save memory buffer - This option allows you to save the text  stored
  353. "    in the computers memory in a file on the disk drive.
  354. "
  355. "    9. Exit program - This option will reset the computer, as  if  it  were
  356. "    turned off and on again.
  357. "
  358. "    Technical note:
  359. "
  360. "    This program is designed for communicating via the RS-232 port  of  the
  361. "    Commodore-64 (an edge connector, which will require suitable cable,  or
  362. "    a VIC1011A adaptor) to another computer, or modem, at speeds from 50 to
  363. "    2400 baud.  Since the  Commodore-64  has  only  one  RS-232  port,  the
  364. "    program assumes the printer is connected to  the  CBM  serial  port  as
  365. "    device 4, or some other interface cartridge which intercepts the KERNAL
  366. "    functions (for example, RTC's 64-LINK cartridge, which allows any  IEEE
  367. "    printers to be connected to the Commodore-64.  This program  will  work
  368. "    with that cartridge installed.)
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391. "    8/2/83                                            By Paul Higginbottom
  392.  
  393.  
  394.  
  395.  
  396.  
  397. "    Preliminary TERM-64 manual                                     Page...7
  398.  
  399.  
  400. "                     Terminal mode (option 1 from the menu)
  401. "
  402. "    Pressing '1' from the menu puts you in 'terminal  mode'  which  is  the
  403. "    environment where ALL communicating with another,  remote  computer  is
  404. "    done.
  405. "
  406. "    A status line is shown on the top line of the screen.  It  should  look
  407. "    like:
  408. "
  409. "        :T:S:O:W:D:B:-12:00:00-42000:0:000:000:
  410. "         ! ! ! ! ! !       !       ! !   !   !--Character code
  411. "      Status Indicators    !       ! !   !      received
  412. "                           !       ! !   !
  413. "          Clock------------!       ! !   !------Character code sent
  414. "                                   ! !
  415. "          Free memory in buffer----! !----------No. nulls to be sent
  416. "                                                after a carriage return
  417. "
  418. "
  419. "    T - (The 'timeout' indicator) When you transmit characters to a  remote
  420. "    computer, usually by typing, the usual environment of communications is
  421. "    known as 'full duplex' which simply  means  that  the  [larger]  remote
  422. "    computer will send back to the Commodore-64 each character you send  to
  423. "    it.  This indicator will 'light up' (go into inverse video) if, when in
  424. "    full duplex, a character you transmit is not sent back  by  the  remote
  425. "    computer within a short time.
  426. "
  427. "    S  -  (The  ALLCAPS  mode  indicator)  The   shiftlock   key   on   the
  428. "    Commodore-64's keyboard is not always useful for  entering  upper  case
  429. "    text, because it will shift the numerics and all other keys also, so an
  430. "    'ALLCAPS' mode is provided for simply  ensuring  all  alpha  characters
  431. "    ('a' to 'z') transmitted are sent in UPPER case regardless  of  whether
  432. "    the shift key is depressed.  This mode can be  turned  on  and  off  by
  433. "    holding down the Commodore key and pressing 's'.
  434. "
  435. "    O - (The OUTPUT-SUPPRESSED mode indicator) When lit, the user's  output
  436. "    will not be displayed (in either half or full duplex).  This is  useful
  437. "    for not allowing other people to see you entering passwords  on  remote
  438. "    computer systems, for example.  The indicator can be turned on and  off
  439. "    by holding down the Commodore key and pressing 's'.
  440. "
  441. "    W - (The WORD-WRAP mode indicator) Since the Commodore-64  can  display
  442. "    40 characters on a line, instead of 80 (or even 132)  columns  as  most
  443. "    commercially used terminals can, words may get  'split'  at  the  right
  444. "    hand side of your screen (for example, the word  'Commodore'  beginning
  445. "    in the 35th column, and 'Commo' is on that line, and 'dore' ends up  at
  446. "    the start of the next line).  When the WORD-WRAP indicator is lit,  the
  447. "    program will automatically ensure that no words are split at the end of
  448. "    a line.  It does this by pushing the word onto  the  next  line  if  it
  449. "    won't fit on the current line.  Word-wrap mode can be turned on and off
  450. "    by holding down the Commodore key and pressing 'w'.
  451. "
  452. "    D - (The DISPLAY-CONTROL-CHARACTERS mode indicator) It  is  most  often
  453.  
  454.  
  455.  
  456.  
  457. "    8/2/83                                            By Paul Higginbottom
  458.  
  459.  
  460.  
  461.  
  462.  
  463. "    Preliminary TERM-64 manual                                     Page...8
  464.  
  465.  
  466. "    not necessary to see the incoming control characters (character codes 0
  467. "    through 31 decimal, excluding  certain  ones,  for  example,  'Carriage
  468. "    Return', which is 13), but in case the user does wish to see them,  the
  469. "    program  allows  for  this.   Control  characters  will  be  shown   as
  470. "    highlighted  characters  on  the  screen,  from   '@'   to   'Z'.    To
  471. "    enable/disable this mode, hold down the Commodore key and press 'd'.
  472. "
  473. "    B - (The BUFFER-OPEN/CLOSED mode indicator) Any text which is displayed
  474. "    can be stored in the memory of the Commodore-64, for later viewing,  or
  475. "    hardcopy on the printer, or even storing to the disk in a  file.   This
  476. "    ability is known as a 'memory buffer' because the  text  is  'buffered'
  477. "    for later usage.  The five digit number on the  status  line  indicates
  478. "    how much memory is left for text to be stored.  The text  is  only  put
  479. "    into the memory buffer if the indicator is lit,  which  allows  you  to
  480. "    selectively store  information  (for  example,  news  stories  or  only
  481. "    certain stock information).  To  start  or  stop  the  program  storing
  482. "    incoming text in the memory buffer, hold down the  Commodore  key,  and
  483. "    press 'b'.  If you  wish  to  'clear  out'  the  memory  buffer,  i.e.,
  484. "    instruct the computer to 'forget' all  it  has  stored  for  you,  thus
  485. "    makinng available all the memory again, hold down either shift key, and
  486. "    press '*'.
  487. "
  488. "    For quick temporary storage of, for example, an address, or other piece
  489. "    of information you quickly want to capture, but you  didn't  have  your
  490. "    memory buffer open, hold down the Commodore key, and press  'x'.   This
  491. "    swaps the screens contents with a SECOND screen.   Pressing  'Commodore
  492. "    X' again, will bring back the 'first' screen again.
  493. "
  494. "    The clock - functions like a normal clock; can be used to inform you of
  495. "    connect time on a system, or give you the actual time.  Can be reset to
  496. "    00:00:00 by holding down the Commodore key and pressing 't', or set  to
  497. "    a given time from the Examine/alter protocols option (3) from the menu.
  498. "
  499. "    Summary of keyboard 'functions' in terminal mode:
  500. "    <SHIFT *> - Clear memory buffer
  501. "    <Commodore S> - Enable/disable ALL CAPITALS mode
  502. "    <Commodore O> - Enable/disable displaying of your typing for privacy
  503. "    <Commodore W> - Enable/disable automatic formatting of the end of  each
  504. "    line
  505. "    <Commodore D> - Enable/disable display  of  control  characters  (ASCII
  506. "    0-26)
  507. "    <Commodore B> - Enable/disable memory capture of displayed text
  508. "    <Commodore P> - Reset buffer pointer without clearing buffer
  509. "    <Commodore C> - Close disk file when sending a file from disk
  510. "    <Commodore +> - Change background colour of the screen
  511. "    <Commodore -> - Change colour of text
  512. "    <Commodore *> - Change border colour
  513. "    <left arrow> is displayed as an underscore on  the  screen  (consistent
  514. "    with 'most' terminals).
  515. "    <CTRL L> If received, acts as a 'form feed' and clears the screen
  516. "    <CTRL :> Generates an ESC (ASCII 27) character
  517. "    <Commodore X> Swap screen with second stored, screen.
  518. "    <CTRL +> Increase the number of nulls to be sent after a
  519.  
  520.  
  521.  
  522.  
  523. "    8/2/83                                            By Paul Higginbottom
  524.  
  525.  
  526.  
  527.  
  528.  
  529. "    Preliminary TERM-64 manual                                     Page...9
  530.  
  531.  
  532. "              carriage return (maximum 9)
  533. "    <CTRL -> Decrease the number of nulls to be sent after a
  534. "              carriage return (minimum 0)
  535. "    <shifted DEL> - Generates ASCII DELETE character (value 127)
  536. "    <Commodore T> - Resets clock to 0:00:00
  537. "
  538. "    The function keys send strings as designated:
  539. "
  540. "    Unshifted..............<F01>/<F03>/<F05>/<F07>
  541. "    Shifted................<F02>/<F04>/<F06>/<F08>
  542. "    Commodore..............<F09>/<F10>/<F11>/<F12>
  543. "    CTRL...................<F13>/<F14>/<F15>/<F16>
  544. "
  545. "    Local editing mode
  546. "
  547. "    This terminal program gives you to do full screen editing  (as  you  do
  548. "    when correcting mistakes, when  entering  a  program),  even  when  the
  549. "    computer you are communicating with, does not support such a function.
  550. "
  551. "    If RETURN is pressed while either shift key is  held  down  is  entered
  552. "    when in  terminal  mode,  the  cursor  will  flash  (instead  of  being
  553. "    'solid').  Incoming text will still be output to the screen as  normal,
  554. "    but further typing by  the  user  is  NOT  transmitted  to  the  remote
  555. "    computer.  At this point, you can use the  CURSOR  MOVEMENT  KEYS  (up,
  556. "    down, left and right), the INSert key, the DELete key, the HOME and CLR
  557. "    keys, and in fact, EVERY key to edit and enter text  onto  the  screen.
  558. "    When you want to send a line of text, you simply position the cursor on
  559. "    the first character to be sent, and  enter  another  <SHIFTED  RETURN>.
  560. "    The program will then enter all characters from that point  on  on  the
  561. "    screen line, and also transmit a RETURN.
  562. "
  563. "    'What can I use that for?' you say.  Let's take a look  at  an  example
  564. "    usage of this feature:
  565. "
  566. "    Let us suppose the computer you are communicating with is awaiting your
  567. "    command.  You want to send a letter to another user, and you enter  the
  568. "    command:
  569. "
  570. "    MAIL SEND JOHN EXPRESS
  571. "
  572. "    The system responds with:
  573. "
  574. "    User 'JOHN' not found.
  575. "    Re-enter:
  576. "
  577. "    And you realise that you entered the NAME of the  user  you  wished  to
  578. "    send mail to  instead  of  their  computer  account  'ID',  which  this
  579. "    particular system requires.  You no longer have to type this command in
  580. "    all over again, you simply enter 'local editing mode' by  holding  down
  581. "    the shift and pressing RETURN.  The cursor  should  be  flashing.   You
  582. "    move the cursor up using the  cursor  movement  keys  and  correct  the
  583. "    mistake:
  584. "
  585.  
  586.  
  587.  
  588.  
  589. "    8/2/83                                            By Paul Higginbottom
  590.  
  591.  
  592.  
  593.  
  594.  
  595. "    Preliminary TERM-64 manual                                    Page...10
  596.  
  597.  
  598. "    MAIL SEND XYZ999 EXPRESS
  599. "
  600. "    To send the whole line again, you simply position the cursor on the 'M'
  601. "    in 'MAIL' (often easiest by pressing return, and  then  cursor  up,  if
  602. "    you're on the same line as the line you wish to send), and  then  press
  603. "    return while holding down the shift again, and   you'll  see  the  line
  604. "    re-entered for you.
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655. "    8/2/83                                            By Paul Higginbottom
  656.  
  657.  
  658.  
  659.  
  660.  
  661. "    Preliminary TERM-64 manual                                    Page...11
  662.  
  663.  
  664. "                    Disk directory (option 2 from the menu)
  665. "
  666. "    As soon as you press '2' from the menu, the screen will clear, and  the
  667. "    directory will be listed onto the screen.  As it is listed, any key can
  668. "    be pressed to stop and resume the listing,  and  if  the  STOP  key  is
  669. "    pressed at any time, the listing will terminate.
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721. "    8/2/83                                            By Paul Higginbottom
  722.  
  723.  
  724.  
  725.  
  726.  
  727. "    Preliminary TERM-64 manual                                    Page...12
  728.  
  729.  
  730. "                Examine/alter protocols (option 3 from the menu)
  731. "
  732. "    When the program is run, the RS232 and terminal parameters are  set  to
  733. "    defaults which are suitable for practically all terminal  work  at  300
  734. "    baud, which includes the VICMODEM.
  735. "
  736. "    When 3 is pressed from the menu, the current protocols  are  displayed.
  737. "    To alter them, simply press the numeric key  alongisde  the  particular
  738. "    protocol.  For example, to change duplex, press '1'.  When  you've  set
  739. "    them to your particular requirements, pressing the STOP key will return
  740. "    you to the menu.
  741. "
  742. "    The protocols are:
  743. "
  744. "    '1' - Duplex - alternatives - Half, or  Full.   In  half  duplex,  each
  745. "    character transmitted by your computer is displayed by the  program  on
  746. "    the screen.  In full duplex, the program expects the remote computer to
  747. "    send each character back which your computer sends to it.   Almost  all
  748. "    commercial networks operate in full duplex.  If, for example, you  want
  749. "    to communicate with another FPZZPZ(64 though,  both  you,  and  your
  750. "    remote telecomputing partner would need to operate in half duplex.
  751. "
  752. "    '2' - Line feed - alternatives - Yes, or  No.   After  you  transmit  a
  753. "    carriage return, some networks require a linefeed  also.   This  option
  754. "    allows you the alternative of having a  line  feed  sent  automatically
  755. "    after a return, or not.  This is becoming less likely  though,  and  in
  756. "    most operation, you would have the option set to 'No'.
  757. "
  758. "    '3' - Stop bits  -  alternatives  -  1,  or  2.   The  RS232  interface
  759. "    separates each character of information with 1 or 2  stop  'pauses'  or
  760. "    bits.  Sometimes, more often with 1200 baud, you might need to send  2,
  761. "    instead of the far more usual 1.
  762. "
  763. "    '4' - Parity - alternatives - None, Even, Odd,  Space,  or  Mark.   The
  764. "    RS232 interface can mark the end of each character, with an extra piece
  765. "    of information  (known as a 'parity bit'), which gives either computer,
  766. "    a slightly more secure way of ensuring  good  data  transmission.   You
  767. "    would  have  to  investigate  which  parity  the   computer   you   are
  768. "    communicating with requires.  Most systems don't require any parity, or
  769. "    just ignore it.
  770. "
  771. "    '5' - Baud rate - alternatives - 110, 150, 300,  600,  1200,  1800,  or
  772. "    2400.  The  RS232  interface  can  transmit  information  at  different
  773. "    speeds.  This will need to be set according to your modem,  and/or  the
  774. "    computer you are communicating with.  300 baud is the most common, with
  775. "    1200 being used for 'high speed' communication usually.
  776. "
  777. "    '6' - Word length - alternatives - 5, 6, 7, or  8  bits.   Some  remote
  778. "    computers ignore, or don't use all of the 8 bits in a  byte.   If,  for
  779. "    example, you set this parameter to 7 bits, the 8th bit will be ignored.
  780. "
  781. "    '7' - Set time - asks for the time you wish to set the clock to  (which
  782. "    is displayed in terminal mode).  The format of the time  you  enter  is
  783.  
  784.  
  785.  
  786.  
  787. "    8/2/83                                            By Paul Higginbottom
  788.  
  789.  
  790.  
  791.  
  792.  
  793. "    Preliminary TERM-64 manual                                    Page...13
  794.  
  795.  
  796. "    checked and if the program doesn't understand what  you  have  entered,
  797. "    the bell will ring, and the time will not be altered.  Do NOT enter  in
  798. "    24 hour format, it's a 12 hour clock.  You can enter just the hours and
  799. "    minutes (the seconds will default to 0), or  you  can  enter  the  full
  800. "    hours, minutes and seconds.  2 digits for each part  must  be  entered,
  801. "    therefore, if the time is five minutes after two, you should enter:
  802. "
  803. "    0205
  804. "
  805. "    or
  806. "
  807. "    020500
  808. "
  809. "    '9' - Return to menu - if pressed, the program  returns  to  the  menu.
  810. "    This can also be achieved at any time by pressing the STOP key.
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853. "    8/2/83                                            By Paul Higginbottom
  854.  
  855.  
  856.  
  857.  
  858.  
  859. "    Preliminary TERM-64 manual                                    Page...14
  860.  
  861.  
  862. "          Print file/buffer to screen/printer (option 4 from the menu)
  863. "
  864. "    This important option, allows you to print, to  either  the  screen  or
  865. "    your printer, the text you captured in the computer's memory buffer, or
  866. "    a disk file.
  867. "
  868. "    When '4' is pressed to select this option, you will be asked:
  869. "
  870. "    Buffer or file?
  871. "    (Press 'B' or 'F')
  872. "
  873. "    As implied, press 'b' if you wish to print whatever text you  may  have
  874. "    stored in your memory buffer, or 'f' for a disk file.
  875. "
  876. "    Having selected 'b' or 'f', you will then be  asked  (the  screen  will
  877. "    clear) if you wish to print to the screen or printer in a similar  'one
  878. "    key' selection.  Press 's' if you just wish to view the  memory  buffer
  879. "    or disk file on the screen, or 'p' if you want to  print  the  text  on
  880. "    your printer.
  881. "
  882. "    If you are printing a disk file (instead of  the  memory  buffer),  you
  883. "    will be asked for the name of the file.  If you enter  a  filename  and
  884. "    the file is not on the diskette in the drive, a bell  will  sound,  and
  885. "    you will be returned to the main menu.
  886. "
  887. "    If you opt to output either the contents of your memory buffer, or  the
  888. "    disk file to your printer, you will then be asked to select  your  type
  889. "    of printer.  Note, the program assumes the printer is connected to  the
  890. "    CBM serial port as device 4, or some other  interface  cartridge  which
  891. "    intercepts the KERNAL functions (for example, RTC's 64-LINK  cartridge,
  892. "    which allows any IEEE printers to be  connected  to  the  Commodore-64.
  893. "    This program will work with that cartridge installed.)
  894. "
  895. "    The program's options include:
  896. "
  897. "    1)1525 (or 1526), 2)Other CBM printer (IEEE printers,  NOT  8300P),  or
  898. "    3)True ASCII printer (other brand of printer or Commodore 8300P).
  899. "
  900. "    While the file/buffer is printing to screen/printer,  any  key  can  be
  901. "    pressed to stop and resume printing, and if the STOP key is pressed  at
  902. "    any time, printing will terminate, and the program will prompt  you  to
  903. "    press any key to return to the menu.
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919. "    8/2/83                                            By Paul Higginbottom
  920.  
  921.  
  922.  
  923.  
  924.  
  925. "    Preliminary TERM-64 manual                                    Page...15
  926.  
  927.  
  928. "              Examine/alter function keys (option 5 from the menu)
  929. "
  930. "    This option allows you to examine or change, the strings of  characters
  931. "    which will  be  sent  by  the  function  keys,  and  function  keys  in
  932. "    conjunction with shift/Commodore/CTRL keys.
  933. "
  934. "    For your own security, a password is  requested  when  this  option  is
  935. "    selected from the menu.  When no parameter file has  been  loaded,  and
  936. "    the password has not been changed, it is defaulted to '64'.
  937. "
  938. "    Having entered the password, you will see a display like:
  939. "
  940. "    ----------------------------------------
  941. "    5. Examine/alter function keys
  942. "    f01='
  943. "    f02='
  944. "    f03='
  945. "    f04='
  946. "    f05='
  947. "    f06='
  948. "    f07='
  949. "    f08='
  950. "    f09='
  951. "    f10='
  952. "    f11='
  953. "    f12='
  954. "    f13='
  955. "    f14='
  956. "    f15='
  957. "    f16='
  958. "    Enter key to change, press 'STOP'
  959. "    for menu, or 'p' to change password.
  960. "    ----------------------------------------
  961. "
  962. "    To alter a string, enter the function  keypress  itself,  for  example,
  963. "    function key string 11 (f11) is entered by holding down  the  Commodore
  964. "    key, and pressing 'f5'.  (For a full list of  the  key  sequences,  see
  965. "    'Summary of keyboard functions' in section  2.)   Having  selected  the
  966. "    string to change, you will be prompted to enter the text string  to  be
  967. "    assigned to that key.  Enter this, for example:
  968. "
  969. "    Enter new text for function key f11
  970. "    >
  971. "
  972. "    You type 'hello', and press RETURN.
  973. "
  974. "    The program then asks if you want a RETURN to be transmitted after  the
  975. "    string when you press the function key, by prompting you with:
  976. "
  977. "    Add a carriage return?
  978. "
  979. "    Enter 'y', or 'n' (yes, or no) as  desired.   For  frequently  executed
  980. "    comman&?!????a?poa???07????????5?????????????9???1?????7?9????i?5??44444???????????????????????                           By Paul Higginbottom
  981.  
  982.  
  983.  
  984.  
  985.  
  986. "    Preliminary TERM-64 manual                                    Page...16
  987.  
  988.  
  989. "    your function key assignments  are  completely  secure,  you  can  even
  990. "    assign your log-in password to remote systems.
  991. "
  992. "    You are then asked if you want the string to be displayed on the screen
  993. "    or not, with the prompt:
  994. "
  995. "    Echo string to screen? (Y/N)
  996. "
  997. "    Enter 'y', or 'n' (yes,  or  no)  as  desired.   If  you  do  not  wish
  998. "    'viewers' watching what  commands  of  text  you  are  sending  to  the
  999. "    computer, such as log-in passwords, you would want  to  press  'n'  for
  1000. "    this option.
  1001. "
  1002. "    The string is then displayed in its place in the  definitions,  and  if
  1003. "    you chose for the string not to be echoed  to  the  screen,  there  are
  1004. "    small 'blocks' around the assignment.
  1005. "
  1006. "    If you press 'p' from the prompt, you will be asked for a new  password
  1007. "    (the one you enter when selecting this option  from  the  menu).   This
  1008. "    password is the ONLY way you can get into the section, so if you change
  1009. "    it, be sure not to forget it!
  1010. "
  1011. "    When you're finished, press STOP to return to the menu.
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046. "    8/2/83                                            By Paul Higginbottom
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052. "    Preliminary TERM-64 manual                                    Page...17
  1053.  
  1054.  
  1055. "                Load or save parameters (option 6 from the menu)
  1056. "
  1057. "    The 'parameters' include the protocols, the function  key  definitions,
  1058. "    and the screen, text, and border colours.  You may be save the  details
  1059. "    of the way  you  'configure'  the  program  for  communicating  with  a
  1060. "    particular remote computer as a file on the disk, in a parameter file.
  1061. "
  1062. "    An example of two parameter files might be  'source'  and  'compuserve'
  1063. "    for communicating with these large, popular database networks.
  1064. "
  1065. "    When '6' is pressed to select this option, you will be asked:
  1066. "
  1067. "    Load or Save parameters?
  1068. "    (Press 'L' or 'S')
  1069. "
  1070. "    As implied, press 'l' if you wish to load in a parameter file you  have
  1071. "    previously stored, or 's' if you wish to save the current parameters in
  1072. "    a disk file.
  1073. "
  1074. "    Having selected 'l' or 's', you will be asked for the name of the file.
  1075. "    If you enter a filename which causes a disk error, a bell  will  sound,
  1076. "    and you will be returned to the main menu.
  1077. "
  1078. "    Load parameters: The colours will be set, the RS232 will be setup,  the
  1079. "    function keys will be re-assigned.
  1080. "
  1081. "    Save parameters: The colours will be saved, the RS232  parameters  will
  1082. "    be saved, and the function keys assignments will be saved.
  1083. "
  1084. "    After either function, the program will,  once  again,  return  to  the
  1085. "    menu.
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112. "    8/2/83                                            By Paul Higginbottom
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118. "    Preliminary TERM-64 manual                                    Page...18
  1119.  
  1120.  
  1121. "               Send a file to the modem (option 7 from the menu)
  1122. "
  1123. "    You will be asked for the name of the file on disk to  be  transmitted.
  1124. "    If you enter a filename and the file is not  on  the  diskette  in  the
  1125. "    drive, a bell will sound, and you will be returned to  the  main  menu.
  1126. "    If the file is present, the program will go  into  terminal  mode,  and
  1127. "    each character from the file will be transmitted to the computer as  if
  1128. "    you were typing it.  If 'Commodore c' is  entered  while  the  file  is
  1129. "    still being transmitted, or a disk error occurs, or the end of the file
  1130. "    is reached, the process will stop, the disk file will  be  closed,  and
  1131. "    the user will remain in terminal mode.
  1132. "
  1133. "    Technical note:
  1134. "    Sometimes, the number of nulls to be sent after a carriage return  will
  1135. "    need to be set to more  than  zero  to  ensure  the  computer  you  are
  1136. "    communicating with does  not  drop  any  characters  after  a  carriage
  1137. "    return.
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. "    8/2/83                                            By Paul Higginbottom
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184. "    Preliminary TERM-64 manual                                    Page...19
  1185.  
  1186.  
  1187. "                  Save memory buffer (option 8 from the menu)
  1188. "
  1189. "    Text captured in the memory buffer in terminal mode, can be  stored  on
  1190. "    disk, in a file, for later viewing/printing, or even usage  with  other
  1191. "    software.
  1192. "
  1193. "    You will be asked for the name of the file  under  which  you  wish  to
  1194. "    store the memory buffer contents.  If you enter a filename which causes
  1195. "    an error, a bell will sound, and you will be returned to the main menu.
  1196. "    Otherwise, the storing will  proceed,  when completed, the program will
  1197. "    return to the menu.
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244. "    8/2/83                                            By Paul Higginbottom
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250. "    Preliminary TERM-64 manual                                    Page...20
  1251.  
  1252.  
  1253. "                     Exit program (option 9 from the menu)
  1254. "
  1255. "    Pressing '9' from the menu will reset your computer, as if it had  been
  1256. "    turned off and on again.
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310. "    8/2/83                                            By Paul Higginbottom
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.