home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / GT_PCP03.ZIP / PCP-SCR.DOC < prev    next >
Encoding:
Text File  |  1991-11-28  |  15.0 KB  |  333 lines

  1.                  ┌──────────────────────────────────────────┐
  2.                  │  Dialing Directory Script for PCP calls  │
  3.                  │  by Dan Mancuso, Another BBS? (900/006)  │
  4.                  │  (c) 1991  Version 0.3α    11/28/91 DJM  │
  5.                  └──────────────────────────────────────────┘
  6.  
  7.  These scripts are released under the "FREEWARE" concept, you are free to
  8.  use it and pass it along to anyone under the agreement that all files
  9.  will be sent intact without alterations to the original scripts. No fee
  10.  may be charged (other than normal BBS subscriptions or minimal fee for
  11.  disks and copying charge - not to exceed $5.00)
  12.  
  13.  To register these scripts for use, please NetMail me at 900/006 or send
  14.  a postcard or letter to:
  15.  
  16.                             Dan Mancuso
  17.                             Another BBS?
  18.                             5621 Acoma SE  Ste. 11A
  19.                             Albuquerque, NM 87108
  20.  
  21.  
  22.  Absolutely no guarantees come with these scripts. They work for me and
  23.  should work for you. I accept NO responsibitity whatsoever for anything
  24.  that may or may not happen while using these scripts.
  25.  
  26. --------------------------------------------------------------------------
  27.  
  28. These Scripts were written for GT Power 16/17.xx but should work with
  29. some earlier versions of GT with little or no modifications.
  30.  
  31. --------------------------------------------------------------------------
  32.  
  33. INSTALLING the Files...
  34. ~~~~~~~~~~~~~~~~~~~~~~~
  35.  
  36. The FILES...
  37. ~~~~~~~~~~~~
  38.  
  39. Put the TWO .SCR files in the directory where you told GT to find your
  40. SCRipt files. (ALT-I setup - PATHS)
  41.  
  42. Put the TWO .DIR files in the Directory where you told GT to find your
  43. Dialing Directories. (ALT-I setup - PATHS)
  44.  
  45. Put the .KEY file in your GTPATH. This file must be renamed to GT.KEY.
  46. NOTE: You may already have a .KEY file (these are your Keyboard Macros
  47. that you see when you do an ALT-M from the keyboard) If you do, there
  48. are a few things you can do...
  49.  
  50. 1. You can modify the script a little to change the  .KEY file.
  51. 2. You can create a MACRO that will swap the .KEY file out for you.
  52. 3. You can replace the new .KEY file for your old one, or edit in the
  53.    new keys that are used by these scripts. There are 10 keys used and
  54.    are ALT-F1 to ALT-F10. Only ALT-F1 and ALT-F3 are critical to the
  55.    operation of the scripts.
  56.  
  57. It is suggested that you use them all to simplify your activity on PCP
  58. and use the same keys as I did so that reading these DOC will be easier.
  59. the DOCs will refer to these keys to perform certain functions. ALSO,
  60. THE SCRIPTS THEMSELVES EXPECT THAT SOME OF THESE KEYS BE WHAT THEY ARE
  61. IN THE SAMPLE!!!
  62.  
  63. IMPORTANT!!!
  64. ~~~~~~~~~~~~
  65. Also, the MACROs for Keys ALT-F5 thru ALT-F8 need your attention. You
  66. will need to change the FIRST LAST to your First and LAST name as you
  67. log into BBSs. I will describe the function of the keys as I have them
  68. set-up, but these keys can be altered if you wish.
  69.  
  70. --------------------------------------------------------------------------
  71.  
  72. SETTING up the SCRIPTS...
  73. ~~~~~~~~~~~~~~~~~~~~~~~~~
  74.  
  75. First thing you should do after installing all the files is to hit the
  76. ALT-F2 key... (this key displays the PCPSTART.DIR file)
  77.  
  78. In here you should enter the local access number for PCPursuit. Use the
  79. number for the fastest connection you can make to your LOCAL access
  80. point.  There should only be ONE entry in this directory!!!
  81.  
  82. You can use more of them, but the script will only dial the first number
  83. on the list. If you want to use other numbers from time to time, you
  84. should change something in the Dialing Directory you can sort on to
  85. bring the appropriate number to the top of the list when desired.
  86. i.e. Putting numbers in the comment fields and BBS name fields can allow
  87. you to use upto three different numbers (you should need more than that.
  88. - 1200/2400/9600) in the name field you can use:
  89.  
  90. 1 - Local 1200 = 1 Local PCP access 1200  \
  91. 2 - local 2400 = 2 Local PCP access 2400   > to allow the 1200 to be on
  92. 3 - local 9600 = 3 Local PCP access 9600  /  top when sorting by BBSname
  93.  
  94. then for the comment fields you could use:
  95.  
  96. {COMMENT 1}
  97.  
  98. 1 - Local 1200 =  2  \
  99. 2 - local 2400 =  3   > to allow the 9600 to be on top when sorting by
  100. 3 - local 9600 =  1  /  COMMENT 1 field
  101.  
  102. {COMMENT 2}
  103.  
  104. 1 - Local 1200 =  3  \
  105. 2 - local 2400 =  1   > to allow the 2400 to be on top when sorting by
  106. 3 - local 9600 =  2  /  COMMENT 2 field
  107.  
  108. --------------------------------------------------------------------------
  109.  
  110. The second thing you should do is hit the ALT-F4 key, this will display
  111. the PCP.DIR file...  the sample one has a few PCPable BBSes in it. You
  112. should edit these, Add your Passwords and notice how they are setup and
  113. add other entries of your own...
  114.  
  115. Notice that the 1 and area code are not listed. this is important. the
  116. only exception to the rules is for those BBSs you call in PCPable cities
  117. that require a 1 to precede the number. Currently the script does not
  118. handle this situation. It will be included in a future version of the
  119. script. (if it is required... currently I don't need this function so I
  120. didn't add it) if you have to have this function, let me know and I will
  121. modify the script to handle that situation.
  122.  
  123. Make sure you put your PASSWORDs in the dialing directory. ALT-F5 thru
  124. ALT-F9 use the PASSWORD field for logging into various BBSs with a
  125. single keystroke. More on this later...
  126.  
  127. Next thing is to look into the SCRipts themselves. there are
  128. instructions in there that will tell you where to place you PCP access
  129. numbers, UserIDs and Password.
  130.  
  131. BE VERY CAREFUL NOT TO CHANGE ANYTHING THAT YOU SHOULDN'T. THESE SCRIPTS
  132. ARE A BIT DELICATE. CHANGING SOMETHING CAN RESULT IN THE SCRIPT NOT
  133. WORKING. DO NOT CHANGE ANY OF THE TWAIT SETTINGS ESCPECIALLY!... THE
  134. SCRIPTS SET UP AS THEY ARE VERY GOOD AT INSURING THAT NO PCP BILLABLE
  135. TIME IS ACCUMULATED UNLESS YOU ACTUALLY ARE CONNECTED TO A BBS IN A
  136. REMOTE CITY!!! - keep in mind though, anything can happen...
  137.  
  138. --------------------------------------------------------------------------
  139.  
  140. USING the SCRIPTS...
  141. ~~~~~~~~~~~~~~~~~~~~
  142.  
  143. You should be ready to start using the scripts...
  144.  
  145. the various ALT-Fx keys control the scripts. The following BRIEFLY
  146. describes the function of each of the keys...
  147.  
  148. ALT-F1 - CONNECTS to PCP
  149. ALT-F2 - DISPLAY the PCPSTART.DIR
  150. ALT-F3 - STARTS PCP calling
  151. ALT-F4 - DISPLAY the PCP.DIR
  152. ALT-F5 - Typical PCBoard Login
  153. ALT-F6 - Normal GT BBS LOGIN
  154. ALT-F7 - FIRST and LAST name w/CR
  155. ALT-F8 - FULL GT Login bypassing Bulletins
  156. ALT-F9 - PASSWORD only w/CR
  157. ALT-F10- HANG-UP on PCP
  158.  
  159. Now I will describe each key in detail...
  160.  
  161. ALT-F1 - This is the key you hit when you are ready to start your PCP
  162. session. This key will automatically change the current dialing
  163. directory to the one names PCPSTART.DIR it will also make sure that the
  164. dialing directory is set up properly. i.e. it will mark the first entry
  165. for dialing and then run the appropriate script (DIAL-PCP.SCR) when a
  166. connection is made, a brief message will flash saying when the window
  167. disappears, press the ALT-F3 key.
  168.  
  169. ALT-F2 - This will simple display the PCPSTART.DIR so you can edit it if
  170. needed. Generally once you set the PCPSTART.DIR up you will not need to
  171. change it unless the local PCP number changes...
  172.  
  173. ALT-F3 - This starts the whole thing dialing the entries you mark in the
  174. PCP.DIR (See ALT-F4) the script will start dialing the first number
  175. marked in the list, and using the circular dialing will dial each number
  176. in the list until a connection is made. This works exactly like the
  177. circular dialing you probably use all the time when making local calls.
  178. This is why I wrote the script the way I did. Pressing the ALT-F3 will
  179. start the circular dialing for you automatically.
  180.  
  181. ALT-F4 - This is the first key you will generally press when getting
  182. ready for a PCP session. This key displays the PCP.DIR and allows you to
  183. mark the BBSs you want to dial.
  184.  
  185. === these first four buttons are totally automated. they will perform
  186. there function from almost anywhere when you are in GT Terminal mode.
  187. i.e. you do not have to press the E button and manualy change to the
  188. required .DIR file to do the function require, these macros do all the
  189. work. I wanted to make my PCP sessions as easy to deal with as possible.
  190. so I had the MACROs do all the tedious stuff for me...
  191.  
  192. ALT-F5 - After you connect to a PCBoard, press this button and it will
  193. do the login for you. This one will work with other BBSs as well, the
  194. output is in this form:
  195.                             FIRSTNAME LASTNAME PASSWORD {CR}
  196.  
  197. Whatever BBS uses this format . i.e. ROS, OPUS and others can be
  198. accessed with this key. It requires that you have modified the GT.KEY
  199. file (supplied in this archive as PCP.KEY) as described above.
  200.  
  201. ALT-F6 - This is the basic GT Login, it should also work for WildCat
  202. BBSs and others that use this format:
  203.  
  204.                             FIRSTNAME LASTNAME Y PASSWORD {CR}
  205.  
  206. ALT-F7 - This one is just your FIRST and LAST name followed by a
  207. Carraige Return, i.e.:
  208.                             FIRSTNAME LASTNAME {CR}
  209.  
  210. ALT-F8 - This one is for GT BBSs only. and then only when you have the
  211. ability to bypass the login bulletins. The format is like this:
  212.  
  213.                             FIRSTNAME LASTNAME Y PASSWORD Y {CR}
  214.  
  215. ALT-F9 - This one is generally used in conjunction with ALT-F7. It will
  216. extract the PASSWORD from the Dialing directory and enter that followed
  217. by a Carriage Return like this:
  218.  
  219.                             PASSWORD {CR}
  220.  
  221. ALT-F10- This one is used to hang up on PCP when you are done. Do not
  222. use this one while Scripts are running, unpredictable results will
  223. occur)  it is the Standard Hang-up info when you are connected to
  224. PCPursuit. i.e.:
  225.                             {CR} @ {CR} HANGUP
  226.  
  227. --------------------------------------------------------------------------
  228.  
  229. A Typical Session...
  230. ~~~~~~~~~~~~~~~~~~~~
  231.  
  232. Hit ALT-F4
  233.  
  234. Mark all the entries you wish to attempt to contact.
  235.  
  236. Hit ALT-F1
  237.  
  238. When you are connected to PCPursuit a message will flash by telling you
  239. to wait till the window disappears and hit ALT-F3. When the window
  240. disappears a message appears on the screen saying:
  241.  
  242. connect to PCPursuit (or whatever you PCPSTART.DIR entry says for the
  243. hit any key to continue...                                      BBS name)
  244.  
  245. Hit ALT-F3 (do not hit any key, use ALT-F3, it includes the "any key"
  246.  
  247. NOTE: at this point the script will start dialing at the first entry
  248. marked. If you want to start with a BBS listed a little further down the
  249. line then hit the space bar to clear the message, then hit ALT-F4. move
  250. the highlight bar to the entry you want to start from, then immediately
  251. hit ALT-F3. the dialing will commence from that entry. At this point you
  252. can also dial BBSs by highlighting them and hitting enter. just like you
  253. might using GT in normal fashion. After each attempt, if no connect is
  254. made, the script will automatically disconnect from the remote modem
  255. while leaving you connected to the local access of PCP. Note... PCP will
  256. disconnect you if no activity occurs withing a certain amount of time,
  257. usually 30 to 120 seconds)
  258.  
  259. If you just hit ALT-F3, then the script will try to dial and connect to
  260. the first marked entry. if unsuccessful, it will disconnect from the
  261. remote modem and get the next marked entry and continue until it makes a
  262. connection.
  263.  
  264. During the process of dialing, the script is constantly checking to make
  265. sure the connection is valid and that PCP is responding properly. If
  266. something goes wrong, a message will appear in the progress window.
  267. telling you what happened. in most cases you can ignore it and the
  268. script will handle the situation as best it can. If worse comes to worse
  269. and the script can't figure out what to do, it will go into a "panic
  270. mode" and disconnect from PCPursuit. (unfortunately at the moment I have
  271. not been able to find a way to stop the circular dialer from continuing
  272. to operate, but hitting the ESC key while the script is NOT in operation
  273. will stop the process. You can tell when the script is in operation by
  274. watching the status line... the letters SCR are on the status line when
  275. the script is running. NEVER HIT A KEY WHEN THE 'SCR' is on the status
  276. line. you get a short period of time before each call is started to hit
  277. the ESC key to get out of the circular dialer to make adjustments or to
  278. disconnect. If you want to disconnect at that point, hit the ALT-F10 key
  279. and the script will disconnect you from PCPursuit completely.
  280.  
  281. After you have completed a call to a remote BBS and wish to continue
  282. dialing other marked BBSs, simply hit ALT-6 (this normal start-up for
  283. the circular dialer) this will automatically disconnect your from the
  284. remote PCP site and continue dialing the remaining directory entries.
  285. The last connected BBS will be removed from the markes list just like it
  286. does when you use the circular dialer in normal use. Also all activities
  287. normally sent to the GT.LOG will still go there.
  288.  
  289. --------------------------------------------------------------------------
  290.  
  291. Tips and Hints...
  292. ~~~~~~~~~~~~~~~~~
  293.  
  294. For now, Enjoy the scripts. I think you will like the automation they
  295. provide. They are pretty good about handling most of the bru-ha-ha
  296. PCPursuit normally tries to dish out to screw up a script.
  297.  
  298. This script is not immune to them all but is very good at bailing out
  299. when something goes wrong.
  300.  
  301. I have noticed a lot of time that PCPursuit will not send back a result
  302. code that the script can recognize. there is a check for that, if a
  303. message comes up and sez: Unrecognized response recieved: in yellow
  304. letters on a red backround. the message it recieved should be displayed
  305. afterwards. in my experience it is always a blank field. in theory this
  306. shouldn't happen, something should be there. but what the heck. that's a
  307. X.25 PAD for you!....   generally it seems to meean that the remote end
  308. was answered by voice, or that the remote PCP city is down or is having
  309. problems or doing maint or something unusual.
  310.  
  311. These scripts should not need any adjustment, I have been testing them
  312. for almost 3 months now (as you see them here) and I have not had to
  313. make any adjustments to them at all.
  314.  
  315. The occasional message from the script saying something like Password
  316. not accepted, or remote site did not acknowledge ATZ or something like
  317. that is normally not a problem if if only happens once in a while. It
  318. could mean that the remote modem is not functioning properly, do not be
  319. tempted to start making adjustments. many of the settings are
  320. interdepentant on other setting and you could throw the whole thing off.
  321.  
  322. If you are tempted to make adjustments, make sure you back up the
  323. original so you have something to fall back on.
  324.  
  325. --------------------------------------------------------------------------
  326.  
  327. If you need help or have questions, you can contact me on the GT Network
  328. in the GT SCRIPTS echo or via NetMail at Net/Node 900/006 addressed to
  329. SYSOP or to Dan Mancuso. I will be happy to try and help you out.
  330.  
  331. You can aslo call my BBS direct (unfortunately not via PCP) at
  332. 505-255-3623 (Another BBS?) in Albuquerque, NM
  333.