home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 147.img / NETMAL46.ZIP / SCRIPTS.ZIP / CALLNET2.ZIP / CALLNET2.DOC next >
Text File  |  1989-11-01  |  21KB  |  593 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   -----------
  17.  
  18.                           --------  CALLNET  --------
  19.  
  20.                                   -----------
  21.  
  22.  
  23.                                   Version 2.0
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                      For  the  System  Operator of PCBoard
  33.                      using NET/Mail, Procomm Plus and DSZ,
  34.                      to automate network mail transfers as
  35.                      part of a scheduled event.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                       Copyright (c)1989 by Edward Thigpen
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.     CALLNET2.DOC                    Page 2                 November 1, 1989
  69.  
  70.  
  71.     NOTICE:
  72.     ----------------
  73.  
  74.     The files contained herein are Copyright (c)1989 by Edward Thigpen  and
  75.     are  donated  to  the  public  domain  with  the condition that  NO FEE
  76.     whatsoever may be charged for duplication or  distribution,  including,
  77.     but  not limited to disk duplication charges, download time, or connect
  78.     time while downloading, or use of the files.  Distribution must include
  79.     the original and complete, unaltered ZIP file.
  80.  
  81.     You  use the scripts at your own risk.  They are provided AS IS with NO
  82.     WARRANTIES of any kind.  They  are  straight  ASCII  text  and  may  be
  83.     altered  by anyone with basic programming skills.  Therefore you should
  84.     fully test the scripts and any revisions you make prior to  using  them
  85.     in unattended transfers, as unexpected results may occur.
  86.  
  87.     Certain  names  and  products  mentioned in this text are trademarks of
  88.     their respective companies.
  89.  
  90.     ----------------
  91.  
  92.     My  sincerest  appreciation  to Lloyd Osteryoung of Cecil's Nite Owl in
  93.     Palm Beach Gardens, FL, for providing the need for a package of  script
  94.     files  as  these,  and  for his unending patience while testing various
  95.     ideas and additions.  As we all know, providing a  top  notch  bulletin
  96.     board  system  with  state-of-the-art features is an expensive and time
  97.     consuming process.  Yet, Cecil's Nite Owl meets these  standards  while
  98.     remaining  free of charge to its callers, reaffirming the basic premise
  99.     of bulletin boards, the free and open exchange of ideas.
  100.  
  101.     My  appreciation  also goes out to Mark Findlay, author of the NET/Mail
  102.     software package that allows all of us all over the  country,  and  now
  103.     Europe,  the  means to communicate in an open forum.  Mark's package is
  104.     tops in its field, operating almost flawlessly since its inception!
  105.  
  106.     ----------------
  107.  
  108.     Files  in  CALLNET2.ZIP  (except  this documentation file) as displayed
  109.     using the -V parameter in PKZIP:
  110.  
  111.  
  112. Searching ZIP: CALLNET2.ZIP
  113.  
  114.  Length  Method   Size  Ratio   Date    Time   CRC-32  Attr  Name
  115.  ------  ------   ----- -----   ----    ----   ------  ----  ----
  116.    1044  Implode    636  40%  11-01-89  11:01  bf8a8c40 --w  README.NOW
  117.     247  Shrunk     178  28%  11-01-89  11:01  7e637db3 --w  NETSEND.BAT
  118.      28  Stored      28   0%  11-01-89  11:01  987af400 --w  IN.BAT
  119.      29  Stored      29   0%  11-01-89  11:01  61a9bd91 --w  OUT.BAT
  120.      66  Shrunk      58  13%  11-01-89  11:01  c32462ee --w  MCALL.BAT
  121.     928  Implode    463  51%  11-01-89  11:01  e8b73ac8 --w  PROFILE.ASP
  122.   14053  Implode   3062  79%  11-01-89  11:01  646ef5bc --w  DCWAS24.ASP
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.     CALLNET2.DOC                    Page 3                 November 1, 1989
  135.  
  136.  
  137.     OVERVIEW:
  138.     ----------------
  139.  
  140.     CALLNET  uses  a  common  sense  approach  in automating the process of
  141.     exchanging mail packets between node and hub systems.  It  is  designed
  142.     to  be  called  from the PCBoard's overnight event, allowing the use of
  143.     Telenet's PC Pursuit service or to take  advantage  of  discount,  late
  144.     night  long  distance  rates.  The main script file used is designed to
  145.     watch for potential errors and, in most cases, to recover from problems
  146.     such as noisy phone lines or busy systems.  All of this is accomplished
  147.     while maintaining *courtesy* toward other system  operators  trying  to
  148.     access the same hub by limiting the number of dialing retries.
  149.  
  150.     If CALLNET fails to connect to the hub system for whatever reason, fear
  151.     not.  Recovery during the next event is a painless, automatic  process,
  152.     as  long  as  your  script  is  properly  configured.   A  log  file is
  153.     maintained for the entire session to call your  attention  to  problems
  154.     such  as  bad  or  missing prompts, or conflicting schedules with other
  155.     nodes.  More on the log file later in the documentation.
  156.  
  157.     Briefly,  CALLNET  will  attempt  to  access  Telenet  and a distant PC
  158.     Pursuitable city up to ten times, and once  connected  to  the  distant
  159.     city,  will  attempt  access to the hub bulletin board up to ten times.
  160.     Failure results in a ten minute wait before a retry.  Assuming  failure
  161.     again,  CALLNET,  when configured to do so, will attempt one last round
  162.     by dialing direct (1+) to the hub system.  Failure again results  in  a
  163.     warning  message  in  the  log file, with recovery expected during your
  164.     next event, or through manual processing.
  165.  
  166.     Once successfully connected to the hub, CALLNET watches for appropriate
  167.     messages in ensure that all processing is  taking  place  as  expected.
  168.     Failure  to "see" key prompts will result in the declaration of a fatal
  169.     error, and one retry to transfer mail. (Note:  Retry  will  take  place
  170.     ONLY  if  originally  connected through PC Pursuit.  This feature is to
  171.     reduce the chance of a long distance bill  the  size  of  the  national
  172.     debt.)  Assuming success, CALLNET will return to DOS and return control
  173.     to the batch file, NETSEND.BAT, to  complete  the  import  process  and
  174.     reboot your bulletin board.
  175.  
  176.     In  a worse case scenario, your bulletin board is unavailable for calls
  177.     (and will not answer for any reason) for about thirty minutes and  your
  178.     connect  time  on PC Pursuit is about twenty minutes (or about 10 hours
  179.     during a month of complete failures!), keeping your PC Pursuit  charges
  180.     well  within  the  maximum  flat  rate  charges.  Of course, monthly PC
  181.     Pursuit connect time will vary, depending on the amount of network mail
  182.     being transferred.  Our experience at Cecil's Nite Owl during the  past
  183.     five  months  has  shown  that  NET/Mail  transfers use less than eight
  184.     hours of the thirty hour per month cap recently instituted by Telenet.
  185.  
  186.     As provided, CALLNET will shell to DOS three times during each session.
  187.     OUT.BAT  is  executed to upload your mail packet to the hub system, and
  188.     IN.BAT is executed to download your packet from the hub.  MCALL.BAT  is
  189.     used  to  update  your  opening  screen once the mail is *successfully*
  190.     transferred.  If you do not have the necessary software to update  your
  191.     opening  screens,  MCALL.BAT  will  have  to  be disabled, as discussed
  192.     further in this text.
  193.  
  194.  
  195.  
  196.                       Copyright (c)1989 by Edward Thigpen
  197.  
  198.  
  199.  
  200.     CALLNET2.DOC                    Page 4                 November 1, 1989
  201.  
  202.  
  203.     CONVENTIONS:
  204.     ----------------
  205.  
  206.         - Do not add carriage returns to the end of your string
  207.           assignments.  CALLNET provides carriage returns (^m)
  208.           in the appropriate places.
  209.  
  210.         - The telephone number of your hub MUST be in the exact
  211.           format ###-###-####.  If you are using a hub within
  212.           your own area code, the format MUST be ----###-####.
  213.           This requirement applies whether or not the direct dial
  214.           feature is implemented.
  215.  
  216.         - Using PC Pursuit, the first five characters in the
  217.           string assigned to S1 (line 23) MUST be the PC Pursuit
  218.           city code.  Example, assuming your hub is located in
  219.           Washington, DC, the first five characters is S1 MUST
  220.           be DCWAS.  For a Seattle hub, S1 must contain WASEA
  221.           as the first five characters.
  222.  
  223.         - You may prevent certain lines in the script files
  224.           from being executed by placing a semicolon (;) at the
  225.           beginning of the line.  If you wish to activate the
  226.           direct dialing feature in CALLNET, place a semicolon
  227.           at the beginning of line 176, so that is reads:
  228.  
  229.                               ;GOTO BAD
  230.  
  231.         - When calling hubs that do NOT feature color graphics, it
  232.           will be necessary to place semicolons in front of lines
  233.           200 through 205, and line 208 to prevent CALLNET from
  234.           bombing at missing graphics prompts.
  235.  
  236.  
  237.     The  scripts  in  CALLNET  should be installed and run from a hard disk
  238.     drive.  Each line in a script must be read, all  while  the  system  is
  239.     "watching"  for  prompts  and  special  characters coming from the host
  240.     system.  Floppy drives will slow reaction time considerably and in most
  241.     cases will cause the routines to fail.
  242.  
  243.     On the same note, waiting for Procomm Plus to beep a  number  of  times
  244.     when  certain  events  (such  as connecting to a host system) occur may
  245.     cause the scripts to terminate.  The alarm in Procomm  Plus  should  be
  246.     turned  off,  and the alarm time should be set to zero seconds.  If you
  247.     use PROFILE.ASP provided the alarm will be disabled for you.
  248.  
  249.     There are seven different retry  counters  operating  within  the  main
  250.     script file, using the integer values N0 through N6.  While each serves
  251.     a unique purpose and each controls a unique function.  Altering one may
  252.     have  a  domino  effect  on the remainder and care should be taken when
  253.     changing any of the code involving integers.
  254.  
  255.     The  log  file,  NETMAIL.LOG in our script, does not have to be deleted
  256.     after each session.  If you decide to keep it, new log information will
  257.     be appended to the end of the existing  file.   Once  you  are  up  and
  258.     running  without  any  problems you may find storing a month's worth of
  259.     log information a waste of space.
  260.  
  261.  
  262.                       Copyright (c)1989 by Edward Thigpen
  263.  
  264.  
  265.  
  266.     CALLNET2.DOC                    Page 5                 November 1, 1989
  267.  
  268.  
  269.     CONFIGURATION:
  270.     ----------------
  271.  
  272.     First  things first, you will need to configure the batch files to your
  273.     system's specifications.  Below are copies of each batch file  with  an
  274.     explanation of each line.  OUT.BAT, IN.BAT and MCALL.BAT must reside in
  275.     your Procomm Plus subdirectory or path.
  276.  
  277.  
  278.     NETSEND.BAT
  279.     ----------------
  280.  
  281.         echo off                    ; turn echo off
  282.         cls                         ; clear the screen
  283.         m:                          ; log to drive m:
  284.         cd\netmail                  ; log to netmail subdirectory
  285.         export nodelist             ; execute export
  286.         cd\pcplus                   ; log to pcplus subdirectory
  287.         pcplus /fdcwas24            ; execute pcplus, profile and dcwas24
  288.         copy netmail.log prn        ; dump log file to printer
  289.         copy netmail.log n:\s1      ; copy log file to d/l directory
  290.         del netmail.log             ; delete log file
  291.         cd\netmail                  ; log to netmail subdirectory
  292.         import                      ; execute import
  293.         cd\netmail\files            ; log to files subdirectory
  294.         del nodelist.was            ; delete yesterday's nodelist
  295.         ren nodelist nodelist.was   ; rename nodelist
  296.         l:                          ; log to drive l:
  297.         cd\pcb                      ; log to pcb subdirectory
  298.         board                       ; execute board.bat
  299.  
  300.  
  301.     IN.BAT
  302.     ----------------
  303.  
  304.         DSZ port 2 rz NODEMAME.IN   ; be sure to configure to your specs!
  305.  
  306.  
  307.     OUT.BAT
  308.     ----------------
  309.  
  310.         DSZ port 2 sz NODENAME.OUT  ; be sure to configure to your specs!
  311.  
  312.  
  313.     MCALL.BAT
  314.     ----------------
  315.  
  316.         echo off                    ; turn echo off
  317.         l:                          ; log to drive l:
  318.         cd\pcb                      ; log to pcb subdirectory
  319.         mailcall mailcall.cfg       ; execute mailcall to update screen
  320.         cd\                         ; log to root directory
  321.         m:                          ; log to drive m:
  322.         cd\pcplus                   ; log to pcplus subdirectory
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                       Copyright (c)1989 by Edward Thigpen
  329.  
  330.  
  331.  
  332.     CALLNET2.DOC                    Page 6                 November 1, 1989
  333.  
  334.  
  335.     PROFILE.ASP
  336.     ----------------
  337.  
  338.         Change Line 7 to the proper COMM port for your modem.
  339.  
  340.         Change Line 9 to the proper baud rate.
  341.  
  342.             Note:  The main script provided, DCWAS24.ASP is geared
  343.                    to users of PC Pursuit at 2400 baud!
  344.  
  345.  
  346.     DCWAS24.ASP
  347.     ----------------
  348.  
  349.         Change Line 13 to include any drive, path and name you wish
  350.         to use for the log file maintained during the call.  Insure
  351.         that any changes are reflected in NETSEND.BAT!
  352.  
  353.         Line 22 (S0) should be changed to your local Telenet access
  354.         phone number.  Be sure to use the special numbers reserved
  355.         for 2400 baud calls is you are running at 2400 baud.
  356.  
  357.         Line 23 (S1) *MUST* include the PC Pursuit city code as the
  358.         first five characters.  The characters after the first five
  359.         can be anything you wish.  This format is REQUIRED if you
  360.         wish the scripts to function properly, and was designed in
  361.         this manner to allow expansion and linking of scripts.
  362.  
  363.         Line 24 (S2) should be changed to the area code and phone
  364.         number of the hub system.  As discussed earlier, calls to
  365.         hubs within your area code uses the format ----###-####.
  366.         The scripts look at the right most eight characters when
  367.         determining the hub phone number.
  368.  
  369.         Line 25 (S3) should be changed to your first and last name
  370.         as registered on the hub system.  Remember, do not add a
  371.         carriage return character (^m), as it is added to the end
  372.         of the string when used by the script.
  373.  
  374.         Line 26 (S4) should be changed to your password on the hub
  375.         system.
  376.  
  377.         Line 27 (S5) should include the "OPEN" command as well as
  378.         the door number for your hub's NET/Mail door.
  379.  
  380.         Lines 28 and 29 (S6 and S7) are used internally by the script.
  381.  
  382.         Line 30 (S8) should be changed to your PC Pursuit ID code.
  383.         Again, do not add a trailing carriage return.
  384.  
  385.         Line 31 (S9) should be changed to your PC Pursuit password.
  386.  
  387.     If you are *not* calling through PC Pursuit, delete the  semicolon  (;)
  388.     at  the beginning of line 48 so that the script bypasses the PC Pursuit
  389.     logon procedures.  You will also need to *add* a semicolon to the start
  390.     of Line 176, the first  command  under  DIRECT:.   When  calling  local
  391.     numbers,  it  is  necessary to change Line 181 to read "ATDT".
  392.  
  393.  
  394.                       Copyright (c)1989 by Edward Thigpen
  395.  
  396.  
  397.  
  398.     CALLNET2.DOC                    Page 7                 November 1, 1989
  399.  
  400.  
  401.     If you are calling a hub that does not support graphics, and thus, does
  402.     not begin with a graphics prompt, place semicolons at the beginning  of
  403.     Lines  200-205  *and*  Line  208.   These  lines  are  also marked with
  404.     asterisks in the far right column.
  405.  
  406.     Operators  not  using  the mail call routines will need to disable Line
  407.     294 by placing a semicolon at the beginning of the line.
  408.  
  409.  
  410.     BEFORE YOU CALL:
  411.     ----------------
  412.  
  413.     Before you try your script, place a "live" call to your hub and  insure
  414.     that  your  user  record  reflects  EXPERT  mode.   The scripts are not
  415.     designed to account for added prompts and the  time  delays  associated
  416.     with novice user levels.
  417.  
  418.     You should also inform the operator  of  your  hub  that  you  will  be
  419.     debugging your scripts for awhile and arrange a time when the system is
  420.     usually available for repeated calls.
  421.  
  422.     If,  on  you *first* call since midnight, you do not get a "Press enter
  423.     to continue" prompt, it would be wise to change Line 199 to read:
  424.  
  425.                               WHEN "More?" "n^m"
  426.  
  427.     This  change  will  eliminate  the  potential  for  fatal  errors  once
  428.     connected to the hub system.
  429.  
  430.  
  431.     TESTING:
  432.     ----------------
  433.  
  434.     Above  all, test your scripts and any changes during live sessions.  DO
  435.     NOT install them in your event file until you are  sure  everything  is
  436.     functioning properly.  It took us about a week to get all the kinks out
  437.     of  our routines, but that was during the creation process when various
  438.     points of error checking were added.  You should be able to install the
  439.     routines in your event  within  a  couple  of  days  after  making  any
  440.     necessary changes.
  441.  
  442.     As  provided, the script DCWAS24.ASP runs successfully when calling the
  443.     DC Information Exchange in Washington, DC.  Anytime we missed our "mail
  444.     runs", due to vacations and a  recent  move  to  a  new  location,  the
  445.     recovery  of missed mail was completely painless, and automatic as part
  446.     of the next scheduled event after the system went back online.
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                       Copyright (c)1989 by Edward Thigpen
  461.  
  462.  
  463.  
  464.     CALLNET2.DOC                    Page 8                 November 1, 1989
  465.  
  466.  
  467.     LOG FILE:
  468.     ----------------
  469.  
  470.     Below are descriptions and reasoning behind the NETMAIL.LOG entries.
  471.  
  472.  
  473.         @@ Telenet Inbound Failure @@
  474.  
  475.             The local Telenet number (S0) is incorrect or busy.
  476.  
  477.  
  478.         @@ Telenet Wakeup Failure @@
  479.  
  480.             Telenet failed to respond to the wakeup command.  If
  481.             you are not running 2400 baud, this wakeup command
  482.             will have to be changed.
  483.  
  484.  
  485.         @@ Telenet Login Failure @@
  486.  
  487.             Telenet failed to recognize your terminal type input.
  488.  
  489.  
  490.         @@ Telenet Distant Node Busy @@
  491.  
  492.             Nodes to the distant city are busy or out of service.
  493.             Another possibility is incorrect PC Pursuit ID or
  494.             password strings.
  495.  
  496.  
  497.         @@ Outbound Node Failure @@
  498.  
  499.             The hub system is busy or the number entered is incorrect.
  500.  
  501.  
  502.         @@  Direct Dial Failure @@
  503.  
  504.             The hub system is busy or the number entered is incorrect.
  505.             Repeated busys indicate conflicting schedules between nodes.
  506.  
  507.  
  508.         @@ HUBFAIL: Graphics Prompt @@
  509.  
  510.             The script did not see the graphics query within the 15
  511.             second limit.  Is your hub a graphics system?
  512.  
  513.  
  514.         @@ HUBFAIL: Name Prompt @@
  515.  
  516.             The script missed and could not recover from a missing
  517.             name prompt.  Noisy lines?
  518.  
  519.  
  520.         @@ HUBFAIL: Password Prompt @@
  521.  
  522.             The password prompt was not seen.  Possibilities include
  523.             noisy phone lines or your name is not recognized.
  524.  
  525.  
  526.                       Copyright (c)1989 by Edward Thigpen
  527.  
  528.  
  529.  
  530.     CALLNET2.DOC                    Page 9                 November 1, 1989
  531.  
  532.  
  533.         @@ HUBFAIL: Mail Check Prompt @@
  534.  
  535.             The prompt to check for your mail was missed.
  536.  
  537.  
  538.         @@ HUBFAIL: Main Command Prompt @@
  539.  
  540.             The main command prompt was missing or garbled and the
  541.             script was unable to recover.
  542.  
  543.  
  544.         @@ HUBFAIL: Door Locked Message @@
  545.  
  546.             The NET/Mail door was in use on another node.
  547.  
  548.  
  549.         @@ HUBFAIL: DSZ Upload Prompt @@
  550.  
  551.             The DSZ initialization string was not found.
  552.  
  553.  
  554.         @@ HUBFAIL: Upload Questionable @@
  555.  
  556.             Messages confirming a successful upload were not found.
  557.  
  558.  
  559.         @@ HUBFAIL: Importing Conference @@
  560.  
  561.             Message in preparation for your download were not found.
  562.  
  563.  
  564.         @@ HUBFAIL: DSZ Download Prompt @@
  565.  
  566.             The DSZ initialization string was not seen.  The hub is
  567.             allowed up to ten minutes to prepare the download, more
  568.             than enough time for even large mail packets.
  569.  
  570.  
  571.       =============================
  572.  
  573.         NET/Mail Transfer Failure
  574.  
  575.       =============================
  576.  
  577.             CALLNET was not successful in transferring mail with the
  578.             hub system for whatever reason.  If your scripts are
  579.             properly configured, recovery will be automatic during
  580.             the next event.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                       Copyright (c)1989 by Edward Thigpen
  593.