home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / osborne / oterm401.doc < prev    next >
Text File  |  1994-07-13  |  50KB  |  2,441 lines
  1. OTERM.DOC -- OTERM Terminal Simulator                page   1
  2.  
  3.  
  4. Copyright 1981, 1982  Michael M Rubenstein
  5. Version 4.00 (4 Oct 82)
  6.  
  7.  
  8. Credits.
  9.  
  10. The  modem  protocol used for file transmission  was 
  11. developed by Ward Christensen.
  12.  
  13. The modem protocol was extended to use the  cyclical 
  14. redundancy code by John Mahr.
  15.  
  16. The  subprogram  to compute the cyclical  redundancy 
  17. code was written by Paul Hansknecht.
  18.  
  19. The window manager is based on one written by Robert 
  20. Lansdale.
  21.  
  22. All  four  gentlemen  have made  their  work  freely 
  23. available for noncommercial purposes.
  24.  
  25. Ideas for many the features of OTERM have come  from 
  26. other terminal programs.   The authors of these pro-
  27. grams must share the credit for OTERM.
  28.  
  29. Most of OTERM is now written in C.   It was compiled 
  30. with the Software Toolworks C/80 compiler.
  31.  
  32. A  large  number of people have offered  suggestions 
  33. and  encouragement in developing  this  program.   I 
  34. thank all of them.
  35.  
  36. The CompuServe CP/M Interest Group (CP-MIG) has been 
  37. a  valuable  forum for discussion and a source of  a 
  38. great many ideas used in OTERM.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. OTERM.DOC -- OTERM Terminal Simulator                page   2
  63.  
  64.  
  65. Description.
  66.  
  67. OTERM allows the user to communicate with time shar-
  68. ing  services,  computerized  bulletin  boards,  and 
  69. other computers.  Special features of OTERM include:
  70.  
  71.         - a  circular  log of the session  is  kept.  
  72.           This log is under the control of the user.  
  73.           It may be browsed without exiting OTERM.
  74.  
  75.         - an  optional warning is provided when  the 
  76.           log is almost full.   If the remote device 
  77.           supports it,  transmission will be  halted 
  78.           with  a  control S.   If a file  is  being 
  79.           sent,  the transmission is interrupted (it 
  80.           can be restarted.)
  81.  
  82.         - a file may be received without a protocol.  
  83.           If  the remote supports ^s/^q to stop  and 
  84.           start transmission, the file may be larger 
  85.           than main memory.
  86.  
  87.         - files  may be sent to the remote  computer 
  88.           without  a  special  protocol  for  trans-
  89.           mission.
  90.  
  91.         - any  command which can be entered from the 
  92.           keyboard  may also be entered from a  file 
  93.           or from a function key.
  94.  
  95.         - file  tranmission may be interrupted  from 
  96.           the  keyboard or from a command  contained 
  97.           in  the  file.   Transmission may  be  re-
  98.           started without loss of data.
  99.  
  100.         - the  Ward  Christensen modem  protocol  is 
  101.           implemented.   This allows error free com-
  102.           munications  with  remote CP/Ms  or  other 
  103.           computers.
  104.  
  105.         - the CIS A protocol is  implemented.   This 
  106.           allows   error  free  communications  with 
  107.           CompuServe Information Services.
  108.  
  109.         - optionally  lines may be wrapped so as  to 
  110.           keep words on a single line (word wrap)
  111.  
  112.         - commands   to  OTERM  are  entered   using 
  113.           function key 1.   Help menus are available 
  114.           by entering ? in response to any prompt.
  115.  
  116.         - extended  function  keys  are   available.  
  117.           names  of extended function keys may be up 
  118.           to 127 characters long and data sent by  a 
  119.           function key may be up to 4094 characters.
  120.  
  121.  
  122.  
  123. OTERM.DOC -- OTERM Terminal Simulator                page   3
  124.  
  125.  
  126.  
  127.         - the directory of a disk may be viewed from 
  128.           OTERM.
  129.  
  130.         - files may be deleted from OTERM.
  131.  
  132.         - files may be typed from OTERM.
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184. OTERM.DOC -- OTERM Terminal Simulator                page   4
  185.  
  186.  
  187. Limitations.
  188.  
  189. OTERM  will run only on an Osborne 1 computer.   The 
  190. revision  level must be 1.2 or higher (the  original 
  191. rev A is no longer supported).
  192.  
  193. No printer support is provided.
  194.  
  195. OTERM  is primarily designed for  operator  attended 
  196. communications.   There  is  no provision  for  auto 
  197. answer.
  198.  
  199. OTERM  contains  no  provision for  special  modems.  
  200. However with some modems,  function keys can be used 
  201. for autodialing or other functions.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  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. OTERM.DOC -- OTERM Terminal Simulator                page   5
  246.  
  247.  
  248. New features/corrections in version 4.
  249.  
  250. Note: Version  4.00 is almost a complete rewrite  of 
  251.       the program.   Much of it has be rewritten  in 
  252.       C.
  253.  
  254. Browsing of the log has been implemented.
  255.  
  256. The CIS A protocol has been implemented.
  257.  
  258. Access  to the directory ,  typing and  deletion  of 
  259. files have been implemented.
  260.  
  261. Extended function keys have been implemented.
  262.  
  263. A  window manager is now used to allow prompting for 
  264. commands, display of messages from OTERM  and of the 
  265. log  and directory.   Escape sequences are not  used 
  266. except from a file.
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306. OTERM.DOC -- OTERM Terminal Simulator                page   6
  307.  
  308.  
  309. Using OTERM (summary).
  310.  
  311.  
  312. The  modem should always be in full duplex mode  for 
  313. use with OTERM.  Follow the modem manufacturer's and 
  314. the  Osborne instructions for connecting the  modem.  
  315. Note than almost all modem's will require that pin 2 
  316. on  the modem be connected to pin 3 on the  computer 
  317. and pin 3 on the modem be connected to pin 2 on  the 
  318. computer.
  319.  
  320. On  exiting OTERM the RS232 interface will be  reset 
  321. to the same options as at entry.
  322.  
  323. The  setting of the rs232 rate and the line size  on 
  324. the disk have no effect on OTERM.  OTERM always uses 
  325. it's internal settings.
  326.  
  327. As  distributed,  on startup OTERM is set to commun-
  328. icate with most time sharing services.   The default 
  329. characteristics may be changed temporarily or  OTERM 
  330. can  easily  be modified to start up with  different 
  331. characteristics.
  332.  
  333. Establish  communications following the modem  manu-
  334. facturer's and the remote service's instructions.
  335.  
  336. Commands  to  OTERM are preceded by function  key  1 
  337. (control 1).  Other function keys are used for OTERM 
  338. functions.
  339.  
  340. Several OTERM functions require significant time for 
  341. disk  access  during which OTERM  cannot  check  the 
  342. modem.   If the remote responds to control s to stop 
  343. and  control  q to restart and OTERM is informed  of 
  344. this through the delay command,  OTERM will stop the 
  345. remote  during these operations and no data will  be 
  346. lost.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367. OTERM.DOC -- OTERM Terminal Simulator                page   7
  368.  
  369.  
  370. Function Keys.
  371.  
  372. OTERM  takes over the function keys.   The  function 
  373. keys have the following meanings:
  374.  
  375.       -------------------------------------------
  376.       |      7      |      8      |      9      |
  377.       |             |             |             |
  378.       | scroll up   | scroll up   |   cancel    |
  379.       |   half      |   full      |   file      |
  380.       |             |             |   or fk     |
  381.       |             |             |             |
  382.       -------------------------------------------
  383.       |      4      |      5      |      6      |
  384.       |             |             |             |
  385.       | scroll down | scroll down |   cancel    |
  386.       |   half      |   full      |   special   |
  387.       |             |             |   display   |
  388.       |             |             |             |
  389.       -------------------------------------------
  390.       |      1      |      2      |      3      |
  391.       |             |             |             |
  392.       |   command   |  extended   |  standard   |
  393.       |             |  function   |  function   |
  394.       |             |    key      |    key      |
  395.       |             |             |             |
  396.       -------------------------------------------
  397.  
  398. A  display  similar to the above may  be  viewed  by 
  399. entering the fkhelp command.
  400.  
  401. Use of function keys:
  402.  
  403. Key   Use
  404. ---   ----------------------------------------------
  405.  1    Signals OTERM that a command is to be entered.
  406.  
  407.  2    Signals OTERM that an extended function key is 
  408.       to be entered.  OTERM will prompt for the name 
  409.       of the function key.   Extended function  keys 
  410.       are   installed  in  OTERM  with  the  program 
  411.       OTSETUP.   Note,  that  if  the  name  of  the 
  412.       function  key is a single digit,  the  Osborne 
  413.       function  key (installed with SETUP)  will  be 
  414.       used.   This  function  may not be used  while 
  415.       entering an OTERM command.
  416.  
  417.  3    Signals  OTERM that an Osborne function key is 
  418.       to be entered.   OTERM does not prompt for the 
  419.       name  of  the function key,  which must  be  a 
  420.       single digit or a single letter.   If a single 
  421.       letter, the extended function key installed by 
  422.       OTSETUP  will be used.   This function may  be 
  423.       used at any time,  including while entering an 
  424.       OTERM command.
  425.  
  426.  
  427.  
  428. OTERM.DOC -- OTERM Terminal Simulator                page   8
  429.  
  430.  
  431.  
  432.   4   Scrolls  the special display down by half  the 
  433.       size of the window.
  434.  
  435.   5   Scrolls  the special display down by the  size 
  436.       of the window.
  437.  
  438.   6   Clears special display (browse log, directory, 
  439.       typed file or the function key display).
  440.  
  441.   7   Scrolls  the  special display up by  half  the 
  442.       size of the window.
  443.  
  444.   8   Scrolls  the special display up by the size of 
  445.       the window.
  446.  
  447.   9   Cancels  a  protocol  file transfer  or  halts 
  448.       transmission  without protocol of a  file.   A 
  449.       transmission without protocol may be continued 
  450.       without loss.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489. OTERM.DOC -- OTERM Terminal Simulator                page   9
  490.  
  491.  
  492. Extended function keys.
  493.  
  494. Extended or Osborne function keys may be nested to a 
  495. depth  of 16.   There is no checking for  recursion.  
  496. All  function keys are canceled when a file read  is 
  497. started,  but a file read may contain function keys.  
  498. That  is,  if  a function key contains a  file  read 
  499. command,   nothing  in  the  function  key  will  be 
  500. processed after the command.
  501.  
  502. Extended  function keys are installed in OTERM  with 
  503. the program otsetup.  See otsetup.doc for details.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550. OTERM.DOC -- OTERM Terminal Simulator                page   10
  551.  
  552.  
  553. OTERM Commands.
  554.  
  555. When function key 1 is entered, OTERM opens a window 
  556. at the top of the screen and prompts for a  command.  
  557. You  may then enter a command with or without  argu-
  558. ments.   In most cases, if no arguments are entered, 
  559. OTERM  will  then prompt for them.   In a few  cases 
  560. (e.g.  dir) a default will be used.   At any  prompt 
  561. you may enter a ? (followed by return) to see a list 
  562. of  possible  operands or a description of the  com-
  563. mand.
  564.  
  565. In  scanning commands,  OTERM allows abbreviation to 
  566. the minimum number of letters needed to identify the 
  567. command  or  operand.    Commands  are  checked   in  
  568. alphabetic   order  so  the  line  command  may   be 
  569. abbreviated  "l",  but  the log command requires  at 
  570. least "lo".  Commands and operands may be be entered 
  571. in upper or lower case.
  572.  
  573. In  some cases (e.g.  log) if no operand is entered, 
  574. the current status is displayed.
  575.  
  576. Examples:
  577.  
  578.       cmd: log on     (will turn log on)
  579.  
  580.       cmd: log        (will  display log status  and 
  581.                       prompt for operands)
  582.  
  583.       cmd: quit       (will exit OTERM)
  584.  
  585. Several  commands require the entry of a file  name.  
  586. OTERM uses a generalized file system which does  not 
  587. permit  the  use  of "/" or "\" in a file  name  (of 
  588. course the usual illegal characters are not  allowed 
  589. either).   The slashes are used to set flags for the 
  590. file system.  The only flag which is of use in OTERM 
  591. is  \b,  which causes an old file with the same name 
  592. to  be deleted,  rather than renamed to  <name>.bak.  
  593. Simply  append  this  flag to the end  of  the  name 
  594. (after  the extension) with no  intervening  spaces.  
  595. The old file will only be deleted after the new file 
  596. is successfully written.
  597.  
  598. All  file  names  may be entered in upper  or  lower 
  599. case.
  600.  
  601. A new disk may be mounted whenever there are no open 
  602. files.   A new disk may also be mounted on any drive 
  603. except  the default drive (the drive which is  shown 
  604. in the CP/M prompt,  e.g.  A>) whenever there are no 
  605. files open on it.   Remember, halting the reading of 
  606. a file with function key 9 does not close the file.
  607.  
  608.  
  609.  
  610.  
  611. OTERM.DOC -- OTERM Terminal Simulator                page   11
  612.  
  613.  
  614. To  modify OTERM to use new defaults,  simply  enter 
  615. the desired commands,  exit with the quit  command, 
  616. and  save  the program with the CP/M  save  command.  
  617. Remember  to  check the current size of  OTERM  with 
  618. stat before entering OTERM.
  619.  
  620. The following sections describe in detail the  OTERM 
  621. commands.
  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.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672. OTERM.DOC -- OTERM Terminal Simulator                page   12
  673.  
  674.  
  675. log command.
  676.  
  677. A log of the session is kept in memory.   As distri-
  678. buted,  this log is enabled at start up.  The log is 
  679. circular;  that  is,  when the log is filled,  char-
  680. acters  at  the beginning are deleted as  new  char-
  681. acters  are added.   The size of the log depends  on 
  682. the version.   The log is always cleared when  OTERM 
  683. is entered.
  684.  
  685. If  this  command is entered without  operands,  the 
  686. status of the log will be displayed.
  687.  
  688. In full duplex mode,  only characters received  from 
  689. the  remote device are entered in the log.   In half 
  690. duplex  mode  all characters sent  or  received  are 
  691. entered.   In  host  mode only characters  sent  are 
  692. entered in the log.
  693.  
  694. Since  OTERM  does not recognize deletion  of  char-
  695. acters  or lines,   it usually will be necessary  to 
  696. edit  the log after writing it to disk to  eliminate 
  697. errors.   The log may be edited with WordStar or ED.  
  698. This  is  also  useful  for  eliminating  extraneous 
  699. material  from  the log (e.g.  commands or  messages 
  700. when a program source file is listed and logged.)
  701.  
  702. The following operands are recognized:
  703.  
  704.   Operand      Function
  705. -----------    -------------------------------------
  706. clear          Clears  the log and  starts  entering 
  707.                data into it.
  708.  
  709. endfile        Stops automatic saving of the log.
  710.  
  711. file           Starts automatic saving of the log in 
  712.                a  file.   The file name  is  entered 
  713.                after the word "file".  If not enter-
  714.                ed,  you will be prompted.  This must 
  715.                be the last operand on the line.
  716.  
  717. nowarn         Turns off warning of log being almost 
  718.                full.
  719.  
  720. off            Turns off the log.  Data currently in 
  721.                the log is not lost.
  722.  
  723. on             Turns on the log.   Data currently in 
  724.                the log is not lost.
  725.  
  726. warn           Turns on warning of log being  almost 
  727.                full.   When  the log is almost full, 
  728.                you will be informed with three bells 
  729.                and,   if  the  remote  responds   to                
  730.  
  731.  
  732.  
  733. OTERM.DOC -- OTERM Terminal Simulator                page   13
  734.  
  735.  
  736.                control s and control q (and OTERM is 
  737.                informed  of  this through the  delay 
  738.                command) a control s will be sent.  A 
  739.                control q will not be sent  automati-
  740.                cally.   Warning  is not effective if 
  741.                the log is being automatically saved.
  742.  
  743. write          Writes  the  current log to  a  file.  
  744.                The file name is be entered after the 
  745.                word "write".   If not  entered,  you 
  746.                will  be prompted.   This must be the 
  747.                last operand on the line.
  748.  
  749.  
  750. A common (and the simplest) method of using the  log 
  751. is  to simply ignore it until something is  received 
  752. which one wants to save.   The log is then saved and 
  753. later edited to eliminate unwanted material.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794. OTERM.DOC -- OTERM Terminal Simulator                page   14
  795.  
  796.  
  797. browse command.
  798.  
  799. The browse command is used to view the  log.   While 
  800. active,  the  screen is split with the log displayed 
  801. in  the upper half and the terminal display  in  the 
  802. lower.  The scrolling function keys (4, 5, 7, and 8) 
  803. are active while the log is being displayed.
  804.  
  805. To turn off the log, use function key 6.
  806.  
  807. The following operands are recognized:
  808.  
  809.   Operand      Function
  810. -----------    -------------------------------------
  811. down           Followed  by a number.   Scrolls  the 
  812.                log  down  the  specified  number  of 
  813.                lines.  Note: during scrolling, input 
  814.                from the remote cannot be  completely 
  815.                processed  and some data may be  lost 
  816.                if the number of lines is larger than 
  817.                about 400 (at 300 baud).   This  must 
  818.                be the last operand on the line.
  819.  
  820. end            Starts browsing the log,  showing the 
  821.                last data entered.
  822.  
  823. start          Starts browsing the log,  showing the 
  824.                oldest data entered. 
  825.  
  826. up             Followed  by a number.   Scrolls  the 
  827.                log up the specified number of lines.  
  828.                Note:  during  scrolling,  input from 
  829.                the remote cannot be completely  pro-
  830.                cessed  and some data may be lost  if 
  831.                the  number  of lines is larger  than 
  832.                about  400 (at 300 baud).   This must 
  833.                be the last operand on the line.
  834.  
  835. If no operand is entered, "end" will be assumed.
  836.  
  837. The display of the log will not be usable if the log 
  838. does  not contain line feeds.   This will  occur  if 
  839. line  feeds are supplied on the console rather  than 
  840. by   the  remote  service  or  by  the  transmission 
  841. routines.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855. OTERM.DOC -- OTERM Terminal Simulator                page   15
  856.  
  857.  
  858. cis command.
  859.  
  860. Used to turn recognition of CompuServe A protocol on 
  861. or off.  Usually, recognition of CompuServe protocol 
  862. will cause no problems, but there is a slight chance 
  863. that some other service will send control  sequences 
  864. which  make OTERM think it is engaged in an exchange 
  865. with  CompuServe.   If this happens,  turn  off  cis 
  866. protocol.
  867.  
  868. The possible operands are "on" or "off".
  869.  
  870. If entered without operands,  the status of cis mode 
  871. will be displayed.
  872.  
  873. CIS  file  transfers are initiated by the remote  by 
  874. sending  a special sequence  of  characters.   OTERM 
  875. will notify you of the transfer.  If it is an upload 
  876. (transmission  to  the  remote) the  file  size  and 
  877. estimated transmission time will be shown.
  878.  
  879. The progress of the transmission will be  displayed.  
  880. Under this protocol blocks are variable length,  but 
  881. are  normally  either  128 characters or  256  char-
  882. acters.  When sending,  all blocks except, possibly, 
  883. for the last are 256 characters.
  884.  
  885. A  file transfer may be cancelled with function  key 
  886. 9.   The  other  system is notified of  the  cancel-
  887. lation.
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916. OTERM.DOC -- OTERM Terminal Simulator                page   16
  917.  
  918.  
  919. clear command.
  920.  
  921. This  command clears the screen.   This is  a  local 
  922. operation.  Nothing is transmitted or logged.
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977. OTERM.DOC -- OTERM Terminal Simulator                page   17
  978.  
  979.  
  980. console command.
  981.  
  982. The console command controls the display of informa-
  983. tion sent or received.   It has no effect on the log 
  984. or on the data transmitted:
  985.  
  986. If entered without operands,  the status of the con-
  987. sole will be displayed.
  988.  
  989. The following operands are recognized:
  990.  
  991.   Operand      Function
  992. -----------    -------------------------------------
  993. autolf         Treats a carriage return as the start 
  994.                of a new line (i.e displays as if  it 
  995.                were a carriage return line feed).
  996.  
  997. bsdel          Deletes the previous character when a 
  998.                backspace is received.
  999.  
  1000. control        Control characters are passed to  the 
  1001.                screen  output  routines and  act  as 
  1002.                defined in the Osborne user's manual.
  1003.  
  1004. ffclr          Clears the screen when a form feed is 
  1005.                received.
  1006.  
  1007. ignorectl      Control characters are ignored.
  1008.  
  1009. maskctl        Control  characters are displayed  as 
  1010.                periods.
  1011.  
  1012. noautolf       Turns off autolf.   A carriage return 
  1013.                moves  the  cursor to the  left,  but 
  1014.                does not start a new line.
  1015.  
  1016. nobsdel        Turns off bsdel.   A backspace  moves 
  1017.                the  cursor left one  character,  but 
  1018.                does not delete the character.
  1019.  
  1020. nowwrap        Turns off word wrap.  On reaching the 
  1021.                end of the line on the screen,  a new 
  1022.                line is started immediately.
  1023.  
  1024. showctl        Control  characters are displayed  as 
  1025.                "^" followed by a printing character.  
  1026.                Rubout is displayed as "^?".
  1027.  
  1028. wwrap          Turns on word wrap.   On reaching the 
  1029.                end of a line,  the line is broken at 
  1030.                a word boundary.  For the purposes of 
  1031.                OTERM,  a word boundary is a carriage 
  1032.                return,    line   feed,    space   or 
  1033.                horizontal tab.   Note:  word wrap is 
  1034.                done  at the end of the logical  line 
  1035.  
  1036.  
  1037.  
  1038. OTERM.DOC -- OTERM Terminal Simulator                page   18
  1039.  
  1040.  
  1041.                as specified in the line command, not 
  1042.                necessarily   at   the  end  of   the 
  1043.                physical  screen.   This option  will 
  1044.                probably  not  be too useful  if  the 
  1045.                line size is set to greater than 52.
  1046.  
  1047. The four options to control display of control codes 
  1048. apply   to  most  nondisplayable  codes.    Carriage 
  1049. return,  line feed,  back space,  and horizontal tab 
  1050. are  not  affected.   Form feed is not  affected  if 
  1051. ffclr  is  on.    Nulls  are  displayed  only  under 
  1052. showctl.
  1053.  
  1054. Control  z,  which normally clears the screen on the 
  1055. Osborne,  will  be ignored if control and ffclr  are 
  1056. both set on.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. OTERM.DOC -- OTERM Terminal Simulator                page   19
  1100.  
  1101.  
  1102. delay command.
  1103.  
  1104. When  sending  a file or a function key to a  remote 
  1105. computer,  it  may be necessary to give  the  remote 
  1106. some time to process the data.  This is accomplished 
  1107. with the delay command.
  1108.  
  1109. Except  for "usectls",  the delay mode commands  not 
  1110. meaningful  except  when a file or function  key  is 
  1111. being sent.
  1112.  
  1113. If no operands are given,  the delay status will  be 
  1114. displayed.
  1115.  
  1116. The following operands are recognized:
  1117.  
  1118.   Operand      Function
  1119. -----------    -------------------------------------
  1120. char           Sets delay mode to character.  When a 
  1121.                delay  is  required,   it  will   end 
  1122.                whenever a character is received from 
  1123.                the remote.   This is the opposite of 
  1124.                time.
  1125.  
  1126. chdelay        Causes  a delay after each  character 
  1127.                sent.
  1128.  
  1129. delay=         Followed  immediately by a digit  (no 
  1130.                space).   Specifies  the length of  a 
  1131.                character or line delay.   If 0,  the 
  1132.                delay   will   always  be   until   a 
  1133.                character is received.
  1134.  
  1135. delctls        Causes  transmission  to  stop   when 
  1136.                control   s  is  received  from   the 
  1137.                remote.    Transmission  will  resume 
  1138.                when  a control q is received.
  1139.  
  1140. lndelay        Causes a delay after each line sent.
  1141.  
  1142. nochdly        Turns off chdelay.
  1143.  
  1144. nodelctls      Turns off delctls.
  1145.  
  1146. nolndly        Turns off lndelay.
  1147.  
  1148. noprompt       Turns  off  waiting for prompt  after 
  1149.                each line.
  1150.  
  1151. nousectls      Turns off usectls.
  1152.  
  1153. prompt=        Followed immediately (no space) by  a 
  1154.                character.   After  each  line  sent, 
  1155.                OTERM  will  wait until the  specifed 
  1156.                character  is  received.   A  control 
  1157.  
  1158.  
  1159.  
  1160. OTERM.DOC -- OTERM Terminal Simulator                page   20
  1161.  
  1162.  
  1163.                character  may  be  specified  as   ^ 
  1164.                followed by a character (e.g.  ^@ for 
  1165.                NUL).
  1166.  
  1167. time           Causes  character and line delays  to 
  1168.                last the specified  time,  regardless 
  1169.                of   characters  received  from   the 
  1170.                remote.  The opposite of char.
  1171.  
  1172. usectls        Informs   OTERM   that   the   remote 
  1173.                responds  to  control s to  stop  and 
  1174.                control q to restart.  This should be 
  1175.                specified   whenever   possible    to 
  1176.                prevent   loss   of  data   on   disk 
  1177.                accesses.
  1178.  
  1179. Use  of  delays for file transmission can be  a  bit 
  1180. tricky.   Usually,  a combination of line prompt and 
  1181. short  character  delay (1 or 2) works well  if  the 
  1182. remote  provides a suitable prompt.   In other cases 
  1183. fairly  long (4-7) time delays may be needed.   With 
  1184. half  duplex systems,  a line prompt or  long  (5-9) 
  1185. time delays will be needed.
  1186.  
  1187. Some   time   sharing  services  (most   using   DEC 
  1188. equipment)   will   send  a  control   s   to   stop 
  1189. transmission and a control q to restart.  If delctls 
  1190. is  set,  the transmission will work well,  but  the 
  1191. display  will probably be incoherrant if the  remote 
  1192. is  sending during the transmission.   If  a  proper 
  1193. display  is required,  use a line prompt a character 
  1194. delay also.
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221. OTERM.DOC -- OTERM Terminal Simulator                page   21
  1222.  
  1223.  
  1224. directory command.
  1225.  
  1226. The  directory  of any disk may be viewed  with  the 
  1227. directory  command.   The  only operand is the  disk 
  1228. drive letter.  If omitted the default disk is used.
  1229.  
  1230. The directory is displayed in a window at the top of 
  1231. the screen.   If there are more files than will  fit 
  1232. in the window, the scrolling function keys (4, 5, 7, 
  1233. and  8)  may be used to view the  entire  directory.  
  1234. The display is turned off with function key 6.
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  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. OTERM.DOC -- OTERM Terminal Simulator                page   22
  1283.  
  1284.  
  1285. diskspace command.
  1286.  
  1287. The  diskspace  command may be used to  display  the 
  1288. disk  space  used and remaining on any  drive.   The 
  1289. only operand is the disk drive letter.   If omitted, 
  1290. the default disk is used.
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343. OTERM.DOC -- OTERM Terminal Simulator                page   23
  1344.  
  1345.  
  1346. erase command.
  1347.  
  1348. The  erase command is used to delete a file  from  a 
  1349. disk.   It  takes a single operand,  the name of the 
  1350. file to be deleted.
  1351.  
  1352. It is possible to delete a file which is being used, 
  1353. such  as  the file being typed or read.   The  erase 
  1354. command will be accepted,  but actual deletion  will 
  1355. be defered until the file is closed.
  1356.  
  1357. If  the  file specified is the name of  a  temporary 
  1358. file   generated  for  output  (for  the  log   file 
  1359. command),  the  erase command will be accepted,  but 
  1360. will  be ineffective.   Such files are of  the  form 
  1361. TEMPnnnn.$$$, where nnnn are digits.
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404. OTERM.DOC -- OTERM Terminal Simulator                page   24
  1405.  
  1406.  
  1407. file command.
  1408.  
  1409. The  file  command is used to read a file as  if  it 
  1410. were  typed  at the console.   The file may  contain 
  1411. commands  as  an escape character  followed  by  the 
  1412. digit  for the function key desired.   The responses 
  1413. to the prompts if any must follow in the file.   All 
  1414. responses  to prompts must be terminated by  a  car-
  1415. riage return and line feed.  An escape character may 
  1416. be  sent  by entering two escape characters  in  the 
  1417. file.  This same technique is used to enter commands 
  1418. from function keys.   Control characters may be ent-
  1419. ered  into the file,  or may be specified as  escape 
  1420. followed by a character (e.g. esc @ for NUL).
  1421.  
  1422. Thus  a file may contain either Osborne or  extended 
  1423. function  key calls.   Reading of a file  terminates 
  1424. any  active  function keys.   If a file  contains  a 
  1425. command  to read another file,  control will pass to 
  1426. that file, but will not return at the end (files are 
  1427. chained not nested).
  1428.  
  1429. Reading  of  a  file may be  temporarily  halted  by 
  1430. entering function key 9 from the console.  It may be 
  1431. restarted with the file read command.
  1432.  
  1433. If  this command is entered  without  operands,  the 
  1434. file status will be displayed.
  1435.  
  1436. The following operands are recognized:
  1437.  
  1438.   Operand      Function
  1439. -----------    -------------------------------------
  1440. endfile        Terminates  reading of a  file.   The 
  1441.                file is closed.
  1442.  
  1443. halt           Temporarily stops reading of a  file.  
  1444.                The  file  may be restarted with  the 
  1445.                read operand.   This command is  only 
  1446.                useful if entered from a file.
  1447.  
  1448. lf             Allows  transmission  of  line  feeds 
  1449.                contained in the file.   Note:   this 
  1450.                also applies to function keys.
  1451.  
  1452. nolf           Ignores  line feeds contained in  the 
  1453.                file.   Note:  this  also applies  to 
  1454.                function keys.
  1455.  
  1456. read           Followed  by the name of the file  to 
  1457.                be  read.   This  must  be  the  last 
  1458.                operand on the line.  If reading of a 
  1459.                file  was halted with function key  9 
  1460.                or  by a file halt command,  the file 
  1461.                name may be * to continue the file.
  1462.  
  1463.  
  1464.  
  1465. OTERM.DOC -- OTERM Terminal Simulator                page   25
  1466.  
  1467.  
  1468. fkhelp command.
  1469.  
  1470. Displays the standard OTERM function key usage.
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526. OTERM.DOC -- OTERM Terminal Simulator                page   26
  1527.  
  1528.  
  1529. line command.
  1530.  
  1531. Sets  the  logical line size to any  length  from  1 
  1532. through 128.  The only operand is the line size.
  1533.  
  1534. NOTE:   The line size affects only the display.  The 
  1535.         log and the transmission are not affected.
  1536.  
  1537. If entered without an operand, the current line size 
  1538. will be displayed.
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587. OTERM.DOC -- OTERM Terminal Simulator                page   27
  1588.  
  1589.  
  1590. modem command.
  1591.  
  1592. Used to set the characteristics of the transmission. 
  1593.  
  1594. If entered without operands,  the current  transmis-
  1595. sion status will be displayed.
  1596.  
  1597. The following operands are recognized:
  1598.  
  1599.   Operand      Function
  1600. -----------    -------------------------------------
  1601. 300            Sets 300 baud.
  1602.  
  1603. 1200           Sets 1200 baud.
  1604.  
  1605. 7bits          Sets 7 bits transmitted.
  1606.  
  1607. 8bits          Sets 8 bits transmitted.
  1608.  
  1609. autolf         Sets  automatic transmission of  line 
  1610.                feed  after  carriage  return.   This 
  1611.                option  is usually required with host 
  1612.                mode.
  1613.  
  1614. even           Sets even parity.
  1615.  
  1616. full           Sets full duplex operation.
  1617.  
  1618. half           Sets half duplex operation.
  1619.  
  1620. host           Sets  host  mode.    All   characters 
  1621.                received   are  echoed  back  to  the 
  1622.                remote.    Use  host  mode  when  the 
  1623.                remote  is a terminal (or a  computer 
  1624.                acting as a terminal).
  1625.  
  1626. noautolf       Turns off autolf
  1627.  
  1628. noparity       Sets no parity transmitted.
  1629.  
  1630. odd            Sets odd parity.
  1631.  
  1632. rs232          Sets   operation  through  the  rs232 
  1633.                connector.   Because of hardware  re-
  1634.                strictions,  this  setting will  send 
  1635.                data  to both the rs232 connector and 
  1636.                the serial connector.
  1637.  
  1638. serial         Sets  operation  through  the  serial 
  1639.                (modem) connector.   Data is not sent 
  1640.                to the rs232 connector.
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648. OTERM.DOC -- OTERM Terminal Simulator                page   28
  1649.  
  1650.  
  1651. receive command and crcrecv command.
  1652.  
  1653. The  receive command is used to receive a file  with 
  1654. the  Ward  Christensen  modem  protocol.    This  is 
  1655. compatible  with  the  various  versions  of   modem 
  1656. (single file transfers only), xmodem and yam.
  1657.  
  1658. The  only  operand  is the name of the  file  to  be 
  1659. received  (as  it will appear on your  system  -- it 
  1660. need not be the same as on the remote).
  1661.                
  1662. The  crcrecv  command  is the same  as  the  receive 
  1663. command,  but  crc checking will be used.   This  is 
  1664. superior  to the standard checksum if the remote can 
  1665. handle it.
  1666.  
  1667. The file transmission may be canceled with  function 
  1668. key  9.   The  other  end  is not  notified  of  the 
  1669. cancellation.
  1670.  
  1671. If  the other system sends a cancel (control  x)  in 
  1672. place of the normal block header,  OTERM will inform 
  1673. you of this.  This can be useful when one end wishes 
  1674. to  halt a transmission.   Don't cancel on the first 
  1675. one though, it may just be a transmission error.
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709. OTERM.DOC -- OTERM Terminal Simulator                page   29
  1710.  
  1711.  
  1712. quit command.
  1713.  
  1714. This command returns to CP/M.
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770. OTERM.DOC -- OTERM Terminal Simulator                page   30
  1771.  
  1772.  
  1773. send command.
  1774.  
  1775. The  send  command is used to send a file  with  the 
  1776. Ward Christensen modem protocol.  This is compatible 
  1777. with  the  various versions of  modem  (single  file 
  1778. transfers only), xmodem and yam.
  1779.  
  1780. The  only operand is the name of the file to be sent 
  1781. (as it appears on your system -- it need not be  the 
  1782. same  as on the remote).
  1783.  
  1784. crc checking is implemented.  In this protocol it is 
  1785. requested by the receiver.
  1786.  
  1787. The file transmission may be canceled with  function 
  1788. key  9.   The  other  end  is not  notified  of  the 
  1789. cancellation.
  1790.  
  1791. If  the other system sends a cancel (control  x)  in 
  1792. place of the normal block header,  OTERM will inform 
  1793. you of this.  This can be useful when one end wishes 
  1794. to  halt a transmission.   Don't cancel on the first 
  1795. one though, it may just be a transmission error.
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831. OTERM.DOC -- OTERM Terminal Simulator                page   31
  1832.  
  1833.  
  1834. type command
  1835.  
  1836. Used  to  display  a file.   A  single  operand,  an 
  1837. unambiguous  file name,  is accepted.   The file  is 
  1838. displayed  as a secondary  display.   The  scrolling 
  1839. function keys (4 and 5 only) are active.
  1840.  
  1841. The  file must be a standard CP/M text file,  except 
  1842. that  a  file  with  lines  terminated  by  carriage 
  1843. return,   but  no  line  feed,   will  be  displayed 
  1844. properly.
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892. OTERM.DOC -- OTERM Terminal Simulator                page   32
  1893.  
  1894.  
  1895. wait command
  1896.  
  1897. This  command delays transmission for from 1 through 
  1898. 60 seconds.   This is sometimes useful in sending  a 
  1899. file  without  protocol to allow for some action  by 
  1900. the  remote.   The  only operand is  the  number  of 
  1901. seconds to wait.
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953. OTERM.DOC -- OTERM Terminal Simulator                page   33
  1954.  
  1955.  
  1956. Protocol file transfers.
  1957.  
  1958. This  section contains information on using OTERM to 
  1959. send and receive files.   The information on use  of 
  1960. other  programs is,  of course,  not to be taken  as 
  1961. absolute.   There  are  many different  versions  of 
  1962. other programs which will communicate with OTERM and 
  1963. details   vary.     When   in   doubt,   check   the 
  1964. documentation  of  the other program.   Most  rcpm's 
  1965. have help files or documentation files available.
  1966.  
  1967. To  communicate  with another  system,  one  of  the 
  1968. systems  must have an originate modem,  the other an 
  1969. answer  modem  (not necessarily auto  answer  -- the 
  1970. term  answer  here refers only  to  the  frequencies 
  1971. used).   Most moderately priced to expensive  modems 
  1972. can operate in either originate or answer mode.
  1973.  
  1974.  
  1975. Transfers from OTERM to OTERM
  1976.  
  1977. It  is  usually best to first  establish  communica-
  1978. tions.   One of the systems is set to host mode  and 
  1979. auto  line feed transmission (modem host autolf) and 
  1980. the other to full duplex (modem full).   It is  then 
  1981. possible to communicate through OTERM.   Once commu-
  1982. nications have been established, the receiver enters 
  1983. the  crcrecv command and the sender enters the  send 
  1984. command.  The transfer will then begin.
  1985.  
  1986. One  may  use the receive command,  but the  crcrecv 
  1987. command gives greater assurance of correct  transfer 
  1988. at no measurable cost.
  1989.  
  1990.  
  1991. Transfers with other systems
  1992.  
  1993. The same method as for OTERM-OTERM transfers  should 
  1994. be used,  if possible.   Some programs,  however, do 
  1995. not  allow establishing communications as a terminal 
  1996. first.   In  that case,  once the modems have  esta-
  1997. blished carriers,  enter the required  commands.  If 
  1998. the  other system allows crc checking,  it should be 
  1999. used.
  2000.  
  2001. Some programs are set up for automatic selection  of 
  2002. crc checking.   If sending a file to such a program, 
  2003. issue  the  send command to OTERM before  the  other 
  2004. system issues the receive command.
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014. OTERM.DOC -- OTERM Terminal Simulator                page   34
  2015.  
  2016.  
  2017. Receiving from an rcpm.
  2018.  
  2019. Most rcpm's use the following method.
  2020.  
  2021. Type (to the rcpm, not as an OTERM command)
  2022.  
  2023.                xmodem s <filename>
  2024.  
  2025. followed by return.   <filename>  is the name of the 
  2026. file as it appears on the rcpm.   The xmodem program 
  2027. will type a message telling you that it can transfer 
  2028. the file or that there is an error.  Usually, if the 
  2029. file  can  be transferred it will tell you the  size 
  2030. and  the  estimated  transmission  time.   When  the 
  2031. message is complete, enter the OTERM command
  2032.  
  2033.                crcrecv <filename>
  2034.  
  2035. where  <filename> is the file name you wish to  use.  
  2036. Usually it should be the same as on the rcpm, except 
  2037. that  files with type .OBJ should be  received  with 
  2038. type .COM.   These are really COM files, but are put 
  2039. on the rcpm with a different type so you will not be 
  2040. able to run them.  Usually, you cannot receive files 
  2041. with type .COM on the rcpm.
  2042.  
  2043. A few systems do not support crc checking.   In that 
  2044. case, use the receive command.
  2045.  
  2046.  
  2047. Sending to an rcpm
  2048.  
  2049. This is similar to receiving.   The command for  the 
  2050. rcpm is
  2051.  
  2052.                xmodem rc <filename>
  2053.  
  2054. for  sending with crc checking.   If crc checking is 
  2055. not available, the command is
  2056.  
  2057.                xmodem r <filename>
  2058.  
  2059. The OTERM command is
  2060.  
  2061.                send <filename>
  2062.  
  2063. Rcpm's  will not accept files with a type  of  .COM.  
  2064. Use  the  type  .OBJ  in the  xmodem  command  (many 
  2065. systems will automatically change it if you forget.)
  2066.  
  2067. Some  systems  will automatically put the  file  you 
  2068. send to a special area.   Others ask that you put it 
  2069. in  some special area yourself.   A few  don't  care 
  2070. where you put it.
  2071.  
  2072.  
  2073.  
  2074.  
  2075. OTERM.DOC -- OTERM Terminal Simulator                page   35
  2076.  
  2077.  
  2078.  
  2079.  
  2080. Transferring files with CompuServe
  2081.  
  2082. Make  sure  cis protocol is on in  OTERM  (cis  on).  
  2083. You  may generally leave it on.   It will seldom  do 
  2084. any harm.
  2085.  
  2086. There are no OTERM commands directly associated with 
  2087. CompuServe  file transfers.   You enter commands  to 
  2088. CompuServe,   and  the  system  sends  the  required 
  2089. instructions to OTERM.
  2090.  
  2091. To  send or receive a file from your user  area,  or 
  2092. from  another user area which is accessable to  you, 
  2093. enter the (CompuServe) command
  2094.  
  2095.                r xftran
  2096.  
  2097. You will be prompted for details.
  2098.  
  2099. To   receive   a  file  from   access,   enter   the 
  2100. (CompuServe) command
  2101.  
  2102.                dow <filename>
  2103.  
  2104. where <filename> is the name of the file you wish to 
  2105. receive.  Again, you will be prompted for details.
  2106.  
  2107.  
  2108. Display during transfers
  2109.  
  2110. During the transfer,  OTERM displays the block being 
  2111. sent  or received and the number of retries.   If  a 
  2112. retry  is  required,   OTERM  displays  the  reason.  
  2113. Retries are made if either end discovers an error in 
  2114. the  transmission.   If there are a great number  of 
  2115. retries required, the phone line is probably bad.  A 
  2116. few retries are no cause for concern.  In some cases 
  2117. transmission errors may cause the transmission to be 
  2118. halted.   OTERM will always inform you of this,  and 
  2119. if  a  file is being received will delete the  file.  
  2120. In this case,  an old file of the same name will  be 
  2121. retained.
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136. OTERM.DOC -- OTERM Terminal Simulator                page   36
  2137.  
  2138.  
  2139. Common problems.
  2140.  
  2141. Protocol file transfers.
  2142.  
  2143. The most common problem in making protocol transfers 
  2144. is failure to use a program in the remote which uses 
  2145. a  compatible protocol or using the wrong  protocol.  
  2146. OTERM  can communicate with programs using the  Ward 
  2147. Christensen  modem  protocol,  with or  without  crc 
  2148. checking,  or  with programs using the CompuServe  A 
  2149. protocol.
  2150.  
  2151. Versions of modem (a terminal program) are available 
  2152. for  most  CP/M systems at no cost.   Some  versions 
  2153. (modem 7) also support a batch transmission protocol 
  2154. for sending multiple files.   This batch protocol is 
  2155. not supported by OTERM.
  2156.  
  2157. The modem protocol is also supported by xmodem (used 
  2158. by remote CP/M (rcpm) systems), by yam (available at 
  2159. no  charge from CompuServe CP/M Interest Group  (CP-
  2160. MIG), or from many rcpm systems), and by a number of 
  2161. commercial terminal programs.
  2162.  
  2163. The  CompuServe A protocol is primarily  useful  for 
  2164. uploading  and  downloading from  CompuServe.   This 
  2165. protocol  is controled by the remote  (OTERM  cannot 
  2166. act as host for this protocol).  Programs are avail-
  2167. able from CompuServe CP-MIG to allow CP/M systems to 
  2168. act  as host,  but it usually will be better to  use 
  2169. the modem protocol.
  2170.  
  2171.  
  2172. Double spacing
  2173.  
  2174. Line feeds may be supplied by the remote or by OTERM 
  2175. or may be supplied on the screen only.  If more than 
  2176. one source is supplying line feeds, the display will 
  2177. be double spaced.   For most time sharing systems or 
  2178. bulletin boards,  line feeds will be supplied by the 
  2179. remote and OTERM should be set to 
  2180.  
  2181.                console noautolf
  2182.                modem noautolf
  2183.                file nolf
  2184.  
  2185. When  communicating  with a terminal (or a  terminal 
  2186. program)  OTERM  will usually have  to  supply  line 
  2187. feeds and should be set to
  2188.  
  2189.                console noautolf
  2190.                modem autolf
  2191.                file nolf
  2192.  
  2193. In this case, OTERM will usually be in host mode.
  2194.  
  2195.  
  2196.  
  2197. OTERM.DOC -- OTERM Terminal Simulator                page   37
  2198.  
  2199.  
  2200.  
  2201. Characters not displayed or 
  2202. Characters displayed twice
  2203.  
  2204. In full duplex mode, characters typed are not shown 
  2205. on the screen and must be echoed by the "host".   In 
  2206. half  duplex  mode,  each  side is  responsible  for 
  2207. displaying  characters  it  sends,   but  most  time 
  2208. sharing  services  and bulletin boards  will  supply 
  2209. "free"  line  feed.    When  communicating  with   a 
  2210. terminal, OTERM may act as the host.
  2211.  
  2212. OTERM  and the remote must be in agreement with  the 
  2213. remote  as  to whether the transmission is  full  or 
  2214. half  duplex.   Most bulletin boards operate only in 
  2215. full  duplex mode.   Most time sharing  systems  may 
  2216. operate  in either full or half duplex  mode.   Full 
  2217. duplex is generally best as the echo gives assurance 
  2218. that  characters were received properly.   A notable 
  2219. exception  is  that  time  sharing  systems  on  IBM 
  2220. mainframes usually operate in half duplex mode only.
  2221.  
  2222. If  OTERM  is in half duplex mode while  the  remote 
  2223. thinks it is host to full duplex,  anything you type 
  2224. will  be  displayed  twice.   If OTERM  is  in  full 
  2225. duplex, while the remote thinks it is in half duplex 
  2226. mode,  nothing you type will be displayed.   If both 
  2227. OTERM  and  the remote are acting as hosts  to  full 
  2228. duplex, a character will be repeated indefinitely.
  2229.  
  2230.  
  2231. Unable to establish communications.
  2232.  
  2233. This is usually due to incompatibility of the modems 
  2234. being  used (there are two incompatible  "standards" 
  2235. for  1200  baud modems.   If you and the remote  are 
  2236. using different standards, you will get nowhere.) or 
  2237. by  incompatibility of the  transmissions  settings.  
  2238. The two sides should be in agreement as to data rate 
  2239. (OTERM  supports 300 baud or 1200 baud),  number  of 
  2240. stop bits,  number of data bits,  and parity.   Most 
  2241. systems will work with 8 data bits,  1 stop bit,  no 
  2242. parity.
  2243.  
  2244.  
  2245. Problems with nonprotocol file sending.
  2246.  
  2247. A  good  deal of playing around may be necessary  to 
  2248. get  the transmission to work properly.   If at  all 
  2249. possible,  a line prompt should be used.   In  other 
  2250. cases, it may be necessary to set the delay to time.  
  2251. When  all  else fails,  try long time delays  (5-9).  
  2252. The transmission will be painfully slow, but in most 
  2253. cases this will work.
  2254.  
  2255.  
  2256.  
  2257.  
  2258. OTERM.DOC -- OTERM Terminal Simulator                page   38
  2259.  
  2260.  
  2261. Remember  that with nonprotocl transfers there is no 
  2262. error checking.   Line noise may garble a  character 
  2263. and  the  error  will be  undetected.   Do  not  use 
  2264. nonprotocol  transfers if the other system  supports 
  2265. the modem or CIS protocol.
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319. OTERM.DOC -- OTERM Terminal Simulator                page   39
  2320.  
  2321.  
  2322.         Browse.................................. 12
  2323.         Characters displayed twice.............. 33
  2324.         Characters not displayed................ 33
  2325.         Cis command............................. 13
  2326.         Clear command........................... 14
  2327.         Commands................................  5
  2328.         Common problems......................... 33
  2329.         CompuServe A protocol................... 13
  2330.         Console command......................... 15
  2331.         Control q...............................  5
  2332.         Control s...............................  5
  2333.         Crcrecv command......................... 25
  2334.         Credits.................................  1
  2335.         Delay command........................... 17
  2336.         Description.............................  2
  2337.         Directory command....................... 19
  2338.         Diskspace command....................... 20
  2339.         Display during transfers................ 32
  2340.         Double spacing.......................... 33
  2341.         Erase command........................... 21
  2342.         Extended function keys..................  8
  2343.         File command............................ 22
  2344.         File name...............................  9
  2345.         Fkhelp command..........................  6,22
  2346.         Function key............................ 17
  2347.         Function key 1..........................  5, 9
  2348.         Function key 6.......................... 12,19
  2349.         Function key 9..........................  9,13,22,25,27
  2350.         Function Keys...........................  6, 6
  2351.         Limitations.............................  3
  2352.         Line command............................ 15,23
  2353.         Log command............................. 10
  2354.         Modem...................................  5
  2355.         Modem command........................... 24
  2356.         Modify OTERM............................  9
  2357.         New disk................................  9
  2358.         New features/corrections................  4
  2359.         OTERM Commands..........................  9
  2360.         Printer.................................  3
  2361.         Problems with nonprotocol file sending.. 34
  2362.         Protocol file transfers................. 30,33
  2363.         Quit command............................ 26
  2364.         Receive command......................... 25
  2365.         Receiving from an rcpm.................. 31
  2366.         Revision level..........................  3
  2367.         RS232 interface.........................  5
  2368.         Scrolling function keys................. 12,19,28
  2369.         Send command............................ 27
  2370.         Sending a file.......................... 17
  2371.         Sending to an rcpm...................... 31
  2372.         Transferring files with CompuServe...... 31
  2373.         Transfers from OTERM to OTERM........... 30
  2374.         Transfers with other systems............ 30
  2375.         Type command............................ 28
  2376.         Unable to establish communications...... 34
  2377.  
  2378.  
  2379.  
  2380. OTERM.DOC -- OTERM Terminal Simulator                page   40
  2381.  
  2382.  
  2383.         Using OTERM (summary)...................  5
  2384.         Using the log........................... 11
  2385.         Wait command............................ 29
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.