@database "CARDS.Guide"
@Node Main " CARDS V2.5 Caling Card managing tool Contents "
@next copyright


               *****    *****   ******    ******     ***** TM
              *** ***  *** ***  *******   *******   *******
              ***      **   **  **  ***   **   ***  **
              ***      *******  ******    **    **   *****
              ***      *******  **  **    **   ***      ***
              *** ***  **   **  **  ***   *******   *** ***
               *****   **   **  **   ***  ******     *****



             WELCOME TO THE LITTLE /X-TOOL »» CARDS V2.5 ««
             -----------------------------------------------

        
                       @{" Copyright            " link copyright}
                       @{" Introduction         " link intro}
                       @{" Check for Backdoors  " link checkback}
                       @{" Installation         " link install}
                       @{" Setup CARDS service  " link setup}
                       @{" The main functions   " link main}
                       @{" The private mode     " link private}
                       @{" The public mode      " link public}
                       @{" The fast-import-mode " link import}
                       @{" The logfile          " link logfile}
                       @{" The statistics       " link stats}
                       @{" History              " link history}
                       @{" Final Greetings      " link greetings}


@endnode
@node copyright " CopyRight "
@next intro




               *****    *****   ******    ******     ***** TM
              *** ***  *** ***  *******   *******   *******
              ***      **   **  **  ***   **   ***  **
              ***      *******  ******    **    **   *****
              ***      *******  **  **    **   ***      ***
              *** ***  **   **  **  ***   *******   *** ***
               *****   **   **  **   ***  ******     *****



        This masterpiece was arexxed by FÅm¦Çø¶ s¡mply GøÐf£e$h for 
            the Shining 8 HQ TERROR DOOM BBS! +49-217-393-8713

           »» CARDS V2.2 © 93,94 by FÅm¦Çø¶ s¡mply GøÐf£e$h ««


 If ya got sugestions or bug-reports, feel free to contact me on one of 
 these fine boards or at a bar neer you!

                        CAULDRON BBS TRSI HQ
                        LIGHTHOUSE BBS THHG HQ
                        VILLA STRAYLIGHT BBS SCANDAL DIST. SITE
                        TERROR DOOM BBS SHINING 8 HQ
                        R.A.P.E. BBS ACCUMULATORS HQ

TÅKE ÇÅ®E
÷·÷·÷ FÅm¦Çø¶ `94 ÷·÷·÷




@endnode
@node intro " Introduction to CARDS "
@next checkback

The idea for writing a caling card managing tool is not absolute new,
but writing it in pure AREXX with some stunning new features is new.

This tool is basicly a CC dispenser for a sysop that wants to support his
top traders with CC`s! 

It gives the registered user of the service a rack where he can find his
own CC`s. The manager can simply give the user a list of cards for abusing!
So the user doesn`t nerv the sysop all the time "jo dude! gimme a new card!"

But the tool can do a whole lot more! Check it out!

I wrote it in AREXX coz it is simple and developing gets fast.
I did not compile it coz it didn`t work on every platform and i am 
not afraid of some people anticipating from my source code! (great ehm?!)

You don`t have to worry that there might be a backdoor in it, coz you can
read the source and convince yourself!


The handling is pretty handy and every Mr.average should come along
with it.

Okay, folks. That's it for now! Look out for some more /X tools 
from   FÅm¦Çø¶ s¡mply GøÐf£e$h!

Have fun... and abuse AT&T and MCI to the hardest hehehe...

@endnode
@node checkback " checking the Integrety of ya CARDS version! "
@next install


Check your CARDS version for Backdoors thru a magic checksum:
=============================================================

To make sure that you are using a 100% original version from the author,
that means that there are NO backdoors in the program, use the accomplished
little proggy named: »» CARDScheckV2.2 ««!

That program will give you the information which version of CARDS you are 
using and a checksum for it! (listed below)

Do the check once you downloaded the CARDS package from your favourite BBS!
Just to see if some dummy altered the code in order to atach a backdoor to
the service!
If the checker says that you are using a ORIGINAL version you can install 
the door and feel free to change the ansis in the program!

the checksums are for:
----------------------

CARDS V2.12 = 1117340352
CARDS V2.5  = 813694016

@endnode
@node install " Installation "
@next setup

copy the files    => CARDS.REXX      <- The main program.
                  => CARDScheckV2.5  <- The checksum checker!
                  => CARDS.Guide     <- The file ya actually reading! 
                  => CARDS.CNF       <- Application CONFIG file
                  => CARDS.AXX       <- Access file (WHO IS SYSTEM MANAGER)
                  => CARDS.BAN       <- Optional ansi banner file
                  => CARDS.ALI       <- Alias file 
   
to the folowing Directory: BBS:DOORS/CARDS/

copy the files    => FAMICON.DAT     <- SAMPLE FILE FOR A RACK (DELETE ME)
                  => SATAN.DAT       <- SAMPLE FILE FOR A RACK (DELETE ME)

to the following Directory: BBS:DOORS/CARDS/RACKS/

The @{" LOGFILE " link logfile} »» CARDS.LOG ««  & the @{" STATFILE " link stats} will be created 
by the tool itself!

if ya working on /X 2.XX then add this to your BBS.CMD:

----------CUT HERE-------------
*CARDS    RM100DOORS:CARDS/CARDS.REXX
----------CUT HERE-------------

otherwise if ya smart you got /X 3.XX installed then 
put the CARDS.INFO icon into the drawer:

IMPORTANT!! YOU NEED TO COPY THE V2.5 CARDS.INFO TO THE DIRECTORY COZ
SINCE V2.5 CARDS IS NO LONGER MULTINODE CAPABLE!

    ==>BBS:Commands/BBSCmd/

The files containing the calling cards named after the rackowner(USERNAME)
with the extension .DAT!

IMPORTANT!: THE DIR FOR THE RACKS HAS CHANGED SINCE V2.5!!!

They have to be in the BBS:DOORS/CARDS/RACKS/ directory!
                       ======================

that`s all for the installation dude, the @{" LOGFILE " link logfile} WILL BE AUTO GENERATED!

@endnode
@node setup " setup your CARDS service "
@next menu

BEFORE YOU START OUT:
=====================

in the file CARDS.BAN you can place an ansi logo of your choice!
It will be displayed before the door starts.
After the ansi you will be questioned about a user password!!

You can edit the APPLICATION-PW and also the PUBLIC-PW in the CONFIG-file:

                    => CARDS.CNF

There are 2 entries:
         PRIVATE= <= APPLICATION-PW for the @{" PRIVATE-MODE " link private} 
         PUBLIC=  <= APPLICATION-PW for the @{" PUBLIC-MODE  " link public}  

If you don't want an ansi before the tool, just put a blank line in
the file CARDS.BAN!

In order to run this nize little tool correctly you have to edit the
file CARDS.AXX!

This file contains the usernames of the people that are allowed to have 
full managing axxs to the tool! So put yar sysop-username in here!
That means that the users in that list can edit custom racks and add users
to the service! So be careful with that entries (normaly only sysop, cosys
and card supplier)

In case that your bbs-username contains special ascii codes that are not
allowed in amiga dos you have to insert your bbs-username in the file
»» CARDS.ALI ««. That is the alias file. The tool recognizes names with
bad ascii codes and tries to substitute them internaly with alias's!
So budhead go ahead and enter yar bbs-username with all da strange ansi
stuff and let a '@' follow directly and after that you enter a decent amiga
dos compatible alias for the bbs-username!
You need to do this only the first time! From than on you will enter the
alias online if it's needed!

PHEWW...That was hard to explain but most of the people are so stupid! hehe

@endnode
@node private " The PRIVATE-MODE "
@next public

PRIVATE-MODE:
=============

the PRIVATE mode is for accounted users of the CARDS service only!
If the user entered the PRIVATE-PW he will see his private (OWN) rack.
If he entered the PUBLIC-PW he will see the public rack.

@endnode
@node public " The PUBLIC-MODE "
@next import

PUBLIC-MODE:
============
The PUBLIC-MODE is a rack for all users of the CARDS service and the ones
that don`t have an own rack but want to get sum donation cards from the 
beloved sysop!
So if the sysop wants to kill a card or just make a present to all users 
than he puts a card into the PUBLIC rack and eall`s the CARDS-PUBLIC-PW!
If you entered no PUBLIC-PW in the CARDS.CNF file, then the PUBLIC-MODE
is turned OFF!! (PUBLIC=)

 
@endnode
@node import " The FAST-IMPORT-MODE "
@next menu

FAST-IMPORT-OPTION:
===================

This is new since rel. 2.1! I implemented this option, coz i thought it 
might come handy for one or another sysop!

If you are getting the CC`s as a normal ascii file from ya supplier, 
it looks most probably like this:

12121212121212
13212312321323
32453214521433
21342134213432
      :
      :
      :

If not, use your CED (macro option) to bring it into that format!!
Notice!! There are no spaces at the beginning!!

Now, if ya wanna add all these cards to the CARDS service, it`s a lot of
boring, fucking, lame work to add them using the normal A)dd option!
So you betta use the new I)mport option! It reads the import-file 
and puts the cards right into the actuall rack! Isn`t that great!?
yeahh... ya might say! 

@endnode
@node menu " The MAIN functions "
@next manager

NOW IN GENERAL:
=============== 

This tool enables you as a sysop or an enabled remote-user to have a
look at the CC's that are available on the bbs right now!

But that's not all! Infact there is more to come.

            @{" MANAGER MODE     " link manager}
            @{" NORMAL USER MODE " link user}


@endnode
@node manager " The MANAGER mode functions: "
@next user

IN GENERAL THERE ARE 11 OPTIONS IN THE MANAGER MODE:
===================================================
    
         You can change the CC-number of a CC-slot!            -> C)

         You can just change the status of a card!             -> S)

         You can add a card to the actuall rack!               -> A)

         You can @{" FAST-IMPORT " link import} CC`s to the actuall rack!         -> I)

         You are able to delete one ore a range of cards       -> D)
         from the rack! (E.G. 4 deletes the single card 4,
                              4-7 deletes the cards 4,5,6,7)
            
         You can change the rack, on which you want to work on -> R)

         You can move one or a range of cards from one rack    -> M)
         to an other rack of the service!                

         You can add a user to that service!                   -> U)

         You can kill a user (rack) from the service!          -> K)

         You can list all user-racks of the cards service      -> L)
    
         And last but not least... ya can QUIT!                -> Q)


@endnode
@node user " The NORMAL USER mode functions: "
@next logfile

THE NORMAL USER MODE:
=====================

        You can just change the status of a card!             -> S)

        You can poll for new CC`s (msg to sysop)              -> P)

        You are allowed to QUIT!                              -> Q)


Got it! Fine DUMMY!

@endnode
@node logfile " The Logfile  "
@next stats

CARDS will produce a logfile (CARDS.LOG) in the directory:

                    ==> BBS:DOORS/CARDS/

The logfile will scan all actions that took place including hacking!
 
In order to take care of the overall length of the logfile you can edit 
the CARDS-CONFIG-FILE: »» CARDS.CNF «« 

There is a option named: KEEP_LOG=...

This option will indicate how many MONTH the logfile contains!

e.g.: if KEEP_LOG=2 is set (default) and we have march than the logfile
will hold all actions for february and march! That prevents the logfile
from getting too long and keeps the @{" STATFILE " link stats} generation short!

The output could look for example like this:

CARDS V2.5 successful installed! © by FÅm¦Çø¶ 94 
-----------------------------------------------------------------------------
FAMICON entered CARDS on 03/03/94 at 15:45:26 on Node 0 in PRIVATE mode!
===> CARDS MANAGER ACCESS GRANTED! 
===> Added the card No.: 3 CARD: 333-333-3333-3333
===> FAMICON used the rack of JUDAS at 15:46:17
===> Deleted the card(s) No.: 1
===> FAMICON used the rack of FAMICON at 15:46:47
===> Added the card No.: 4 CARD: 123-456-7890-1234
===> Added the card No.: 5 CARD: 111-111-1111-1111
===> Added the card No.: 6 CARD: 222-222-2222-2222
===> Added the card No.: 7 CARD: 444-444-4444-4444
===> Moved card(s) No.: 6-12 from rack:FAMICON to rack:JUDAS
FAMICON exits CARDS on 03/03/94 at 15:48:03 on Node 0
-----------------------------------------------------------------------------
JOE COOL failed with pw: famicon on 03/03/94 at: 15:51:09 on Node 0
JOE COOL exits CARDS on 03/03/94 at 15:51:09 on Node 0
-----------------------------------------------------------------------------
JOE COOL entered CARDS on 03/03/94 at 15:51:13 on Node 0 in PRIVATE mode!
===> CARDS NORMAL USER ACCESS GRANTED! 
JOE COOL exits CARDS on 03/03/94 at 15:51:13 on Node 0
-----------------------------------------------------------------------------
JOE COOL entered CARDS on 03/03/94 at 15:52:10 on Node 0 in PRIVATE mode!
===> CARDS NORMAL USER ACCESS GRANTED! 
===> JOE COOL tried to use the rack of JOE COOL at 15:52:10
JOE COOL exits CARDS on 03/03/94 at 15:52:10 on Node 0
-----------------------------------------------------------------------------
FAMICON entered CARDS on 03/03/94 at 15:52:29 on Node 0 in PRIVATE mode!
===> CARDS MANAGER ACCESS GRANTED! 
===> Added the new user: JOE COOL to the CARDS service & used his rack! 
===> FAMICON used the rack of FAMICON at 15:52:48
===> Moved card(s) No.: 6-10 from rack:FAMICON to rack:JOECOOL
===> Changed the status of card No.: 4 to tERMiNAtED
FAMICON exits CARDS on 03/03/94 at 15:53:23 on Node 0
-----------------------------------------------------------------------------
FAMICON entered CARDS on 03/03/94 at 15:53:27 on Node 0 in PUBLIC mode!
===> CARDS MANAGER ACCESS GRANTED! 
FAMICON exits CARDS on 03/03/94 at 15:53:35 on Node 0



@endnode
@node stats " The Statistic option  "
@next history

The CARDS Statistic Feature:
----------------------------
Since it is pretty neat for the users and the managers to know how often 
the CARDS service is frequented and what the main actions were, i included
that little option!

It evaluates the @{" LOGFILE " link logfile} after every session in the 
CARDS service and gives a small overview in a listform!

might look like this:

[-+-]        C.A.R.D.S V2.5 ©`93,`94 by FÅm¦Çø¶ ÷ $¦mp£¥ GøÐf£eSh       [-+-]
-----------------------------------------------------------------------------

       |  USAGE OF CARDS SERVICE  | NEW  | KILLED |  NEW  | KILLED |
       |   MANAGER   |     USER   |      |        |       |        |
 MONTH |  PRIV | PUB | PRIV | PUB | CC`S |  CC`S  | USERS | USERS  | HACKING
-------+-------+-----+------+-----+------+--------+-------+--------+---------
   02  |  002  | 007 | 000  | 000 | 016  |   000  |  001  |  001   |  000
   03  |  048  | 010 | 004  | 003 | 000  |   001  |  001  |  001   |  002
-------+-------+-----+------+-----+------+--------+-------+--------+---------

Rackowner:FAMICON
A)dd a Card, E)dit a Cardnumber, D)elete Card(s), change the S)tatus
Select a R)ack, M)ove a Card(s) to an other rack, Add a new U)ser, ST)atistics
K)ill a USER, I)mport CARDS, L)ist Racks, Q)uit, (ENTER)Redisplay ?


@endnode
@node history " History of CARDS "
@next greetings

HISTORY:
========

    V0.5  internal version

    V1.2  1st rel. version

    V1.6  2nd rel. version improved managing functions! (delete, add)

    V1.7  some minor bugs fixed!

    V1.8  3rd rel. version built in logfile & some bugs fixed!

    V1.9  Beta rel. version built in move option, racklist, poll!

    V2.0  4th rel. version tuned move option, correct poll
                   and PUBLIC-MODE support!

    V2.1  5th rel. version (probably last one) tuned design,
                   implemented FAST-IMPORT-MODE & the KILL USER option

    V2.11 minor bugs fixed!

    V2.12 more bugs fixed! Checksum, Backdoor protection!
                    DUPE-CHECK in FAST-IMPORT-MODE!
                    converted the Doc file to a GUIDE!

    V2.5  AmigaDos Version information included,    
                   Logfilestripping,
                   Configurationfile,
                   Statistics option

@endnode
@node greetings " The Greetings "

FINAL GREETINGS:
================

JUDAS       => LAME SAUFPOCKE HOFFENTLICH IS BALD GENUCH BIER DA!!!
               SUPER BUSTER - 09 SUXX!!!

SPEEDLOCK   => NICE PIX CONF DUDE!!

WINTERMUTE  => SORRY BUT I DON`T HAVE THE TIME TO CALL THAT OFTEN R8 NOW!
               10 DAYS TO MY FINAL MATH TEST!

SATAN       => LAMENESS NEVER DIES!! HEHE COOL ANSIWORK DUDE!
               THNX 4 BETA TESTING CARDS!

M.BISON     => HOPE TO CHAT YA SOON AGAIN! (JAGUAR SUXX!?)

LORD VIGO   => NICE COPIER DEAL! DUDE!

J-F-K       => PLEASURE TO MEAT YA! KEEP UP YA WORK!

J.WALKER    => WAITING FOR YA SNES ASSEMBLER FOR THE AMIGA!!

YUNO HU     => FOR BEING SUCH A STRANGE BUT LOYAL FRIEND!

@endnode
