home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 2 BBS
/
02-BBS.zip
/
upager11.zip
/
UltiPager.Doc
< prev
next >
Wrap
Text File
|
1995-07-11
|
31KB
|
693 lines
UltiPager
┌─────────────────────────────────────────────────────────┐
│▓▒░ ░▒▓│
│▓▒░ THE ULTIMATE SYSOP PAGER ░▒▓│
│▓▒░ For AdeptXBBS ░▒▓│
│▓▒░ ░▒▓│
└─────────────────────────────────────────────────────────┘
Documenation For
UltiPager V1.1
Copyright 1995 John F. Doran
All Rights Reserved Worldwide.
┌─────────────────────────────────────────────────────────┐
│▓▒░ Table Of Contents ░▒▓│
└─────────────────────────────────────────────────────────┘
WARRANTY 1
ACKNOWLEGEMENTS 1
SHAREWARE DISTRIBUTION 2
DISTRIBUTION FILE CONTENTS 2
-> ULTIPAGER 3
--> Description 3
---> Requirements 4
-> SUPPORT FILES 4
--> UltiPager.Erx 4
---> UltiPager.Cfg 4
----> UltiPager.Doc 4
-----> JPlay.Exe 4
------> AgstWind.Mid 4
-------> PageSysOp.Cmd 4
-> ASC / ANS / AVT Screens 5
--> NoSysOp.* 5
---> PagedTooSoon.* 5
----> SpecialUser.* 5
-----> SysOpIn.* 5
------> SysOpOut.* 5
-------> TooManyPages.* 5
--------> YesSysOp.* 5
-> ULTIPAGER INSTALLATION 6
--> Menu Installation 6
-> ULTIPAGER CONFIGURATION 7
--> SysOp Definable Time Windows 7
---> Sec1 Over-Ride Level 7
----> Sec2 Over-Ride Level 7
-----> Flag1 Over-Ride Level 7
------> Flag2 Over-Ride Level 7
-------> EMail Message Base 7
--------> SoundCard/PC Speaker 7
---------> Save And Exit 7
----------> Quit (No Save) 7
-> ULTIPAGER USER NOTES 8
--> The HOME Key 8
---> AnsiMated Prompts 8
---> AnsiMated Paging 8
-> APPENDICES 9
--> Contacting The Author 9
---> User Restrictions 10
----> Registration 11
-----> Registration Form 12
(Page 1)
┌─────────────────────────────────────────────────────────┐
│▓▒░ WARRANTY ░▒▓│
└─────────────────────────────────────────────────────────┘
UltiPager (The Ultimate SysOp Pager) has NO WARRANTY. Use Of
UltiPager and any accompanying programs/files is at YOUR OWN RISK. By
use of UltiPager, you agree to hold the author and parties directly or
indirectly related to the author faultless from the non-use, use, an/or
misuse of UltiPager.
UltiPager is provided 'AS-IS' and WITHOUT WARRANTY IMPLIED OR
OTHERWISE.
┌─────────────────────────────────────────────────────────┐
│▓▒░ ACKNOWLEDGEMENTS ░▒▓│
└─────────────────────────────────────────────────────────┘
References not otherwise documented.
AdeptXBBS Refers To AdeptXBBS Bulleetin Board System
for IBM 32-bit OS/2.
Copyright (c) 1993 - 1995 by AdeptSoft
Portions Copyright (c) 1991 - 1994 M.Kimes
Special Thanks To Julie Strietelmeier For Being An Alpha Test Site For
All My Ulti' Utilities As Well As An Official Distribution Site. Also,
It Was Julie Who Gave Me The Idea And Information To Get Me Started On
UltiPager. I Can't Begin To Thank Julie Enough For The Time And Effort
She's Single Handedly Devoted To AdeptXBBS Support, And To Ulti-Utils!
Thanks To Rick Towers As Well For His Support And For Pushing Me To Make
UltiPager What It Is Today. Also Thanks To Rick For Being Another
Official Distribution Site For Ulti' Utilties.
Thanks To Frank Jacoberger For Being The FIRST PERSON I KNOW To Run
One Of My Utilities (UltiCBV) And For Helping To Debug Some Of The
ShortComings Of My First Release!
And Of Course To Steven Towers And John Morris... WithOut AdeptXBBS
<A Very Fine BBS Package>, UltiPager Would Not Even Work <Smile!>
(Page 2)
┌─────────────────────────────────────────────────────────┐
│▓▒░ SHAREWARE DISTRIBUTION ░▒▓│
└─────────────────────────────────────────────────────────┘
Shareware is a unique method for the marketing of comptuer software.
Most of all the products are easily obtained from larger Bulletin Board
Systems worldwide. The basis behind the workings of the Shareware
system is the HONOR system. This means that the end user is free to
use the product for a limited trial period to see if it suits their
needs. If the user continues to use the product after this trial period
it is expected of them to register the product with its auther along
with any stated fees, this is to reimbuse the author for both the time
spent in developing the product and to provide incentive to maintain
and update the product.
You are free to test and use this program, UltiPager, to determin if it
suits your neds. If you continue to use this program beyond its thirty
(30) days trial period, complete the registration form (REGISITER.INFO)
and mail it along with the registration fee to the address listed on
the form. Upon the receipt of the completed registration form and fees
you will be kept advised of the status and availability of UltiPager,
granted use of the registered version, get timely support when needed,
and possible use of beta and specialized versions of UltiPager.
┌─────────────────────────────────────────────────────────┐
│▓▒░ DISTRIBUTION FILE CONTENTS ░▒▓│
└─────────────────────────────────────────────────────────┘
Naming Convention Of UltiPager Distribution Archives:
UPAGERMm.AAA
UPAGE = UltiPager
M = Major Version Number(ie: 1>
r = Revision/Minor Version Number <ie: .01>
AAA = Archiver Type <ie: ZIP>
UltiPager is distributed as a complete package compressed into one archive
file. The archive file of the UNREGISTERED version may be freely
distributed so long as no charge is required to obtain the pacackage and
no modifications to the distribution package is made beyond converting
the archiver format <ie: changing archive from ZIP to ARJ>
DISTRIBUTION OF REGISTERED, ALPHA, OR BETA VERSIONS IS PROHIBITED.
Included in the completed archive for UltiPager are the following files:
UltiPager.ERX - UltiPager In AdeptXBBS's Enhanced REXX Format.
Pager_Screens.Zip - Archive Containing All Of UltiPager's Screens.
File_ID.DIZ - Text Describing UltiPager Distribution Archive.
UlitPager.DOC - Documentation For UltiPager.
Register.Info - Registration Info And Form For UltiPager.
History.Text - Text Describing The Changes And History Of UltiPager.
Future.Text - Planned On Features For Future Releases Of UltiPager.
(Page 3)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - Description ░▒▓│
└─────────────────────────────────────────────────────────┘
UltiPager is an intelligent SysOp Paging utility for use with AdeptXBBS
Bulletin Board Systems. It is intended to provide an easy way for Adept
SysOps to allow users to 'Page' the SysOp for Chatting. UltiPager also
enhances the look and features of any AdeptXBBS System. UltiPager gives
the SysOp control over what users are able to page, when they are able
to page, how they are able to page, how often they are able to page,
and much much more. By providing for TWO seperate SysOp definable chat
windows per day, a SysOp can now configure their Paging set-ups far more
than they thought possible with AdeptXBBS.
UltiPager also allows for a SysOp to define 'Security Over-Ride' switches
to allow special users and CoSysOps with the added ability to over-ride
the pre-defined SysOp Chatting times incase of a valid emergency. These
'Security Over-Ride' switches can be based on a users 'Sec1' level,
'Sec2' level, 'Flag1' configuration or 'Flag2' configuration. Any and
all switches are valid!
UltiPager comes with its own, powerful yet user friendly configuration
program BUILT RIGHT IN! This allows for a SysOp to configure his or
her hours when they will be available to 'Chat' with their users. This
also allows them to configure their sound card or internal PC Speakers
for use with UltiPager as well as set up with Message Base they want
E-Mail posted from users from within UltiPager.
UltiPager can also track how many times the user has attempted to page
the SysOp and compare that to what the SysOp has configured in their
Adept set up <Max Pages>... and if the user exceeds the amount of pages
for that call, they are politely informed of this fact. Further,
UltiPager tracks the last time the user paged... This way, if a User
attempts to page the SysOp again within 5 minutes of their last page
attempt, UltiPager will politely inform them of this, and request that
they wait at least Five Minutes between paging attempts!
UltiPager uses external screens for MOST of its screen writes. This offers
SysOps a great deal of flexibility in adding UltiPager to their own specific
AdeptXBBS Setup. Screens can be modified at the SysOps will.
As with all other 'Ulti' utilities and add-ons written specifically for
AdeptXBBS, UltiPager was designed to 'Blend In Seamlessly' with your own
set-up. There are no "Written By" screens or nag screens shown to the
remote user. From their vantage point, UltiPager is just a really NICE
built in feature of your fine system. All 'Ulti' utilities will always
be written and designed with this goal! Its part of our dedication to
fine Shareware, and to a great BBS package like AdeptXBBS.
(Page 4)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - Requirements ░▒▓│
└─────────────────────────────────────────────────────────┘
Hardware: Basically, you can run UltiPager on any machine and any modem
that you can run AdeptXBBS (For OS/2) on.
Software: UltiPager requires that you have OS/2 V2.1 or higher installed
and running as your systems operating system. Further, UltiPager requires
that you installed OS/2's REXX modules <installed during installation
procedures or during Selective Install>. Also, UltiPager requires the
existance of RexxUtil - the extended/enhanced features provided with
OS/2's basic REXX modules.
UltiPager needs to be run from a SubDirecty within your Adept main directory
called "UltiPager". (ie: C:\Adept\UltiPager). All of UltiPager's screens
should be placed in your Adept\TEXT Directory.
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - Support Files ░▒▓│
└─────────────────────────────────────────────────────────┘
UltiPager.Erx: This is the Pager itself in AdeptXBBS's Enhanced Rexx
format. UltiPager.Erx also contains its own configuration module built
right in for easy configuration and modification of your UltiPager set-up.
This will also allow you to configure UltiPager from Remote (If Registered).
UltiPager.Cfg: This is the data configuration file used by UltiPager.
Inside this file is stored all your configuration options, settings and
switches to control UltiPagers various functions.
(This file should only be modified by UltiPager.Erx!)
UltiPager.Doc: What you are reading right now! In here you will find
description of UltiPager, its files, screens, and functions.
JPlay.Exe: This Is An OS/2 Utility That Plays MID And WAV Format Files.
Author Is UnKnown... JPlay is not required to run UltiPager, However
UltiPager does take advantage of JPlay's ability to play MIDI files.
As Far As I Know, JPlay Was Released Into The Public Domain And Is NOT
Included In The Registration Of UltiPager. It Is Simply Provided For
Extra SysOp Convenience. If You Have Your Own Command Line MID/WAV File
Player You Wish To Use With UltiPager, Then Edit PageSysOp.CMD <Below>
To Use The One You Wish.
PageSysOp.Cmd: A Simple Batch File Called By UltiPager When The SysOp
Has SoundCard Paging Enabled. You Can Easily Edit PageSysOp.Cmd To
Play Any WAV Or MID You Want For When Users Request A Chat. Just Be
Sure To Follow The Format Of PageSysOp.Cmd Exactly As It Set-Up From
The UltiPager Distribution Archive Or Else PageSysOp.Cmd Might Not Work.
AgstWind.Mid: A Great Tune <Bob Seager I Believe!> Against The Wind In
MIDI Format. AgstWind.Mid Is A Public Domain MID File And Is NOT Included
In The REgistration of UltiPager. It Is Simply Provided For Extra SysOp
Convenience And Enjoyment. If You Wish To Use Any Other MID File, Then
Edit PageSysOp.Cmd <Above> To Change UltiPager To Play Your New MID Or WAV.
(Page 5)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - ANS/ASC/AVT Files ░▒▓│
└─────────────────────────────────────────────────────────┘
UltiPager was written with the SysOp in mind. I wanted to allow a great
deal of flexibility in the configuration of UltiPager so a SysOp can
almost totally customize UltiPager to reflect their own personal tastes
and the theme/look of their systems. That is why most of UltiPager's
screens are external. This way a SysOp can modify these screens in any way
they see fit to better match them with their own system.
Below is a list of all the ANSI, ASCII and AVATAR screens distributed with
UltiPager and their uses.
NoSysOp -> This is shown to a user who has paged the SysOp, but the SysOp
did not respond. (This screen will prompt the user to send
Private E-Mail to the SysOp)
PagedTooSoon -> This is shown to a user who has paged the SysOp within 5
mintues of their last page attempt. The screen will
politely ask them to wait at least 5 Minutes between page
attempts.
SpecialUser -> Shown to users who's Security Level And/Or Security Flag
matches the SysOp defined 'Security Over-Ride' flags. The
user is told that the page attempt is outside of the SysOps
predefined Chatting hours, but that they have the ability
to over-ride this is it's a valid reason.
SysOpIn -> Shown to a user who attempts to Page the SysOp, and the page
attempt is within the predefined SysOp chatting hours.
SysOpOut -> Shown to a user who attempts to Page the SysOp, and the page
attempt is NOT within the predefined SysOp chatting hours.
TooManyPages -> Shown to a user who has exceeding their alloted 'Page
Attempts'.
YesSysOp -> Shown to a user when they are paging the SysOp, and the SysOp
agrees to chat with them <By Hitting Thier "HOME" Key>
(Page 6)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - INSTALLATION ░▒▓│
└─────────────────────────────────────────────────────────┘
To Install UltiPager, make a subdirectory from your Adept main directory
called 'UltiPager' (ie: C:\Adept\UltiPager) In this directory, unzip
the UltiPager distribution archive. Move all the *.Ans *.Asc and *.Avt
screens into your Adept\Text directory. Then you need to manually edit
your Main.Menu <and any other menu which you wish to have UltiPager called
from> and add the following line (or similar based on your menu setup):
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
C, 0, [C]hat With The SysOp! ,C:\Adept\UltiPager\UltiPager.Erx,0,0,100,10,10
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Of course you will need to put in YOUR Drive:\Path to your Adept directory
above... as well as 'map' the key anyway you want <ie: P for Page, C for
Chat, Y for Yell, whatever!>
Edit The PAGESYSOP.CMD To Make Sure You Have The Correct Drive\Path
Configured For JPLAY.EXE To Play The MIDI File Of Your Choice. If This
Path Is NOT Set Right... Then The SysOp Will Never Hear The Page!!!!
Log on locally and test out UltiPager. The first time you run UltiPager,
it will inform you that no configuration file exists and UltiPager will
load with its defaults, and then send you directly into the Configuration
module which is built in! Once you've configured UltiPager to suit your
specific needs, [S]ave and exit UltiPager... and you'll then be able to
test out what UltiPager can do for you!
(Page 7)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - Configuration ░▒▓│
└─────────────────────────────────────────────────────────┘
As stated earlier, UltiPager's configuration module is built right in.
This makes for easy modification and configuration of all of UltiPagers
various settings.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
[1] Time Windows:
UltiPager allows you to set up and define up to Two SysOp Chatting
Time Windows Per Day. This means you have to windows for Mondays,
Two windows for Tuesday, etc.... This design affords a GREAT
deal of configurability. For instance, if you ran a commercial
Tech Support System, but wanted to configure your Chatting Hours
so that you were not available during lunch breaks, you could do
the following:
Monday: Window1 - On: 09:00:00
Off: 12:30:00
Window2 - On: 13:30:00
Off: 17:00:00
This will cause UltiPager to enable SysOp paging from 9:00am till
12:30noon.... and then again from 1:30pm too 5:00pm.
If you're a nightbird <like me>.. then you can configure it to read:
Monday: Window1 - On: 00:00:00
Off: 01:30:00
Window2 - On: 12:30:00
Off: 23:59:59
(Note: Setting windows up this way allows you to 'wrap' around
midnight)
From the Configuration Menu, Options A - N define your SysOp
Chatting Time Windows.
[1] Sec1 OverRide: This setting allows you to configure which
Security Level a user must match to be considered a 'Special
User'. (Based On The Users Sec1 Setting)
[2] Sec2 OverRide: This setting allows you to configure which
Security Level a user must match to be considered a 'Special
User'. (Based On The Users Sec2 Setting)
[3] Flag1 OverRide: This setting allows you to configure which
User Flag a user must have 'checked' to be considered a
'Special User'( Based On The Users Flags1 Attributes)
[4] Flag2 OverRide: This setting allows you to configure which
User Flag a user must have 'checked' to be considered a
'Special User'( Based On The Users Flags2 Attributes)
[5] E-Mail Message Base. This is the number of your AdeptXBBS
Message Base used for Private Mail.
[6] Use SoundCard Or Speakers. If you have a sound card installed
and are using MMOS/2, then UltiPager use your Soundcard to notify
you when a User pages you. UltiPager will spawn a seperate OS/2
window and play a MIDI File to alert you of the users page. If
you wish to use your PC's internal speakers, then you will
receive a series of beeps to alert you of a users page.
[S] Save Configuration And Exit - Writes your configuration to the
hard disk and exits UltiPagers Configuration module.
[Q] Quit Configuration (No Save). Does NOT write your configuration to
hard disk and exits UltiPagers Configuration module.
(Page 8)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - Notes ░▒▓│
└─────────────────────────────────────────────────────────┘
[HOME]
When a user is 'Paging The SysOp' you can hit your HOME key.
This will send the user a nice note saying that you've accepted
their request to chat, and exits them cleanly from UltiPager.
(Screen Shown: YesSysOp.Ans/Asc/Avt)
[AnsiMation Prompts]
UltiPager uses special routines to handle strings and prompts
for ANSI and AVATAR users. The effect is a 'motion' prompt which
cycles color from Dark Grey to Light Grey To White, then back down
the spectrum, and from left to right. This give a really nice
flowing motion to a static screen and also adds a nice touch of
professionalism to any AdeptXBBS BBS System.
[AnsiMated Paging]
UltiPager is ANYTHING but boring! Users will love the Ansimated
action during SysOp paging. SysOps will love it too!
(Page 9)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - APPENDICES ░▒▓│
└─────────────────────────────────────────────────────────┘
CONTACTING THE AUTHOR:
You can contact me with questions, problems, suggestions or questions in
a variety of ways:
Via US Mail to:
John F. Doran
209 East 56th Street
Suite 11Q
New York, NY 10022
Via BBS:
The NightStalker BBS
(212) 486-6281
Via AdeptSoft Support Echo.
REGISTRATION froms must be sent via U.S. Mail.
USER RESTRICTIONS:
You Are Granted Permission To Test Out And Review The Ultimate SysOp Pager
<Also Known As UltiPager> For A Period Of No More Than 30 Days. During
This 30 Day Test Period, *ALL* Features Of UltiOager Will Be Available
And In Use. Nothing Will Be Crippled!
Use Of This Program Beyond The 30 Day Evaluation Period Is Illegal And
Unethical! If You Continue To Use This Program For Longer Than The Alloted
30 Day Evaluation Period Without Registering It, Certain Features Will
Become Disabled. Below Is A List Of The Features Which Will Become Affected
By Non-Registration After 30 Days....
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
(Page 10)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - APPENDICES <cont> ░▒▓│
└─────────────────────────────────────────────────────────┘
**************
ULTIPAGER.ERX
**************
SysOp Logging: UltiPager Will No Longer Write Users Chat Attempts And
Other Logged Information To The SysOp Log or SysOp ListBox.
Security Over-Ride settings will no longer be checked. All users will be
considered 'Normal Users'
UltiPager will only recognize SysOp Chat Time Windows '1'. Window '2' Will
Be Ignored.
UltiPager will only use the Internal PC Speakers for Paging attempts.
Remote Configuration of UltiPager will be impossible!
*NONE* Of This Affects The User. All Basic Functions Of UltiPager Will Still
Be Available To Them. They Will *NOT* Recieve Nag Screens, Unregistered
Comments... All That Nasty Crap! Only The SysOp Will Know That UltiPager Is
Still UnRegistered!
**HOWEVER**
If You Continue To Use UltiPager Well Past The 30 Day Trial Period <60 Days
To Be Exact), UltiPager Will Totally And Completely Refuse To Work! ALL
Features Of UltiPager Will Become Automatically Disabled Until It Becomes
Registered!
(Page 11)
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - REGISTRATION ░▒▓│
└─────────────────────────────────────────────────────────┘
To Register This Program, Fill Out The Below Form And Mail It To The
Address Shown Along With A Check For The Price Shown Below.
UltiPager List Prices As Of 06/06/95..
Version 1.1:....................................................$ 15.00 (US)
All Upgrades Will Be Available For Downloading Through The NightStalker BBS
At (212) 486-6281... Or Via One Of My Support Sites.
To Register:
Send A Check Or Money Order <No Cash> Made Payble To:
John F. Doran
And Mail To:
John F. Doran
209 East 56th Street
Suite 11Q
New York, NY 10022
(Sorry, But I Don't Handle Credit Cards At This Point In Time. If
There Is Enough Call For My Utilities, Then I'll Set Myself Up To
Recieve Faxed Registration And Credit Cards).
┌─────────────────────────────────────────────────────────┐
│▓▒░ UltiPager - REGISTRATION FORM ░▒▓│
└─────────────────────────────────────────────────────────┘
REGISRATION FORM FOR 'THE ULTIMATE SYSOP PAGER' v1.1
Company Name: _____________________________________________________________
<If Applicable>
SysOp Name:________________________________________________________________
<This Should Match Exactly With The Name Configured In Adept For SysOp>
Address:___________________________________________________________________
City:_________________________ State:__________________ Zip:______________
BBS Name:___________________________________________________________________
<This Should Match Exactly With The Name Configured In Adept For BBS Name>
Voice Number:______________________ BBS Number:__________________________
FidoNet:__________________________ (If Available)
Mr. John Doran,
I am hereby registering UltiPager Version 1.1. Enclosed with this form is
a check or money order in the amount of $______________ (in US Funds) for
the ________ Node Version Of UltiPager. This shows my support for both the
Shareware concept and to encourage further development of UltiPager and/or
other 'Ulti' Utilities written by you for AdeptXBBS.
I further agree not to distribute registered copies of UltiPager, or its
registration key(s) without your expiressed written consent. I further
agree that if I DO distribute registered versions of UltiPager or its
registration key(s) without your prior written consent that I can and will
be held liable for all copy(s) of the program(s) released.
I understand that UltiPager is provided 'As-Is' with no warranties implied or
otherwise, and that I use UltiPager at my own risk.
Should I have any comments or suggestions, I understand that I may contact
you via US Mail at the address listed above, or through your BBS System
as listed above.
Signed:_________________________________________ Date:____________________
( ) Please add me to your user list on The NightStalker BBS and provide
me with access to the special directory set up for Registered
UltiPager Users, and your other 'Ultimate' line of Utilities for
AdeptXBBS.