                            *** DPARCHIE 1.5 ***
          Part of the DPNET series: Internet Software for PowerBBS

                              by Detlef Pleiss

               Internet:   det@powerbbs.com
               Compuserve: 74101.755

               Download and Online Order:
               Internet: http://dpsoft.powerbbs.com
                         http://www.abacus2.com
                         http://www.write-byte.com/3rd-Party-Download-Central
               Compuserve: GO PBBS

               Online Support Mailing List:
               to subscribe send a message to majordomo@mail.msen.com with
               "subscribe dpsoft" in the body (no quotes)

====================================================================
Files included in package:
DPARCH.DLL   - BBS side DLL for ANSI and GUI, 16 bit version
DPARCH32.DLL - BBS side DLL for ANSI and GUI, 32 bit version
DPARCH2.PA   - Caller side GUI DLL
DPARCHIE.ICO - Icon for PowerGenerator Screens
DPARCH.INI   - configuration file
DPARCHS.TXT \
DPARCHD.TXT  -- the online help files
DPARCHP.TXT  /
DPARCHM.TXT /
DPARCHIE.TXT - This File
DPSOFT.TXT   - Information about DP Software Products
FILE_ID.DIZ  - Description for BBS File Lists
UPGRADE.TXT  - Upgrading from earlier Versions
====================================================================

The Basics of DPARCHIE

DPARCHIE offers quick and easy access to ARCHIE servers for your ANSI
and PA callers. ARCHIE is a powerful tool to quickly locate files on FTP
servers throughout the world. Files can be searched by different methods
(exact, substring, regular expressions). Searches can be restricted to domains
(of FTP servers) or paths containing certain substrings.

Only requirement besides a running PowerBBS is a working
Windows Socket TCP/IP stack, a WINSOCK.DLL (WSOCK32.DLL for 32 bit). The type
of connection to your Internet provider doesn't matter, even a dialup
connection does the job. DPARCHIE can call a batch file of your choice in
order to establish a connection on demand. DPARCHIE can be operated going
through a Proxy server. This document does not explain how to get your TCP/IP
stack up and running. For that you need to refer to the documentation of the
TCP/IP software you're using or to your internet provider.

====================================================================

Installation

If you are upgrading from a previous version, read the file UPGRADE.TXT.

If you run the 16 bit version of PowerBBS, copy DPARCH.DLL to your PowerBBS
home directory.
If you run the 32 bit version of PowerBBS, copy DPARCH32.DLL to your PowerBBS
home directory and there rename it to DPARCH.DLL.
Copy DPARCHS.TXT, DPARCHD.TXT, DPARCHP.TXT and DPARCHM.TXT to your POWERBBS
directory.
Copy DPARCH2.PA to your POWRBBS\SOURCE directory.
Copy DPARCH.INI to your \windows home directory. You now need to edit the
"DefaultServer" entry of DPARCH.INI (using any text editor, like Notepad):

DefaultServer=  name of the archie server to be used by default

Take a look at DPARCHS.TXT for a list of archie servers. Enter the name of a
server at your country.
On networked BBS's have a copy of \windows\dparch.ini on each machine!
On one of your PGen screens add a command to run DPARCHIE as a PA DLL. The
command reads "O-DPARCH.DLL". You may want to use DPARCHIE.ICO for the icon.
Using CONFIG add the command to run DPARCH.DLL as ANSI DLL to one of your ANSI
menus.

====================================================================

Running the Program and Customization

Running the program should be self-explanatory. Take a look at the ANSI help
files for detailled information on the different options. The help files are:
DPARCHS.TXT - List of archie servers
DPARCHD.TXT - Help on restricting the domain(s) to search
DPARCHP.TXT - Help on restricting search to certain paths
DPARCHM.TXT - Help on the different search methods

You may want to adjust the help files to the settings of your default server.
You can do so in (DP)Telnet-ing to this server. Login as "archie" (without
quotes). Typing the command "servers" (without quotes) will get you a list of
archie servers. "help set match_domain", "help set match_path", "help set
search" and "help set sortby" (without quotes) will get you information on the
different options. "quit" (without quotes) will end the connection.

You may want to provide similar help screens for your PA callers.

Search Results of the ANSI version of DPARCHIE will be stored temporarily in
your POWRBBS directory using filenames like DPAnnnn.TXT, where nnnn is
combined using a search count and the node number.

All screen texts and hotkeys of the ANSI version of DPARCHIE can be configured
in DPARCH.INI. Compare the entries of DPARCH.INI from the original archive
with what you see on screen and you'll get how it works.

====================================================================

Dial-Up Support

DPARCHIE supports dialup connections to your provider in that you can specify
the

Dialup= path to batch file called on Internet connection requests

parameter in DPARCH.INI. This batch file is called everytime a caller launches
an ARCHIE request. Its purpose is to initiate a dialup connection in
case your Windows Socket stack doesn't dial-on-demand. If you don't need it
just leave this parameter empty.
During dial-up the "please wait" message taken from the

PleaseWait=  message to be displayed during dial-up

entry in DPARCH.INI is displayed to the caller.

====================================================================

Proxy Support

DPARCHIE supports running through a Proxy server. This is transparent to the
caller. If your BBS runs multiple nodes on multiple machines on a LAN, while
only one of these machines has an actual Internet connection, you may be
running a Proxy server on that machine. A Proxy server is the sort of software
that most often is advertised like "connect your entire LAN to the Internet
with only one dialup account". DPARCHIE connects to the Archie server using
the Telnet protocol on port 23. In order to get DPARCHIE to work through a
Proxy, the Proxy must support forwarding Telnet connections. When going
through the Proxy, DPARCHIE does not connect to the Archie server directly
but first to the Proxy server. It assumes to receive some sort of prompt which
it answers by sending the Internet address of the Archie server to connect to.
In order to activate Proxy support, you need to fill in two entries in
DPARCH.INI:

ProxyAddress= IP address (on the LAN) of your Proxy server
ProxyPrompt=  text DPARCHIE waits for before sending the Archie server address

DPARCHIE then connects to the given "ProxyAddress", waits for the given
"ProxyPrompt" and then sends the given "DefaultServer" address to the Proxy.

====================================================================

For backup and reference purposes here a copy of the original
DPARCH.INI Parameters

[DPARCHIE]
DefaultServer=archie.rutgers.edu
# Menus
Server=Archie [S]erver
Domain=Search only [D]omain(s)
Path=Search only [P]ath(s)
Method=[M]ethod
Sort=S[O]rt Result by
Find=[F]ind what
Search=Search [N]ow!
Help=[H]elp
Back=[B]ack
HelpLine=*** Show Help on: ***
GetByZ=Download Results (ZModem)? (Y/N)
# Hotkeys
ServerKey=S
DomainKey=D
PathKey=P
MethodKey=M
SortKey=O
FindKey=F
SearchKey=N
HelpKey=H
BackKey=B
# Methods
EXACT=exact
SUB=substring
SUBCASE= substring, case sensitive
REGEX=regular expression
EXACTSUB=first exact, then substring
EXACTSUBCASE=first exact, then substr/case
EXACTREGEX=first exact, then regular expression
# Sorting
NONE=none
HOSTNAME=hostname
TIME=time, latest first
SIZE=size, largest first
FILENAME=filename
RHOSTNAME=hostname, reverse
RTIME=time, oldest first
RSIZE=size, smallest first
RFILENAME=filename, reverse
PleaseWait=please wait
DialUp=
ProxyAddress=
ProxyPrompt=

====================================================================

Registration and Disclaimer

DPARCHIE is shareware. It is neither free, nor freeware nor in the public
domain. The unregistered version may be distributed freely in its unaltered
form. This software is provided as is. Detlef Pleiss disclaims all
warranties, either expressed or implied, including but not limited to implied
warranties of merchantability, fitness for a particular purpose. In no event
will Detlef Pleiss be liable to you for damages, including any loss of data,
profits, lost savings, or other incidental or consequential damages arising
out of your use or inability to use the software. Use at your own risk.

The unregistered version of DPARCHIE is limited to searches using the EXACT
method. A message stating so will appear in ANSI if you try to switch to a
different method. The unregistered GUI client has the other options disabled.
This restriction and the message will vanish after applying your registration
code to DPARCHIE.

Online registration is available at
http://addons.powerbbs.com/pleiss.htm
http://www.abacus2.com
http://www.write-byte.com/3rd-Party-Download-Central
and via Compuserve GO SWREG, ID 11749.

Registration fee is $20. After registering you'll receive a registration code
that is valid for your name and your BBS's name. If registering at
Compuserve, please additionally send Compuserve mail to 74101.755 stating
which program you registered, your name and your BBS's name. This
information will be needed. Registration can not be transferred. If
either name or BBS name change a new registration is required.

====================================================================

History of DPARCHIE:

v 1.0 - released: May 31 1996
        first public release
v 1.1 - released: June 21 1996
        added 32 bit version
v 1.2 - released: Sep 12 1996
        some internal code streamlining
v 1.3 - released: Dec 1 1997
        fixed login problem with some servers
        moved INI location to \windows
        added Proxy support
        added GUI client
v 1.4 - released: Mar 3 1998
        some internal code streamlining
        added "please wait" dial-up message
v 1.5 - currently in Beta
        updated list of Archie servers
        some internal updates
