home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / POLL_101.ZIP / POLL!.DOC < prev    next >
Encoding:
Text File  |  1994-07-23  |  4.8 KB  |  122 lines
  1.      Poll! 1.01 -- for FrontDoor / InterMail
  2.  
  3.      Copyright (C) Barto Veldhuis 1994. All rights reserved.
  4.       
  5.      Poll! creates empty poll messages, it reads the mailer's history
  6.      files to see how long ago a node was called or if you were called 
  7.      by that node.
  8.  
  9.      Poll! is designed to run from a batchfile. It automagically 
  10.      finds the FrontDoor logfile, your name and address(es). If you
  11.      are a point and want to poll your boss' system, simply type: 
  12.      
  13.      'Poll! .0'
  14.  
  15.      The general syntax is:
  16.                                                                        
  17.      POLL! [-options] <address to poll> [-options]                      
  18.                                                                    
  19.      Options: ('/' and '-' are valid prefixes)
  20.      -dxxx    last call xxx days back
  21.      -hxxx    last call xxx hours back
  22.      -mxxx    last call xxx minutes back
  23.      -sCIF    Crash / Immediate / Force pickup status 
  24.               (Pvt/Dir/Loc/Kill is always set)
  25.               If this option is not present the Crash statusbit will be set
  26.      -i       read inbound history file too
  27.      -n       do *not* log to logfile
  28.      -a       log in appendmode, without header
  29.  
  30.      Example: poll! -d3 -h12 -sc 2:282/210 -i
  31.               poll! @poll!.rsp
  32.  
  33.      Address 
  34.      ------- 
  35.      An address may be abbreviated the same way as in FrontDoor.
  36.      
  37.      e.g. your address is 2:282/210.15, 
  38.      poll! 320    -> 2:282/320
  39.      poll! .2     -> 2:282/210.2
  40.      poll! 2800/2 -> 2:2800/2
  41.  
  42.      Poll! uses the aka matching tables in SETUP.FD. 
  43.       
  44.      Logfile 
  45.      ------- 
  46.      Poll! searches for the FrontDoor logfile defined in SETUP.FD/SYS.FD.
  47.      To find SETUP.FD/SYS.FD, the environment variable FD/IM must be set: 
  48.      SET FD=C:\FD, or SETUP.FD/SYS.FD is found in the current directory. 
  49.  
  50.      In a FD mL setup, '$TASK$' in the logfilename will be replaced
  51.      by the tasknumber (taken from the environment variable 'TASK').
  52.      
  53.      If you don't want to log to the FD logfile use the -n option. The
  54.      output is displayed on the screen and can be redirected to a file:
  55.      poll! -h4 210 -n >> poll!.log 
  56.      
  57.      Example log entries:
  58.                                                    
  59.      ----------  Sun 12 Jun 94, Poll! 1.01
  60.      # 22:00:41  Command line: -h1 -sc .0               
  61.      # 22:00:41  Empty pollmessage created for 2:282/210
  62.                  
  63.      When called more than once the logfile can be messed up, so I invented
  64.      the -a option (append):
  65.                                                    
  66.      ----------  Sun 12 Jun 94, Poll! 1.01              
  67.      #  0:48:17  Command line: /h4/30 282/100 /si      
  68.      #  0:48:17  Empty pollmessage created for 2:282/100
  69.      #  0:49:15  Command line: /d4 281/10 /sdi /a       
  70.      #  0:49:15  Empty pollmessage created for 2:281/10 
  71.      
  72.      If no poll is necessary it's logged as:
  73.                                                                          
  74.      ----------  Sun 12 Jun 94, Poll! 1.01
  75.      #  0:50:10  Command line: /d1/h12/m45 282/210 /si
  76.      #  0:50:10  No need to poll 2:282/210. Last poll: Sat 14 May 94, 22:02:39
  77.  
  78.      @Response file
  79.      --------------
  80.      Poll! can read commands from a responsefile. This is a plain
  81.      ASCII file with one command per line:
  82.      
  83.      ; This is a Poll! responsefile comment line
  84.      80:200/29 -i -d3 -si   ; poll novionet every 3 days
  85.      .0 -h1                 ; poll boss if it's longer than 1 hour ago
  86.      111:314/10 -s
  87.  
  88.      Everything after ';' is ignored. 
  89.  
  90.      Errorlevels 
  91.      ----------- 
  92.      Poll! returns errorlevel 1 in case of a fatal error: probably
  93.      a file that couldn't be created or opened. An errormessage is
  94.      written to the logfile.
  95.      
  96.      Disclaimer/legal note
  97.      ---------------------
  98.      * You may freely distribute and copy Poll! provided no fee 
  99.        is charged and the Poll! archive contains unmodified 
  100.        copies of the original files. Although care has been taken 
  101.        to write Poll!, it is provided "as is", without warranty 
  102.        or guarantee of any kind. 
  103.                                      
  104.      * In no event shall Barto Veldhuis be liable to you or anyone 
  105.        else for any damages or cost, including, but not limited 
  106.        to, any lost profits, lost savings or lost income which may 
  107.        result from the use or inability to use Poll!. 
  108.       
  109.      * FrontDoor is a trademark of Joaquim Homrighausen.
  110.  
  111.      * InterMail is a trademark of Scandinavian PC systems and
  112.        Interzone software inc.
  113.  
  114.  
  115.      Barto Veldhuis,  
  116.      Nijmegen (near Gendt) NL, July 1994
  117.  
  118.      2:283/608.15@fidonet  (new adres!)
  119.      barto.veldhuis@p15.f608.n283.z2.gds.nl
  120.      barto@dds.hacktic.nl                              
  121.      PGP-key: send routed netmail to 'PGPserver'
  122.