💾 Archived View for mirrors.apple2.org.za › archive › ground.icaen.uiowa.edu › upl1999 › Jul99 › AM.… captured on 2024-12-18 at 03:10:36.

View Raw

More Information

-=-=-=-=-=-=-


                      ADDRESS MANAGER INSTRUCTIONS
                      ============================

Verions 2.0e - September 1988.

Program Author:

Eric Gilliard 
Rte du Simplon 45
CH-1094 Paudex
Switzerland

I have included the full source files written in
TML Pascal (APW version).


Functions of 'Address Manager'
------------------------------

This application is a menu- and window-driven simple data base manager
wich is specially done to handle addresses.

It can handle up to 700 records divided in up to 50 groups.

A usefull setup program lets you define all menu- and item-names; you can
also use default values.

With 'Address Manager' you can print reports and labels.


Hardware requirement
--------------------

1 Apple IIGS with at least 512 KB.
1 disk drive.
1 printer recommended.


Getting started
---------------

Two programs are necessary :  'AddrManag'  and   'AMSetup'
You have to copy these files into one folder.

With 'Finder' or 'Launcher', select 'AMSetup'. Just choose 'Create New File'
of File menu and 'Quit'. This will create two data files :

        'AMFile.Param'   and   'AMFile.Data'.

Now you can run program 'AddrManag' and enter addresses. A third file will
then be created :

        'AMFile.Index'.


Files on Disk
-------------

AddrManag                           Main program Addresses Manager
AMSetup                             Program to create new files
                                        and to modify names

Users.doc                           Documentation for users

AMFile.Data                         File containing main datas
AMFile.Index                        Index file
AMFile.Param                        Parameters file

AMFile.= requires about 66 KB for 200 addresses, 222 KB for 700 addresses.


Program 'ADDRMANAG'
===================

Specifications of program
-------------------------

Maximum number of addresses      700
Maximum of groups                 50  (you can set the title only for the
                                       20 first groups)

Number of Windows                  4

This program can print on different devices :

  - ImageWriter II via Printer Port
  - ASCII disk files (usable in most wordprocessors)
  - WordPerfect disk files

Paper of 11 inches and 12 inches is supported.


Description of Menu Bar
-----------------------

Apple Menu :  About AddrManag         Quick description of program
                                      Gives occupation of file
              NDAs                    New Desk Accessories
                                      (must be copied in SYSTEM/DESK.ACCS/)

File Menu :   Close Window            To close front window
              Sort Index              To sort index
                                      (when you add an address, index is
                                       not automatically sorted)
              Generate Index          Regenerate index file from data file
                                      (useful when record does not correspond
                                       to index or when you switch computer
                                       off without 'Quitting')
              Generate List of Groups Regenerate groups list
              Quit                    End of program

Edit Menu :   Cut                     Standard function
              Copy                        "       "
              Paste                       "       "
              Clear                       "       "

Window Menu : Record 1 to 4           Select window with record 1 to 4

Reports Menu: Sorted by name          Creates report sorted by name
              Sorted by group         Creates report sorted by group/name
              For 1 group (menu)      Creates report for one group
              Labels                  Creates labels sorted by name
              ImageWriter II          Sends listings to ImageWriter II
              Print to Ascii File     Listings will be created on Ascii files
              Print to WordPerfect    Listings will be created for WordPerfect
              Paper 11"/12"           Length of page

Groups Menu : List of Groups          The 16 first groups will be in this menu.
                                      if you select one, it will create the list
                                      of the first 16 addresses of this group

Addresses Menu : List of Addresses    The 16 first Addresses of one group


Description of one Window
-------------------------

Items :     Name          30 positions      Name (accesskey)
            Address1      30 positions      first  line of address
            Address2      30 positions      second line of address
            City          30 positions      City + State + Zip
            PhoneNr H     14 positions      Home   Phone Number
            PhoneNr O     14 positions      Office Phone Number
            BirthDate     10 positions      Birth  Date (MM/JJ/YYYY)
          * RecordDate     7 positions      Record Date    (MM/YYYY)
          * Nationality   15 positions      Nationality
          * Entry Year     4 positions      Entry in USA      (YYYY)
            Group 1        4 positions      Group 1 (Accesskey)
            Group 2 (opt.) 4 positions      Group 2 (Accesskey)
            Function      30 positions      Function
            Remark        30 positions      Remark
            A-button                        Can be used for special function
            B-button                         "   "   "   "     "       "
          # Mrs.                            Radio Button
          # Miss                              "     "
          # Mr.                               "     "


# Radio Button is used for labels only


How to create a new address
---------------------------

Select <New> with mouse and click.

A blank window will appear. Now you have to fill up fields; to pass from
one field to another, you can use [tab] key or mouse. When done, select
<Store> to save address or <Cancel>.


How to select an address by Name
--------------------------------

Enter Name or part of Name and press [return] or click <Search>. Two bips will
tell you if not found or window will be filled with all informations.

<Find Next> will show you next record with same Name.

<Find Prior> will show you previous record with same Name.


How to select an address by Group
---------------------------------

One Record that have 'Group 1' and 'Group 2' defined can be accessed by
these two groups.

Enter Group or part of Group in field 'Group 1' and press [return] or click
<Search>.

You can also use Menu 'Groups' to select one group. This will create a
new Menu named 'Group ....' which contains list of names of this group.
Then you can select one Name.

<Find Next> and <Find Prior> work as descripbed above.


Select by Name and Group
------------------------

You can combine Name and Group (part of Name, part of Group) to select one
record.


How to modify an address
------------------------

Select an address and modify fields. When it is done, press <Store> to save
your modifications or <Cancel>.


How to suppress an address
--------------------------

Select an address and press <Delete>. A window will ask you to confirm.
When you delete an address, a page will be printed with all informations
and the date of deletion.


Print one address
-----------------

Select an address and press <Print>. This will print one page with all infor-
mations.


Print Reports
-------------

It is possible to generate 3 types of reports :

        - sorted by name
        - sorted by group and name    (1 page per group)
          [if an address is declared in two groups, it will appear twice]
        - sorted by name for 1 group  (first you have to select group with menu)


Print labels
------------

Labels are printed sorted by name and you have 5 labels to align printer.


Printer Options
---------------

By menu you can select length of paper (11" or 12"). With 11", you can print
12 addresses per page; with 12", 14 addresses per page.

You can select 3 types of devices :

        - ImageWriter II connected to printer port
                When you print to ImageWriter II, you can stop printer by
                pressing mouse button
        - Ascii data file under name    /RAM5/PRT.ASC.LISTnn
                                        /RAM5/PRT.ASC.FICHnn
                                        nn = number of report
                You can use these files in word processor programs or you
                can dump then to any printers other than ImageWriter II
        - WordPerfect file under name   /RAM5/PRT.WP.LISTnn
                                        /RAM5/PRT.WP.FICHnn
                These files can be used only by WORDPERFECT program which
                lets you to print on different types of printers.

if /RAM5 (RAM Disk) is not defined, these files will be routed to current
Folder.


Program 'AMSetup'
===================

Specifications of program
-------------------------

Definition of all names (Menu, Windows, Reports).

Creation of new file.


Description of Menu Bar
-----------------------

Apple Menu :     About AMSetup        Quick description of program
                 NDAs                 New Desk Accessories
                                      (must be copied in SYSTEM/DESK.ACCS/)

File Menu :      Close Window         To close current window
                 Create New File      Creation of a new file.
                 Quit                 End of program

Edit Menu :      Cut                  Standard function
                 Copy                     "       "
                 Paste                    "       "
                 Clear                    "       "

Setup Menu :     Windows Setup        Definition of datanames for Window Display
                                      and Report Titles
                 Menu Setup           Definition of Menunames
                 Groups Setup         Definition of Groups Names and Titles
                                      (4 positions and 30 positions)


Description of Windows
----------------------

Window Setup :

This window contains all constants for windows displayed in 'AddrManag'. You
can set the name of each field. You can also define names of buttons. When
you finish modifying datas, press either <Store> to save or <Cancel>.
Itemnames of this window are used for titles in reports.

Menu Setup :

This window contains name of menubar. This lets you define your own
menubar.

Groups Setup :

This window contains up to 20 groups. You have to define name of groups for
window (up to 4 positions) and title of groups for reports (up to 30 pos.).
This window contains general title for reports and secondary title if sorted
by name.


How to create a new application
-------------------------------

Create a Folder for this application, copy 'AddrManag' and 'AMSetup' programs
to this folder. Then run 'AMSetup' program.

Select 'Create New File' of Menu bar and confirm that you want to delete
current file.

Modify itemnames, menunames and groupnames using 'Window Setup', 'Menu Setup'
and 'Groups Setup'. Don't forget to <Store> each window.

Select 'Quit' from menu.


IMPORTANT
---------

Do not forget to select 'Quit' from File Menu when you have finished your work !

Make regularly a backup copy of files: 'AMFile.data', 'AMFile.index' and
'AMFile.param'.


User Support
------------
If you have any problem or any suggestions about 'Address Manager', you can write to the address mentioned above.