home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / procomm / apcp37.arc / APCP.DOC < prev    next >
Text File  |  1988-03-18  |  19KB  |  492 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            A P C P 3 7
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                  Automated PC-Pursuit Version 3.7
  29.                           March 18, 1988
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                       THOM LITTLE ASSOCIATES
  39.  
  40.                           P.O. Box 1901
  41.                       Boston, MA  02205-1901
  42.  
  43.                           (617) 438-0396
  44. INTRODUCTION:
  45.  
  46. Welcome to the possible world of PC-Pursuit automation under 
  47. PROCOMM PLUS. 
  48.  
  49. This collection of command files provides a system of menus for 
  50. accessing Telenet's PC-Pursuit.  The command files presented here 
  51. are written in ASPECT and requires PROCOMM PLUS.  These command 
  52. files will not operate under PROCOMM 2.4.2. 
  53.  
  54. Due to the uncertainty of Telenet's 2400 baud support, the 2400 
  55. baud option ("2424.ASP") contained in this package and described 
  56. here has not been verified as being operational.  It is included 
  57. for information and future planning purposes only. 
  58. INSTALLATION: 
  59.  
  60. To use these command files you need to perform the following 
  61. four steps. 
  62.  
  63. (1)  The first step is to use PKXARC to un-ARC the distribution 
  64. files into the appropriate directory on your disk.  The
  65. appropriate directory is one of many possible directories. 
  66.  
  67. As an example, on my system I specify the following in my 
  68. AUTOEXEC.BAT file: 
  69.  
  70.     SET PCPLUS=C:\COM\PCP 
  71.  
  72. In addition, I start PROCOMM PLUS by specifying the following in 
  73. my AUTOEXEC.BAT file: 
  74.  
  75.     CD \COM\CUR 
  76.     \COM\PCP\PCPLUS /FPCPLUS 
  77.  
  78. So in my case PROCOMM PLUS will search directories in the 
  79. following order when looking for the other command files in the 
  80. collection: 
  81.  
  82.     C:\COM\CUR 
  83.     C:\COM\PCP 
  84.     C:\ 
  85.  
  86. I have all of the command files installed in C:\COM\PCP.  This 
  87. allows me to put modified copies of each in C:\COM\CUR for 
  88. testing.  When I'm satisfied with the new version I simply 
  89. replace the original version in C:\COM\PCP and delete the copy 
  90. out of C:\COM\CUR. 
  91.  
  92. (2)  The second step is to establish one or more entries in your 
  93. dialing directory of the form: 
  94.  
  95.         NAME                        NUMBER  BAUD P D S D  SCRIPT 
  96.     141 PC-Pursuit - Slow           xxx-xxxx   300 E-7-1 F  0303 
  97.     142 PC-Pursuit - Medium         yyy-yyyy  1200 E-7-1 F  1212 
  98.     143 PC-Pursuit - Fast           zzz-zzzz  2400 E-7-1 F  2412 
  99.     144 PC-Pursuit - Experimental   zzz-zzzz  2400 E-7-1 F  2424 
  100.  
  101. Where: 
  102.  
  103.     xxx-xxxx is your local Telenet access number for 300 baud 
  104.     yyy-yyyy is your local Telenet access number for 1200 baud 
  105.     zzz-zzzz is your local Telenet access number for 2400 baud 
  106.  
  107.  
  108. (3)  The third step is to specify your Telenet Account Number and 
  109. Telenet Password.  Using your favorite editor or word processor 
  110. edit the following command files: 
  111.  
  112.     0303.ASP
  113.     1212.ASP
  114.     2412.ASP
  115.     2424.ASP 
  116.  
  117. The Telenet Account Number and Telenet Password are clearly 
  118. identified in the command files.  You need to:
  119.  
  120.     o  Replace "xxxxnnnn" with your Telenet Account Number, and
  121.  
  122.     o  Replace "nnnnxxxx" with your Telenet Password.
  123.  
  124. PROTECT THESE COMMAND FILES AND NEVER MAKE                      
  125. THEM AVAILABLE TO ANYONE.  Give my command files to everyone but 
  126. in the form I gave them to you.  Otherwise you may end up 
  127. financing the processing of some strangers.
  128.  
  129.  
  130. (4)  The fourth step is to customize the remote city menus for 
  131. your own use.  Using your favorite editor or word processor 
  132. modify the names and telephone numbers of Electronic Bulletin 
  133. Board Systems (EBBS) in the remote city menus.  If a new city is 
  134. added to PC-Pursuit you can use the Generic EBBS menu named 
  135. "XXXXX.ASP" as a model to create a menu for that new city. 
  136. OPERATION: 
  137.  
  138. You are now prepared to invoke APCP by using the PROCOMM PLUS 
  139. dialing directory.  Using the examples from the INSTALLATION 
  140. section: 
  141.  
  142.     o  <alt-D> <select 141> <enter> establishes a 0300 baud local
  143.        connection and invokes the PC-Pursuit main menu 0303.ASP 
  144.        for subsequent dialing of remote cities at 0300 baud, 
  145.  
  146.     o  <alt-D> <select 142> <enter> establishes a 1200 baud local
  147.        connection and invokes the PC-Pursuit main menu 1212.ASP 
  148.        for subsequent dialing of remote cities at 1200 baud,
  149.  
  150.     o  <alt-D> <select 143> <enter> establishes a 2400 baud local
  151.        connection and invokes the PC-Pursuit main menu 2412.ASP 
  152.        for subsequent dialing of remote cities at 1200 baud, and
  153.  
  154.     o  <alt-D> <select 144> <enter> establishes a 2400 baud local
  155.        connection and invokes the PC-Pursuit main menu 2424.ASP 
  156.        for subsequent dialing of remote cities at 2400 baud.
  157.  
  158. When the main menu appears, you can specify as many cities as you 
  159. desire as an example "tja" would dial Atlanta and if busy then 
  160. dial Houston and if busy then dial Phoenix.  Note that the 
  161. dialing was in the order "ajt" even though you issues "tja". 
  162.  
  163. Once a remote city is connected a menu for that city will appear.  
  164. Again choose the possible connections from the list and they will 
  165. be dialed in ascending order.  When a connection is finally made, 
  166. PROCOMM PLUS will no longer be executing an ASPECT menu command 
  167. file and you'll be on your own.  
  168.  
  169. Notice that entry 143 in the example establishes a 2400 baud 
  170. connection to your local Telenet node and then dials all of the 
  171. remote nodes using 1200 baud.  This will provide you with the 
  172. maximum file transfer speed at 1200 baud.  You can almost achieve 
  173. a non-packet switch speed at 1200 baud.  The negative effect of 
  174. this technique is that text that you type will appear a little 
  175. "choppy".
  176.  
  177. It has been reported that if you prefer to use ZMODEM that this 
  178. techniqe for file transfers is not available.  If using ZMODEM 
  179. you must use the same baud rate at both the local and remote 
  180. connection (as provided by "0303.ASP", "1212.ASP", or 
  181. "2424.ASP").  So, if you have a 2400 baud modem and a local 2400 
  182. baud telephone number for Telenet then you have a choice: 
  183.  
  184.     o  Use an entry like 142 in the example for slower file 
  185.        transfers and smoother typing, or
  186.  
  187.     o  Use an entry like 143 in the example for faster file 
  188.        transfers and "choppier" typing. 
  189.  
  190. (I personally prefer the entry like 143 and find the slight 
  191. "choppiness" to be almost unnoticeable.) 
  192.  
  193. Notice that entry 144 in the example establishes a 2400 baud 
  194. connection to your local Telenet node and then (in theory) dials 
  195. all of the remote nodes using 2400 baud.  I have never 
  196. accomplished this feat.  Numerous rumors exist on the
  197. availability, non-availability, and planned availability of 2400 
  198. baud support in Telenet.  I don't know if it exists now or if it 
  199. will ever exist in the future.  If and when it ever exists the 
  200. entry 144 in the example will be made to operate. 
  201.  
  202. When you log off an in the remote city you can gracefully 
  203. disconnect from PC-Pursuit by calling the APCP re-select menu and 
  204. requesting "Q" (or any key other than "C" or "E") for "Terminate 
  205. APCP".  This is: 
  206.  
  207.     <alt-F5> "APCP" <enter> "Q" <enter> 
  208.  
  209. To select another EBBS in the same city by calling the APCP re-
  210. select menu and requesting "E" for "Select new EBBS".  This will 
  211. return you to the current remote city menu (that you previously 
  212. selected) of EBBS telephone numbers.  This is: 
  213.  
  214.     <alt-F5> "APCP" <enter> "E" <enter> 
  215.  
  216. When the remote city menu appears select the new remote EBBS as 
  217. you did the first time.
  218.  
  219. To select a new city simply call the APCP re-select menu and 
  220. request "C" for "Select new CITY".  This will return you to the 
  221. appropriate main selection menu (either "0303.ASP", "1212.ASP", 
  222. "2412.ASP", or "2424.ASP") of PC-Pursuit city codes.  This is: 
  223.  
  224.     <alt-F5> "APCP" <enter> "C" <enter> 
  225.  
  226. When the main menu appears select the new PC-Pursuit cities as 
  227. you did the first time. 
  228.  
  229. In order to retain the information on your request, the main city 
  230. menus ("0303.ASP", "1212.ASP", "2412.ASP", and "2424.ASP") create 
  231. a file called "APCPSTRS".  This is a very short file that 
  232. contains the main city menu name ("0303", "1212", "2412" or 
  233. "2424") and the remote city code (of the form "SSCCC" where SS is 
  234. the state and CCC is the city). 
  235.  
  236. You should also be aware that the "APCPSTRS" file is created in 
  237. the DEFAULT directory.  On my system this is C:\COM\CUR. 
  238.  
  239. If the very first thing you do with this package is to execute 
  240. "APCP.ASP" it WILL NOT WORK and you will receive an error message.  
  241. You must enter this package through the dialing directory and use 
  242. APCP to re-select. 
  243.  
  244. The current implementation only allows 42 remote EBBS entries in 
  245. each remote city menu.  There is no reason why there couldn't be 
  246. a large number of these menus for each city with an intermediate 
  247. selector menu to get from one to the other.  
  248.  
  249. There's one aspect of this procedure that's a little strange.  
  250. Each time a connection is made, a log file is opened with a name 
  251. which is the local telephone number.  This allows you to trace 
  252. all activity.  More importantly, this is the mechanism by which 
  253. the macros recognize that a connection has been made in the past.  
  254. It's needed for the circular dial mechanism to work. 
  255.  
  256. Now here's the quirk ... you call once are connected do your 
  257. processing and log off.  The next day you try the same number and 
  258. the macros do not work!  That's because you must MANUALLY delete 
  259. the log for that number from the previous connection.  The
  260. command "ERASE *." will delete all files in a directory with no 
  261. extension (make sure you don't confuse it with "ERASE *.*" which 
  262. deletes ALL the files in a directory).
  263.  
  264. You should also be aware that these log files are being created 
  265. in the DEFAULT directory.  On my system this is C:\COM\CUR.
  266.  
  267. (The way I have PROCOMM PLUS configured for my own use that the 
  268. default directory C:\COM\CUR is: 
  269.  
  270.     o  The default directory for downloads,
  271.  
  272.     o  The default directory for uploads,
  273.  
  274.     o  The directory that has all APCP log files, and
  275.  
  276.     o  The directory that has the APCPSTRS control file.)
  277.  
  278. (I find this arrangement very convenient as I now have one 
  279. directory that is the central focus for all currently active 
  280. communications files.  File maintenance with an arrangement like
  281. this is quite straight forward and is easily augmented with a 
  282. couple of simple batch files.  And, when I issue an "erase 
  283. \com\cur\*." command it removes all of the APCP logs and the APCP 
  284. control file.)
  285.  
  286.  
  287.  
  288. VARIABLE ASSIGNMENTS: 
  289.  
  290. The collection of PROCOMM command files are consistent in their 
  291. use of the PROCOMM string variables.  This usage is: 
  292.  
  293.      n0  -  <unused>
  294.      n1  -  <unused>
  295.      n2  -  <unused>
  296.      n3  -  <unused>
  297.      n4  -  <unused>
  298.      n5  -  <unused>
  299.      n6  -  <unused>
  300.      n7  -  <unused>
  301.      n8  -  <unused>
  302.      n9  -  <unused>
  303.  
  304.      s0  -  User Request 
  305.      s1  -  Work Area 
  306.      s2  -  Remote City Access Code 
  307.      s3  -  Remote City Name 
  308.      s4  -  Remote EBBS Number 
  309.      s5  -  Remote EBBS Name 
  310.      s6  -  <unused> 
  311.      s7  -  <unused> 
  312.      s8  -  <unused> 
  313.      s9  -  Flag for "MORE" to Dial 
  314. DISTRIBUTION FILES: 
  315.  
  316. The files in the archive all contain: 
  317.  
  318.     03-18-88 - as the creation date. 
  319.     12:00a   - as the creation time (some programs (like the DOS 
  320.                DIR command) print this time as a blank field). 
  321.  
  322. The files in the archive are: 
  323.  
  324.     READ.ME     Errata on the current distribution 
  325.     APCP.DOC    This documentation file 
  326.     0303.ASP    0300 baud local / 0300 baud remote city menu 
  327.     1212.ASP    1200 baud local / 1200 baud remote city menu 
  328.     2412.ASP    2400 baud local / 1200 baud remote city menu 
  329.     2424.ASP    2400 baud local / 2400 baud remote city menu 
  330.     APCP.ASP    Main APCP re-selection menu
  331.     AZPHO.ASP   Phoenix, AZ remote EBBS menu 
  332.     CAGLE.ASP   Glendale, CA remote EBBS menu 
  333.     CALAN.ASP   Los Angles, CA remote EBBS menu 
  334.     CAPAL.ASP   Palo Alto, CA remote EBBS menu 
  335.     CARIV.ASP   Riverside, CA remote EBBS menu 
  336.     CASAC.ASP   Sacramento, CA remote EBBS menu 
  337.     CASAD.ASP   San Diego, CA remote EBBS menu 
  338.     CASAN.ASP   Santa Ana, CA remote EBBS menu 
  339.     CASFA.ASP   Sam Francisco, CA remote EBBS menu 
  340.     CASJO.ASP   San Jose, CA remote EBBS menu 
  341.     CODEN.ASP   Denver, CO remote EBBS menu 
  342.     CTHAR.ASP   Hartford, CT remote EBBS menu 
  343.     DCWAS.ASP   Washington, DC remote EBBS menu 
  344.     FLMIA.ASP   Miami, FL remote EBBS menu 
  345.     FLTAM.ASP   Tampa, FL remote EBBS menu 
  346.     GAATL.ASP   Atlanta, GA remote EBBS menu 
  347.     ILCHI.ASP   Chicago, IL remote EBBS menu 
  348.     MABOS.ASP   Boston, MA remote EBBS menu 
  349.     MIDET.ASP   Detroit, MI remote EBBS menu 
  350.     MNMIN.ASP   Minneapolis, MO remote EBBS menu 
  351.     MOKAN.ASP   Kansas City, MO remote EBBS menu
  352.     MOSLO.ASP   St. Louis, MO remote EBBS menu 
  353.     NCRTP.ASP   Res. Tri. Prk., NC remote EBBS menu 
  354.     NJNEW.ASP   Newark, NJ remote EBBS menu 
  355.     NYNYO.ASP   New York, NY remote EBBS menu 
  356.     OHCLV.ASP   Cleveland, OH remote EBBS menu 
  357.     ORPOR.ASP   Portland, OR remote EBBS menu 
  358.     PAPHI.ASP   Philadelphia, PA remote EBBS menu 
  359.     TXDAL.ASP   Dallas, Tx remote EBBS menu 
  360.     TXHOU.ASP   Houston, TX remote EBBS menu 
  361.     UTSLC.ASP   Salt Lake City, UT remote EBBS menu 
  362.     WASEA.ASP   Seattle, WA remote EBBS menu 
  363.     WIMIL.ASP   Milwaukee, WI remote EBBS menu 
  364.     XXXXX.ASP   Generic remote EBBS menu 
  365.  
  366. For those of you who wish to save disk space, you can delete the 
  367. menus that you don't need.  If you only run in 1200 baud then you 
  368. can delete "0303.ASP", "2412.ASP" and "2424.ASP".  In addition, 
  369. you can delete any remote city menu that you never contact.  If 
  370. as an example you never call Tampa then you can delete 
  371. "FLTAM.ASP".  You can of course delete "READ.ME" and "APCP.DOC" 
  372. after reading them.  You can not delete "APCP.ASP" or
  373. "APCPSTRS" however.
  374. HISTORY: 
  375.  
  376. APCP37 - Version 3.7 - March 18, 1988 - The ASPECT file problem 
  377. still remains for some.  All files were again revised to issue a 
  378. goto top and this was followed by a return that will never be 
  379. executed.
  380.  
  381. APCP36 - Version 3.6 - March 17, 1988 - The ASPECT file problem 
  382. has been traced to a DataStorm error in calculating the length of 
  383. a buffer which is truncating (or appending) the last command in 
  384. the buffer.  All files were updated with PCEDIT to contain 
  385. "return", "CR", "LF", "CR", "LF", "EOF". 
  386.  
  387. APCP35 - Version 3.5 - March 16, 1988 - Some users reported that 
  388. they could only use APCP34 if they used the PCEDIT program from 
  389. DataStorm to edit their files.  Since PCEDIT does not add a 
  390. trailing CR/LF after the End-Of-File, all files were updated yet 
  391. again using PC-Write to add the missing CR/LF.  The corrected 
  392. files should now work with any editor.  The original problem that 
  393. caused all of these releases of APCP3x are the clear result of a 
  394. very odd bug in the ASPECT processing in PCPLUS.
  395.  
  396. APCP34 - Version 3.4 - March 15, 1988 - Some users still reported 
  397. errors with APCP33 when executing the last statement in a file 
  398. which was a "goto top".  This was changed to a "return". 
  399.  
  400. APCP33 - Version 3.3 - March 14, 1988 - The bad Dallas Remote 
  401. EBBS file "TXDAL.ASP" was corrected.  The minor problem in the 
  402. Tampa Remote EBBS file "FLTAM.ASP" was corrected.  The files were 
  403. all updated using the PCEDIT program from DataStorm.  This 
  404. assures that no editor incompatibilities in the distribution 
  405. archive exist. 
  406.  
  407. APCP32 - Version 3.2 - February 29, 1988 - The APCP31.ARC 
  408. distribution library was permanently fixed by adding a carriage 
  409. return/line feed/end of file at the end of each file.  This 
  410. should permanently correct inconsistencies introduced by various 
  411. and sundry editors when used to modify the menus.  The 2400 baud 
  412. local with 1200 baud remote option was added.  Specific tests 
  413. were added for a request to process an "empty" element in both 
  414. the remote city and remote EBBS menus.  The documentation file 
  415. APCP.DOC was added with additional information included. 
  416.  
  417. APCP31 - Version 3.1 - February 24, 1988 - The APCP30.ARC 
  418. distribution library contained some garbage characters.  A new 
  419. distribution library was created.  The re-select menu (APCP.ASP) 
  420. was added.  The READ.ME documentation file was expanded.
  421.  
  422. APCP30 - Version 3.0 - February 22, 1988 - The APCP20 mechanism 
  423. was revised to use the newly release PROCOMM PLUS program in 
  424. place of the previous PROCOMM Version 2.4.2. 
  425.  
  426. APCP20 - Version 2.0 - January 19, 1988 - The APCP10 mechanism 
  427. was revised coincide with the changes made to the access codes 
  428. for PC-Pursuit and to allow 300, 1200, and 2400 baud support. 
  429.  
  430. APCP10 - Version 1.0 - January 03, 1987 - The basic APCP 
  431. mechanism was a repackaging of the work started by an unknown 
  432. programmer in the EBBS world an enhanced greatly by Bob Lake.  
  433. The menus and messages were changed in this version as well as 
  434. the method for initially invoking the menus. 
  435. DISTRIBUTION AND PAYMENT: 
  436.  
  437. I do not request any money for this package.  You should feel 
  438. free to distribute this package to anyone who desires to use it.  
  439. You should feel free to modify your copy of this package for your 
  440. own use. 
  441.  
  442. I do request that you do two things for me however:
  443.  
  444.     o  Drop me a message if you use this package that just says 
  445.        that you use APCP, and 
  446.  
  447.     o  Do not modify APCP and redistribute it as the name 
  448.        APCPxx is starting to be associated with me and Thom 
  449.        Little Associates. 
  450.  
  451. If you have suggestions for changes and improvements to APCP 
  452. please feel free to contact me. 
  453.  
  454. If you encounter any problems using this package I will be glad 
  455. to try to help you solve them.   I make no guarantees or 
  456. warranties however.  Be it known that you use this package at 
  457. your own risk.  I am not responsible for any problems that you 
  458. encounter through the use of this package.  I developed it for my 
  459. own use and use it every day.  
  460.  
  461. I hope you enjoy the automation. 
  462.  
  463. Thom Little 
  464.  
  465.  
  466.  
  467.     ... by mail:
  468.                     THOM LITTLE ASSOCIATES
  469.                     P.O. Box 1901
  470.                     Boston, MA  02205-1901
  471.                     (617) 438-0396
  472.  
  473.     ... by modem:
  474.                     CHANNEL ONE
  475.                     Cambridge,MA
  476.                     (617) 354-8873
  477.                     1200/2400 N81 and 9600 MNP
  478.                     Brian Miller (sysop)
  479.  
  480.     ... by APCP using PC-Pursuit:
  481.                     At the CITY menu   select "B"
  482.                     At the BOSTON menu select "A"
  483.  
  484.  
  485.  
  486. ACKNOWLEDGEMENTS:
  487.  
  488. Telenet is a trademark of Telenet Communications Corporation
  489. PROCOMM PLUS is a trademark of DataStorm Technologies, Inc.
  490. ASPECT is a trademark of DataStorm Technologies, Inc.
  491. 
  492.