home *** CD-ROM | disk | FTP | other *** search
- ┌──────────────────────────────────────────┐
- │ Dialing Directory Script for PCP calls │
- │ by Dan Mancuso, Another BBS? (900/006) │
- │ (c) 1991 Version 0.3α 11/28/91 DJM │
- └──────────────────────────────────────────┘
-
- These scripts are released under the "FREEWARE" concept, you are free to
- use it and pass it along to anyone under the agreement that all files
- will be sent intact without alterations to the original scripts. No fee
- may be charged (other than normal BBS subscriptions or minimal fee for
- disks and copying charge - not to exceed $5.00)
-
- To register these scripts for use, please NetMail me at 900/006 or send
- a postcard or letter to:
-
- Dan Mancuso
- Another BBS?
- 5621 Acoma SE Ste. 11A
- Albuquerque, NM 87108
-
-
- Absolutely no guarantees come with these scripts. They work for me and
- should work for you. I accept NO responsibitity whatsoever for anything
- that may or may not happen while using these scripts.
-
- --------------------------------------------------------------------------
-
- These Scripts were written for GT Power 16/17.xx but should work with
- some earlier versions of GT with little or no modifications.
-
- --------------------------------------------------------------------------
-
- INSTALLING the Files...
- ~~~~~~~~~~~~~~~~~~~~~~~
-
- The FILES...
- ~~~~~~~~~~~~
-
- Put the TWO .SCR files in the directory where you told GT to find your
- SCRipt files. (ALT-I setup - PATHS)
-
- Put the TWO .DIR files in the Directory where you told GT to find your
- Dialing Directories. (ALT-I setup - PATHS)
-
- Put the .KEY file in your GTPATH. This file must be renamed to GT.KEY.
- NOTE: You may already have a .KEY file (these are your Keyboard Macros
- that you see when you do an ALT-M from the keyboard) If you do, there
- are a few things you can do...
-
- 1. You can modify the script a little to change the .KEY file.
- 2. You can create a MACRO that will swap the .KEY file out for you.
- 3. You can replace the new .KEY file for your old one, or edit in the
- new keys that are used by these scripts. There are 10 keys used and
- are ALT-F1 to ALT-F10. Only ALT-F1 and ALT-F3 are critical to the
- operation of the scripts.
-
- It is suggested that you use them all to simplify your activity on PCP
- and use the same keys as I did so that reading these DOC will be easier.
- the DOCs will refer to these keys to perform certain functions. ALSO,
- THE SCRIPTS THEMSELVES EXPECT THAT SOME OF THESE KEYS BE WHAT THEY ARE
- IN THE SAMPLE!!!
-
- IMPORTANT!!!
- ~~~~~~~~~~~~
- Also, the MACROs for Keys ALT-F5 thru ALT-F8 need your attention. You
- will need to change the FIRST LAST to your First and LAST name as you
- log into BBSs. I will describe the function of the keys as I have them
- set-up, but these keys can be altered if you wish.
-
- --------------------------------------------------------------------------
-
- SETTING up the SCRIPTS...
- ~~~~~~~~~~~~~~~~~~~~~~~~~
-
- First thing you should do after installing all the files is to hit the
- ALT-F2 key... (this key displays the PCPSTART.DIR file)
-
- In here you should enter the local access number for PCPursuit. Use the
- number for the fastest connection you can make to your LOCAL access
- point. There should only be ONE entry in this directory!!!
-
- You can use more of them, but the script will only dial the first number
- on the list. If you want to use other numbers from time to time, you
- should change something in the Dialing Directory you can sort on to
- bring the appropriate number to the top of the list when desired.
- i.e. Putting numbers in the comment fields and BBS name fields can allow
- you to use upto three different numbers (you should need more than that.
- - 1200/2400/9600) in the name field you can use:
-
- 1 - Local 1200 = 1 Local PCP access 1200 \
- 2 - local 2400 = 2 Local PCP access 2400 > to allow the 1200 to be on
- 3 - local 9600 = 3 Local PCP access 9600 / top when sorting by BBSname
-
- then for the comment fields you could use:
-
- {COMMENT 1}
-
- 1 - Local 1200 = 2 \
- 2 - local 2400 = 3 > to allow the 9600 to be on top when sorting by
- 3 - local 9600 = 1 / COMMENT 1 field
-
- {COMMENT 2}
-
- 1 - Local 1200 = 3 \
- 2 - local 2400 = 1 > to allow the 2400 to be on top when sorting by
- 3 - local 9600 = 2 / COMMENT 2 field
-
- --------------------------------------------------------------------------
-
- The second thing you should do is hit the ALT-F4 key, this will display
- the PCP.DIR file... the sample one has a few PCPable BBSes in it. You
- should edit these, Add your Passwords and notice how they are setup and
- add other entries of your own...
-
- Notice that the 1 and area code are not listed. this is important. the
- only exception to the rules is for those BBSs you call in PCPable cities
- that require a 1 to precede the number. Currently the script does not
- handle this situation. It will be included in a future version of the
- script. (if it is required... currently I don't need this function so I
- didn't add it) if you have to have this function, let me know and I will
- modify the script to handle that situation.
-
- Make sure you put your PASSWORDs in the dialing directory. ALT-F5 thru
- ALT-F9 use the PASSWORD field for logging into various BBSs with a
- single keystroke. More on this later...
-
- Next thing is to look into the SCRipts themselves. there are
- instructions in there that will tell you where to place you PCP access
- numbers, UserIDs and Password.
-
- BE VERY CAREFUL NOT TO CHANGE ANYTHING THAT YOU SHOULDN'T. THESE SCRIPTS
- ARE A BIT DELICATE. CHANGING SOMETHING CAN RESULT IN THE SCRIPT NOT
- WORKING. DO NOT CHANGE ANY OF THE TWAIT SETTINGS ESCPECIALLY!... THE
- SCRIPTS SET UP AS THEY ARE VERY GOOD AT INSURING THAT NO PCP BILLABLE
- TIME IS ACCUMULATED UNLESS YOU ACTUALLY ARE CONNECTED TO A BBS IN A
- REMOTE CITY!!! - keep in mind though, anything can happen...
-
- --------------------------------------------------------------------------
-
- USING the SCRIPTS...
- ~~~~~~~~~~~~~~~~~~~~
-
- You should be ready to start using the scripts...
-
- the various ALT-Fx keys control the scripts. The following BRIEFLY
- describes the function of each of the keys...
-
- ALT-F1 - CONNECTS to PCP
- ALT-F2 - DISPLAY the PCPSTART.DIR
- ALT-F3 - STARTS PCP calling
- ALT-F4 - DISPLAY the PCP.DIR
- ALT-F5 - Typical PCBoard Login
- ALT-F6 - Normal GT BBS LOGIN
- ALT-F7 - FIRST and LAST name w/CR
- ALT-F8 - FULL GT Login bypassing Bulletins
- ALT-F9 - PASSWORD only w/CR
- ALT-F10- HANG-UP on PCP
-
- Now I will describe each key in detail...
-
- ALT-F1 - This is the key you hit when you are ready to start your PCP
- session. This key will automatically change the current dialing
- directory to the one names PCPSTART.DIR it will also make sure that the
- dialing directory is set up properly. i.e. it will mark the first entry
- for dialing and then run the appropriate script (DIAL-PCP.SCR) when a
- connection is made, a brief message will flash saying when the window
- disappears, press the ALT-F3 key.
-
- ALT-F2 - This will simple display the PCPSTART.DIR so you can edit it if
- needed. Generally once you set the PCPSTART.DIR up you will not need to
- change it unless the local PCP number changes...
-
- ALT-F3 - This starts the whole thing dialing the entries you mark in the
- PCP.DIR (See ALT-F4) the script will start dialing the first number
- marked in the list, and using the circular dialing will dial each number
- in the list until a connection is made. This works exactly like the
- circular dialing you probably use all the time when making local calls.
- This is why I wrote the script the way I did. Pressing the ALT-F3 will
- start the circular dialing for you automatically.
-
- ALT-F4 - This is the first key you will generally press when getting
- ready for a PCP session. This key displays the PCP.DIR and allows you to
- mark the BBSs you want to dial.
-
- === these first four buttons are totally automated. they will perform
- there function from almost anywhere when you are in GT Terminal mode.
- i.e. you do not have to press the E button and manualy change to the
- required .DIR file to do the function require, these macros do all the
- work. I wanted to make my PCP sessions as easy to deal with as possible.
- so I had the MACROs do all the tedious stuff for me...
-
- ALT-F5 - After you connect to a PCBoard, press this button and it will
- do the login for you. This one will work with other BBSs as well, the
- output is in this form:
- FIRSTNAME LASTNAME PASSWORD {CR}
-
- Whatever BBS uses this format . i.e. ROS, OPUS and others can be
- accessed with this key. It requires that you have modified the GT.KEY
- file (supplied in this archive as PCP.KEY) as described above.
-
- ALT-F6 - This is the basic GT Login, it should also work for WildCat
- BBSs and others that use this format:
-
- FIRSTNAME LASTNAME Y PASSWORD {CR}
-
- ALT-F7 - This one is just your FIRST and LAST name followed by a
- Carraige Return, i.e.:
- FIRSTNAME LASTNAME {CR}
-
- ALT-F8 - This one is for GT BBSs only. and then only when you have the
- ability to bypass the login bulletins. The format is like this:
-
- FIRSTNAME LASTNAME Y PASSWORD Y {CR}
-
- ALT-F9 - This one is generally used in conjunction with ALT-F7. It will
- extract the PASSWORD from the Dialing directory and enter that followed
- by a Carriage Return like this:
-
- PASSWORD {CR}
-
- ALT-F10- This one is used to hang up on PCP when you are done. Do not
- use this one while Scripts are running, unpredictable results will
- occur) it is the Standard Hang-up info when you are connected to
- PCPursuit. i.e.:
- {CR} @ {CR} HANGUP
-
- --------------------------------------------------------------------------
-
- A Typical Session...
- ~~~~~~~~~~~~~~~~~~~~
-
- Hit ALT-F4
-
- Mark all the entries you wish to attempt to contact.
-
- Hit ALT-F1
-
- When you are connected to PCPursuit a message will flash by telling you
- to wait till the window disappears and hit ALT-F3. When the window
- disappears a message appears on the screen saying:
-
- connect to PCPursuit (or whatever you PCPSTART.DIR entry says for the
- hit any key to continue... BBS name)
-
- Hit ALT-F3 (do not hit any key, use ALT-F3, it includes the "any key"
-
- NOTE: at this point the script will start dialing at the first entry
- marked. If you want to start with a BBS listed a little further down the
- line then hit the space bar to clear the message, then hit ALT-F4. move
- the highlight bar to the entry you want to start from, then immediately
- hit ALT-F3. the dialing will commence from that entry. At this point you
- can also dial BBSs by highlighting them and hitting enter. just like you
- might using GT in normal fashion. After each attempt, if no connect is
- made, the script will automatically disconnect from the remote modem
- while leaving you connected to the local access of PCP. Note... PCP will
- disconnect you if no activity occurs withing a certain amount of time,
- usually 30 to 120 seconds)
-
- If you just hit ALT-F3, then the script will try to dial and connect to
- the first marked entry. if unsuccessful, it will disconnect from the
- remote modem and get the next marked entry and continue until it makes a
- connection.
-
- During the process of dialing, the script is constantly checking to make
- sure the connection is valid and that PCP is responding properly. If
- something goes wrong, a message will appear in the progress window.
- telling you what happened. in most cases you can ignore it and the
- script will handle the situation as best it can. If worse comes to worse
- and the script can't figure out what to do, it will go into a "panic
- mode" and disconnect from PCPursuit. (unfortunately at the moment I have
- not been able to find a way to stop the circular dialer from continuing
- to operate, but hitting the ESC key while the script is NOT in operation
- will stop the process. You can tell when the script is in operation by
- watching the status line... the letters SCR are on the status line when
- the script is running. NEVER HIT A KEY WHEN THE 'SCR' is on the status
- line. you get a short period of time before each call is started to hit
- the ESC key to get out of the circular dialer to make adjustments or to
- disconnect. If you want to disconnect at that point, hit the ALT-F10 key
- and the script will disconnect you from PCPursuit completely.
-
- After you have completed a call to a remote BBS and wish to continue
- dialing other marked BBSs, simply hit ALT-6 (this normal start-up for
- the circular dialer) this will automatically disconnect your from the
- remote PCP site and continue dialing the remaining directory entries.
- The last connected BBS will be removed from the markes list just like it
- does when you use the circular dialer in normal use. Also all activities
- normally sent to the GT.LOG will still go there.
-
- --------------------------------------------------------------------------
-
- Tips and Hints...
- ~~~~~~~~~~~~~~~~~
-
- For now, Enjoy the scripts. I think you will like the automation they
- provide. They are pretty good about handling most of the bru-ha-ha
- PCPursuit normally tries to dish out to screw up a script.
-
- This script is not immune to them all but is very good at bailing out
- when something goes wrong.
-
- I have noticed a lot of time that PCPursuit will not send back a result
- code that the script can recognize. there is a check for that, if a
- message comes up and sez: Unrecognized response recieved: in yellow
- letters on a red backround. the message it recieved should be displayed
- afterwards. in my experience it is always a blank field. in theory this
- shouldn't happen, something should be there. but what the heck. that's a
- X.25 PAD for you!.... generally it seems to meean that the remote end
- was answered by voice, or that the remote PCP city is down or is having
- problems or doing maint or something unusual.
-
- These scripts should not need any adjustment, I have been testing them
- for almost 3 months now (as you see them here) and I have not had to
- make any adjustments to them at all.
-
- The occasional message from the script saying something like Password
- not accepted, or remote site did not acknowledge ATZ or something like
- that is normally not a problem if if only happens once in a while. It
- could mean that the remote modem is not functioning properly, do not be
- tempted to start making adjustments. many of the settings are
- interdepentant on other setting and you could throw the whole thing off.
-
- If you are tempted to make adjustments, make sure you back up the
- original so you have something to fall back on.
-
- --------------------------------------------------------------------------
-
- If you need help or have questions, you can contact me on the GT Network
- in the GT SCRIPTS echo or via NetMail at Net/Node 900/006 addressed to
- SYSOP or to Dan Mancuso. I will be happy to try and help you out.
-
- You can aslo call my BBS direct (unfortunately not via PCP) at
- 505-255-3623 (Another BBS?) in Albuquerque, NM
-