home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64Telecom / CBTERM-DOC2 < prev    next >
Text File  |  2019-04-13  |  19KB  |  512 lines
  1.  
  2. For information on the CBterm Vidtex overlay program, see the file
  3.  CBTVTX.DOC in DL2 of the CBIG SIG. (go CBIG)
  4.  
  5. VIDTEX is a trademark of Compuserve Inc.
  6.  
  7.     CLOCK
  8.     =====
  9. Just so you can keep track of your time on line, CBterm includes an on screen
  10. time clock. To set the clock, press C= J. You will be prompted for 4 digits
  11. [HHMM]. To set the clock to 6:30, enter 0630. 10:48 would be 1048. The clock
  12. starts as soon as the last digit is pressed. You can turn the clock display on
  13. and off with C= K. The clock will still keep time even if it is not being 
  14. displayed.
  15.  
  16. --------------------------------------------------------------------------------
  17. To exit CBterm/C64 press C= SHIFT and CTRL together. This will reset the
  18. computer.
  19.  
  20. --------------------------------------------------------------------------------
  21. Please report any bugs or suggestions to CHRISDOS by posting a message in the
  22. Compuserve CBIG sig to SYSOP. (no email please) (Go CBIG at any ! prompt.)
  23. --------------------------------------------------------------------------------
  24.     Key Summary
  25.     -----------
  26. C= 8    80 column mode.
  27. C= 4    40 column mode.
  28. C= A    Add LF after CR (sending).
  29. C= B    Batch Transmit (80 col only).
  30. C= C    Close RAM Buffer.
  31. C= D    Display RAM Buffer.
  32. C= E    Extra LF after CR (recieved).
  33. C= F    File Translation (ASCII/PETSCII).
  34. C= G    Send Control Codes to Printer.
  35. C= H    HELP!
  36. C= I    7/8 Bits.
  37. C= J     Set Clock.
  38. C= K    Display Clock.
  39. C= L    Load RAM.
  40. C= M    Mask/Local LF.
  41. C= N    Xmodem Download.
  42. C= O    Open RAM Buffer.
  43. C= P    Print RAM Buffer.
  44. C= Q    Disk Command.
  45. C= R    Read Disk File.
  46. C= S    Save RAM to Disk.
  47. C= T    Transmit RAM.
  48. C= U    Xmodem Upload.
  49. C= V    Set Printers Secondary Addr.
  50. C= W     Write Disk File.
  51. C= X    Full/Half Duplex.
  52. C= Y    Disk Directory.
  53. C= Z    Zero RAM Buffer.
  54. C= 1    Pick Up Auto Modem.
  55. C= 2    Hang Up Auto Modem.
  56. C= 3    Dial Auto Modem.
  57. C= 5    Positive/Negitive Dialing.
  58. C= 7     300/1200 Baud.
  59. C= 6    Dump HiRes Screen to printer.
  60. C= \    (English Pound) Invert Black/White to printer dump.
  61.  
  62.  
  63. SHIFT    Hold RAM display.
  64. CTRL    Abort RAM display or transmit or up/down loads.
  65. + -    RAM Transmit speed adjust.
  66. Shift/RunStop    Restart CBterm/C64.
  67. C=/Shift/CTRL    EXIT CBterm/C64 and RESET Computer.
  68. F7    User Defined Function Keys On/Off
  69. F8    Load Function Key File.
  70.  
  71. To send        Type a
  72. -------------   --------------
  73. Backslash    British-pound
  74. Escape        Back Arrow
  75. Underline    F1
  76. Vertical-bar    F2
  77. Grave-accent    F3
  78. Tilde        F4
  79. Left-brace    F5
  80. Right-brace    F6
  81.         (Unless F keys have been user defined.)
  82. Control S    CLR/HOME
  83. Control Q    Shift/CLR/HOME or CRSR Down
  84. Backspace    INST/DEL
  85. Space        CRSR Right
  86. ASCII DEL.    Shift/CRSR Right
  87. **************************************************************************
  88.  
  89.     Function Keys
  90.     =============
  91. CBterm will allow you to turn the keys F1 through F6 into
  92. Programable Function keys. These keys may be used for either LOCAL (C=)
  93. control or for transmittable data.
  94.  A support program is required to define the function keys, and this is
  95. done off line. The support program creates a disk file with the key info
  96. that can be loaded into CBterm. Any number of files may be created, and any
  97. or all used during a session. 
  98. The support program is called CBTKEY.BAS.
  99. --------------------------------------------------------------------------------
  100. Operation of CBTKEY is fairly simple. You load and run the program. You will
  101. see a menu of 5 items. If you are creating your first key file, you pick
  102. the number for making a NEW file. The Screen will present the F key numbers
  103. and the lines will be blank, ready for data.
  104.  You are asked for the F key number you wish to define, you enter 1 to 6.
  105.  You are then prompted for the info for that key. You enter the info just
  106. as if you were entering it into CBterm itself. You may enter  up to
  107. 31 key presses for each F key.
  108.  
  109. If you wanted to have F1 transmitt your ID number, you would select key 1
  110. and enter: 77777,777<RETURN>        (Press <CRSR RIGHT> to signal end.)
  111.  The <RETURN> key would show on the screen as ^M in reverse video. ^M is the
  112. code for control M, and that is a <RETURN>.
  113.  
  114. To program F2 to send your password, you would select 2 then enter:
  115.   password<return>         <CRSR RIGHT>
  116. you would see: password^M
  117.  
  118. You could program the other keys to transmitt anything else you like. If you
  119. make a mistake, exit the line and reenter that line again. Backsapce will
  120. not backspace, as it is taken as data itself.
  121.  
  122. Once you have defined your keys (they do not all need to be set) you exit
  123. to the main menu by pressing 0 for a key value.
  124. You then select SAVE file option to save the data to disk. You are asked for
  125. a name for the file, you could use like: keys1   or  keys2  etc.
  126. The file is then written to disk. It should only be 1 block long.
  127.  
  128. The above examples only show the F keys being set to transmittable data, but
  129. since the F keys are read by CBterm just like they came from the keyboard, you
  130. can program them to do C= functions as well. Again, you would enter the key
  131. strokes into the file just as if you were doing it to CBterm.
  132. You could program a key to dial CBterm for you, you would enter:
  133.  C=2C=355512122^M^M     (<CRSR RIGHT>)
  134. This is C=2 (Press the Commodore key and hit 2) - Hang up command.
  135. C=3 (commodore and 3) - Dialing command
  136. 5551212^M - the number to dial ending with a <RETURN>
  137. ^M - a second return to answer the EXTRA DELAY question.
  138.  
  139. If this were programmed into F4 and F4 was pressed in CBterm, the whole
  140. dialing sequence would be automatic.
  141. Note: the combination of C= and a key will display as the key in reverse
  142. video. The C= does not display. So a key in reverse video is a C= key function.
  143. A key in reverse video with a ^ before it is a CTRL value.
  144.  
  145. Another key might be set to reset the clock/timer to 0 so it could be
  146. used as a timer. The action in CBterm would be to press C=J and then
  147. 4 zeros to answer the SET TIME question. If you programmed a f key for:
  148. C=J0000   (<CRSR RIGHT>)
  149. Pressing the F key would reset the time to 0:00:00.
  150.  
  151. As you can see, you simple act as if you were typing to CBterm, all the key
  152. presses are stored and read back by CBterm.
  153. NOTE: If you use a F key to send control codes to the Printer, (the C=G option)
  154. you will have to press <SHIFT><CTRL> by hand to exit it. As there is no way
  155. to store the <CTRL> key ITSELF in the file.
  156.  
  157. The other options on the CBTKEY menu allow you to read in and edit an OLD
  158. function key file. Operation is the same as above, except the values
  159. of the file you enter are loaded into CBTKEY so that they may be altered.
  160. Don't forget to then resave the file.
  161.  
  162. If you return to the main menu, but want to go back and alter the file in
  163. memory again, use the DISPLAY and EDIT option.
  164.  
  165. The last option on the menu exits CBTKEY.
  166. --------------------------------------------------------------------------------
  167. Using the F key files and CBterm.
  168.  
  169. Normally the F keys in CBterm transsmitt special characters |_~`}{
  170. and they will continue to do so unless a F KEY file is loaded into CBterm.
  171. The Function key F7 turns the F keys (1-6) on and off. If the keys are turned
  172. on and no file has been loaded, then the F keys (1 to 6) will not do anything.
  173.  
  174. Using the F8 (Shift F7) will prompt for a F Key file name. Enter the name
  175. for a file you created with CBTKEY. You will be prompted for S or P. A F Key
  176. file is allways (S).
  177. The File will be loaded and the keys turned ON. You may use F7 to toggle
  178. the F (1-6) keys between the ASCII characters and the F Key file.
  179.  
  180. One other nice thing about the F Key system is the fact that F keys themselves
  181. may be chained into another F key. When creating the F key file, you can
  182. enter another F key into it. If you had F6 programmed as:
  183.  <F8>keys2^Ms    (<CRSR RIGHT>)
  184. Then pressing F6 would invoke the load F keys function and load
  185. the file KEYS2 into the F Key Buffer. 
  186. (The F Key Buffer is the cassette buffer.)
  187. ------------------------------------------------------------------------------
  188.  
  189.     Hi and Med Res. Graphics
  190.     ========================
  191.  
  192. In addition to all its other functions, CBterm has the
  193. ability to translate CIS' Medium and HiRes Graphics codes into pictures
  194. on the 80 column screen. This operation is automatic and controlled
  195. by escape sequences sent from CIS.
  196.     And, if you have a Gemini-10x or other compatable printer, you
  197. can dump the Hi Res screen to it.
  198.  
  199.  Operation
  200.  ---------
  201.  To use the Graphics option, you must be switched into 80 column mode (C=8)
  202. in CBterm. Then simply select the graphics picture you require.
  203.  (at this time there are only 2 hires graphic areas on CIS. The weather
  204. maps [go AWX-4] and the picture demo [go VID-100]. To use the picture
  205. demo, you must temporaly set your terminal type to VIDTEX. This being done on
  206. page CIS-9 [The DEFALT program].)
  207.  CBterm will recieve the graphics data and build the picture on the screen.
  208. While recieving, the keyboard is still active and the OUTPUT display line
  209. is also.
  210.  At the end of the picture, to return to normal mode, you press your
  211.   <RETURN> key to send a CR to CIS.
  212.  
  213.     To print the screen, press the C= 6 keys. The computer will then
  214. do a fast dump of the Hi Res screen to the printer along with the control
  215. codes required to put the printer into Bit Map mode. If your picture
  216. comes out with black and white reversed (a negitive image) then press
  217. C= \ (english pound sign) to toggle the reverse image setting of CBterm.
  218. (press once to reverse, press again to return to normal) Then press
  219. C= 6 again to dump to printer.
  220.     Note: The C= 6 dump will print anything on the 80 column screen,
  221. so you can use it to dump text as well as graphics. Think of it as a
  222. screen print. You may also use the 25th (output) line to title your
  223. screen before you dump your Hi Res picture.
  224.  
  225. ******************************************************************************
  226.     Ascii/Petscii modes and CBterm
  227.     ------------------------------
  228. Due to the fact that CBterm must be able to handle both standard ASCII files
  229. and Commodore's PETSCII files, a number of flags were built into CBterm.
  230. The 2 most important ones are the C= M (Mask/Local LF) and C= F (Ascii/Petscii
  231. File Type).
  232. These 2 flags are often set/reset together to tell CBterm if it should
  233. translate a file. Most of the translation is done on Reading of Disk into ram
  234. memory, or on Writing of ram to disk. (Note: This could be either RAM BUFFER
  235. or XMODEM transfer.) They also affect data going to the Printer.
  236.  
  237.     In a nutshell, you can think of CBterm having a TRANSLATE and NO
  238. TRANSLATE mode. When C= M is set ON and C= F is set PETSCII, you are 
  239. TRANSLATING (either Petscii to Ascii or Ascii to Petscii). 
  240. When both C=M is OFF and C= S is ASCII, CBterm does NOT TRANSLATE and you
  241. are woring with what ever you are sending or recieving. If you have a PETSCII
  242. file, and you want to send it out PETSCII, you wold not need to translate it,
  243. so you would have C=M OFF and C=F ASCII.
  244.     You can see that this sometimes looks backwards, but if you think about
  245. what type your file is, and how you want it to wind up, it is really simple.
  246.  
  247. When using XMODEM, you will be prompted for the kind of translation you want,
  248. you are asked (A)scii (P)etscii (N)o change.
  249. It might help you to think of it as NO TRANSLATE, TRANSLATE and SPECIAL.
  250.  ( (N)o change is a special mode that keeps the flags the way you have
  251. manually set them with C=M and C=F. Used for doing special translation.)
  252. If you are posting a file to a SIG or BBS, you should include in its description
  253. what type of data it is: ASCII or PETSCII. This will help other when they come
  254. to download it.
  255.  
  256.  
  257.     Customization of CBterm.
  258.     ------------------------
  259. You can load CBterm and alter some values in the program, then save CBterm
  260. back to your disk with the new defalt values. The most offen changed ones are
  261. the screen colors. Here is a list of where to poke what.
  262. What        Position Hex    Position Dec    Current Value    Comments
  263. --------------    ------------    ------------    -------------    ---------------
  264. User Baud HIGH    $0A50        2640        1        1200 baud
  265. User Baud LOW    $0A4F        2639        59        1200 baud
  266. Color 25TH line $0ADD        2781        177        output line 80c
  267. Color 40 Col    $0AE2        2786        27        Char & screen
  268. Color 80 Col    $0AE7        2791        191        Char & screen
  269. Border Color    $0AF8        2808        12        Border color
  270. Printer Sec Adr    $1D8E        7566        5        Secondary Addr.
  271. Printer Dev #    $1D97        7575        4        Device number
  272. Hayes Speed    $32FE        13054        6        #of 1/60 second
  273. Dial Open    $3020        12320        3        Ticks open
  274. Dial Close    $3030        12336        3        Ticks close
  275. Time Bet Digs    $3063        12387        60        Ticks between
  276.  
  277.  
  278. The Program may be loaded, but before being RUN, you may poke to memory
  279. the defalt values you choose and resave the program.
  280. The user baud rates are the defined rates used in 1200 baud mode.
  281. The color values are the combination of Charater and screen colors (Forground-
  282. backgraound).
  283. Printer device number and secondary address are for those who wish to alter
  284. the defalt values. And the Hayes speed is the wait time between characters
  285. when CBterm is sending commands to the modem. The value is counts in ticks.
  286. --------------------------------------------------------------------------------
  287. SPECIAL BUG NOTE: CBterms RAM buffer starts a $0400, this is the old area
  288. used by the 40 column screen. (It was moved to high memory.) But is seems
  289. that when you switch between 40 and 80 column or back again, this area is
  290. being cleared, so the first 1K of ram data is being lost.
  291. So please do not switch screens while you have valuable data in RAM, save
  292. it to disk first.
  293. -------------------------------------------------------------------------------
  294. CBterm may be restarted after a C=/SHIFT/CTRL or a reset by a SYS 33451
  295. assuming that the memory image has not been overwritten.
  296. CBterm loads as a basic program into $0801 and is about 11.5k long. It
  297. relocates itself after turning basic ROM off to $8000 thru $AFFF.
  298. $B000 thru $BFFF contains buffers and scratch memory. $C000 thru $CFFF is not
  299. used so that Wedges there may be reused after CBterm is exited. The 40 column
  300. screen is moved to high memory, and when in 80 column mode ram in the range
  301. of $5c00 to $7FFF is used. CBterms MAIN RAM BUFFER runs from $0400 to $5BFF.
  302. --------------------------------------------------------------------------------
  303.  
  304.     Messages from CBterm
  305.     --------------------
  306. The following is a list of messages you may encounter from CBterm and what
  307. they mean.
  308.  
  309.     Baud?
  310. Enter 3 for 300 or 12 for 1200 baud operation.
  311.  
  312.     [Done]
  313. CBterm finished a process you asked for. (You should now be in terminal mode.)
  314.  
  315.     [Recv. 8 Bits]
  316.     [Recv. 7 Bits]
  317. You changed CBterm to Recieve 7 or 8 bit data.
  318.  
  319.     [Batch Xmit ON]
  320.     [Batch Xmit OFF]
  321. CBterm is in (or out) of Batch Transmit mode for the output line.
  322.  
  323.     [Full Duplex]
  324.     [Half Duplex]
  325. Your duplex setting.
  326.  
  327.     [Output extra LF ON]
  328.     [Output extra LF OFF]
  329. Cbterm will (will not) send a line feed after a return character.
  330.  
  331.     [Input LF Add ON]
  332.     [Input LF Add OFF]
  333. Cbterm will (will not) add a LF after a recieved return character.
  334.  
  335.     [LF Mask/Local ON]
  336.     [LF Mask/Local OFF]
  337. CBterm will (will not) ignore all recieved LF's and provide a new line on
  338. a retern charater recived.
  339.  
  340.     [ASCII Mode]
  341. CBterm will not translate a file. (Should also require LF Mask/Local OFF)
  342.  
  343.     [PETSCII Mode]
  344. CBterm will translate a file. (Should also require LF Mask/Local ON)
  345.  
  346.     (A)scii,(P)etscii,(N)o change?
  347. You are being asked if you wish CBterm to alter the settings of the
  348. Ascii/Petscii and LF Mask/Local flags. Enter A,P, or N.
  349.  
  350.     [RAM Buffer Full]
  351. It's all fed up.
  352.  
  353.     [Ram Buffer Zeroed] nnnnn
  354. You pressed C= Z. It's now empty. nnnnn = number of bytes in buffer.
  355.  
  356.     [Ram Buffer Closed] nnnnn
  357. You closed the ram buffer. nnnnn = number of bytes left.
  358.  
  359.     [Ram Buffer Open] nnnnn
  360. Ram capturing data. nnnnn = number of free bytes.
  361.  
  362.     [RAM Buffer Display]
  363. Displaying to screen.
  364.  
  365.     [RAM Buffer End]
  366. End of the display.
  367.  
  368.     [*ABORTED*]
  369. Anytime a process is aborted by pressing CTRL or entering a NULL filename.
  370.  
  371.     Secondary Address:
  372. You are being prompted for a new printer secondary address. Press 0-9.
  373.  
  374.     [Printing Buffer]
  375. Ram going to printer.
  376.  
  377.     [Transmitting Buffer]
  378. Sending the Ram buffer.
  379.  
  380.     Load:
  381.     Save:
  382. You are being prompted for a filename for a Kernal type Load or Save.
  383.  
  384.     [*Kernal I/O Error*] nnn
  385. The kernal has flaged an error during Disk I/O. nnn = either the Kernals
  386. error return value, OR the value of the ST Status variable.
  387.  
  388.     [Write to Disk]
  389. CBterm is writing RAM buffer to disk.
  390.  
  391.     [Nothing in RAM]
  392. You wanted to write to disk when there was no info in the RAM buffer.
  393.  
  394.     [Read From Disk]
  395. Reading a file into RAM.
  396.  
  397.     Write:
  398.     Read:
  399. You are being prompted for a file name.
  400.  
  401.     [00,ok,00,00]
  402. What the disk's error channel is reporting. May vary if there is an error.
  403.  
  404.     [*Check Disk*]
  405. You get this anytime the disk's error channel reports an error.
  406.  
  407.     [FAILURE TO COMMUNICATE]
  408. Your XMODEM download bombed out for some reason.
  409.  
  410.     (S)eq or (P)rg ?
  411. You are being prompted for the proper file type.
  412.  
  413.     [CheckSum Error]
  414. The checksum on the recived XMODEM block does not match what is expected.
  415.  
  416.     [Header No Good]
  417. The XMODEM block has bad header info.
  418.  
  419.     [Block Mismatch]
  420. The XMODEM block does not have the correct block number in its header.
  421.  
  422.     [Cant Get Block]
  423. CBterm has tried it maximum amount of loops to recieve a block and can not.
  424.  
  425.     [Time out - Block] nn
  426.     xxx
  427. The alloted time has expired to recieve a full Xmodem block. nn = Block number.
  428. xxx = the number of bytes that were recived. (1 block = 132 bytes.)
  429.  
  430.     [Have Block] nn
  431. A full XMODEM block was recived. nn = block number.
  432.  
  433.     [Stripped VIDTEX Header]
  434. The first XMODEM block had a VIDTEX (.IMG) file header, and it was stripped.
  435.  
  436.     [Download Done]
  437. Xmodem finished.
  438.  
  439.     Download:
  440.     Upload:
  441. Prompt for a file name.
  442.  
  443.     [Upload Done]
  444. Xmodem finished.
  445.  
  446.     [Sent Block] nn
  447. An Xmodem block was sent.
  448.  
  449.     [Waiting for NAK]
  450. Waiting for a handshake from the remote computer for upload to begin.
  451.  
  452.     [XOFF]
  453. A stop transmitting (or any) character was recived during an upload.
  454.  
  455.     [XON]
  456. The strat character was recived.
  457.  
  458.     [Time Out XON]
  459. CBterm waited long enugh, will start transmitting anway.
  460.  
  461.     Set Clock [HHMM]:
  462. Prompt for the correct time.
  463.  
  464.     Command:
  465. Command to be sent to the disk drive.
  466.  
  467.     [*Disk Drive Not Present*]
  468.     [*Process ABORTED*]
  469. You tried to talk to the disk drive when it was off or unplugged.
  470.  
  471.  
  472.     Enter Codes. (Shift/CTRL to End) :
  473. Prompt for escape codes to be sent to the printer.
  474.  
  475.     Enter Number to Dial:
  476. Prompt for a phone number.
  477.  
  478.     Dialing: abcdxyz
  479. As the number is being dialed.
  480.  
  481.     [Standby]
  482. After dialing and waiting for connect.
  483.  
  484.     [Hung Up]
  485. Modem on hook.
  486.  
  487.     [Pick Up]
  488. Modem on line.
  489.  
  490.     [Negitive Dialing]
  491. Hes,Mighty Mo, 1660 Mode for dialing pulses.
  492.  
  493.     [Positive Dialing]
  494. Normal,Hayes, every thing else mode.
  495.  
  496.     [DCD Switched]
  497. The Data Carried Detect line changed state.
  498.  
  499.     # of extra 20 sec. delays (0-9):
  500. Prompt for wait time out.
  501.  
  502.     [Hanging up...]
  503. Hang up in 4 seconds.
  504.  
  505.     [On Line]
  506. From auto dialing into terminal mode.
  507.  
  508.  
  509.  
  510. -------------------------------------------------------------------------------
  511.     -Chrisdos [76703,717]
  512. F┼