----------------------------------------------------------------------------
---- ZOC QWK Script v1.0 for Synchronet BBS Software README ----------------
----------------------------------------------------------------------------
          WasteLand BBS   -  telnet://wasteland.darktech.org
               	 	     telnet://wasteland.detour.net

	        Website   -  http://wasteland.darktech.org

                 E-mail   -  pg@wasteland.darktech.org        
----------------------------------------------------------------------------
Synchronet BBS Software   -  telnet://vert.sync3.net
			     http://www.weedpuller.com/synchronet/
----------------------------------------------------------------------------
	    ZOC Website   -  http://www.emtec.com/
----------------------------------------------------------------------------
----------------------------------------------------------------------------

        
  Look at the REXX Help files included with ZOC for more information on
  the REXX Scripting Language and Functions.

  This script is designed to allow Synchronet BBS Software to
  Automatically make a QWK Call with Telnet using the Terminal Program
  ZOC v3.13.  It should work when calling any version of Synchronet,
  however I have not tested this with older versions of ZOC.

  ** NOTE: Some changes *may* be necessary to work with your system.
           Especially if the BBS has modified the [Pause] prompt or
           the QWK: Menu Prompt.  Look over it, this version works with
           Unmodified Synchronet v2.x and v3.  It's pretty intuitive as to
           what the script is doing.

  ** This is the first version of this script.  It may not be perfect,
     so you can find a newer version at the below, or just edit the dam
     thing yourself!  :=)

  This script will probably work with other BBS Software with only a few
  modifications.

  This script is designed to work with a Terminal Program called ZOC which
  is available for Win95/98/NT and OS/2.

  You can obtain ZOC at any of the addresses at the bottom of this README.


------------------------------------------------------------------------------
--- INSTALLATION -------------------------------------------------------------
------------------------------------------------------------------------------

NOTE :  Installation is different for v2.x and v3.x of Synchronet.  

With the new Win32 Native (v3) of Synchronet you can execute a Win32 
Application (ZOC) directly without the need of a batch file.  However, with 
v2.x of Synchronet it is required to load ZOC via a Batch File.  Please follow
the directions carefully for the version you are running.

------------------------------------------------------------------------------
--- (1) ----------------------------------------------------------------------

First load the .ZRX file in a text editor and then make the necessary changes
that are commented in the Script.  Then save it into your SBBS\EXEC Directory.

------------------------------------------------------------------------------
--- (2) ----------------------------------------------------------------------

****  Version 2.x Only! ******************************************************
******************************************************************************

Either copy the included QNET.BAT file into your SBBS\EXEC directory or edit 
the one that is already there and change it as follows.

-------------------------------------------
@echo off
c:
cd\zoc313
START /W ZOC.EXE /Q /U /S:%1vertpoll.zrx
cd %SBBSNODE%
-------------------------------------------

** Be sure to change the paths or filenames to match your systems configuration

** Note - The START /W before ZOC.EXE is very important as this will make the 
batch file wait for ZOC to finish before continuing to the next line of the 
Batch File.

******************************************************************************
******************************************************************************

------------------------------------------------------------------------------
--- (3) ----------------------------------------------------------------------

***************************  Version 2.x Setup *******************************
******************************************************************************

Set up your HUB ID's Call Out Command Line in SCFG under :

Networks/QWK Packet Networks/Network Hubs/QWK Network Hubs/Command Line

Change the callout command line to:

%!qnet.bat %!

Be sure to add the %! after the QNET.BAT so the included batch file is looking
in the SBBS\EXEC directory for the script.  (Notice the %1 in the Batch File)

Set the time(s) and node number you wish to use while here in SCFG.

Make sure your Networked Sub-Boards are configured correctly. Refer to your
SYSOP.DOC that comes with Synchronet for more information on your QWK Network
Call-Out Configuration.

******************************************************************************
******************************************************************************

-------------------------------------------------------------------------------

***************************  Version 3.x Setup *******************************
******************************************************************************

Set up your HUB ID's Call Out Command Line in SCFG under

Networks/QWK Packet Networks/Network Hubs/QWK Network Hubs/Command Line

Change the callout command line to:

c:\zoc313\zoc.exe /Q /U /S:%!vertpoll.zrx

Be sure to change the command line to reflect the proper paths and filenames
for your system!

Set the time(s) and node number you wish to use while here in SCFG.

Make sure your Networked Sub-Boards are configured correctly. Refer to your
SYSOP.DOC that comes with Synchronet for more information on your QWK Network
Call-Out Configuration.

******************************************************************************
******************************************************************************

------------------------------------------------------------------------------
--- (4) ----------------------------------------------------------------------

****  Version 3.x Only  ******************************************************
******************************************************************************

Add ZOC.EXE to your OS/2 / Windows executable Programs List in SCFG under 
External Programs/OS2 Program List.

This will let Synchronet know ZOC.EXE is a Win32 Native App and will cause the
BBS to execute ZOC directly without DOS level execution.

**  Note: The OS2 Program List is also used for Win32 Apps in v3.

******************************************************************************
******************************************************************************

------------------------------------------------------------------------------
--- (5) ----------------------------------------------------------------------

Open ZOC and Turn Off Start Transfers Automatically.

To find this option, open ZOC and use the Top Menu Bar to go to :

Options / Settings / Transfer-2 / Start Transfer Automatically

Then go to :

Options / Settings / Transfer / Download to Alt Path

Remove the "QW?|" entry at the beggining of the string.

ZOC comes configured by default to download file ending in ".QW*" to the Alt 
download path so we need to disable this.

** Note : Be sure to SAVE the options before closing the Settings Window

*****  If you are experiencing trouble with ZOC not downloading the QWK files
       into the proper (SBBS\DATA) directory go to Options/Global/Directories
       and delete the Alternative Download path.  Synchronet will not import
       the QWK files unless they are placed in the SBBS\DATA directory!


------------------------------------------------------------------------------
--- (6) ----------------------------------------------------------------------

Once configured correctly this script should allow your QWK Networking to
operate without any intervention from the Sysop at all.  Every effort has been
made to assure it goes smoothly when unattended, but some problems may occur.

Please report any Bugs or problems to me ASAP.

E-Mail:
pg@wasteland.darktech.org

DoveNet :
Pistolgrip@WASTELND

------------------------------------------------------------------------------
--- (7) ----------------------------------------------------------------------

That should do it.  

The BBS should now poll automatically for you using the settings you
configured in SCFG Network Hubs.

If you wish to force a QWK Call you can Manually Force a QWK call by hitting
the (F) key from WFC (v2.x Only) or by using the ;CALL Sysop Command from the
Main Menu (v2.x or v3).

Send me email if you have any trouble.

pg@wasteland.darktech.org

------------------------------------------------------------------------------
------------------------------------------------------------------------------

------------------------------------------------------------------------------
---- NOTE --------------------------------------------------------------------
------------------------------------------------------------------------------
If you wish to have the script keep ZOC open or not hang up after polling you
need to comment out the lines at the bottom of the script like so.

Change :

CALL ZocHangup
CALL ZocEndZoc

To     :

/* CALL ZocHangup */
/* CALL ZocEndZoc */

This may be useful if you wish to run the script manually or debug it.
----------------------------------------------------------------------------

----------------------------------------------------------------------------
----------------------------------------------------------------------------
          WasteLand BBS   -  telnet://wasteland.darktech.org
               	 	     telnet://wasteland.detour.net

	        Website   -  http://wasteland.darktech.org

                 E-mail   -  pg@wasteland.darktech.org        
----------------------------------------------------------------------------
Synchronet BBS Software   -  telnet://vert.sync3.net
			     http://www.synchro.net/
----------------------------------------------------------------------------
	    ZOC Website   -  http://www.emtec.com/
----------------------------------------------------------------------------
/* END */
