home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / zmodem / zcpbqnow.arc / NOW.NOT < prev    next >
Encoding:
Text File  |  1988-12-29  |  7.6 KB  |  150 lines
  1.       This file is the main telephone directory or %phones file.  It 
  2.     includes telephone numbers, a couple of short scripts, function key 
  3.     macros, and a couple of support routines called by the PB.T, Q.T and 
  4.     other scripts.
  5.     
  6.     TELEPHONE NUMBERS
  7.     
  8.       The telephone numbers at the top are all systems in the Boston area 
  9.     (area code 617), except for Telegodzilla.  These fine BBS systems are 
  10.     all waiting for you to call - try them out.  The PCPursuit code for 
  11.     the Boston area is MABOS.
  12.     
  13.       Notice that most of the systems are listed twice.  (example: bix and 
  14.     abix, chan and achan).  The entry which starts with "a" is automatically
  15.     linked with a script by the "dial" and "linkup" entries, the unadorned
  16.     name is not. The :** after the second group of numbers displays them
  17.     with a function key (find **\r %phones).
  18.     
  19.     THE DIAL MCOMMAND
  20.     
  21.       The "dial" entry is quite different from those in the %phones script
  22.     Omen supplies with Zcomm.  The section of the dial script beginning 
  23.     with the label "doit" is the dialing procedure itself.  This is where 
  24.     you'll edit in special initialization strings, etc. you need for your 
  25.     particular setup. (The statliner string parameter introduced without 
  26.     fanfare a few versions back replaces the port and speed info on the 
  27.     real-time status line with a string of your choice, in this case - 
  28.     %remote).
  29.     
  30.       The top of the dial entry first checks to see if the directory entry 
  31.     name is preceded by the letter "a" (for "automatic" access).  If not, 
  32.     we skip to "doit" and dial.  A call command which does start with the 
  33.     letter a is subjected to further processing - the call command line is 
  34.     parsed for up to 9 possible modifiers.  The modifiers are stored in 
  35.     string parameters %n1-%n9, and a count of modifiers is stored in %n0. 
  36.     
  37.     For example:  call ac,1,5,6,9,25,d
  38.     
  39.     will cause %n0-9 to be set as follows:
  40.     
  41.        n0      6           <- number of modifiers
  42.        n1      1
  43.        n2      5
  44.        n3      6
  45.        n4      9
  46.        n5      25
  47.        n6      d
  48.        n7
  49.        n8
  50.        n9
  51.     
  52.       The PCBoard calling script (PB.T) supplied in the ZPBQNOW archive 
  53.     gives one example of how these modifiers can be used.
  54.     
  55.       Once the command line is parsed, the dial script calls the "linkup" 
  56.     subroutine to attach the proper script file to the system called using 
  57.     the mconnect facility.  The name of the attached script is displayed, 
  58.     and the call is placed.
  59.     
  60.       The command-line parsing/linkup procedure adds a second or two of lag 
  61.     time between typing a call command and dialout when the NOW file is 
  62.     stored on a ramdisk on a particularly slow 4.77 mhz PC.  On a faster 
  63.     computer, you may not notice it at all. Keeping the telephone numbers 
  64.     and dial entry at the top of the script speeds access.
  65.     
  66.       If the call fails, the nocon label cleans things up and returns the 
  67.     Zcomm command prompt.
  68.     
  69.     SUPPORT ROUTINES
  70.     
  71.       The setpass routine finds the %remote name in a file called PASS and 
  72.     grabs a line containing a password and whatever other info is there 
  73.     into the %z0 string parameter.  The line is string split into tokens 
  74.     stored in %z0-%z9 (the %remote name is in %z0) and control is returned 
  75.     to the caller.  The PB.T script gets door numbers for Prodoor and 
  76.     Quickmail (if needed) from the PASS file.  A sample PASS file is 
  77.     included.
  78.     
  79.       The clsparms routine sets string parameters %n0-%n9, %s0-%s9, and 
  80.     %password to empty.  It also sets %ifs (internal field separator for 
  81.     string splitting) to a smorgasboard of characters used by different 
  82.     scripts.  All the scripts in the ZCPBQNOW archive use either a comma 
  83.     or a blank space as separators.
  84.     
  85.       The k1 routine sets function keys to a default status.  It's handy
  86.     to keep this as a separate routine so that scripts for a particular 
  87.     system can redefine fkeys for their own purposes and quickly reset 
  88.     them when the script is finished.  The "bon" script (for calling BIX) 
  89.     and the Q.T script for the outcall queue both use this technique.
  90.     
  91.       The tedit routine speeds the script editing/tryout cycle. Called from 
  92.     a function key, it prompts for a filename and calls your editor to 
  93.     work on it.  The filename is stored in the %menu string parameter.  
  94.     When editing is finished, the script can be tested by pressing just 
  95.     "m" at the Zcomm command prompt.  A filename in the %menu parameter 
  96.     "sticks" until it's specifically overridden, so the second and further 
  97.     tryouts can be edited just by Shift-f7-Enter.  The editor used in 
  98.     testing was the fine shareware product SLED.COM copyrighted 1987 by 
  99.     Sam Willmot of Ontario, Canada.
  100.     
  101.       The findname subroutine is almost unchanged from a routine posted in 
  102.     the Omen-tech conference on the Interlink BBS Network by a fellow 
  103.     named Barry Thorp.  Pressing Shift f-10 will search the capture buffer 
  104.     for the last filename displayed and ask if it is the correct one. When 
  105.     the right filename is displayed, pressing Y will initiate an Xmodem or 
  106.     Xmodem-1K download.  A default filename is created if none can be 
  107.     found.  Thanks, Barry! 
  108.     
  109.       The sparms subroutine provides a somewhat formatted display of the 
  110.     contents of string parameters %z0-%z9, %n0-%n9, and %s0-%s9.  It looks 
  111.     nicer with "display overstrike" enabled.
  112.     
  113.     TINY SCRIPTS
  114.     
  115.       The "bon" subroutine (linked to system name "abix") calls the BIX 
  116.     time- sharing system (copyright McGraw-Hill).  Tymnet-specific login 
  117.     stuff is not included because we're lucky enough to have a direct 
  118.     access node here in Boston.  This script is here mostly to illustrate 
  119.     a trick I've used to cut my bix costs considerably -- don't struggle 
  120.     with those conference names, define them once and let Zcomm soft keys 
  121.     do the typing.  If called from the outcall queue, this script just 
  122.     gets a listing of new messages and logs you off.
  123.     
  124.       The "omenscan" subroutine (linked to aomen) refreshes copies of the 
  125.     "answer" and "messages" files on the Telegodzilla system and gets a 
  126.     "dirt" listing of files so you can see if your favorite comm program 
  127.     has been updated recently.  It uses the zmodem -Z parameter added in 
  128.     version 17.27 to speed download of the text files by about 10%.
  129.     
  130.     
  131.     SETUP ENTRY
  132.     
  133.       The setup entry is pretty minimal and you'll want to edit in your 
  134.     favorite setup stuff to suit your environment.  The colors chosen are 
  135.     for my green-screen composite monitor attached to a CGA equivalent -- 
  136.     they give bright text on a light background for incoming data and user 
  137.     input and black text on the same background for program messages and 
  138.     script prompts.  Be sure to set the %lib string parameter to the
  139.     directory where you keep PB.T, Q.T and other scripts. 
  140.     
  141.     The setup entry does two things specific to the enclosed Q.T script. 
  142.     First, it looks for an archive of *.q files specific to the day of the 
  143.     week (example: Sun.arc, Mon.arc, etc.) and uses the ARCE archive
  144.     extract utility (available from System Enhancements Associates) to
  145.     decompress it if present, allowing for a schedule of outgoing calls.
  146.     It then calls Q.T to start the *.q file creation process.  Q.T is not
  147.     called if there are Zcomm commands on the DOS command line (example:
  148.     C:> zcomm call dog). Striking the carriage return twice after the
  149.     program name at the Dos prompt quickly bypasses Q.T.
  150.