home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / comm / host-iii.lzh / HOST-III.DOC next >
Text File  |  1985-10-01  |  32KB  |  1,412 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                HOST-III
  25.  
  26.                               Version 1.1
  27.  
  28.  
  29.        Unattended Teons for the IBM Personal Computer
  30.                   Requires a Hayes Smartmodem and 128K
  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.                    Copyright 1984 William HT Bailey
  60.                          All Rights Reserved
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.       COMMERCIAL                  COMMERCIAL                  COMMERCIAL
  70.  
  71.  
  72.  
  73.  
  74.                     --- REQUEST FOR CONTRIBUTION --
  75.  
  76. If  you  are  using  this  program  and  find  it  to  be  of value then a $35
  77. contribution is suggested.
  78.                            William HT Bailey
  79.                             P.O. Box 29723
  80.                        Elkins Par, PA 19117-0923
  81.                          Compuserve: 74145,1046
  82.  
  83.  
  84.                      --- USER SUPPORTED CONCEPT ---
  85.  
  86. This  HOST-III / HOSTCALL software package is being distributed under the USER
  87. SUPPORTED  concept.  That is you are granted permission to copy and share this
  88. program  as  long  as  no  price is charged for the software or documentaion.
  89. Contributions,  although  completely voluntary, will compensate the Author for
  90. his  effort  and will ensure further development. Anyone may request a copy of
  91. this package by either
  92.     1. Sending the Author a blank formatted double-sided diskette (or 2 single
  93.        sided diskettes) along with a self-addressed postage-paid mailer
  94. or
  95.     2. Sending the Author $35 in which case the  diskette, mailer  and postage
  96.        will be supplied.
  97.  
  98.  
  99.                              --- DISCLAIMER ---
  100.  
  101. In  no  event  will the Author be liable to you for any damages, including any
  102. lost  profits,  lost  savings  or  other  incidental  or consequential damages
  103. arising  out  of  the  use  of or inability touse these programs, even if the
  104. Author  has  been advised of the possibility of such damages, or for any claim
  105. by any other party.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.       COMMERCIAL                  COMMERCIAL                  COMMERCIAL
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.                                HOST-III
  144.  
  145.                               Version 1.1
  146.  
  147.  
  148.        Unattended Telecommunications for the IBM Personal Computer
  149.                   Requires a Hayes Smartmodem and 128K
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.                                CONTENTS
  160.  
  161.                                                                          Page
  162.  
  163.    I. eneral Description ...............................................  1
  164.   II. HOST-III Setup ...................................................  6
  165.  III. HOST-III Signon ...................................................  9
  166.   IV. User Commands ..................................................... 10
  167.    V. System Operator Commands ......................................... 13
  168.   VI. File Transmission ................................................. 15
  169.  VII. File Reception .................................................... 17
  170. VIII. HOST-III Signoff and Reset ........................................ 19
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                    HOST-III
  202.  
  203.  
  204. I. General Description
  205.  
  206. This section has two objectives. They are:
  207.     1. To describe the uses of this program.
  208.     2. To  provide  enough information so that you can start using the program
  209.        immediately.
  210. The  second  objective  is  possible, ecause the use of this program is quite
  211. straight  forward.  You  will  find  the  details which will enable you to use
  212. HOST-III to its fullest capability in the remaining sections.
  213.  
  214. If you and a friend have ever transferred files over the telephone lines using
  215. manual communication packages, then you know that it involves a lot of message
  216. typing  to coordinate who is going to send what when and making sure that the
  217. receiver  is ready. HOST-III takes care of that coordination at your end. Your
  218. friend at the other end transfers the files at his own pace while you watch or
  219. attend  to  some  other  business. You could also use this program to transfer
  220. files to and from your computer while you are omeplace else. These are just a
  221. couple  of  examples  of  how  HOST-III can be used. In general it can be used
  222. whenever  one  end of a communications link must be automated. However, if the
  223. computer  at  the  other  end  is  running  HOSTCALL,  then  both  ends of the
  224. communications link will be automated.
  225.  
  226. In  normal  operation, HOST-III assumes tat the file it is transferring is an
  227. ASCII  file.  However  ANY  type of file can be transferred if the user at the
  228. other  end  invokes  the  XMODEM protocol of file transmission (and the user's
  229. program supports this protocol). This protocol is invoked by appending a +X to
  230. a filename specification. The XMODEM protocol is simply a sophisticated method
  231. of transferring files.
  232.  
  233. HOST-III  asks   for  a  password  before  it  allows files to be transferred.
  234. Initially the password is WORD.
  235.  
  236. The program recognizes 9 commands from the user at the other end. They are:
  237.     A - List the fles on drive A.
  238.     B - List the files on drive B.
  239.     C - List the files on drive C.
  240.     D - List the files on drive D.
  241.     G - Signoff (GOODBYE).
  242.     M - Send message.
  243.     R - Receive a file from the remote location.
  244.     T - Transmit a file to the remote location.
  245.     ? - Summarize the commands.
  246.  
  247. The  program  recognizes  4 commands from the ystem operator at its end. They
  248. are:
  249.     CTRL Prtsc - Printout on / Printout off (of intercomputer correspondence).    ALT D      - Display files / View a file. (Inactive during a comm. link).
  250.     ALT M      - Send message to remote location.
  251.     ALT X      - Exit program.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                       -1-
  263.  
  264.  
  265.  
  266.                                   HOST-III
  267.  
  268.  
  269. Some other important notes concerning this program are:
  270.     1. HOST-III requires the use of a Hayes Smartmodem and 128K memory.
  271.     2. An  active communication  link is automatically closed, if 5 minutes of
  272.        inactivity passes.
  273.     3. If  a  file  that  is  that is being  received as an ASCII file already
  274.        exists, then the received file is attached to the end of the old file.
  275.     4. If  a  file  that  is being received  under the XMODEM protocol already
  276.        exists, then the old file is first deleted.
  277.  
  278. After the simple setup procedure (dscribed in detail in section II), HOST-III
  279. is  ready to accept a telephone call. The 2 figures at the end of this secion
  280. contain examples of HOST-III sessions. Note that the numbers on the right side
  281. of  these  figures  are not produced by the program. They are in these figures
  282. for the sake of this discussion.
  283.  
  284. Figure  1 illustrates a session in wich the user at the remote location sends
  285. the  ASCII  file  PROG1.BAS  to HOST-III and requests the ASCII file PROG2.BAS
  286. from HOST-III. The following is a line by line discussion of figure 1.
  287.     Line  1. HOST-III asks  for the password and the user responds with WORD.
  288.     Line  2. This is the program's message indicating a successful signon.
  289.     Lne  3. At the program's prompt (>), the user issues a ? command.
  290.     Ln 5-14. HOST-III lists the summary of commands.
  291.     Line 16. The user issues an R command.
  292.     Line 17. HOST-III  requests  the  name  of  the file  the user is about to
  293.              send.  The  drive  on  which the user wants the file to be stored
  294.              may  be  part  of  the  specification.  The  user  responds  with
  295.              B:PROG1.BAS.
  296.     Line 19. After  the  program  opens the file it is about to receive, it is
  297.              ready for the user to send it.
  298.  
  299.              The  file transfer occrs between lines 17 and 18. HOST-III lists
  300.              the file on the screen as the file is being received.
  301.  
  302.     Line 20. At  the end of the file, HOST-III pauses for about 15 seconds and
  303.              then  asks  the  user  to  confirm that  the end of file has been
  304.              reached. The user responds with Y.
  305.     Line 21. The  program closes he file it has just received and issues this
  306.              message.
  307.     Line 22. The user issues a T command.
  308.     Line 23. HOST-III requests the name of the file the user wants it to send.
  309.              The  drive  on  which  the  file  resides  may  be  part  of  the
  310.              specification. The user responds with B:PROG2.BAS.
  311.     Line 25. The  program  informs  the  user  that he has about 15 seconds to
  312.              prepare his end to receive the file.
  313.     Line 26. The  program  informs the user that he may abort the transmission
  314.              by typing an X.
  315.  
  316.              he  file transfer occurs between lines 24 and 25. HOST-III lists
  317.              the file on its screen as the file is being sent.
  318.  
  319.     Line 27. This  is  the end of file message. It is in the format of a BASIC
  320.              remark statement, so that a transmitted BASIC program may be used
  321.              without  having  to first edit it. (This message isnot sent when
  322.              HOST-III is operating with HOSTCALL).
  323.     Line 28. Notice that HOST-III does not issue a prompt after transmitting a
  324.              file.  However  it  still  ready  for  the next command. The user
  325.              issues the signoff command.
  326.     Line 29. The program responds with the signoff message.
  327.  
  328.                                       -2-
  329.  
  330.  
  331.  
  332.                                    HOST-III
  333.  
  334.  
  335.  
  336. Figure  2  illustrates  a  session  in  which  the user at the remote location
  337. requests  that  the file PROG.COM be sent from HOST-III under XMODEM protocol.
  338. The following is a line by line discussion of figure 2.
  339.     Lns 1,2. Signon.
  340.     Line  3. The user issues a T command.
  341.     ine  4. HOST-III  requests  the  name  of the file. The user responds and
  342.              appends to the end of the filename specification a +X, indicating
  343.              that the program is to be sent under the XMODEM protocol.
  344.  
  345.              The file transfer occurs between lines 4 and 5. The program lists
  346.              numerous  transmission  status  messages on the screen throughout
  347.              the transfer.
  348.  
  349.     Lns 5,6. Signoff.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                       -3-
  395.  
  396.  
  397.  
  398.                                    HOST-III
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. PASSWORD? WRD                                                           --  1
  406. *** ENTER ? FOR SUMMARY OF COMMANDS ***                                 --  2
  407. >?                                                                       --  3
  408.                                                                          --  4
  409.       --- SUMMARY OF COMMANDS ---                                       --  5
  410. A - LIST THE FILES ON DRIVE A                                            --  6
  411. B - LIST THE FILES ON DRIVE B                                            --  7
  412. C - LIST THE FILES ON DRIVE C                                            --  8
  413. D - LIST THE FILES ON DRIVE D                                            --  9
  414. G - SIGNOFF (GOODBYE)                                                    -- 10
  415. M - SEND MESSAGE                                                         -- 11
  416. R - RECEIVE A FILE FROM YOUR LOCATION                                    -- 12
  417. T - TRANSMIT A FILE TO YOUR LOCATION                                     -- 13
  418. ? - PRINT THE SUMMARY OF COMMANDS                                        -- 14
  419.                                                                          -- 15
  420. >R                                                                       -- 16
  421. NAME OF FILE: B:PROG1.BAS                                               -- 17
  422.                                                                          -- 18
  423. *** READY TO RECEIVE FILE ***                                            -- 19
  424.                     .
  425.                     .
  426.                     .
  427. RECEPTION SUSPENDED. END OF FILE? (Y/N) Y                                -- 20
  428. ***RECEPTION TERMINATED ***                                             -- 21
  429. >T                                                                       -- 22
  430. NAME OF FILE: B:PROG2.BAS                                                -- 23
  431.                                                                         -- 24
  432. *** TRANSMISSION BEGINNING IN 15 SECONDS ***                             -- 25
  433.     TYPE X TO ABORT TRANSMISSION                                         -- 26
  434.                     .
  435.                     .
  436.                     .
  437. 65529 ' *** TRANSMISSION COMPLETE ***                                    -- 27
  438. G                                                                        -- 28
  439. *** GOODBYE ***                                                          -- 29
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448. FIGURE 1. Sample HOST-III session.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                       -4-
  461.  
  462.  
  463.  
  464.                                    HOST-III
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. PASSWORD? WRD                                                           --  1
  472. *** ENTER ? FOR SUMMARY OF COMMANDS ***                                  --  2
  473. >T                                                                       --  3
  474. NAME OF ILE: A:PROG.COM+X                                               --  4
  475.                     .
  476.                     .
  477.                     .
  478. G                                                                        --  5
  479. *** GOODBYE ***                                                          --  6
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488. FIGURE 2. Sample HOST-III session using XMODEM.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                       -5-
  527.  
  528.  
  529.  
  530.                                    HOST-III
  531.  
  532.  
  533. II. HOST-III Setup
  534.  
  535. This  section  describes  the  setup  procedure  that you must complete before
  536. HOST-III  will  be  ready  to  receive  a  telephone call. The setup procedure
  537. involves  getting  the  program  started  ad  providing  information  on  the
  538. following items:
  539.     Password
  540.     Communication parameters
  541.     Screen width
  542. Your  setup  will  be  saved  and presented to you the next time you start the
  543. program. Therefore the full setup must be completed only on the first time you
  544. run the program, and when you want to change the setup.
  545.  
  546.  
  547.  
  548.  
  549. Connect and turn on your Hayes Smartmodem. Insure that the lights above the TR
  550. and MR are lit.
  551.  
  552.  
  553.  
  554. The following are the 2 steps required to get HOST-III loaded and running:
  555.  
  556.     1 . Insert  a  disk containing the Disk Operating System into disk drive A
  557.         (the drive on the left) and turn on the computer. Answer any questions
  558.         the  computer may ask you (such as DATE and TIME) until you get to the
  559.         point where the computer prompts you with
  560.  
  561.         A>
  562.  
  563.     2a. If the disk currently in drive A contains HOST-III then type
  564.  
  565.         HOST-III
  566.  
  567.         Press carriage return.
  568.  
  569.     2b If  the  disk  does  not contain HOST-III  then  remove  the  disk and
  570.         insert your disk containing HOST-III into drive A. Type
  571.  
  572.         HOST-III
  573.  
  574.         Press carriage return.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                       -6-
  593.  
  594.  
  595.  
  596.                                    HOST-III
  597.  
  598.  
  599. HOST-III  begins  by  printing a heading, a copyright ntice and the following
  600. questions.
  601.  
  602.  
  603.     Current password is WORD
  604.     Is this OK? (Y,N):
  605.  
  606. A  user  of HOST-III must provide the current password before he/she is signed
  607. on.  If  you  do not want to change the current password, then enter Y (or y).
  608. If you  do  want  to change the current password, then enter N (or n).
  609.  
  610.  
  611.     Enter new password:
  612.  
  613. If  you  responded  to the previous question with N, then the program will ask
  614. for the new password. This new password of 8 characters or less will remain in
  615. effect  for  this  and  all  future  uses  of HOST-III, until it is once againchanged. UPPER AND LOWER CASE LETTERS ARE NOT INTERCHANGABLE. For instance, if
  616. you change the password to abcdef, then program will not sign on a user if he/
  617. she  enters  ABCDEF  as the password. If you are using HOST-III with HOSTCALL,
  618. then  changing  the  password will have no effect on operations since HOSTCALL
  619. bypasses the password requirement.
  620.  
  621.  
  622.     Do you want to lockout HOSTCALL? (Y,N):
  623.  
  624. Since HOSTCALL bypasses the password requirement, a person calling your system
  625. using HOSTCALL could access your files despite a changed password. This option
  626. permits  you  to  prevent access of your system by HOSTCALL. Enter Y (or y) if
  627. you want to lockout HOSTCALL. ENTER N (OR n) IF YOU DESIRE COMMUNICATIONS WITH
  628. HOSTCALL.
  629.  
  630.  
  631.     Current communication parameters are:
  632.          SPEED     300
  633.          PARITY    E
  634.          DATA BITS 7
  635.          STOP BITS 1
  636.     Are they OK? (Y,N):
  637.  
  638. If you do not want to change the communication parameters, the enter Y (or y),
  639. and  the  program will skip the next 4 questions. If you do want to change the
  640. communicatin  parameters,  then enter N (or n). If you do not understand this
  641. question,  then  enter  Y (or y) since the default parameters will suffice for
  642. most cases.
  643.  
  644.  
  645.     SPEED (75,110,150,300,600,1200):
  646.  
  647. Enter   transmission   speed.  (This  question  is  skipped,  if  the  current
  648. communication parameters are OK).
  649.  
  650.  
  651.     PARITY (S,O,M,E,N):
  652.  
  653. Enter  parity  type.  (This  question is skipped, if the current communication
  654. parameters are OK).
  655.  
  656.  
  657.                                       -7-
  658.  
  659.  
  660.  
  661.                                    HOST-III
  662.  
  663.  
  664.  
  665.     DATA BITS (4,5,6,7,8):
  666.  
  667. Enter  the  number  of  data  bits.  (This question is skipped, if the current
  668. communication parameters are OK).
  669.  
  670.  
  671.     STOP BITS (1,2):
  672.  
  673. Enter  the  number  of  stop  bits.  (This question is skipped, if the current
  674. communication parameters are OK).
  675.  
  676.  
  677.     Choose screen width (40,80):
  678.  
  679. Choose  the  number  of  characters you want displayed across your screen. You
  680. shoul choose 80 unless your display does not have the resolution to handle an
  681. 80 column screen.
  682.  
  683.  
  684. At this point the program will clear the screen, display the message
  685.  
  686.     ********* HOST COMPUTER III program active *********
  687.  
  688. and turn on the light above the AA on the Smartmodem. HOST-III is now ready to
  689. receive a telephone call.
  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.  
  722.                                       -8-
  723.  
  724.  
  725.  
  726.                                    HOST-III
  727.  
  728.  
  729. III. HOST-III Sinon
  730.  
  731. This  section describes the signon procedure that a user calling into HOST-III
  732. must complete before he/she will be allowed to transfer files.
  733.  
  734.  
  735. When  a  user  dials HOST-III, the program answers the telephone and asks  the
  736. user the question
  737.  
  738.     PASSWORD?
  739.  
  740. If an incorrect password is given, then the program says
  741.  
  742.     TRY AGAIN
  743.  
  744. If  the  correct  password is not given in 3 tries, then the program tells the
  745. user
  746.  
  747.     *** GOODBYE ***
  748.  
  749. and signs off.
  750.  
  751.  
  752. If the current password is received within 3 tries, then the program says
  753.  
  754.     *** ENTER ? FOR SUMMARY OF COMMANDS ***
  755.     >
  756.  
  757. and signon is complete.
  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.                                       -9-
  789.  
  790.  
  791.  
  792.                                    HOST-III
  793.  
  794.  
  795. IV. User Commands
  796.  
  797. This  section  describes  the  commands that a user can issue to HOST-III once
  798. he/she is signed on.
  799.  
  800.  
  801. HOST-III recognizes 9 single character commands from the user. THey are:
  802.  
  803.     A - List the files on drive A
  804.     B - List the files on drive B
  805.     C - List the files on drive C
  806.     D - List the files on drive D
  807.     G - Signoff (GOODBYE)
  808.     M - Send Message
  809.     R - Receive a file from the remote location
  810.    T - Transmit a file to the remote location
  811.     ? - Summarize the commands
  812.  
  813. The prompt
  814.  
  815.     >
  816.  
  817. indicates  that the program is ready to accept a command. All commands must be
  818. terminated  with  a  carriage  return.  If HOST-III is expecting a command but
  819. receives something longer than 1 character, then it issues the message
  820.  
  821.     SINGLE CHARACTER CMMANDS PLEASE
  822.  
  823.  
  824.  
  825.  
  826. A description of how HOST-III responds to each command follows.
  827.  
  828.  
  829.                                       A
  830.  
  831. The program responds with
  832.  
  833.     FILES A
  834.  
  835. and sends the file directory of the disk in drive A. Possible error conditions
  836. such  as an open drive door or an empty drive will be detected and will result
  837. in  the  program  issuing  a message  followed by its prompt. The program will
  838. then wait for the next command.
  839.  
  840.  
  841.                                       B
  842.  
  843. The program responds with
  844.  
  845.     FILES B
  846.  
  847. and sends the file directory of the disk in drive B. Possible eror conditions
  848. such  as an open drive door or an empty drive will be detected and will result
  849. in  the  program  issuing  a message followed  by its prompt. The program will
  850. then wait for the next command.
  851.  
  852.  
  853.  
  854.                                      -10-
  855.  
  856.  
  857.  
  858.                                    HOST-III
  859.  
  860.  
  861.                                       C
  862.  
  863. The progam responds with
  864.  
  865.     FILES C
  866.  
  867. and sends the file directory of the disk in drive C. Possible error conditions
  868. such  as an open drive door or an empty drive will be detected and will result
  869. in  the  program  issuing  a message  followed by its prompt. The program will
  870. then wait for the next command.
  871.  
  872.  
  873.                                       D
  874.  
  875. The program responds with
  876.  
  877.     FILES D
  878.  
  879. and sends the file directory of the disk in drive D. Possible error conditions
  880. suh  as an open drive door or an empty drive will be detected and will result
  881. in  the  program  issuing  a message followed  by its prompt. The program will
  882. then wait for the next command.
  883.  
  884.  
  885.                                       G
  886.  
  887. This  is the signoff command. It must be issued before the user hangs up. Upon
  888. receiving the signoff command, HOST-III issues a
  889.  
  890.     *** GOODBYE ***
  891.  
  892. and  resets  itself so that it may receive the next call. The user may hang up
  893. after he/she receives the
  894.  
  895.     *** GOODBYE ***
  896.  
  897.  
  898.                                       M
  899.  
  900. This command allows the user to send a one line message to the system operator
  901. (the  operator  at  the computer which is running HOST-III). User messages are
  902. received  and  printed  without  interpretation by the program. Upon receiving
  903. this command, the program transmits
  904.  
  905.     ENTER 1 LINE MESSAGE
  906.  
  907. At the same time HOST-III beeps its buzzer and prints on its screen
  908.  
  909.     *** USER ESSAGE ***
  910.  
  911. At  this  point  the  user  may  enter  his/her message followed by a carriage
  912. return.
  913.  
  914.  
  915.                                       R
  916.  
  917. This command is described in section VII.
  918.  
  919.  
  920.                                      -11-
  921.  
  922.  
  923.                                    HOST-III
  924.  
  925.  
  926.  
  927.                                       T
  928.  
  929. This command is described in section VI.
  930.  
  931.  
  932.  
  933.                                       ?
  934.  
  935. This  command  results  in  the  printout  of the user's command options. Upon
  936. receiving this command the program transmits
  937.  
  938.          --- SUMMARY OF COMMANDS ---
  939.     A - LIST HE FILES ON DRIVE A
  940.     B - LIST THE FILES ON DRIVE B
  941.     C - LIST THE FILES ON DRIVE C
  942.     D - LIST THE FILES ON DRIVE D
  943.     G - SIGNOFF (GOODBYE)
  944.     M - SEND MESSAGE
  945.     R - RECEIVE A FILE FROM YOUR LOCATION
  946.     T - TRANSMIT AFILE TO YOUR LOCATION
  947.     ? - PRINT THE SUMMARY OF COMMANDS
  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.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.                                      -12-
  986.  
  987.  
  988.  
  989.                                    HOST-III
  990.  
  991.  
  992. V. System Operator Commands
  993.  
  994. This  section  describes  the  options available to the person at the computer
  995. which  is  running  HOST-III.  This person (which is ou) is called the system
  996. operator.
  997.  
  998.  
  999. HOST-III recognizes 4 commands from the system operator. They are:
  1000.  
  1001.     CTRL Prtsc - Printout on / Printout off (of intercomputer correspondence).
  1002.     ALT D      - Display files / View a file. (Inactive during a comm. link).
  1003.     ALT M      - Send message to remote location.
  1004.     ALT X      - Exit program.
  1005.  
  1006. They are activated by a double key depression. That is, the first key must be
  1007. pressed while the second key is hit, then both keys are released.
  1008.  
  1009.  
  1010. A description of how HOST-III responds to each command follows.
  1011.  
  1012.  
  1013.                                    CTRL Prtsc
  1014.  
  1015. This  command  allows you to turn on the printout if it is off, or to turn off
  1016. the  printout  if  it is on. With the printout on, all commands, responses and
  1017. messages  transferred  during  an active communications link are listed on the
  1018. printer  as well as the display. NOTE that printout is deactivated during file
  1019. transfer.  If the  printout is off when this command is issued, then HOST-III
  1020. turns the printout on, beeps and responds with
  1021.  
  1022.     --- PRINTOUT ON ---
  1023.  
  1024. If  the  printout  is  on when this command is issued, then HOST-III turns the
  1025. printout off, beeps and responds with
  1026.  
  1027.     --- PRINTOUT OFF ---
  1028.  
  1029. At startup the printout is initially off.
  1030.  
  1031.  
  1032.                                    ALT D
  1033.  
  1034. This  command allows you to both display the file directories on disk drives A
  1035. B,  C  and  D  and  view  an  ASCII  file. Viewing a file means displaying the
  1036. contents  of  an  ASCII  file  on the screen. Upon receiving this command, the
  1037. program responds with
  1038.  
  1039.     Drive A, B, C, D, View a file or Return? (A,B,C,D,V,R):
  1040.  
  1041. If  you enter an A, B, C or D, the program will display the file directory of
  1042. the corresponding disk drive.
  1043.  
  1044. If you enter a V, the program will respond with
  1045.  
  1046.     Name of file:
  1047.  
  1048.  
  1049.  
  1050.  
  1051.                                      -13-
  1052.  
  1053.  
  1054.  
  1055.                                   HOST-III
  1056.  
  1057.  
  1058. At this point you may enter the filename specification of the file you wish to
  1059. see.  HOST-III  will  display 18 lines of the file at a time and prompt you to
  1060. continue  by  pressing  the  space bar. You may abort the viewing of a file by
  1061. hitting the ESC key.
  1062.  
  1063. To  return  to the program's normal mode, you must enter an  when the program
  1064. asks  you to select an option.
  1065.  
  1066. NOTE  the program will ignore the ALT D command, if it is engaged in an active
  1067. communications link.
  1068.  
  1069.  
  1070.                                     ALT M
  1071.  
  1072. This  command  allows  you to send the user a one line message. Upon receiving
  1073. this command the program responds with
  1074.  
  1075.     *** SYSTEM OPERATOR MESSAGE **
  1076.  
  1077. At  this  message you may enter a message followed by a carriage return, which
  1078. HOST-III will send to the user. NOT the user will not receive the prompt
  1079.  
  1080.     >
  1081.  
  1082. after  a  system  operator message, because the program is still waiting for a
  1083. response  to  the prompt it issued just before the message. Therefore the user
  1084. can issue his/her next command immediately after receiving the message.
  1085.  
  1086.  
  1087.                                     ALT X
  1088.  
  1089. This command allows you to exit the program. HOST-III responds to this command
  1090. with
  1091.  
  1092.     --- EXIT ---
  1093.  
  1094. and terminates the program.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.                                      -14-
  1118.  
  1119.  
  1120.  
  1121.                                    HOST-III
  1122.  
  1123.  
  1124. VI. File Transmission
  1125.  
  1126. This  section  describes the protocol involved in transferring a file from the
  1127. HOST-III location to the user's location.
  1128.  
  1129.  
  1130. Upon receiving the command
  1131.  
  1132.     T
  1133.  
  1134. from the user, the program responds with
  1135.  
  1136.     NAME OF FILE: 
  1137.  
  1138. HOST-III  is  asking  the  user  to give it the full name of the file the user
  1139. wants to be transmitted. For instance if the user wants the file PROG2.BAS and
  1140. it resides on drive B, then the user may respond with
  1141.  
  1142.     B:PROG2.BAS
  1143.  
  1144. followed  by  a carriage return. If HOST-III encounters an error such as "file
  1145. not  found" or "disk not ready", then the prgram will inform the user of this
  1146. and send him/her a prompt for the next command.
  1147.  
  1148. If there are no errors then HOST-III tells the user
  1149.  
  1150.     *** TRANSMISSION BEGINNING IN 15 SECONDS ***
  1151.         TYPE X TO ABORT TRANSMISSION
  1152.  
  1153. The  user  now  has 15 seconds to prepare his program to receive the file. The
  1154. user may abort transmission at any time by typig an X.
  1155.  
  1156. To denote the end of the file, HOST-III sends
  1157.  
  1158.     65529 ' *** TRANSMISSION COMPLETE ***
  1159.  
  1160. The  user may remove this trailing message with a text editor before using the
  1161. file.  A  prompt  is  NOT sent after file transmission Therefore the user may
  1162. issue  his/her  next  command  immediately after the transmission is complete.
  1163. NOTE  that if the user is the program HOSTCALL, then a trailing message is not
  1164. attached  to  the  end  of  the file since the two programs have a protocol to
  1165. determine the end of a file.
  1166.  
  1167.  
  1168.  
  1169. If  the user's program supports the XMODEM protocol of fie transmission, then
  1170. he/she  may  elect to have HOST-III send him/her the file under this protocol.
  1171. To  have  HOST-III  send  the  program  PROG.COM  from drive A, the user would
  1172. respond to the request
  1173.  
  1174.     NAME OF FILE: 
  1175.  
  1176. with
  1177.  
  1178.     A:PROG.COM+X
  1179.  
  1180.  
  1181.  
  1182.  
  1183.                                      -15-
  1184.  
  1185.  
  1186.  
  1187.                                    HOST-III
  1188.  
  1189.  
  1190. As  sown,  the  user  invokes  the  XMODEM  protocol by appending a +X to the
  1191. filename  specification. During transmission HOST-III will display a number of
  1192. status  messages on the screen. At the end of the file, the program will issue
  1193. its prompt and wait for the next command.
  1194.  
  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.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.                                      -16-
  1250.  
  1251.  
  1252.  
  1253.                                    HOST-III
  1254.  
  1255.  
  1256. VII. File Reception
  1257.  
  1258. This  section  describes  te  protocol involved in transferring a file to the
  1259. HOST-III location from the user's location.
  1260.  
  1261.  
  1262. Upon receiving the command
  1263.  
  1264.     R
  1265.  
  1266. from the user, the program responds with
  1267.  
  1268.     NAME OF FILE: 
  1269.  
  1270. HOST-III  is  asking  the  user  to give it the full name of the file the user
  1271. intends  to  send. For instance if the user intends to send the file PROG1.BAS
  1272. and he/she wants to store it on drive B, the user may respond with
  1273.  
  1274.     B:PROG1.BAS
  1275.  
  1276. followed  by  a  carriage eturn. If HOST-III encounters an error such as "bad
  1277. file name" or "disk write protected", then the program will inform the user of
  1278. this and send him/her a prompt for the next command.
  1279.  
  1280. If there are no errors then HOST-III tells the user
  1281.  
  1282.     *** READY TO RECEIVE FILE ***
  1283.  
  1284. The  program  will  wait  15  seconds  for  the  beginning of transmission. If
  1285. transmission has not begun within this time, the program transmits
  1286.  
  1287.     RECEPTION SUSPENDED. END OF FILE? (Y,N)
  1288.  
  1289. If  this happens, the user should just complete his procedure for transmitting
  1290. a  file.  NOTE  however  that  if  the END  OF  FILE question is asked before
  1291. transmission  begins,  then  HOST-III  assumes  that  the  first  character it
  1292. receives  is the answer to its question. Therefore that first character is not
  1293. stored  as  part  of the received file. Moreover if the first character of the
  1294. transmitted  file  is  Y (or y), then reception is terminated. In short, itis
  1295. best for the user to initiate his transmission within 15 seconds.
  1296.  
  1297. At  the  end  of  transmission,  the  program  pauses for about 15 seconds and
  1298. transmits
  1299.  
  1300.     RECEPTION SUSPENDED. END OF FILE? (Y,N)
  1301.  
  1302. If the user responds with Y (or y) or if there is no response within 1 minute,
  1303. HOST-III terminates reception and tells the user
  1304.  
  1305.     *** RECEPTION TERMINATED ***
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.                                      -17-
  1316.  
  1317.  
  1318.  
  1319.                                    HOST-III
  1320.  
  1321.  
  1322. If  the user's program supports the XMODEM protocol of file transmission, then
  1323. he/she  may  elect  to  have HOST-II receive the file under this protocol. To
  1324. have  HOST-III  receive the program PROG.COM and store it on drive A, the user
  1325. would respond to the request
  1326.  
  1327.     NAME OF FILE: 
  1328.  
  1329. with
  1330.  
  1331.     A:PROG.COM+X
  1332.  
  1333. As  shown,  the  user  invokes  the  XMODEM  protocol by appending a +X to the
  1334. filename  specification.  During  reception  HOST-III will display a numbr of
  1335. status  messages on the screen. At the end of the file, the program will issue
  1336. its prompt and wait for the next command.
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.                                      -18-
  1382.  
  1383.  
  1384.  
  1385.                                    HOST-III
  1386.  
  1387.  
  1388. VIII. HOST-III Signoff
  1389.  
  1390. This section lists the conditions which will cause HOST-III to sgn off.
  1391.  
  1392.  
  1393. When  HOST-III  is  dialed  and  it  initiates communications by answering the
  1394. telephone,  there  are 6 ways in which these communications can be terminated.
  1395. They are:
  1396.  
  1397.     1. Normal signoff command - G.
  1398.     2. Timeout after 5 minutes of inactivity.
  1399.     3. Incorrect password in 3 tries.
  1400.     4. Failing  to  detect  a  carrier  (such as when it is  called by a human
  1401.        instead of a computer).
  1402.     5. User hangup before correct password is issued.
  1403.     6. User hangup during active communications.
  1404.  
  1405. In all cases HOST-III will clear the screen, issue the message
  1406.  
  1407.     ********* HOST COMPUTER III program active *********
  1408.  
  1409. and wait for the next telephone call.
  1410. 
  1411.  
  1412.