home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR10
/
CALLRT16.ZIP
/
CR16.DOC
< prev
next >
Wrap
Text File
|
1993-11-21
|
29KB
|
843 lines
╓───┐╓────┐╓─┐ ╓─┐ ╓────┐╓────┐╓─┐╓─┐╓─────┐╓────┐╓────┐
░║ ╒═╛║ ╒╗ │║ │░░║ │░░░░║ ╒╗ │║ ╒╗ │║ │║ │╚═╗ ╒═╛║ ╒══╛║ ╒╗ │░
░║ │░ ║ └╜ │║ │░░║ │░░░░║ └╜╒╛║ │║ │║ │║ │░░║ │░░║ ╒═░░║ └╜╒╛░
░║ └─┐║ ╒╗ │║ └─┐║ └─┐░░║╒╗ │░║ └╜ │║ └╜ │░░║ │░░║ └──┐║╒╗ │░░
╚═══╛╚═╛╚═╛╚═══╛╚═══╛ ╚╛╚═╛ ╚════╛╚════╛ ╚═╛ ╚════╛╚╛╚═╛
Communications Utility for DOS
Copyright 1992-1993 RBK Software
All Rights Reserved
* Unregistered Shareware Copy *
For support or the latest version call the
RBK Support BBS at (516) 859-1078
Version 1.6 Users Guide
Contents
License and Copyright Information - page 1
Limited Warranty Information - page 1
System Requirements - page 2
Program Overview - page 2
New Features - page 2
Starting Call Router - page 3
Errorlevel Table - page 6
Call Router Ring Sampler Program - page 7
Creating the Startup Batch File - page 10
RBK Utilities - page 14
DSPDAT16 - page 14
DTSTAMP - page 14
WARMBOOT - page 15
RFDIR - page 15
LAPSE - page 15
DOCURS - page 16
Getting help - page 17
Call Router v1.6 License & Copyright Information
Call Router Copyright 1992-93 RBK Software.
All Rights Reserved.
Call Router is user supported software. If you use this
program beyond a two-week trial period, we ask you to
register your copy.
Benefits of registering Call Router:
1) You help fund the future development of this software.
2) You receive full program support.
3) You receive the next version through U.S. mail with
several utilities to use with Call Router.
Limited Warranty
RBK Software specifically disclaims any and all warranties,
expressed or implied, including fitness for a particular
purpose. Use this product at your own risk.
Distribution
This program may be copied and distributed to others to use
on a trial basis so long as all files in the original archive
are intact and unaltered.
----------
MS-DOS is a trademark of Microsoft Corporation.
Hayes is a trademark of Hayes Microcomputer Products, Inc.
Wildcat! copyright Mustang Software, Inc.
1
Call Router System Requirements
* IBM PC or compatible running MS-DOS 3.1 or higher.
* RS-232 Cable with pin 22 connected. (Ring Indicator)
* Voice grade telephone connection.
* Hayes compatible modem.
Call Router Overview
Call Router is a communications utility which initiates batch
action based on incoming phone rings. Call Router will wait
for a call, set the DOS errorlevel and then exit.
Based on the errorlevel set by Call Router, incoming calls
can be routed to a BBS or perform certain actions according
to how many rings there were, the cadences of the rings, or a
combination of both the ring counts and the cadences detected.
If distinctive ringing service is available on a phone line,
Call Router can detect which number was dialed and set the
errorlevel according to a specific ring cadence.
Distinctive ringing service may also be called Custom Ringing,
Identi-Call, Identi-Ring, MultiRing, Personal Ring, Ring Mate,
Smart Ring, Star Ring or similiar names in different areas.
New features in Call Router v1.6
* Call Router may now be set to answer and establish a data
connection. Once a connection is established, the
errorlevel can be tested to determine the baud rate.
* The Call Router Ring Sample program included in the
distribution archive may be used to create up to three ring
data definition files. Each definition can be used to
represent a different distinctive ring phone number to
allow better customization. This feature now enables Call
Router to recognize three different ring patterns and
process each number uniquely.
* Call Router can now make a full distinctive ring type
determination at the completion of just one ring.
2
Starting Call Router
Calling Syntax...
Call Router should be called from within a batch file (see
section on creating batch file) to monitor incoming calls on
a continual basis and so the errorlevel can be tested upon
exit.
CALLROUT n [speed s] [rings r] [answer] [rm]
[userdata] [ssoff] [dtron] [pf]
Arguments enlosed in [] are optional and may be in any order.
You may type: CALLROUT<Enter>, without arguments, to display
the program usage from the DOS prompt.
Description of arguments...
The first argument must always be the number of the COM port
Call Router should open.
n - where argument n is COM port 1,2,3, or 4.
This argument must always be the first.
speed s - Use this argument when the COM port needs to be
opened at a specific baud rate. Call Router will
default to 2400 baud when argument is not used.
rings r - Determines number of rings Call Router should count
before setting errorlevel and exiting. Call Router
will default to 2 rings when argument is not used.
Ignored with 'userdata' argument.
answer - Send answer command to modem.
Call Router will wait for carrier detect. When a
connection has been established, the program will
send a title screen to the caller including a
"Loading program..." message.
Call Router then exits and sets the errorlevel
based on the baud rate detected. From this point
the batch file should be set up to call a host or
BBS program. Ignored with 'userdata' argument.
3
Starting Call Router (cont.)
rm - Sets ringmate detection on.
In previous versions, Call Router had been primarily
designed to work with the distinct ring service
offered by New York Telephone known as Ring Mate.
Their distinct rings are shorter in duration than
standard rings. When this argument is found, Call
Router will exit and set errorlevel to 4 if Ring Mate
type rings are detected and 3 if standard rings are
detected. This argument has been retained to keep
version 1.6 compatible with older versions.
Ignored with 'userdata' argument.
userdata - Use of this argument will instruct Call Router to
search for data files created by the CRSAMPLE
program. The CRSAMPLE program allows you to create
up to 3 ring cadence definitions. Each data file
contains the following information:
1) Phone number
2) Should call router answer?
3) Exit on which ring?
4) Ring data
5) Rest data
As Call Router detects a call, it will procede as
specified in the data file for the specific call
pattern detected.
* The rings, answer, and rm, arguments are ignored
when the userdata argument is used.
dtron - Set DTR to ON upon exit.
Unless Call Router has answered and is exiting so
another program can take control of the call, DTR is
set OFF or LOW. When Call Router is not set to
answer, use this argument to leave DTR on when Call
Router exits.
4
Starting Call Router (cont.)
ssoff - Disables screen-saver.
To prevent screen burn-in, Call Router will
automatically blank the screen while waiting for a
call if there is no call or keyboard activity for
sixty seconds. Use this argument only if you wish to
disable this feature.
pf - Print form.
When this argument is detected, a prompt asking if
a registration form should be printed appears.
After the form is printed or the request to print
is aborted, Call Router continues as normal.
5
Errorlevel Table
Refer to this table when setting up your batch file to test
the errorlevel condition Call Router sets upon exit. Please
notice that the possible errorlevel condition is largely
based on the arguments used start to Call Router.
The symbols 'w/RM' and 'w/USERDATA' indicate the possible
outcome when used with the RM or with the USERDATA arguments.
Errorlevel Condition
---------- ---------
0 Normal termination. ESC key pressed.
1 Fatal Error. Incorrect usage or errors upon
initialization.
2 Timeout. Time period between rings or wait for
carrier took too long.
3 Standard ring detected.
w/RM: Standard ring detected
w/USERDATA: match definition file 1, no answer.
4 w/RM: Ring Mate ring detected.
w/USERDATA: match definition file 2, no answer.
5 w/USERDATA: match definition file 3, no answer.
10 w/USERDATA: match definition file 1, 300 BPS.
11 w/USERDATA: match definition file 1, 1200 BPS.
12 w/USERDATA: match definition file 1, 2400 BPS.
13 w/USERDATA: match definition file 1, 4800 BPS.
14 w/USERDATA: match definition file 1, 9600 BPS.
15 w/USERDATA: match definition file 1, 12000 BPS.
16 w/USERDATA: match definition file 1, 14400 BPS.
20 w/USERDATA: match definition file 2, 300 BPS.
21 w/USERDATA: match definition file 2, 1200 BPS.
22 w/USERDATA: match definition file 2, 2400 BPS.
23 w/USERDATA: match definition file 2, 4800 BPS.
24 w/USERDATA: match definition file 2, 9600 BPS.
25 w/USERDATA: match definition file 2, 12000 BPS.
26 w/USERDATA: match definition file 2, 14400 BPS.
30 w/USERDATA: match definition file 3, 300 BPS.
31 w/USERDATA: match definition file 3, 1200 BPS.
32 w/USERDATA: match definition file 3, 2400 BPS.
33 w/USERDATA: match definition file 3, 4800 BPS.
34 w/USERDATA: match definition file 3, 9600 BPS.
35 w/USERDATA: match definition file 3, 12000 BPS.
36 w/USERDATA: match definition file 3, 14400 BPS.
6
Call Router Ring Sample Program version 1.0 beta
Version 1.6 has the ability to search for pre-defined ring
definition data files when the 'userdata' argument is used.
To create these data files, a supplementary program named
CRSAMPLE.EXE has been included in this archive. Up to three
data files may be created, each representing a different
phone number a caller may dial. A minimum of two must be
found to use the 'userdata' option.
This new feature allows you to specify whether or not Call
Router should answer a call or not and how many rings it
should wait before answering that particular number.
To define the ring pattern for each phone number you wish to
use, a sample ring and rest period are measured. This
requires that each number be dialed remotely.
Using the CRSAMPLE program...
From the DOS prompt type: "CRSAMPLE n" followed by enter.
where n is the COM port you wish to use -> 1, 2, 3, or 4.
If you have provided a valid COM port for the program to use,
it will continue by presenting the introductory screen. After
you have read the information presented, press a key to
continue.
At this point, the CRSAMPLE program will perform a search for
three files: CR16_1.DAT, CR16_2.DAT, and CR16_3.DAT. The
program will display the search results and provide four
options for you to take. By choosing options 1, 2, or 3 you
may create or modify the data files. Choosing option 4 quits
the program. This is the main screen where the program
returns after a ring definition is created and sampled.
To create a new definition file or to replace an existing
file, choose 1-3 based on which file you would to create or
modify. Use 1 for CR16_1.DAT, 2 for CR16_2.DAT, and 3 for
CR16_3.DAT. For Call Router to operate correctly with the
userdata option, it is important to remember that there may
be only ONE definition file per phone number. It does not
matter which file you assign a phone number to.
7
Call Router Ring Sample Program version 1.0 beta (cont.)
The ring definition files must be created in order. To create
CR16_3.DAT, CR16_1.DAT and CR16_2.DAT must be created first.
Likewise, CR16_1.DAT must be created prior to creating
CR16_2.DAT.
This is a fairly simple procedure and is explained in detail below.
"Continuing will delete previous data in file , O.K. (Y/N)?"
When you choose to modify an existing data file you will be
warned that all previous data written to this file will be
deleted. Enter a 'Y' if you wish to continue or a 'N' to
abort. If no data file had been found, this question is
skipped.
You will be asked to enter the phone number of the rings to
be be sampled.
"Enter phone number for file # -> "
This may be any group of characters up to 24 you wish to use
to identify a particular number.
"Do you want Call Router to answer and establish a data
connection when 555-5555 is detected? (y/n) "
Answer 'y' if you want Call Router to answer, 'n' if not.
"Wait/Answer on ring number (1-99)? "
Enter the number of rings you wish Call Router to count
before processing a call detected on this phone number.
"Press a key to start sample procedure..."
You are now ready to capture a ring sample for this number.
If you have not yet pressed a key to advance do so now, you
should have the message:
"Waiting for call..."
8
Call Router Ring Sample Program version 1.0 beta
At this point the number being defined may be dialed from a
remote location and allowed to ring at least two times. You
may also press ESC to abort at this time if you wish. When
the ring data is measured you will see,
"Ring data sucessfully captured"
or if the procedure was incomplete,
"The sampling procedure was incomplete"
Pressing a key will return you to the main menu where the
screen will be updated with the new file information. If
there was an existing file you attempted to modify and the
ring sample procedure was incomplete, you will see that the
file was now gone. Otherwise, you will see a newly created
file or the same screen if the file had existed before.
Repeat the procedure for up to three phone numbers. If you
are sampling two numbers, you should only have two
data files. To delete a ring definition you may enter the
proper number to modify and simply hit ESC at the sample
procedure which will make the procedure incomplete and delete
the file. You may also use the ERASE or DELETE command at the
DOS prompt to delete a ring definition.
Registered Users Note...
If you wish to view the contents of the Call Router v1.6 data
files, there is also a display program DSPDAT16.EXE included
with this archive. By typing "DSPDAT16" followed by enter at
the DOS prompt, you may view the contents of the data files
created by the CRSAMple program.
9
Creating the Startup Batch File
As in earlier versions, you need to create a startup batch
file. This batch file starts Call Router and tests the
errorlevel upon exit. It also calls the proper application
program and can be set up to allow Call Router to monitor
calls on a continual basis.
There are two batch files (.BAT extension) included with
Call Router. They are example files to show how Call Router
may be used. Please feel free to modify these files to suit
your own particular application.
As an example, we can look at MULTI.BAT (included with Call
Router distribution files) line by line. This setup shows how
a single phone line with distinctive ring service, with two
additional numbers added, may be used to run a two BBS systems.
In this example, assume the following numbers are used:
555-1111 Main number we use for voice.
555-2222 Distinctive ring phone #1.
This is the number we give out for the Wildcat BBS.
555-3333 Distinctive ring phone #2.
This is the number to be called for some other
application.
Run CRSAMPLE to obtain data for each number...
1. Sampled main number to be used for voice.
Answer = 'N'
Set ring count to 99 so Call Router continues to
count rings until someone answers or callers hangs up.
2. Sampled first additional distinctive ring for WILDCAT BBS.
Answer = 'Y'
Set ring count to 1.
3. Sampled second additional distinctive ring for MY APP.
Answer = 'Y'
Set ring count to 1.
4. Create BBS.BAT...
10
Creating the Startup Batch File (cont.)
The batch file "MULTI.BAT" included with the Call Router
archive is similiar to batch file shown below and may be
copied and edited.
Please note that the text to the right of the '<' are
comments and would normally be omitted.
--------------------------------------------------------
@echo off <-- This line turns off echoing commands to display
:START <----------- START Label
CALLROUT 1 USERDATA <- Start Call Router using COM 1, use
< data files created by CRSAMPLE program.
if errorlevel 36 goto MYAPP14400 < These lines
if errorlevel 35 goto MYAPP12000 < test to see if
if errorlevel 34 goto MYAPP9600 < phone #3 was answered.
if errorlevel 33 goto MYAPP4800 < If so,
if errorlevel 32 goto MYAPP2400 < the appropriate
if errorlevel 31 goto MYAPP1200 < command is called to
if errorlevel 30 goto MYAPP300 < start 'MY APPLICATION'.
if errorlevel 26 goto WC14400 < These lines
if errorlevel 25 goto WC12000 < test to see if
if errorlevel 24 goto WC9600 < phone #2 was answered.
if errorlevel 23 goto WC4800 < If so,
if errorlevel 22 goto WC2400 < the appropriate
if errorlevel 21 goto WC1200 < command is called to
if errorlevel 20 goto WC300 < start the WILDCAT BBS.
< * Note: testing for errorlevels 5 and 4 would be if inserted
< here if answer was set to NO in definitions 2 and/or 3.
if errorlevel 3 goto START <-- Standard call reached 99 rings.
< Highly unlikely, buts prevents
< false indications if batch
< loops around before caller
< hangs up.
< continued...>
11
Creating the Startup Batch File (cont.)
if errorlevel 2 goto START <-- Timeout condition. Occurs when
< caller hangs up before ring
< count was reached or able to
< detect carrier during answer.
if errorlevel 1 goto FATAL <-- A fatal error!
if errorlevel 0 goto END <-- The ESC key was pressed.
:MYAPP14400 < MYAPP is called with the
CALL MYAPP /B 14400 < appropriate baud rate.
if errorlevel 1 goto END < Assume MYAPP exits at
goto START < errorlevel 1 on error.
:MYAPP12000
CALL MYAPP /B 12200
if errorlevel 1 goto END
goto START
:MYAPP9600
CALL MYAPP /B 9600
if errorlevel 10 goto END
goto START
:MYAPP4800
CALL MYAPP /B 4800
if errorlevel 10 goto END
goto START
:MYAPP2400
CALL MYAPP /B 2400
if errorlevel 10 goto END
goto START
:MYAPP1200
CALL MYAPP /B 1200
if errorlevel 10 goto END
goto START
:MYAPP300
CALL MYAPP /B 300
if errorlevel 10 goto END
goto START
< continued... >
12
Creating the Startup Batch File (cont.)
:BBS14400 < Wildcat is called with the
CALL WILDCAT /B 14400 < appropriate baud rate.
if errorlevel 60 goto START < Wildcat exits at
goto END < errorlevel 60.
:BBS12000
CALL WILDCAT /B 12200
if errorlevel 60 goto START
goto END
:BBS9600
CALL WILDCAT /B 9600
if errorlevel 60 goto START
goto END
:BBS4800
CALL WILDCAT /B 4800
if errorlevel 60 goto START
goto END
:BBS2400
CALL WILDCAT /B 2400
if errorlevel 60 goto START
goto END
:BBS1200
CALL WILDCAT /B 1200
if errorlevel 60 goto START
goto END
:BBS300
CALL WILDCAT /B 300
if errorlevel 60 goto START
goto END
:FATAL <--- Display message and end on fatal error.
@echo.
@echo Call Router ended with a fatal error.
@echo.
goto END
:END <--- Nothing to do, end of batch.
---------------------------------------------------------
13
RBK Utilities
If you are a registered user, you received the Call Router
archive with several utilities. Below is a description of
these utilities and how they may used with Call Router.
Data File Displayer for Call Router v1.0 beta
Usage: DSPDAT16
This Call Router specific utility displays the contents of
data files created by the CRSAMPLE program.
Date/Time Stamp v1.1
Usage: DTSTAMP
Date/Time Stamp provides a one-line reading of the date and
time. Unlike the DOS date and time commands, no prompts
follow, allowing uninterrupted use from within a batch file.
DTSTAMP may be used for continuous log entries from within a
batch file.
i.e. The following line shows an example of how DTSTAMP may
be inserted into an autoexec.bat file to keep a running log
of reboots on your system.
dtstamp >> boots.log
This would append "Date 10/1/1993 Time 11:24:00" to the end
of the file boots.log. This may be used similiarly in the
batch file used to start Call Router to record when an
incoming call is detected.
14
RBK Utilities (cont.)
Warm Boot v1.1
Usage: WARMBOOT
Performs a DOS reload without the preliminary hardware reset
and testing. Basically the same as pressing the
<Ctrl+Alt+Delete> keys. This may be placed within a batch
file to reboot when a certain condition is met. For example,
after 10 rings are detected.
Run File Directory v1.1
Usage: RFDIR [path]
where path is any valid DOS filepath.
Use RFDIR to list only executable files in a specific
directory. Only files with the extensions: .COM, .EXE, and
.BAT are included in the listing. This program is
particularly useful when there are a large number of files in
a directory and the executable files need to be sorted out
quickly.
Lapse v1.2
Usage: Lapse [seconds]
where seconds is the number of seconds you wish to
lapse.
Use LAPSE when you want to suspend activity batch file
activity for a given amount of time in seconds. Typing LAPSE
without specifying seconds will default to five seconds. If
LAPSE is allowed to countdown it will exit errorlevel 0. If
<Ctrl+Break> or <Ctrl+C> is detected, LAPSE will exit setting
the errorlevel to 1.
15
RBK Utilities (cont.)
Do Cursor v1.0
Usage: DOCURS
This simple utility resets your cursor size and position to
normal when a program 'forgets' to restore it. You will not
need to use this with Call Router, but it comes in handy when
you need your cursor and don't want to reboot when a program
fails to 'cleanup'.
16
Support
Any questions, suggestions, or comments may be addressed
to any or all of the following locations:
RBK support BBS - 24hrs.
(516) 859-1078 (300/1200/2400-8/N/1)
Compuserve [70714,3020]
U.S. Mail:
RBK Software
Robert Mulligan
280-13 Belmore Avenue
East Islip, NY 11730
17