As with most software, there are legal conditions associated with Viite-Handler and you must read them before you first use the program.
Viite-Handler - A DOS handler generating reference numbers for bank transfers Copyright (C) 2002 Mikko Koivunalho
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
This documentation may mention various hardware and software by name. Such names are often protected Trademarks and their mention in this document shall in no way damage their legal status.
You can contact the author at the following addresses:
This chapter explains why you may need Viite-Handler, how it works, its system requirements, and how to install it.
Please aquaint yourself with these points before using Viite-Handler.
Note that these instructions include an extensive glossary. If You are unsure of a particular term in the technical jargon, You should check the glossary first, to see if it's explained in there.
Terminology which is adequately explained in Your system manuals has not been included in the glossary. If You are new to, and/or not familiar with your AMIGA, You are urged to keep its manuals at hand.
When You make a bank transaction, i.e. transfer money from one account to an other, for example when paying for rent or Your phone bill, You have surely noticed that long series of numbers which identifies Your payment from the payments of others'. This string of numbers does not consist of just any numbers. It is calculated with an algorithm and this algorithm can be used to check if the payer has written or punched the right numbers. This of course reduces the amount of typos. Viite-Handler is a program to automatically generate those reference numbers.
You need Viite-Handler if You do section B Glossary. Usually invoicing requires creating a lot of bills at the same time. That is what Viite-Handler is for. Because it is a section B Glossary, You only mount it once, not run everytime a new. Think about the saving of section B Glossary
What Viite-Handler does, is create a DOS Device, a handler, from which You can read files, whose contents are the reference numbers.
An example: You have a client with an identification number, ID, 1234 and You want to bill him. You print on the bill reference number which is derived from his ID number. But not just any series of numbers can be a reference number. A reference number is any series of numbers which ends in a specific verification number. This verification number is calculated in a special way.
To derive the reference number from the ID number, You only need to start Viite-Handler and use DOS Device VIITENUMERO:. Open file VIITENUMERO:1234 and read its content. The only content is a string which actually is the reference number.
section 2.4 Testing
How does Viite-Handler work? Viite-Handler receives DOS calls (Open(), Close(), Read(), Write(), ...) directed to the DOS Device VIITENUMERO:. When You open a file for reading (with Open() function) Viite-Handler creates a virtual file (i.e. a file which does not exist in any mass media). The content of this virtual file is calculated with an algorithm from the name of the file opened.
The name of the file opened is always a string of numbers, if anything else, VIITENUMERO: claims the file doesn't exist. This string is analyzed in the following way:
Read from right to left, each of the numbers are multiplied with another numbers according to the following pattern: the first by 7, the second 3, the third by 1, the fourth again by 7 and so on. The outcome of these multiplications are added together. This amount is then subtracted from the next full ten. This outcome is the verification number of the reference number and it is added to the end of the string. This string is the content of the virtual file.
An example: 12345 -> 7*5 + 3*4 + 1*3 + 7*2 + 3*1 = 67 -> 70 - 67 = 3 Reference number is therefore 123453.
If You want to test Viite-Handler before installing it, follow these steps:
Now You can test VIITENUMERO:. Type:
As Viite-Handler is very simple to install, no installation script has been provided.
Having successfully installed Viite-Handler and having gained some understanding of the underlying principles, you can being using Viite-Handler. This chapter outlines points to note while using this program.
When VIITENUMERO: is installed in Your system, You can begin using it. Its use is already described in section section 2.4 Testing so it won't be repeated here.
Viite-Handler can handle these DOS Packets:
ACTION_FINDINPUT
Open().
ACTION_READ
Read().
ACTION_END
Close().
ACTION_DIE
To all other packets Viite-Handler will answer with DOSFALSE,
ERROR_ACTION_NOT_KNOWN.
Only one parameter can be given when opening a file in `VIITENUMERO:' /NOSPLIT. This parameter will cause the generated reference number to have no spaces. Normally there is always a space after every five numbers to ease reading. The spaces are counted from left to right.
This chapter contains information about the executable `Viitenumero' and speculation about world wide banking standards.
Viitenumero
The executable `Viitenumero' is provided for Your convenience in case You only need to know one reference number and don't want to mount VIITENUMERO:.
Well, saddest part!
I know that the section 2.2 Background is used in Finnish banks but I have no idea if it is in use in other countries. I'd like to hear from You, dear user, if the banks in Your country use a different system. Then I could modify Viite-Handler to Your needs.
section 1.3 Author
The source code to both Viite-Handler and Viitenumero has been released together with the programs. It resides in the directory `Source'.
Viite-Handler is programmed in C. Viitenumero on the other hand is programmed in Eiffel. Eiffel is fully object-oriented programming language which I find both easy to write and read. In fact, compared to C, Eiffel source code looks "beautiful". Visit @url{http://SmallEiffel.loria.fr} for the Eiffel compiler I use.
version scsi.device full" at a CLI prompt and note the output.
.device.
For example; scsi.device, gvpscsi.device,
omniscsi.device, z3scsi.device, dracoscsi.device, etc.
The creation of Viite-Handler would not have been able without the following people and "things", so credit where credit is due!
This document was generated on 16 August 2003 using the texi2html translator version 1.51.