@database dfa.guide @Master dfa.texi @Width 72 This is the AmigaGuide file dfa.guide, produced by Makeinfo-1.55 from the input file dfa.texi. @Node Main "dfa.guide" DFA - DFAddress the address utility for the Amiga and OS 2.0 (C) Copyright 1992-1994 Dirk Federlein *** DFA is an SASG product *** - Shareware - This manual describes the installation and the usage of @{b}DFA@{ub} version 2.2. If you use a localized Workbench (Workbench V2.1 and better) and have set it to a language other than English, please notice that I'll refer to the English program texts in this documentation! Introduction... @{" Welcome! " Link "Welcome"} @{" Features " Link "Features"} @{" Installation " Link "Installation"} Before you can use DFA @{" Quick start " Link "Quick Start"} If someone just can't wait... Now the serious bit... @{" The concept of DFA " Link "Concept"} Concept? Which concept? @{" Usage of DFA " Link "UsingDFA"} Some basics @{" The DFA-Server program " Link "DFAServer"} Commodity, AREXX, ... @{" The DFA-Editor program " Link "DFAEditor"} Graphical user interface @{" The DFA-Preferences program " Link "DFAPrefs"} Where you can set (nearly) everything Miscellaneous... @{" Legal stuff " Link "Legal"} Copyright, Status, etc. @{" Registration " Link "Registration"} How to register @{" Updates " Link "Updates"} New versions and how to get them @{" Bugreports " Link "Bugreports"} What shall we do with the bug reports @{" Important addresses " Link "Addresses"} The addresses of the author and the registration sites @{" Internals " Link "Internal"} @{" Configuration Requirements " Link "MinConfig"} Minimum hard- and software requirement @{" Some tips " Link "Tips"} What to do, if something doesn't work @{" Thanks " Link "Thanks"} To find things quickly, the... @{" Index " Link "Index"} @EndNode @Node "Welcome" "dfa.guide/Welcome" @Toc "Main" Welcome! ******** Welcome to the documentation of @{b}DFA@{ub}! You did really manage it and forced yourself to read this manual! Please, do @{b}not@{ub} stop here, but continue reading - it will be to your advantage! Only by reading this manual carefully, can learn everything about the many different features of @{b}DFA@{ub}! Some of your questions - if not all of them - which you might have at this time, will be answered here. Please remember that I put a lot of time and effort (`blood, sweat and tears') into this manual -- please show your acknowledgement by reading this documentation (of course, you may feel free to register)! @{b}Dirk Federlein@{ub} @EndNode @Node "Features" "dfa.guide/Features" @Toc "Main" Features ******** @{b}DFA@{ub} supplies many outstanding features, some of them I'd like to mention here: @{b}*@{ub} OS2.0 "Look and Feel" @{b}*@{ub} Locale support (Workbench 2.1 and better needed) @{b}*@{ub} OS3.0 is supported, if available @{b}*@{ub} Commodity support, i.e. @{b}DFA@{ub} can be reached by hotkey or the Exchange utility of the Workbench @{b}*@{ub} All operations in @{b}DFA@{ub} are accessable via keyboard @{b}*@{ub} The AREXX interface contains more than 30 commands @{b}*@{ub} All windows of @{b}DFA@{ub} are font sensitive @{b}*@{ub} The @{b}DFA-Editor@{ub} main window is font sensitive and @{b}resizable@{ub} @{b}*@{ub} The @{b}DFA-Editor@{ub} main window is an application window @{b}*@{ub} The program has been split into the editor, server and preferences parts; by this the available memory is optimally used and @{b}DFA@{ub} often needs even less memory than in version 1.2x @{b}*@{ub} Program parts used by more than one part of @{b}DFA@{ub} have been exported into a shared library, the @{b}dfa.library@{ub} @{b}*@{ub} Button row, which contains the most important functions @{b}*@{ub} Support of external files @{b}*@{ub} Up to three EMail addresses per entry @{b}*@{ub} Dial function (supports @{b}OwnDevUnit@{ub}) recognizes @{b}BUSY@{ub}, @{b}NO DIALTONE@{ub}, etc. @{b}*@{ub} The addresses can be separated into groups @{b}*@{ub} The groups can be named (incl. shortcut) @{b}*@{ub} New fields @{b}state@{ub} and @{b}c/o@{ub} @{b}*@{ub} Network support @{b}*@{ub} Application icon (can be toggled) @{b}*@{ub} It is possible to use @{b}DFA@{ub} as default tool @{b}*@{ub} New "magic" icons (8 colors) by Martin Huttenloher @{b}*@{ub} Icon generation for the address files can be switched off @{b}*@{ub} The auto save feature can be configured @{b}*@{ub} The format of the address listview can be changed @{b}*@{ub} The display part in the main window of the @{b}DFA-Editor@{ub} can be configured @{b}*@{ub} Addresses can be sorted by any field of the address @{b}*@{ub} The fonts for the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} can be changed @{b}*@{ub} The utility @{b}NewEdit@{ub} is supported @{b}*@{ub} The internal memory management was rewritten from scratch with the consequence that the addresses now use much less RAM than in version 1.2x @{b}*@{ub} The usage of memory pools decreases memory fragmentation @{b}*@{ub} The load and save routines have been rewritten from scratch and are much faster now @EndNode @Node "Installation" "dfa.guide/Installation" @Toc "Main" Installation ************ I strongly recommend use of the supplied install program to install @{b}DFA@{ub}. It extracts the needed file from their archives and copies them to the correct places on your harddisk. It sets all needed tooltypes as well. After the installation procedure has been completed, there exist the following files, or according to your installation at least some of them, on your harddisk: @{b}*@{ub} @{b}@{b}DFA@{ub}, @{b}DFA.info@{ub}@{ub} The @{b}DFA-Server@{ub} program; it supplies the AREXX-Port and manages the Application icon. Putting it into the @{b}WBStartup@{ub} drawer is a good idea. @{b}*@{ub} @{b}@{b}DFAEditor@{ub}, @{b}DFAEditor.info@{ub}@{ub} The graphical user interface of @{b}DFA@{ub}. If you want to start this program from the Shell, please copy it into a drawer in your search path, otherwise in any directory you like, e.g. @{b}DFA:c@{ub}, which is the default. @{b}*@{ub} @{b}@{b}DFAPrefs@{ub}, @{b}DFAPrefs.info@{ub}@{ub} The preferences program for @{b}DFA@{ub}. All settings can be done from within this program. A good place for it is the @{b}SYS:Prefs@{ub} or the @{b}DFA:Prefs@{ub} directory. @{b}*@{ub} @{b}@{b}dfa.library@{ub}@{ub} Must be in @{b}libs:@{ub} or in @{b}DFA:libs@{ub}. This library is needed by all other parts of @{b}DFA@{ub}, i.e. the @{b}DFAServer@{ub}, the @{b}DFAEditor@{ub} and the @{b}DFAPrefs@{ub} program. @{b}*@{ub} @{b}@{b}Registration@{ub}, @{b}Registration.info@{ub}@{ub} This is the new registration program of the @{b}SASG@{ub}. This program makes it possible to register or update in a very comfortable and fast way. Furthermore it contains detailed information about the @{b}SASG@{ub} and the @{b}advantages@{ub} that @{b}you@{ub} may take out of it. @{b}*@{ub} @{b}@{b}DFA.guide@{ub}@{ub} The AMIGAGUIDE documentation of @{b}DFA@{ub}. To read the file you need e.g. the @{b}AmigaGuide@{ub} or the @{b}Multiview@{ub} program. @{b}*@{ub} @{b}@{b}DFA.dvi@{ub}@{ub} The manual in the @{b}DVI@{ub} format. To look at it or print it you need TeX (e.g. PasTeX (C) Georg He mann). @{b}*@{ub} @{b}@{b}DFAEditor.guide@{ub}@{ub} The online help for the @{b}DFA-Editor@{ub}; it can be found in @{b}Help:@{ub} or in the drawer you selected during the installing procedure. @{b}*@{ub} @{b}@{b}DFAPrefs.guide@{ub}@{ub} The online help for the @{b}DFA-Preferences@{ub} program; it can be found in @{b}Help:@{ub} or in the drawer you selected during the installing procedure. @{b}*@{ub} @{b}@{b}dfa.key@{ub}@{ub} If you've got a registered version of @{b}DFA@{ub}, you can find the so-called keyfile @{b}dfa.key@{ub} in the @{b}s@{ub} drawer of the distribution. To give @{b}DFA@{ub} the chance to find the keyfile you either have to copy it to the @{b}s:@{ub} drawer of your boot partition (default) or, if you prefer another directory for your keyfile, you will have to set the environment variable @{b}KEYPATH@{ub} to this @{b}drawer@{ub}. Example: setenv KEYPATH ENV:DFA Usually the install program has already done this for you. @{b}*@{ub} @{b}@{b}s/adr.file@{ub}@{ub} The default address file. It contains the address of the program author. This can be useful for bug reports and -- most of all -- when you want to register. @{b}*@{ub} @{b}@{b}rexx/#?.ced@{ub}@{ub} AREXX scripts for the CED ((C) 1987-1993 CYGNUSSOFT SOFTWARE) working together with @{b}DFA@{ub}. The explanation of each AREXX script can be found in the scripts. @{b}*@{ub} @{b}@{b}rexx/#?.dfa@{ub}@{ub} AREXX scripts that can be started directly out of the @{b}DFA-Editor@{ub} (via the function keys). @{b}*@{ub} @{b}@{b}rexx/#?.rexx@{ub}@{ub} AREXX scripts that can be be started out of the shell (using the @{b}rx@{ub} command. @{b}*@{ub} @{b}@{b}locale/Catalogs//#?.catalog@{ub}@{ub} In each @{b}language@{ub} directory (e.g. @{b}deutsch@{ub} you can find the catalog files that are needed for the locale support (Workbench 2.1 and better needed). Usually the installer script has already copied the needed files to the correct drawers. @EndNode @Node "Quick Start" "dfa.guide/Quick Start" @Toc "Main" Quick Start *********** After you have installed @{b}DFA@{ub} (see @{"Installation" Link "Installation"}, for more information), the builtin default settings are used. These settings already allow you to use @{b}DFA@{ub} and take a lot of advantage out of it. Please notice that the @{b}huge@{ub} amount of settings, which can be tuned in the @{b}DFA-Preferences@{ub} program, can only be saved in the @{b}registered@{ub} version (see @{"The DFA-Preferences program" Link "DFAPrefs"} and @{"Registration" Link "Registration"} for details)! If you copied the @{b}DFA-Server@{ub} (filename @{b}DFA@{ub}) into the @{b}WBStartup@{ub} drawer, as it is recommended by the install program, @{b}DFA@{ub} will be started, each time the computer starts up; futhermore, an application icon for @{b}DFA@{ub} is supplied on the Workbench screen. This behaviour of @{b}DFA@{ub} can be changed as described in @{"Tooltypes" Link "ServerTooltypes"} and @{"The DFA-Preferences program" Link "DFAPrefs"}. As @{b}DFA@{ub} tries to follow the "User Interface Style Guide" as closely as possible, it should be no problem (at least for advanced users) to figure out all the functions of @{b}DFA@{ub} according to "trial and error". If you don't want any bad (?) surprises, just continue reading... @EndNode @Node "Concept" "dfa.guide/Concept" @Toc "Main" The concept of DFA ****************** Since version 2.0 of @{b}DFA@{ub} has been finished, it is no longer a single program, but consists of several parts: The @{b}DFA-Server@{ub} (see @{"The DFA-Server program" Link "DFAServer"}), the @{b}DFA-Editor@{ub} (see @{"The DFA-Editor program" Link "DFAEditor"}) and the @{b}DFA-Preferences@{ub} program (see @{"The DFA-Preferences program" Link "DFAPrefs"}). Certain functions that are used by more than one of these programs have been exported into a socalled "shared library", the @{b}dfa.library@{ub}. By doing so it is possible now that @{b}DFA@{ub} often uses less RAM than in former versions of @{b}DFA@{ub}, even though it contains many enhancements! If @{b}DFA@{ub} would still have been one single program it would have been a size of about 250 KB and nearly noone would have copied it into the @{b}WBStartup@{ub} drawer. In spite of splitting the program into several parts, I tried to keep the known handling of @{b}DFA@{ub}: One should think he works with one single program. To do so, the @{b}DFA-Server@{ub} calls the @{b}DFA-Editor@{ub} after the user hits the hotkey; the @{b}DFA-Preferences@{ub} program on the other side can be reached directly out of the @{b}DFA-Editor@{ub} by selecting the corresponding menu item. This new concept will although be useful for people that start @{b}DFA@{ub} on demand only and therefore don't need the AREXX and the Commodity part of @{b}DFA@{ub}; these people may start the @{b}DFA-Editor@{ub} directly (from the Workbench or Shell) and save the memory the @{b}DFA-Server@{ub} would have taken (about 35 KB). @EndNode @Node "UsingDFA" "dfa.guide/UsingDFA" @Toc "Main" Usage of DFA ************ You can control @{b}DFA@{ub} by mouse as usual as well as @{b}completely@{ub} by keyboard. Some notes to the usage of the keyboard: @{b}*@{ub} @{b}Button Gadgets@{ub} All Gadgets have a corresponding text. In this text you'll find one character @{b}underlined@{ub}. This character is the "shortcut" to the gadget. To use this shortcut, just push the corresponding key. You don't have to push any qualifier like @{b}CONTROL@{ub} or @{b}ALT@{ub}. To simple buttons it doesn't matter if you push the "normal" or the capital letter. To other gadgets it can make a difference (see below for details). @{b}*@{ub} @{b}Listviews@{ub} Listviews are used in the @{b}DFA-Editor@{ub} as well as in the @{b}DFA-Preferences@{ub} program. There are two different types of listviews: Listviews in which you can select entries (raised border), e.g. the address listview in the @{b}DFA-Editor@{ub} main window, and listviews that only display information (recessed border), e.g. the listview in the @{b}DFA-Editor@{ub} full window. If not mentioned otherwise, all listviews can be used as follows: @{b}Input listview:@{ub} Shortcut The next entry becomes the active one, the list scrolls accordingly. Shift Shortcut The previous entry becomes the active one, the list scrolls accordingly. @{b}Read only listview:@{ub} Shortcut The list scrolls @{b}up@{ub}. Shift Shortcut The list scrolls @{b}down@{ub}. Sometimes the listviews can be controlled by the cursor keys or it is possible to scroll page by page. If this is the case, the enhanced usage of that particular listview is described seperately on that place. @{b}*@{ub} @{b}Cycle Gadgets@{ub} In front of a cycle gadget there is short text, which describes the function of the gadget. Again there is one character underlined. However, here it does matter if you use the capital letter or not. The "normal" letter cycles foreward, the capital letter backward. @{b}*@{ub} @{b}Radio Buttons@{ub} Only one of the buttons that belong together can be activated at once. You can select an entry by pushing the proper shortcut. The case of the shortcut is not important. @{b}*@{ub} @{b}Check Boxes@{ub} A check box can be selected (shown by a tick) or deselected ("blank"). You can switch the current state by pushing the corresponding hotkey. @{b}*@{ub} @{b}String Gadgets@{ub} The string gadgets have the same functions as the "original" string gadgets. However, I added some features, which should make them easier to use: - Hit @{b}RETURN@{ub} to end the input to the current gadget and go to the next string or integer gadget. You may use the @{b}ENTER@{ub} key alternatively. - Hit @{b}SHIFT@{ub} @{b}RETURN@{ub} to end the input to the current gadget and go to the @{b}previous@{ub} gadget. - @{b}CURSOR UP@{ub} or @{b}CURSOR DOWN@{ub} brings the cursor to the previous or next string gadget respectively. - Hit @{b}ESCAPE@{ub} to cancel the input completely. The window which contains the gadget is closed and all previous input is discarded. - If the cursor stands within a string gadget, the shortcuts can be reached by hitting @{b}RIGHT AMIGA@{ub}-@{b}@{ub} and @{b}SHIFT@{ub}. If you don't hit @{b}SHIFT@{ub} additionally, the keyboard shortcut is used either by the internal string gadget edit features (like @{b}RIGHT AMIGA X@{ub} or @{b}RIGHT AMIGA Q@{ub}) or by additional tools like @{b}NewList@{ub}. You activate an string gadget by pushing the according shortcut. Usually there is no difference if you hit the upper case or the lower case character, as long as there is no button gadget behind the string gadget. This button gadget that contains a small symbol instead of text, activates a requester, which allows a more comfortable input in the string gadget infront of it. If there is such a button, you activate the string gadget with the lower case key and the button gadget behind the string gadget with the upper case key. @{b}*@{ub} @{b}Text Gadgets@{ub} Usually text gadgets don't have a shortcut, as they only display text, but don't allow any input. Some text gadgets however have a small button gadget behind them (cf. @{b}DFA-Preferences@{ub}: Font-Preferences) After you have hit this gadget a requester pops up and you may select an entry which is displayed in the text gadget as soon as you've completed the requester. Therefore the gadget shortcut doesn't refer to the text gadget itself, but to the button gadget behind it. @{b}*@{ub} @{b}Online Help@{ub} Since version 1.2 has been finished, @{b}DFA@{ub} supports an @{b}Online Help@{ub} feature. To invoke it, just hit the @{b}Help@{ub} key and the help window pops up. Please remember that the @{b}GUIDEFILE@{ub} tooltype of the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program have to be set correctly. The installer program usually has already done this for you. @EndNode @Node "DFAServer" "dfa.guide/DFAServer" @Toc "Main" The DFA-Server program ********************** The @{b}DFA-Server@{ub} (filename: @{b}DFA@{ub}) supplies the commodity features (hotkey, access by the @{b}Exchange@{ub} program) and contains the complete AREXX interface; furthermore it manages the application icon. @{" Tooltypes " Link "ServerTooltypes"} @{" CLI parameter " Link "ServerCLIParams"} @{" Commodity " Link "Commodity"} @{" Application icon " Link "AppIcon"} @{" Arexx interface " Link "Arexx"} @EndNode @Node "ServerTooltypes" "dfa.guide/ServerTooltypes" @Next "ServerCLIParams" @Toc "DFAServer" Tooltypes ========= If you click on the icon of the @{b}DFA-Server@{ub} program once and activate the information program from the Workbench menu you may change the following tooltypes: @{b}*@{ub} @{b}@{b}ADDRESSFILE@{ub}@{ub} If you use this tooltype, you can change the name of the address file that will be loaded by @{b}DFA@{ub} during startup (e.g. @{b}ADDRESSFILE=MyAddresses.dfa@{ub}). Please notice that in this case the file you set in the @{b}DFA-Preferences@{ub} program is not used. @{b}*@{ub} @{b}@{b}CX_POPKEY@{ub}@{ub} The preset hotkey is @{b}LCOMMAND F5@{ub}, i.e. you can pop up the @{b}DFA-Editor@{ub} by pushing @{b}Left Amiga F5@{ub} (cf. @{b}CX_POPUP@{ub}). You can change this hotkey using the following keywords: LSHIFT left shift key RSHIFT right shift key CAPSLOCK caps lock key CONTROL control key LALT left alt key RALT right alt key LCOMMAND left AMIGA key RCOMMAND right AMIGA key NUMERICPAD numeric pad MIDBUTTON middle mouse button RBUTTON right mouse button LEFTBUTTON left mouse button F1-F10 function keys 1 to 10 UP cursor up DOWN cursor down LEFT cursor left RIGHT cursor right HELP help key DEL del key RETURN return key ENTER enter key on the numeric pad; notice that you have to set @{b}NUMERICPAD@{ub} as well! BACKSPACE backspace key ESC escape key SPACE space key COMMA comma key UPSTROKE upstroke key A..Z, a..z "usual" keys 0..9, etc. You can "mix" these keys, for example: - @{b}LSHIFT CONTROL F1@{ub} - @{b}LALT CONTROL D@{ub} - @{b}CONTROL NUMERICPAD ENTER@{ub} - @{b}RCOMMAND RSHIFT A@{ub} @{b}*@{ub} @{b}@{b}CX_POPUP@{ub}@{ub} If you set @{b}CX_POPUP=YES@{ub}, you make the @{b}DFA-Server@{ub} calling the @{b}DFA-Editor@{ub} immediately after startup. Set @{b}CX_POPUP=NO@{ub} to keep @{b}DFA@{ub} "quiet" until you pop up the @{b}DFA-Editor@{ub} by hitting the hotkey or clicking on the application icon or by starting the @{b}DFA-Editor@{ub} directly from the Workbench or the Shell. @{b}*@{ub} @{b}@{b}CX_PRIORITY@{ub}@{ub} With this tool type you can change the Priority of the @{b}DFA@{ub} commodity part. The default setting of @{b}CX_Priority=0@{ub} usually doesn't need to be changed. For more information look up your manual to the @{b}AMIGA-OS@{ub}. @{b}*@{ub} @{b}@{b}DFAEDITOR@{ub}@{ub} This tooltype contains the filename (incl. the full path) that is used by the @{b}DFA-Server@{ub} to call the @{b}DFA-Editor@{ub}. The install program has usually set this tooltype according to your wishes, you only have to change anything if you copied the @{b}DFA-Editor@{ub} manually to another place on your harddisk. @{b}*@{ub} @{b}@{b}DONOTWAIT@{ub}@{ub} This is a system tooltype, which forces the Workbench not to wait for @{b}DFA@{ub} ending. You should @{b}not@{ub} remove this tool type. @{b}*@{ub} @{b}@{b}PORTNAME@{ub}@{ub} @{b}DFA@{ub} uses @{b}DFA@{ub} for the portname. If there is another program with the same portname, @{b}DFA@{ub} attaches numbers (@{b}DFA.1@{ub}, @{b}DFA.2@{ub}, etc.) until a definite name is found. However, if you want your "own" portname, you can set it using the tool type @{b}PORTNAME@{ub} (e.g. @{b}PORTNAME=OtherDFAPortname@{ub}). Please remember that you have to adapt all example AREXX scripts, if you change the portname! @EndNode @Node "ServerCLIParams" "dfa.guide/ServerCLIParams" @Next "Commodity" @Prev "ServerTooltypes" @Toc "DFAServer" CLI-Parameter ============= If you start @{b}DFA@{ub} from Workbench the tooltypes described above will be used. When you start @{b}DFA@{ub} from Shell, these tooltypes are used as well, as long as the corresponding @{b}.info@{ub}-File is present. You can give the following parameters to @{b}DFA@{ub} that overwrite the previous settings (within the .info file). The possible arguments are described below: @{b}ADDRESSFILE/K@{ub}, @{b}CX_POPKEY/K@{ub}, @{b}CX_PRIORITY/N@{ub}, @{b}CX_POPUP/K@{ub}, @{b}PORTNAME/K@{ub}, @{b}DFAEDITOR/K@{ub} This means, you may... ... set the hotkey to @{b}Left Amiga F1@{ub} by @{b}DFA CX_POPUP="LCOMMAND F1"@{ub} ... set the AREXX port to @{b}MyArexxPort@{ub} by @{b}DFA PORTNAME=MyArexxPort@{ub} ... load the alternate address file @{b}MyAddresses.dfa@{ub} by @{b}DFA ADDRESSFILE=MyAddresses.dfa@{ub} @EndNode @Node "Commodity" "dfa.guide/Commodity" @Next "AppIcon" @Prev "ServerCLIParams" @Toc "DFAServer" Commodity ========= By pushing the hotkey (see @{"Tooltypes" Link "ServerTooltypes"}) you may envoke the @{b}DFA-Editor@{ub}. You'll get the same effect, if you start the @{b}Exchange@{ub} program of the Workbench and select @{b}Show Interface@{ub}. Using the @{b}Exchange@{ub} program you can although stop @{b}DFA@{ub} (hit @{b}Remove@{ub}) or to make it inactive (hit @{b}Inactive@{ub}) or active respectively. @EndNode @Node "AppIcon" "dfa.guide/AppIcon" @Next "Arexx" @Prev "Commodity" @Toc "DFAServer" Application-Icon ================ The application icon supplies two functions: @{b}*@{ub} A double click on it activates the @{b}DFA-Editor@{ub}. @{b}*@{ub} If you let the icon of an address file "fall" on the application icon, the @{b}DFA-Editor@{ub} is started and the according address file is loaded. @EndNode @Node "Arexx" "dfa.guide/Arexx" @Prev "AppIcon" @Toc "DFAServer" Arexx ===== @{" Important! " Link "ArexxImportant"} New since version 1.2x @{" Basics " Link "ArexxBasics"} Basics of Arexx @{" Format of the Address Field " Link "ArexxReturnAddress"} @{" Arexx commands " Link "ArexxCommands"} @{" Error codes " Link "ArexxErrorCodes"} Extended error codes @EndNode @Node "ArexxImportant" "dfa.guide/ArexxImportant" @Next "ArexxBasics" @Toc "Arexx" Important -- new features since version 1.2x -------------------------------------------- The AREXX interface has been rewritten from scratch for @{b}DFA@{ub} 2.0. Some commands have been added... @{b}*@{ub} ATTEMPTLOCK @{b}*@{ub} CHANGEGROUPS @{b}*@{ub} FREELOCK @{b}*@{ub} NEWFILE ... some old commands have been changed or improved regarding their syntax: @{b}*@{ub} APPEND @{b}*@{ub} EDIT @{b}*@{ub} KILL @{b}*@{ub} LOAD @{b}*@{ub} NEW @{b}*@{ub} SAVEAS @{b}*@{ub} SEARCH Most of all, however, I've changed the order of the fields within an address item, which is returned by several commands like @{b}FIRST@{ub}, @{b}NEXT@{ub}, @{b}GETCURRENT@{ub}, etc. The reason for doing so is that I thought it would be a good idea to have the same order of the fields in the AREXX interface as in the @{b}DFA-Editor@{ub} edit window, as this makes it a lot easier to remember which meaning the different numbers of an address field have (cf. @{"Format of the address field" Link "ArexxReturnAddress"}). @EndNode @Node "ArexxBasics" "dfa.guide/ArexxBasics" @Next "ArexxReturnAddress" @Prev "ArexxImportant" @Toc "Arexx" Basics ------ @{b}DFA@{ub} (i.e. the @{b}DFA-Server@{ub}) usually accepts AREXX commands at any time, even if the @{b}DFA-Editor@{ub} and/or the @{b}DFA-Preferences@{ub} program is running at the same time. It is possible however that the execution of an AREXX command will be delayed, if someone for example is just editing an address within the @{b}Edit@{ub} window of the @{b}DFA-Editor@{ub}. The reason for this savety protocol can be explained easily: As the addresses are kept in memory only once, all @{b}DFA@{ub} related programs have access to the same address list. By the protocol described above I want to make sure that no part of the @{b}DFA@{ub} package tries to use addresses that another part of @{b}DFA@{ub} has already deleted (this would sooner or later cause the machine to crash). When I talk about executing AREXX commands, the execution of an @{b}AREXX script@{ub} that contains @{b}DFA@{ub} specific AREXX commands, is meant. The basics of the AREXX programming language can be found in the AREXX manual that comes along with @{b}AMIGA-OS 2.0@{ub} or better or in the "AREXX User's Reference Manual"(1). The AREXX port, that has to be used to address @{b}DFA@{ub} is @{b}DFA@{ub}, as long as you did not change this name by the tooltype @{b}PORTNAME@{ub}, as described in @{"Tooltypes" Link "ServerTooltypes"}. This should only be done, if you have another program running that uses the portname @{b}DFA@{ub} as well and you don't want to use @{b}DFA@{ub}'s feature to choose a clear portname. A further remark on the @{b}Load@{ub}, @{b}Append@{ub}, and @{b}Save as@{ub} commands: If you give a filename, you should always use the complete pathname, as otherwise it is very likely that the file can't be found or is written to a place you don't expect. Refering to the home directory of @{b}DFA@{ub} doesn't make much sense, as @{b}DFA@{ub} is often placed in another drawer than the address files and furthermore as @{b}DFA@{ub} remembers the recently loaded filename and uses it for loading and saving. Beyond the item @{b}Syntax@{ub} the possible parameters are listed. The description of the parameters follows the known style given by Commodore, here is its meaning: @{b}/S - Switch@{ub} This is considered a boolean variable. If this option is present, the corresponding option is enabled, otherwise it keeps disabled. @{b}/K - Keyword.@{ub} This parameter must be given in the format @{b}keyword=@{ub}; e.g. the @{b}PRINT@{ub} command can get @{b}FORM/K@{ub} either as @{b}FORM=ALL@{ub} or @{b}FORM=SELECTED@{ub} or @{b}FORM=ACTIVE@{ub}. The equal sign @{b}=@{ub} may be left out. @{b}/N - Number.@{ub} This means the parameter is considered a decimal integer, @{b}/T - Toggle.@{ub} This is similar to the switch (/S) modifier, but one of the keywords @{b}yes@{ub}, @{b}on@{ub}, @{b}no@{ub} or @{b}off@{ub} is expected (not case sensitive). According to the keyword you provide, the option is switched on or off respectively. Please notice that you may @{b}not@{ub} use the equal sign (@{b}=@{ub}) between the parameter and the modifier. The following examples may give you an idea, how this switch can be used: Examples: gui input off output on gui input yes output ON gui input NO output off Important: Starting with version 2.2 of DFA the behaviour of this /T switch changed a bit, so please adopt your Arexx scripts accordingly. @{b}/A - Always.@{ub} This modifier means that this option is required. It must appear in the command line. The exact syntax for every AREXX command can be found below, see @{"Arexx commands" Link "ArexxCommands"}, for details. @{b}Important:@{ub} The AREXX interface of @{b}DFA@{ub} gives you a powerful instrument to manage the stored addresses. A wider range of functionality however implements more ways of loosing your data! This could happen not only by a malfunction of @{b}DFA@{ub} but also by an inproper used function or parameter. Therefore I encourage you to make regular copies of your databases to keep the potential damage as small as possible. ---------- Footnotes ---------- (1) AREXX User's Reference Manual, William S. Hawes, P.O. Box 308, Maynard, MA 01754 @EndNode @Node "ArexxReturnAddress" "dfa.guide/ArexxReturnAddress" @Next "ArexxCommands" @Prev "ArexxBasics" @Toc "Arexx" Format of the Address Field --------------------------- If there is listed @{b}ADDRESS/M@{ub} in the return code section, this means that the corresponding command returns the wanted address if it has been executed successfully. The address can be found either in the variable given together with the AREXX keyword @{b}STEM@{ub} or @{b}VAR@{ub} or in the default variable @{b}RESULTS@{ub}. Example: /* Outputs the first address */ ADDRESS "DFA" OPTIONS RESULTS /* Please notice the full stop behind 'TEST' ! */ FIRST STEM TEST. SAY TEST.ADDRESS.2 EXIT This short example outputs the name of the first entry of the address list. The @{b}STEM@{ub} keyword returns the address in the form of a list, i.e. the address items appear in @{b}TEST.ADDRESS.0@{ub} through @{b}TEST.ADDRESS.25@{ub}. In @{b}TEST.ADDRESS.COUNT@{ub} you can find the number of entries of the address array. The @{b}VAR@{ub} keyword lets @{b}DFA@{ub} return the desired address as well, but the whole address is stored in one single variable, separated by spaces. Please consult your AREXX manual for further details. The address fields correspond to the following "numbers": @{b}0@{ub} Salutation @{b}1@{ub} First @{b}2@{ub} Name @{b}3@{ub} Co @{b}4@{ub} Street @{b}5@{ub} Zip @{b}6@{ub} City @{b}7@{ub} State @{b}8@{ub} Country @{b}9@{ub} Birthday @{b}10@{ub} Phone @{b}11@{ub} Fax @{b}12@{ub} Email1 @{b}13@{ub} Email2 @{b}14@{ub} Email3 @{b}15@{ub} Comment @{b}16@{ub} Group1 @{b}17@{ub} Group2 @{b}18@{ub} Group3 @{b}19@{ub} Group4 @{b}20@{ub} Group5 @{b}21@{ub} Group6 @{b}22@{ub} Group7 @{b}23@{ub} Group8 @{b}24@{ub} Selected @{b}25@{ub} External @EndNode @Node "ArexxCommands" "dfa.guide/ArexxCommands" @Next "ArexxErrorCodes" @Prev "ArexxReturnAddress" @Toc "Arexx" Arexx commands -------------- @{" ABOUT " Link "ABOUT"} @{" APPEND " Link "APPEND"} @{" ATTEMPTLOCK " Link "ATTEMPTLOCK"} @{" CHANGEGROUPS " Link "CHANGEGROUPS"} @{" CLEARALL " Link "CLEARALL"} @{" DESELECT " Link "DESELECT"} @{" DIAL " Link "DIAL"} @{" EDIT " Link "EDIT"} @{" FIRST " Link "FIRST"} @{" FREELOCK " Link "FREELOCK"} @{" GETCURRENT " Link "GETCURRENT"} @{" GUI " Link "GUI"} @{" ICONIFY " Link "ICONIFY"} @{" KILL " Link "KILL"} @{" LAST " Link "LAST"} @{" LOAD " Link "LOAD"} @{" NEW " Link "NEW"} @{" NEWFILE " Link "NEWFILE"} @{" NEXT " Link "NEXT"} @{" NEXTSEL " Link "NEXTSEL"} @{" OPENEDITWINDOW " Link "OPENEDITWINDOW"} @{" POPUP " Link "POPUP"} @{" PREV " Link "PREV"} @{" PREVSEL " Link "PREVSEL"} @{" PRINT " Link "PRINT"} @{" SAVE " Link "SAVE"} @{" SAVEAS " Link "SAVEAS"} @{" SAVEASDEFAULT " Link "SAVEASDEFAULT"} @{" SEARCH " Link "SEARCH"} @{" SEARCHNEXT " Link "SEARCHNEXT"} @{" SELALL " Link "SELALL"} @{" SELBYNAME " Link "SELBYNAME"} @{" SELECT " Link "SELECT"} @{" SORT " Link "SORT"} @EndNode @Node "ABOUT" "dfa.guide/ABOUT" @Next "APPEND" @Toc "ArexxCommands" The ABOUT Command ................. @{b}Syntax:@{ub} ABOUT @{b}Function:@{ub} The @{b}About@{ub} window of @{b}DFA@{ub} is opened @EndNode @Node "APPEND" "dfa.guide/APPEND" @Next "ATTEMPTLOCK" @Prev "ABOUT" @Toc "ArexxCommands" The APPEND Command .................. @{b}Syntax:@{ub} APPEND [FILENAME] [FORCE] [PROMPT] @{b}Argument template:@{ub} FILENAME, FORCE/S, PROMPT/S @{b}Function:@{ub} New addresses are appended to the already existing address database. If the already existing addresses have been changed, the new addresses are not appended, as long as you don't supply the keyword @{b}FORCE@{ub} additionally. It is possible to use the @{b}PROMPT@{ub} parameter, which will supply a file requester to input the desired filename of the address database to append. @{b}Argument description:@{ub} @{b}*@{ub} FILENAME The filename of the address file to be appended. @{b}*@{ub} FORCE Forces appending the address file. @{b}*@{ub} PROMPT Opens a file requester that allows the selection of the address file to be appended. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOFILENAME @{b}*@{ub} RXERR_APPENDFAILED @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKAPPEND @{b}*@{ub} RXERR_MODIFIED @EndNode @Node "ATTEMPTLOCK" "dfa.guide/ATTEMPTLOCK" @Next "CHANGEGROUPS" @Prev "APPEND" @Toc "ArexxCommands" The ATTEMPTLOCK Command ....................... @{b}Syntax:@{ub} ATTEMPTLOCK [] [] @{b}Argument template:@{ub} RETRIES/N, DELAY/N @{b}Function:@{ub} If you are in network mode (see @{"Networking" Link "PrefsNetworking"}), you have to get write access to the address file, before you may modify anything. To do so you have to use the @{b}ATTEMPTLOCK@{ub} command. If someone else in the LAN keeps the write access to the desired address file, this commands returns an error code in @{b}RC@{ub} and @{b}RC2@{ub} (see @{"FREELOCK" Link "FREELOCK"}). @{b}Argument description:@{ub} @{b}*@{ub} RETRIES Maximal number of retries, if the attempt to get write access did not succeed at once. @{b}*@{ub} DELAY Number of seconds that shall pass between two retries. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "CHANGEGROUPS" "dfa.guide/CHANGEGROUPS" @Next "CLEARALL" @Prev "ATTEMPTLOCK" @Toc "ArexxCommands" The CHANGEGROUPS Command ........................ @{b}Syntax:@{ub} CHANGEGROUPS [GROUP1] [GROUP2] [GROUP3] [GROUP4] [GROUP5] [GROUP6] [GROUP7] [GROUP8] [PROMPT] @{b}Argument template:@{ub} GROUP1/S, GROUP2/S, GROUP3/S, GROUP4/S, GROUP5/S, GROUP6/S, GROUP7/S, GROUP8/S, PROMPT/S @{b}Function:@{ub} Changes the active group selection. Commands like @{b}PRINT@{ub} or @{b}SEARCH@{ub} apply only to the currently active groups. To reach all addresses in all groups you have to activate them using this command before. @{b}Argument description:@{ub} @{b}*@{ub} GROUP1 @{b}*@{ub} GROUP2 @{b}*@{ub} GROUP3 @{b}*@{ub} GROUP4 @{b}*@{ub} GROUP5 @{b}*@{ub} GROUP6 @{b}*@{ub} GROUP7 @{b}*@{ub} GROUP8 @{b}*@{ub} PROMPT Opens a window, in which the user may select the desired groups. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOFILENAME @{b}*@{ub} RXERR_NOMEM @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_MODIFIED @{b}Example:@{ub} /* Activates groups 1 through 6 and */ /* deactivates group 7 and 8 */ ADDRESS 'DFA' CHANGEGROUPS GROUP1 GROUP2 GROUP3 GROUP4 GROUP5 GROUP6 @EndNode @Node "CLEARALL" "dfa.guide/CLEARALL" @Next "DESELECT" @Prev "CHANGEGROUPS" @Toc "ArexxCommands" The CLEARALL Command .................... @{b}Syntax:@{ub} CLEARALL @{b}Function:@{ub} All items of the address list are deselected. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKCLEAR @{b}Note:@{ub} Only addresses that correspond to the current group selection are deselected! @EndNode @Node "DESELECT" "dfa.guide/DESELECT" @Next "DIAL" @Prev "CLEARALL" @Toc "ArexxCommands" The DESELECT Command .................... @{b}Syntax:@{ub} DESELECT @{b}Function:@{ub} The current entry (it one exists) is deselected. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOCURRENT @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "DIAL" "dfa.guide/DIAL" @Next "EDIT" @Prev "DESELECT" @Toc "ArexxCommands" The DIAL Command ................ @{b}Syntax:@{ub} DIAL @{b}Function:@{ub} The current address (if one exists) is dialed up. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_SERNOCARRIER @{b}*@{ub} RXERR_SERNODIALTONE @{b}*@{ub} RXERR_SERRING @{b}*@{ub} RXERR_SERBUSY @{b}*@{ub} RXERR_SEROK @{b}*@{ub} RXERR_SERERROR @{b}*@{ub} RXERR_SERCONNECT @{b}*@{ub} RXERR_SERVOICE @{b}*@{ub} RXERR_SERUNKNOWN @{b}*@{ub} RXERR_NOSERIALDEV @{b}*@{ub} RXERR_NOPHONENUM @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "EDIT" "dfa.guide/EDIT" @Next "FIRST" @Prev "DIAL" @Toc "ArexxCommands" The EDIT Command ................ @{b}Syntax:@{ub} EDIT [SALUTATION ] [FIRST ] [NAME ] [STREET ] [CO ] [ZIP ] [CITY ] [STATE ] [COUNTRY ] [BIRTHDAY ] [PHONE ] [FAX ] [EMAIL1 ] [EMAIL2 ] [EMAIL3 ] [COMMENT ] [GROUP1] [GROUP2] [GROUP3] [GROUP4] [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL ] @{b}Argument template:@{ub} SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K, STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K, EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/T, GROUP2/T, GROUP3/T, GROUP4/T, GROUP5/T, GROUP6/T, GROUP7/T, GROUP8/T, SELECT/T, EXTERNAL/K @{b}Function:@{ub} The current address (if one exists) is modified in the given fields. The former contents of these fields is deleted. Fields that are not given as parameter are not changed and keep their former contents. Please notice that parameters that contain spaces have to be set into quotes, for example: EDIT 'COMMENT="A test that contains spaces"' Please remember to use @{b}'@{ub} for the outer and @{b}"@{ub} for the inner quotes! Since version 2.2 of @{b}DFA@{ub} has been completed, the behavior of the @{b}/T@{ub} modifiers has slightly changed. If you want to switch a @{b}/T@{ub} parameter on, you have to supply a @{b}ON@{ub} or @{b}YES@{ub} just behind the according parameter. To switch a parameter off, use the keywords @{b}OFF@{ub} or @{b}NO@{ub}, e.g. EDIT GROUP1 ON GROUP2 OFF GROUP8 ON SELECT ON @{b}Argument description:@{ub} @{b}*@{ub} SALUTATION Salutation @{b}*@{ub} FIRST First name @{b}*@{ub} NAME Name @{b}*@{ub} STREET Street @{b}*@{ub} CO c/o @{b}*@{ub} ZIP Postal code @{b}*@{ub} CITY City @{b}*@{ub} STATE State @{b}*@{ub} COUNTRY Country @{b}*@{ub} BIRTHDAY Birthday @{b}*@{ub} PHONE Phone number @{b}*@{ub} FAX Telefax number @{b}*@{ub} EMAIL1 Email address No. 1 @{b}*@{ub} EMAIL2 Email address No. 2 @{b}*@{ub} EMAIL3 Email address No. 3 @{b}*@{ub} COMMENT Comment @{b}*@{ub} GROUP1 Group No. 1 @{b}*@{ub} GROUP2 Group No. 2 @{b}*@{ub} GROUP3 Group No. 3 @{b}*@{ub} GROUP4 Group No. 4 @{b}*@{ub} GROUP5 Group No. 5 @{b}*@{ub} GROUP6 Group No. 6 @{b}*@{ub} GROUP7 Group No. 7 @{b}*@{ub} GROUP8 Group No. 8 @{b}*@{ub} SELECT Selection state, i.e. @{b}ON@{ub} or @{b}OFF@{ub}. @{b}*@{ub} EXTERNAL The @{b}filename@{ub} of the external file. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NODIR @{b}*@{ub} RXERR_NOFILE @{b}*@{ub} RXERR_NOCURRENT @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKEDIT @EndNode @Node "FIRST" "dfa.guide/FIRST" @Next "FREELOCK" @Prev "EDIT" @Toc "ArexxCommands" The FIRST Command ................. @{b}Syntax:@{ub} FIRST [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The first address of the address list becomes the current one and is returned in the @{b}ADDRESS@{ub} variable. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOFIRST @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "FREELOCK" "dfa.guide/FREELOCK" @Next "GETCURRENT" @Prev "FIRST" @Toc "ArexxCommands" The FREELOCK Command .................... @{b}Syntax:@{ub} FREELOCK @{b}Function:@{ub} If you've got write access using the @{b}ATTEMPTLOCK@{ub} command (cf. @{"ATTEMPTLOCK" Link "ATTEMPTLOCK"}), you should free the locked file as soon as possible using the @{b}FREELOCK@{ub} command, to give other members of the LAN the chance to access this address file. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOSAVE @{b}*@{ub} RXERR_ENVCHANGED @{b}Note:@{ub} Makes sense in network mode only! @EndNode @Node "GETCURRENT" "dfa.guide/GETCURRENT" @Next "GUI" @Prev "FREELOCK" @Toc "ArexxCommands" The GETCURRENT Command ...................... @{b}Syntax:@{ub} GETCURRENT [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The current entry (if there exists one) is returned. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOCURRENT @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "GUI" "dfa.guide/GUI" @Next "ICONIFY" @Prev "GETCURRENT" @Toc "ArexxCommands" The GUI Command ............... @{b}Syntax:@{ub} GUI [] [] @{b}Argument template:@{ub} INPUT/T, OUTPUT/T @{b}Function:@{ub} Using this command you may lock or free the @{b}DFAEditor's@{ub} output and input respectively. After you've locked the input of the @{b}DFAEditor@{ub} using @{b}GUI INPUT OFF@{ub}, it is no longer possible to do any input to the @{b}DFAEditor@{ub}, i.e. you cannot select any gadgets or menus. If you've used @{b}GUI OUTPUT OFF@{ub} to lock the output of the @{b}DFAEditor@{ub}, the address and teh panel listview of the @{b}DFAEditor@{ub} main window are no longer updated, when you more through the address list using @{b}NEXT@{ub} or @{b}PREV@{ub} for example. Not before you've used the command @{b}GUI OUTPUT ON@{ub}, the displayed is "activated" again. @{b}Argument description:@{ub} @{b}*@{ub} INPUT Disables or enables user input into the @{b}DFAEditor@{ub}. @{b}*@{ub} OUTPUT Disables the refreshing of the @{b}DFAEditor@{ub}'s address and panel listview. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_SYNTAX @{b}Note:@{ub} Please make sure that you enable input and/or output, before your Arexx script ends, if you've formerly disabled them. @EndNode @Node "ICONIFY" "dfa.guide/ICONIFY" @Next "KILL" @Prev "GUI" @Toc "ArexxCommands" The ICONIFY Command ................... @{b}Syntax:@{ub} ICONIFY @{b}Argument template:@{ub} @{b}Function:@{ub} The @{b}DFA-Editor@{ub} is stopped, if it is currently running. The @{b}DFA-Server@{ub}, however, keeps running, so you still can reach the @{b}DFA-Editor@{ub} by pushing the hotkey. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOICONIFY @EndNode @Node "KILL" "dfa.guide/KILL" @Next "LAST" @Prev "ICONIFY" @Toc "ArexxCommands" The KILL Command ................ @{b}Syntax:@{ub} KILL [CURRENT] [SELECTED] @{b}Argument template:@{ub} CURRENT/S, SELECTED/S @{b}Function:@{ub} The current entry (@{b}CURRENT@{ub}) or all selected (@{b}SELECTED@{ub}) addresses are deleted! If you use the @{b}KILL@{ub} command without a parameter, it has the same meaning as if you had given the @{b}CURRENT@{ub} parameter, i.e. the current address (as long as there is one) is deleted. @{b}Argument description:@{ub} @{b}*@{ub} CURRENT The current address will be deleted. Can be left out. @{b}*@{ub} SELECTED All selected addresses will be deleted. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKKILL @{b}Note:@{ub} No safety requester will pop up! The addresses are deleted even if they have been modified before! @EndNode @Node "LAST" "dfa.guide/LAST" @Next "LOAD" @Prev "KILL" @Toc "ArexxCommands" The LAST Command ................ @{b}Syntax:@{ub} LAST [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The last address becomes the current one and is returned in @{b}ADDRESS@{ub}. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "LOAD" "dfa.guide/LOAD" @Next "NEW" @Prev "LAST" @Toc "ArexxCommands" The LOAD Command ................ @{b}Syntax:@{ub} LOAD [FILENAME] [FORCE] [PROMPT] @{b}Argument template:@{ub} FILENAME, FORCE/S, PROMPT/S @{b}Function:@{ub} The given address file is loaded, if the previously loaded one had not been changed. You may force the loading of the new addresses by giving the @{b}FORCE@{ub} parameter. Please notice that using the @{b}FORCE@{ub} option throws away any changes you applied to the former loaded addresses. Instead of giving a filename it is possible to use the @{b}PROMPT@{ub} parameter, which will supply a file requester to input the desired filename. @{b}Argument description:@{ub} @{b}*@{ub} FILENAME Address file to be loaded. @{b}*@{ub} FORCE Forces loading a new address file. @{b}*@{ub} PROMPT Supplies a file requester to select the desired filename. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOLOAD @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_MODIFIED @{b}*@{ub} RXERR_NOFILENAME @EndNode @Node "NEW" "dfa.guide/NEW" @Next "NEWFILE" @Prev "LOAD" @Toc "ArexxCommands" The NEW Command ............... @{b}Syntax:@{ub} NEW [SALUTATION ] [FIRST ] [NAME ] [STREET ] [CO ] [ZIP ] [CITY ] [STATE ] [COUNTRY ] [BIRTHDAY ] [PHONE ] [FAX ] [EMAIL1 ] [EMAIL2 ] [EMAIL3 ] [COMMENT ] [GROUP1] [GROUP2] [GROUP3] [GROUP4] [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL ] @{b}Argument template:@{ub} SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K, STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K, EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/S, GROUP2/S, GROUP3/S, GROUP4/S, GROUP5/S, GROUP6/S, GROUP7/S, GROUP8/S, SELECT/S, EXTERNAL/K @{b}Function:@{ub} A new address is created using the provided data. @{b}Argument description:@{ub} @{b}*@{ub} SALUTATION Salutation @{b}*@{ub} FIRST First name @{b}*@{ub} NAME Name @{b}*@{ub} STREET Street @{b}*@{ub} CO c/o @{b}*@{ub} ZIP Postal code @{b}*@{ub} CITY City @{b}*@{ub} STATE State @{b}*@{ub} COUNTRY Country @{b}*@{ub} BIRTHDAY Birthday @{b}*@{ub} PHONE Phone number @{b}*@{ub} FAX Telefax number @{b}*@{ub} EMAIL1 EMail address No. 1 @{b}*@{ub} EMAIL2 EMail address No. 2 @{b}*@{ub} EMAIL3 EMail address No. 3 @{b}*@{ub} COMMENT Comment @{b}*@{ub} GROUP1 Group No. 1 @{b}*@{ub} GROUP2 Group No. 2 @{b}*@{ub} GROUP3 Group No. 3 @{b}*@{ub} GROUP4 Group No. 4 @{b}*@{ub} GROUP5 Group No. 5 @{b}*@{ub} GROUP6 Group No. 6 @{b}*@{ub} GROUP7 Group No. 7 @{b}*@{ub} GROUP8 Group No. 8 @{b}*@{ub} SELECT Selection state, i.e. @{b}0@{ub} or @{b}1@{ub}. @{b}*@{ub} EXTERNAL The @{b}filename@{ub} of the external file. @EndNode @Node "NEWFILE" "dfa.guide/NEWFILE" @Next "NEXT" @Prev "NEW" @Toc "ArexxCommands" The NEWFILE Command ................... @{b}Syntax:@{ub} NEWFILE [] [FORCE] [PROMPT] @{b}Argument template:@{ub} FILENAME, FORCE/S, PROMPT/S @{b}Function:@{ub} This command makes it possible to create a new address file. The command fails, if the previously loaded address file has been modifed. This behaviour can be changed by giving the @{b}FORCE@{ub} option additionally. Using the parameter @{b}PROMPT@{ub} enables a file requester to input the new filename. @{b}Argument description:@{ub} @{b}*@{ub} FILENAME New filename. @{b}*@{ub} FORCE Forces the creation of the new file, even if the old address file has been modified. @{b}*@{ub} PROMPT Supplies a file requester to input the new filename. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NODIR @{b}*@{ub} RXERR_NOEXTERNAL @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKNEW @EndNode @Node "NEXT" "dfa.guide/NEXT" @Next "NEXTSEL" @Prev "NEWFILE" @Toc "ArexxCommands" The NEXT Command ................ @{b}Syntax:@{ub} NEXT [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The next address becomes the current one and is returned. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NONEXT @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "NEXTSEL" "dfa.guide/NEXTSEL" @Next "OPENEDITWINDOW" @Prev "NEXT" @Toc "ArexxCommands" The NEXTSEL Command ................... @{b}Syntax:@{ub} NEXTSEL [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The next selected address becomes the current one and is returned. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NONEXTSEL @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "OPENEDITWINDOW" "dfa.guide/OPENEDITWINDOW" @Next "POPUP" @Prev "NEXTSEL" @Toc "ArexxCommands" The OPENEDITWINDOW Command .......................... @{b}Syntax:@{ub} OPENEDITWINDOW @{b}Argument template:@{ub} @{b}Function:@{ub} The @{b}Edit@{ub} window is opened and the current address is displayed, if there is one. The execution of the Arexx script is halted until the @{b}Edit@{ub} window is closed. @{b}Argument description:@{ub} - @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_CURRENT @{b}Warning:@{ub} The @{b}Edit@{ub} window is opened only if there is a current address, otherwise an error code is returned (see above). @EndNode @Node "POPUP" "dfa.guide/POPUP" @Next "PREV" @Prev "OPENEDITWINDOW" @Toc "ArexxCommands" The POPUP Command ................. @{b}Syntax:@{ub} POPUP @{b}Function:@{ub} If the @{b}DFA-Editor@{ub} doesn't run up to now, it is started. Then it opens its main window. If the @{b}DFA-Editor@{ub} is already running, it comes to front. @EndNode @Node "PREV" "dfa.guide/PREV" @Next "PREVSEL" @Prev "POPUP" @Toc "ArexxCommands" The PREV Command ................ @{b}Syntax:@{ub} PREV [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The previous address becomes the current one and is returned. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOPREV @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "PREVSEL" "dfa.guide/PREVSEL" @Next "PRINT" @Prev "PREV" @Toc "ArexxCommands" The PREVSEL Command ................... @{b}Syntax:@{ub} PREVSEL [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} The previously selected address becomes the current one and is returned. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOPREVSEL @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "PRINT" "dfa.guide/PRINT" @Next "SAVE" @Prev "PREVSEL" @Toc "ArexxCommands" The PRINT Command ................. @{b}Syntax:@{ub} PRINT [WHICH ] [FILE ] [NLQ] [CONDENSED] [FORMFEED] [
] @{b}Argument template:@{ub} WHICH/K, FILE/K, NLQ/S, CONDENSED/S, FORMFEED/S, FORM/N @{b}Function:@{ub} Prints the desired addresses. @{b}Argument description:@{ub} @{b}*@{ub} WHICH @{b}WHICH@{ub} can get the following keywords: @{b}ALL@{ub} All addresses are printed @{b}SELECTED@{ub} Only the selected addresses are printed @{b}ACTIVE@{ub} Only the active entry (if there is one) is printed. @{b}*@{ub} FILE the @{b}FILE@{ub} parameter gets a filename. To this file the addresses are written instead of printed on the printer. @{b}*@{ub} NLQ Prints the addresses in @{b}NLQ@{ub} @{b}*@{ub} CONDENSED Prints the addresses in condensed mode @{b}*@{ub} FORMFEED After the last address, which has been printed, a formfeed is performed. The settings from the @{b}DFA-Editor@{ub} print window are not taken! @{b}*@{ub} FORM the @{b}FORM@{ub} keyword can get the numbers @{b}0@{ub} through @{b}4@{ub}. These numbers have the same meaning as the order of the print forms in the print window, but starting with @{b}0@{ub} instead of @{b}1@{ub}. 0: Short address list 1: Long address list 2: Telephone list 3: mailing labels, [70mm x 46mm] 4: address cards @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_SYNTAX @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_OPNPRT @{b}*@{ub} RXERR_CRTEXTIO @{b}*@{ub} RXERR_CRTPORT @{b}*@{ub} RXERR_WRITEALL @{b}*@{ub} RXERR_WRITESEL @{b}*@{ub} RXERR_WRITECURRENT @EndNode @Node "SAVE" "dfa.guide/SAVE" @Next "SAVEAS" @Prev "PRINT" @Toc "ArexxCommands" The SAVE Command ................ @{b}Syntax:@{ub} SAVE @{b}Function:@{ub} The addresses are saved under their current name. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKSAVE @EndNode @Node "SAVEAS" "dfa.guide/SAVEAS" @Next "SAVEASDEFAULT" @Prev "SAVE" @Toc "ArexxCommands" The SAVEAS Command .................. @{b}Syntax:@{ub} SAVEAS [FILENAME] [FORCE] [PROMPT] @{b}Argument template:@{ub} FILENAME, FORCE/S, PROMPT/S @{b}Function:@{ub} The addresses are saved under the given name. @{b}Argument description:@{ub} @{b}*@{ub} FILENAME Name of the address file to save. @{b}*@{ub} FORCE Saves the addresses even if they have @{b}not@{ub} been changed before. @{b}*@{ub} PROMPT Supplies a file requester, which may be used to select the name of the address file to be saved. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NONETWORKSAVE @{b}*@{ub} RXERR_NOSAVE @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "SAVEASDEFAULT" "dfa.guide/SAVEASDEFAULT" @Next "SEARCH" @Prev "SAVEAS" @Toc "ArexxCommands" The SAVEASDEFAULT Command ......................... @{b}Syntax:@{ub} SAVEASDEFAULT @{b}Function:@{ub} The addresses are saved under the default name that you entered in the @{b}DFA-Preferences@{ub} (default name: @{b}s:adr.file@{ub}). @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NONETWORKSAVE @{b}*@{ub} RXERR_NOSAVE @{b}*@{ub} RXERR_ENVCHANGED @{b}Note:@{ub} Please use this command very carefully! If you've just loaded another than the default address file, the default address file is overwritten by this command! @EndNode @Node "SEARCH" "dfa.guide/SEARCH" @Next "SEARCHNEXT" @Prev "SAVEASDEFAULT" @Toc "ArexxCommands" The SEARCH Command .................. @{b}Syntax:@{ub} SEARCH [PATTERN] [IGNORECASE] [ALL] [SALUTATION] [FIRST] [NAME] [STREET] [CO] [ZIP] [CITY] [STATE] [COUNTRY] [BIRTHDAY] [PHONE] [FAX] [EMAIL1] [EMAIL2] [EMAIL3] [COMMENT] [VAR ] [STEM ] @{b}Argument template:@{ub} PATTERN/A, IGNORECASE/S, ALL/S, SALUTATION/S, FIRST/S, NAME/S, STREET/S, CO/S, ZIP/S, CITY/S, STATE/S, COUNTRY/S, BIRTHDAY/S, PHONE/S, FAX/S, EMAIL1/S, EMAIL2/S, EMAIL3/S, COMMENT/S, VAR/K, STEM/K @{b}Function:@{ub} The given pattern is searched for. If an address fits into the pattern, it is returned. If the @{b}DFA-Editor@{ub} is currently open, the address list scrolls to the corresponding place. @{b}Argument description:@{ub} @{b}*@{ub} PATTERN A search pattern. The known patterns from the Shell, as for example @{b}#?@{ub} may (and must) be used. Please notice that partial strings are only found, if you put an @{b}#?@{ub} before and/or behind the string (see example for details)! A detailed description of possible search patterns can be found in @{"Search" Link "EditorSearch"}. @{b}*@{ub} IGNORECASE Upper and lower case is treated as the same. @{b}*@{ub} ALL All fields are searched. @{b}*@{ub} SALUTATION Only the @{b}Salutation@{ub} fields are searched through. @{b}*@{ub} FIRST Only the @{b}First@{ub} fields are searched through. @{b}*@{ub} NAME Only the @{b}Name@{ub} fields are searched through. @{b}*@{ub} STREET Only the @{b}Street@{ub} fields are searched through. @{b}*@{ub} CO Only the @{b}c/o@{ub} fields are searched through. @{b}*@{ub} ZIP Only the @{b}ZIP@{ub} fields are searched through. @{b}*@{ub} CITY Only the @{b}City@{ub} fields are searched through. @{b}*@{ub} STATE Only the @{b}State@{ub} fields are searched through. @{b}*@{ub} COUNTRY Only the @{b}Country@{ub} fields are searched through. @{b}*@{ub} BIRTHDAY Only the @{b}Birthday@{ub} fields are searched through. @{b}*@{ub} PHONE Only the @{b}Phone@{ub} fields are searched through. @{b}*@{ub} FAX Only the @{b}Fax@{ub} fields are searched through. @{b}*@{ub} EMAIL1 Only the @{b}EMail1@{ub} fields are searched through. @{b}*@{ub} EMAIL2 Only the @{b}EMail2@{ub} fields are searched through. @{b}*@{ub} EMAIL3 Only the @{b}EMail3@{ub} fields are searched through. @{b}*@{ub} COMMENT Only the @{b}Comment@{ub} fields are searched through. @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NOTFOUND @{b}Example:@{ub} /* * Look for all names beginning with @{b}M@{ub}. * Make no difference between upper and lower case. */ ADDRESS 'DFA' SEARCH 'M#?' IGNORECASE NAME @EndNode @Node "SEARCHNEXT" "dfa.guide/SEARCHNEXT" @Next "SELALL" @Prev "SEARCH" @Toc "ArexxCommands" The SEARCHNEXT Command ...................... @{b}Syntax:@{ub} SEARCHNEXT [VAR ] [STEM ] @{b}Argument template:@{ub} VAR/K, STEM/K @{b}Function:@{ub} Continue searching for the pattern given in @{b}SEARCH@{ub} before. If the search succeeded, the found address is returned. If the @{b}DFA-Editor@{ub} is currently running, the address listview is updated. @{b}Argument description:@{ub} @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .ADDRESS.COUNT @{b}*@{ub} .ADDRESS.x @{b}Note:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOTFOUND @{b}*@{ub} RXERR_ENVCHANGED @EndNode @Node "SELALL" "dfa.guide/SELALL" @Next "SELBYNAME" @Prev "SEARCHNEXT" @Toc "ArexxCommands" The SELALL Command .................. @{b}Syntax:@{ub} SELALL @{b}Function:@{ub} All addresses are selected. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKSELECT @{b}Note:@{ub} Only addresses that match the current group selection are selected. @EndNode @Node "SELBYNAME" "dfa.guide/SELBYNAME" @Next "SELECT" @Prev "SELALL" @Toc "ArexxCommands" The SELBYNAME Command ..................... @{b}Syntax:@{ub} SELBYNAME [PATTERN] @{b}Argument template:@{ub} PATTERN/A @{b}Function:@{ub} All addresses that match the given pattern are selected. Upper and lower case does not make a difference. @{b}Argument description:@{ub} @{b}*@{ub} PATTERN A pattern string. The description of such patterns can be found in @{"Search" Link "EditorSearch"}. @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKSELECT @{b}Note:@{ub} All fields of all addresses (that match the current group selection) are searched through. @EndNode @Node "SELECT" "dfa.guide/SELECT" @Next "SORT" @Prev "SELBYNAME" @Toc "ArexxCommands" The SELECT Command .................. @{b}Syntax:@{ub} SELECT [QUERY] [VAR ] [STEM ] @{b}Argument template:@{ub} QUERY/S, VAR/K, STEM/K @{b}Function:@{ub} The current entry (if there is one) is selected. If you supply the @{b}QUERY@{ub} parameter, the current address is @{b}not@{ub} selected, but its selection state (@{b}0@{ub} or @{b}1@{ub}) is returned. @{b}Argument description:@{ub} @{b}*@{ub} QUERY @{b}*@{ub} VAR @{b}*@{ub} STEM @{b}Results:@{ub} @{b}*@{ub} .SELECTED The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_NOCURRENT @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKSELECT @EndNode @Node "SORT" "dfa.guide/SORT" @Prev "SELECT" @Toc "ArexxCommands" The SORT Command ................ @{b}Syntax:@{ub} SORT [SORT1 ] [SORT2 ] [SORT3 ] [SORT4 ] @{b}Argument template:@{ub} SORT1/K, SORT2/K, SORT3/K, SORT4/K @{b}Function:@{ub} The addresses are sorted according to the sort criteria given in the @{b}DFA-Preferences@{ub}. Alternatively you may explicitely give the search criteria by which you would like your addresses be sorted. @{b}Argument description:@{ub} @{b}*@{ub} SORT1 @{b}*@{ub} SORT2 @{b}*@{ub} SORT3 @{b}*@{ub} SORT4 The following keywords are supported for the @{b}Sort@{ub} parameters: - SALUTATION - FIRST - NAME - CO - STREET - ZIP - CITY - STATE - COUNTRY - BIRTHDAY - PHONE - FAX - EMAIL1 - EMAIL2 - EMAIL3 - COMMENT @{b}Results:@{ub} The following error codes can be returned in @{b}RC2@{ub}: @{b}*@{ub} RXERR_ENVCHANGED @{b}*@{ub} RXERR_NONETWORKSORT @EndNode @Node "ArexxErrorCodes" "dfa.guide/ArexxErrorCodes" @Prev "ArexxCommands" @Toc "Arexx" Error Codes ----------- Besides the usual error code that can be found in the @{b}RC@{ub} variable (1) the AREXX interface of DFA returns a second return value in the variable @{b}RC2@{ub}, which describes in further detail what has gone wrong. Bolow you'll find the error numbers and their meaning: @{b}Symbolic Name@{ub} @{b}Meaning@{ub} 10 RXERR_NONETWORKAPPEND....Could not append file, as the network mode is activated 11 RXERR_MODIFIED...........The address file has been changed 12 RXERR_NOFILENAME.........No filename has been supplied 13 RXERR_NOCURRENT..........No current address available 14 RXERR_NOFIRST............No first address available 15 RXERR_NOICONIFY..........Iconifying the Editor went wrong 16 RXERR_NONETWORKKILL......Deleting addresses is not allowed while in network mode 17 RXERR_NOLAST.............There is no last address 18 RXERR_NOLOAD.............The address file could not be loaded 19 RXERR_NONETWORKNEW.......It is not possible to enter new addresses in network mode 20 RXERR_NONEXT.............There is no next address 21 RXERR_NONEXTSEL..........There is no next selected address 22 RXERR_NOPREV.............There is no previous address 23 RXERR_NOPREVSEL..........There is no previous selected address 24 RXERR_SYNTAX.............The AREXX command contained an syntax error 25 RXERR_WRITEALL...........The "printing" of addresses (all) into a file went wrong 26 RXERR_WRITESEL...........The "printing" of addresses (selected) into a file went wrong 27 RXERR_WRITECURRENT.......The "printing" of the current address into a file went wrong 28 RXERR_NOSAVE.............The address file could not be saved 29 RXERR_NONETWORKSAVE......Saving your address database is not allowed in network mode 30 RXERR_NOTFOUND...........The wanted address could not be found 31 RXERR_NONETWORKCLEAR.....Deselecting addresses is not allowed while being in network mode 32 RXERR_NONETWORKSELECT....Selecting addresses is not allowed in network mode 33 RXERR_NONETWORKSORT......Sorting addresses is not allowed while being in network mode 34 RXERR_NONETWORKEDIT......Editing addressen is not allowed while being in network mode 35 RXERR_OPNPRT.............Could not open printer device 36 RXERR_CRTEXTIO...........Could not reach the printer (ExtIO could not be initialized) 37 RXERR_CRTPORT............Could not reach the printer (Could not open message port) 38 RXERR_NOMEM..............No more RAM available 39 RXERR_NORELOAD...........Reloading the address file went wrong 40 RXERR_NOWRITELOCK........could not get write access to the address file 41 RXERR_NODIR..............Could not locate the needed drawer 42 RXERR_NOFILE.............Could not find the address file 43 RXERR_APPENDFAILED.......Appending an address file went wrong 44 RXERR_ENVCHANGED.........Execution of the current AREXX command has been canceled, as the environment changed (e.g. new address file) 45 RXERR_NOEXTERNAL.........Trying to access the external file had no success 46 RXERR_NOSERIALDEV........Could not open serial device 47 RXERR_NOPHONENUM.........Current address doesn't have a phone number 48 RXERR_SERNOCARRIER.......Phone: No Carrier 49 RXERR_SERNODIALTONE......Phone: No dialtone 50 RXERR_SERRING............Phone: Ring 51 RXERR_SERBUSY............Phone: Line is busy 52 RXERR_SEROK..............Phone: Modem sent 'Ok' 53 RXERR_SERERROR...........Phone: Modem recognized an error 54 RXERR_SERCONNECT.........Phone: Data connect 55 RXERR_SERVOICE...........Phone: Voice connect 56 RXERR_SERUNKNOWN.........Error caused by the serial device ---------- Footnotes ---------- (1) cf. AREXX User's Reference Manual, William S. Hawes, P.O. Box 308, Maynard, MA 01754 @EndNode @Node "DFAEditor" "dfa.guide/DFAEditor" @Toc "Main" The DFA-Editor program ********************** The @{b}DFA-Editor@{ub} is the graphical user interface of @{b}DFA@{ub}. It can be started seperately or may be invoked (by the hotkey for example) out of the @{b}DFA-Server@{ub}. @{" Tooltypes " Link "EditorTooltypes"} @{" CLI-Parameter " Link "EditorCLIParams"} @{" Main Window " Link "EditorMainWindow"} @{" Tool Gadgets " Link "EditorTools"} The Gadget row @{" Menus " Link "EditorMenus"} Menus of the main window @{" Full " Link "EditorFull"} The Full window @{" Edit " Link "EditorEdit"} The Edit window @{" New " Link "EditorNew"} The New window @{" Search " Link "EditorSearch"} The Search window @{" Print " Link "EditorPrint"} The Print window @{" Dial " Link "EditorDial"} The Dial window @EndNode @Node "EditorTooltypes" "dfa.guide/EditorTooltypes" @Next "EditorCLIParams" @Toc "DFAEditor" Tooltypes ========= If you click once on the @{b}DFA-Editor@{ub} icon and then activate the Information program of the Workbench, you may adjust the following tooltypes: @{b}*@{ub} @{b}@{b}PUBSCREEN@{ub}@{ub} If you enter the @{b}name@{ub} of a public screen together with this tooltype, you may select an alternate (public) screen for the @{b}DFA-Editor@{ub} to open on. For example: PUBSCREEN=TERM If the given public screen exists when the @{b}DFA-Editor@{ub} comes up, it opens its window(s) on this screen, otherwise on the default public screen, usually the Workbench screen. @{b}*@{ub} @{b}@{b}UPPERPUBSCREEN@{ub}@{ub} If you enter @{b}UPPERPUBSCREEN=YES@{ub}, you tell the @{b}DFA-Editor@{ub} to open its window(s) on the frontmost @{b}public@{ub} screen. If the current frontmost screen isn't public, the @{b}DFA-Editor@{ub} comes up on the screen you selected with the tooltype @{b}PUBSCREEN@{ub}; if this fails as well, the @{b}DFA-Editor@{ub} opens its window(s) on the default public screen. @{b}*@{ub} @{b}@{b}GUIDEFILE@{ub}@{ub} To make the online help work, the @{b}DFA-Editor@{ub} has to know where to find the online help file. This can be done via the tooltype @{b}GUIDEFILE@{ub}. This tooltype is usually already be set by the install program. @{b}*@{ub} @{b}@{b}DFAPREFS@{ub}@{ub} As the @{b}DFA-Preferences@{ub} program can be started directly out of the @{b}DFA-Editor@{ub}, the @{b}DFA-Editor@{ub} has to know where to find the @{b}DFA-Preferences@{ub} program. The complete path name must be given with the tooltype @{b}DFAPREFS@{ub} and is already set by the install program usually. @EndNode @Node "EditorCLIParams" "dfa.guide/EditorCLIParams" @Next "EditorMainWindow" @Prev "EditorTooltypes" @Toc "DFAEditor" CLI parameter ============= If you start the @{b}DFA-Editor@{ub} from the shell (or the CLI), it uses the @{b}tooltypes@{ub} of the corresponding @{b}.info@{ub} file! However, you may overwrite these setting by giving one or more of the following CLI parameters: PUBSCREEN/K,UPPERPUBSCREEN/K,GUIDEFILE/K,DFAPREFS/K This means, you may use... ... @{b}DFAEditor PUBSCREEN=TERM@{ub} to make the @{b}DFA-Editor@{ub} open its window(s) on the public screen named @{b}TERM@{ub}. ... @{b}DFAEditor UPPERPUBSCREEN=YES@{ub} to make the @{b}DFA-Editor@{ub} open its window(s) on the frontmost screen, as long as this is a public screen. ... @{b}DFAEditor GUIDEFILE=Help:DFAEditor.guide@{ub} to set another path for the online help file. ... @{b}DFAEditor DFAPREFS=C:DFAPrefs@{ub} to set another path for the call of the @{b}DFA-Preferences@{ub} program. @EndNode @Node "EditorMainWindow" "dfa.guide/EditorMainWindow" @Next "EditorTools" @Prev "EditorCLIParams" @Toc "DFAEditor" The Main Window =============== The main window of the @{b}DFA-Editor@{ub} can be resized using the sizing gadget on the lower right corner of the window. The window contents automatically adapts on the new window dimensions. As the main window is a socalled application window you may drag the icon of an address file on this window and drop it, to let the @{b}DFA-Editor@{ub} load the corresponding address file. The main window of the @{b}DFA-Editor@{ub} gives you the following possibilities: @{b}*@{ub} @{b}The address listview@{ub} The address listview displays the stored addresses that are available as soon as you entered some (more details about this subject later on). This listview can be controlled by mouse as usual or completely by keyboard: Cursor down The next address becomes the current one. SHIFT+Cursor down The list scrolls @{b}up@{ub} by one page. CRTL+Cursor down The last address becomes the current one. Cursor up The previous address becomes the current one. SHIFT+Cursor up The list scrolls @{b}down@{ub} by one page. CRTL+Cursor up The first address becomes the current one. The current entry is selected. SPACE To make this state visible, the current entry is leaded by a @{b}>@{ub} character. RETURN Activates the @{b}Full@{ub} window, as long as there is an active address item. SHIFT+RETURN Activates the @{b}Edit@{ub} wenster, as long as there is an active address item. SHIFT+SPACE Set the start of the block or the end of the block respectively You may select entries of the address list with @{b}Shift Left Mousebutton@{ub} or @{b}Middle Mousebutton Left Mousebutton@{ub} (3-Button mouse needed); alternatively you may hit @{b}SPACE@{ub} on the keyboard. If you hit @{b}RETURN@{ub}, it has the same effect as if you had selected the @{b}Full@{ub} button: The current address is displayed in another window in further detail (please see @{"Full" Link "EditorFull"} for details). Synonymously you may hit @{b}SHIFT RETURN@{ub} to envoce the @{b}Edit@{ub} window (see @{"Edit" Link "EditorEdit"}). @{b}SHIFT RETURN@{ub} sets the start of the block or -- if you've already set it previously -- the end of the block. After the block end is set, the selection state of all items between start end end of the block is toggled, i.e. the selected addresses become deselected and vice versa. The same result can be reached, if you use the left mouse button together with the @{b}SHIFT@{ub} qualifier. Please notice that you may change the fields of the addresses that are displayed in the address listview using the @{b}DFA-Preferences@{ub} program. @{b}*@{ub} @{b}Der Panel-Listview@{ub} Below the address listview you find another listview. It is used to display some more fields of the current address item. If you use the default settings you'll see the phone number, the three email addresses and the comment. However, by using the @{b}DFA-Preferences@{ub} program you may change the contents of these lines! As this listview doesn't have a title and for this reason no shortcut either, you may scroll it using the following keys: ALT+Cursor down The list scrolls @{b}up@{ub} by one line. ALT+Cursor up The list scrolls @{b}down@{ub} by one line. Of course, the list can only be scrolled if there is 1st an active entry and 2nd more lines to display than visible at the same time. The contents of this listview can be configured in quite a wide range (see @{b}DFA-Preferences@{ub}: Panel Listview, for details). Just below the the address listview there are four buttons that may be used to change the selection of the displayed addresses: @{b}*@{ub} @{b}All@{ub} Selects all displayed addresses. @{b}*@{ub} @{b}By name@{ub} A window is opened in which you may enter a search pattern (case insensitive!). After you hit @{b}Ok@{ub} (or @{b}RETURN@{ub}) all entries of the address list are selected that match the pattern. The difference to the @{b}Search@{ub} function is that 1st you can't toggle case sensitivity and 2nd all address fields are searched through. Furthermore all matching items are @{b}marked@{ub} and the first matching item is activated. A detailed description of the allowed search patterns can be found in @{"Search" Link "EditorSearch"}. @{b}*@{ub} @{b}Clear@{ub} All selected addresses are deselected. @{b}*@{ub} @{b}Jump to@{ub} The next selected entry becomes the current one, as long as there is at least one selected entry left. At the lower end of the main window of the @{b}DFA-Editor@{ub} you can find the gadgets @{b}Quit@{ub} and @{b}Remove@{ub}. If you hit @{b}Quit@{ub} the @{b}DFA-Editor@{ub} is terminated! The @{b}DFA-Server@{ub}, if it is currently running, is not ended however, so you can still reach the @{b}DFA-Editor@{ub} by a doubleclick on the application icon and/or the hotkey (default: @{b}Left Amiga F5@{ub}) If you select @{b}Remove@{ub}, not only the @{b}DFA-Editor@{ub} is ended, but although a currently running @{b}DFA-Server@{ub}. If you terminate the @{b}DFA-Editor@{ub} using @{b}Quit@{ub} or @{b}Remove@{ub}, the addresses are saved if they had been modified before. This behaviour can be customized in the @{b}DFA-Preferences@{ub} however. @EndNode @Node "EditorTools" "dfa.guide/EditorTools" @Next "EditorMenus" @Prev "EditorMainWindow" @Toc "DFAEditor" Tool Gadgets ============ It is possible reach the socalled tool gadgets from the @{b}DFA-Editor@{ub}. Using these gadgets you can easily reach the following functions : @{b}*@{ub} @{b}Full@{ub} Shows the current entry in another window in great detail; see @{"Full" Link "EditorFull"}, for details. @{b}*@{ub} @{b}Edit@{ub} If you hit @{b}Edit@{ub}, you may change the current entry. If there is no current address, this button is displayed "ghosted" and can't be selected (cf. @{"Edit" Link "EditorEdit"}). @{b}*@{ub} @{b}New@{ub} If you select @{b}New@{ub}, you may enter a @{b}new@{ub} address. The functions within this window are exactly the same as within the @{b}Edit@{ub} window; see @{"Edit" Link "EditorEdit"} for details. @{b}*@{ub} @{b}Kill@{ub} Kill can either be used to delete the current entry (if there is one) or all marked entries. To make sure that nobody deletes precious addresses, a safety requester pops up! @{b}*@{ub} @{b}Search@{ub} Another window pops up, in which you may enter a search string as well as some other search related settings (cf. @{"Search" Link "EditorSearch"}). @{b}*@{ub} @{b}Search Next@{ub} @{b}Search Next@{ub} can be selected only, if there has been given a search pattern previously using the @{b}Search@{ub} function. If this is the case, the next matching entry is displayed (not marked!). @{b}*@{ub} @{b}Print@{ub} After you have selected @{b}Print@{ub}, another window pops up, which gives you several ways to print your addresses, as it is described in @{"Print" Link "EditorPrint"}. @{b}*@{ub} @{b}Sort@{ub} @{b}Sort@{ub} sorts the complete address list. As long as you use the default setting the list is sorted by name, first name and city (in this order). If you prefer another sort order, you may change it in the @{b}DFA-Preferences@{ub}. @{b}*@{ub} @{b}Dial@{ub} Another window pops up, which allows you to dial phone numbers (cf. @{"Dial" Link "EditorDial"}). Please notice that there is a corresponding menu item for every tool gadget. All functions can therefore be reached by keyboard shortcuts as well! @EndNode @Node "EditorMenus" "dfa.guide/EditorMenus" @Next "EditorFull" @Prev "EditorTools" @Toc "DFAEditor" The Menu Items ============== @{b}Project Menu@{ub} @{" About " Link "EditorMenuAbout"} @{" Info " Link "EditorMenuInfo"} @{" New file " Link "EditorMenuNewFile"} @{" Open " Link "EditorMenuOpen"} @{" Append " Link "EditorMenuAppend"} @{" Save " Link "EditorMenuSave"} @{" Save as... " Link "EditorMenuSaveas"} @{" Save as default " Link "EditorMenuSaveasdefault"} @{" Quit " Link "EditorMenuQuit"} @{" Remove " Link "EditorMenuRemove"} @{b}Edit Menu@{ub} @{" Full " Link "EditorMenuFull"} @{" Edit " Link "EditorMenuEdit"} @{" New " Link "EditorMenuNew"} @{" Kill " Link "EditorMenuKill"} @{" Copy to Clipboard " Link "EditorMenuCopyToClip"} @{" (Un)set Groups " Link "EditorMenuSetGroups"} @{b}Misc Menu@{ub} @{" Search " Link "EditorMenuSearch"} @{" Search Next " Link "EditorMenuSearchNext"} @{" Print " Link "EditorMenuPrint"} @{" Sort " Link "EditorMenuSort"} @{" Dial " Link "EditorMenuDial"} @{b}Settings Menu@{ub} @{" Preferences " Link "EditorMenuPreferences"} @{" Edit Template " Link "EditorMenuEditTemplate"} @{" Write Access " Link "EditorMenuWriteAccess"} @{" Save Preferences " Link "EditorMenuSavePrefs"} @EndNode @Node "EditorMenuAbout" "dfa.guide/EditorMenuAbout" @Next "EditorMenuInfo" @Toc "EditorMenus" About ----- The @{b}About@{ub} window gives you some useful informations about the program and the author: @{b}*@{ub} The version number and a corresponding remark, if you got a registered version. @{b}*@{ub} The copyright notice and the author's address (incl. email addresses). @{b}*@{ub} Your name and your address, as well as the serial number of the program, if you are a registered user. @EndNode @Node "EditorMenuInfo" "dfa.guide/EditorMenuInfo" @Next "EditorMenuNewFile" @Prev "EditorMenuAbout" @Toc "EditorMenus" The window which pops up as soon as you select the @{b}Info@{ub} menu item gives you some useful informations: @{b}*@{ub} @{b}Arexx Port@{ub} In this field you can look up the name of @{b}DFA@{ub}'s AREXX port. Usually this is @{b}DFA@{ub}. However, you can change the portname by changing the @{b}PORTNAME@{ub} tooltype (of the @{b}DFA@{ub} server program!) If you have already started a program that uses the portname @{b}DFA@{ub}, @{b}DFA@{ub} adapts the portname by appending "numbers" (e.g. @{b}DFA.1@{ub}, @{b}DFA.2@{ub},...) until a clear portname is found. @{b}*@{ub} @{b}Addresses@{ub} The number of the currently loaded address is displayed here. The first number (@{b}d@{ub} means displayed) is the number of actually displayed entries, the second number (@{b}a@{ub} means available) is the number of addresses available. @{b}*@{ub} @{b}Memory Condition@{ub} The three fields give a quite detailed report about the current memory condition. @EndNode @Node "EditorMenuNewFile" "dfa.guide/EditorMenuNewFile" @Next "EditorMenuOpen" @Prev "EditorMenuInfo" @Toc "EditorMenus" New file -------- If you want to create a @{b}new@{ub}, i.e. @{b}empty@{ub} address file, you may use this menu item. A new address file named unnamed.dfa is created then. You may use the @{b}Save as...@{ub} menu item to save this address file under another name. @{b}Be careful:@{ub} Please do never use @{b}Save as default@{ub} after you created a new file to save it, as the new address file (the empty one!) would overwrite your old "default" address file, which means that the old addresses would have been lost! @EndNode @Node "EditorMenuOpen" "dfa.guide/EditorMenuOpen" @Next "EditorMenuAppend" @Prev "EditorMenuNewFile" @Toc "EditorMenus" Use @{b}Open@{ub} to load another address file. The currently loaded addresses are not kept in memory but replaced by the loaded! After you selected @{b}Load@{ub}, a file requester pops up, which lets you enter the address file. Notice that only files can be loaded, which have the proper format -- files that have been created by @{b}DFA@{ub} before! Files with the wrong format can't be loaded by @{b}DFA@{ub} and the already loaded addresses keep unchanged! @EndNode @Node "EditorMenuAppend" "dfa.guide/EditorMenuAppend" @Next "EditorMenuSave" @Prev "EditorMenuOpen" @Toc "EditorMenus" Append ------ @{b}Append@{ub} allows you to append further addresses to the existing ones. The already loaded addresses are @{b}not@{ub} deleted before. Be careful! If you append two identical address lists, every entry will appear twice, which is usually not desired. It is possible to set the group selection for the addresses that are to be appended in the little window that appears after you selected @{b}Append@{ub}. These group selection flags are set to all addresses that shall be loaded! Please notice that already existing group flags of addresses in the file to append are @{b}not@{ub} erased! This means that you may only add new group flags to the addresses but not unset existing ones! @{b}Ok@{ub} accepts the set group selection and appends the selected address file; @{b}Cancel@{ub} not only cancels the group selection but the complete appending procedure, i.e. no addresses are appended! @EndNode @Node "EditorMenuSave" "dfa.guide/EditorMenuSave" @Next "EditorMenuSaveas" @Prev "EditorMenuAppend" @Toc "EditorMenus" @{b}Save@{ub} saves the addresses under the current name. The current name is either the one you entered in the preferences (default: @{b}s:adr.file@{ub}) or the one you selected before when loading an address file. @EndNode @Node "EditorMenuSaveas" "dfa.guide/EditorMenuSaveas" @Next "EditorMenuSaveasdefault" @Prev "EditorMenuSave" @Toc "EditorMenus" Save as... ---------- @{b}Save as@{ub} saves the address as well. However, you are able to select a filename before (a file requester pops up). This may be useful, if you have several address files for different purposes or you've created a new address file just before (cf. @{"New file" Link "EditorMenuNewFile"}) and want to enter a new name for your address file. @EndNode @Node "EditorMenuSaveasdefault" "dfa.guide/EditorMenuSaveasdefault" @Next "EditorMenuQuit" @Prev "EditorMenuSaveas" @Toc "EditorMenus" Save as default --------------- The addresses will be saved under the name specified in the preferences (default: @{b}s:adr.file@{ub}), if you select @{b}Save as default@{ub}, even if you loaded a file with another name before. @{b}Be careful:@{ub} If you have loaded an address file with another but the default name before (or you've created a new address file), you should not use @{b}Save as default@{ub} in any case, as the current address file would overwrite the default address file. @EndNode @Node "EditorMenuQuit" "dfa.guide/EditorMenuQuit" @Next "EditorMenuRemove" @Prev "EditorMenuSaveasdefault" @Toc "EditorMenus" @{b}Quit@{ub} ends the @{b}DFA-Editor@{ub}! The @{b}DFA-Server@{ub}, if it is currently running, is not ended, so it the @{b}DFA-Editor@{ub} still can be reached by a double click on the application icon or by the hotkey (Default: @{b}Left Amiga F5@{ub}). @EndNode @Node "EditorMenuRemove" "dfa.guide/EditorMenuRemove" @Next "EditorMenuFull" @Prev "EditorMenuQuit" @Toc "EditorMenus" Remove ------ Select @{b}Remove@{ub} to end not only the @{b}DFA-Editor@{ub} but a currently running @{b}DFA-Server@{ub} as well. If you end the @{b}DFA-Editor@{ub} using @{b}Quit@{ub} or @{b}Remove DFA@{ub}, the addresses are saved, if they have been modified before. This behaviour can be customized in the @{b}DFA-Preferences@{ub} program however. @EndNode @Node "EditorMenuFull" "dfa.guide/EditorMenuFull" @Next "EditorMenuEdit" @Prev "EditorMenuRemove" @Toc "EditorMenus" Shows the current entry in a separate window. @{b}All@{ub} fields of the address are displayed here; See @{"Full" Link "EditorFull"}. @EndNode @Node "EditorMenuEdit" "dfa.guide/EditorMenuEdit" @Next "EditorMenuNew" @Prev "EditorMenuFull" @Toc "EditorMenus" Using @{b}Edit@{ub} gives you the chance to change the current address item, if there is one. If there is no current entry, the corresponding button is "ghosted" and can't be selected (see @{"Edit" Link "EditorEdit"}). @EndNode @Node "EditorMenuNew" "dfa.guide/EditorMenuNew" @Next "EditorMenuKill" @Prev "EditorMenuEdit" @Toc "EditorMenus" Select @{b}New@{ub} to enter a @{b}new@{ub} address. The functions inside of this window are exactly the same as within the @{b}Edit@{ub} window; see @{"Edit" Link "EditorEdit"} for details. @EndNode @Node "EditorMenuKill" "dfa.guide/EditorMenuKill" @Next "EditorMenuCopyToClip" @Prev "EditorMenuNew" @Toc "EditorMenus" Use @{b}Kill@{ub} to delete either the current entry (if there is one) or all marked addresses. To make sure that nobody deletes precious addresses, a savety requester pops up. @EndNode @Node "EditorMenuCopyToClip" "dfa.guide/EditorMenuCopyToClip" @Next "EditorMenuSetGroups" @Prev "EditorMenuKill" @Toc "EditorMenus" Copy to Clipboard ----------------- This function makes it possible to copy the @{b}current@{ub} address to the clipboard (unit 0). Every other program that supplies clipboard support, can access these data. @EndNode @Node "EditorMenuSetGroups" "dfa.guide/EditorMenuSetGroups" @Next "EditorMenuSearch" @Prev "EditorMenuCopyToClip" @Toc "EditorMenus" (Un)set Groups -------------- After you have selected this menu item, another window pops up that allows you to change the group flags of one, several or all addresses fast and comfortably. Using the upper eight group checkboxes, you can select, which group flags you want to have @{b}cleared@{ub}. The lower eight group checkboxes can be used to @{b}set@{ub} the corresponding group flags. To control even these gadgets by keyboard, you have to push the @{b}CRTL@{ub} key in addition to the shortcut itself. Please notice that these actions take effect only to the active addresses, i.e. the addresses that can be seen within the main address listview. Hit @{b}Active@{ub} to change the current address (if there exists one), @{b}Marked@{ub} to change all marked addresses and @{b}All@{ub} to (un)set the group flags of all (visible) addresses. @EndNode @Node "EditorMenuSearch" "dfa.guide/EditorMenuSearch" @Next "EditorMenuSearchNext" @Prev "EditorMenuSetGroups" @Toc "EditorMenus" Search ------ Another window pops up that allows you to enter several search criteria (cf. @{"Search" Link "EditorSearch"}): @EndNode @Node "EditorMenuSearchNext" "dfa.guide/EditorMenuSearchNext" @Next "EditorMenuPrint" @Prev "EditorMenuSearch" @Toc "EditorMenus" Search Next ----------- @{b}Search Next@{ub} can be selected only, if there has been given a search pattern previously using the @{b}Search@{ub} function. If this is the case, the next matching entry is displayed (not marked!). @EndNode @Node "EditorMenuPrint" "dfa.guide/EditorMenuPrint" @Next "EditorMenuSort" @Prev "EditorMenuSearchNext" @Toc "EditorMenus" Print ----- After you have selected @{b}Print@{ub}, another window pops up, which gives you several ways to print your addresses, as it is described in @{"Print" Link "EditorPrint"}. @EndNode @Node "EditorMenuSort" "dfa.guide/EditorMenuSort" @Next "EditorMenuDial" @Prev "EditorMenuPrint" @Toc "EditorMenus" @{b}Sort@{ub} sorts the complete address list. As long as you use the default setting, the list is sorted by name, first name and city (in this order). If you prefer another sort order, you may change it in the @{b}DFA-Preferences@{ub}. @EndNode @Node "EditorMenuDial" "dfa.guide/EditorMenuDial" @Next "EditorMenuPreferences" @Prev "EditorMenuSort" @Toc "EditorMenus" Another window pops up, which allows you to dial phone numbers (cf. @{"Dial" Link "EditorDial"}). @EndNode @Node "EditorMenuPreferences" "dfa.guide/EditorMenuPreferences" @Next "EditorMenuEditTemplate" @Prev "EditorMenuDial" @Toc "EditorMenus" Preferences ----------- The @{b}DFA-Preferences@{ub} program is loaded. Please notice that the tooltype @{b}DFAPREFS@{ub} of the @{b}DFA-Editor@{ub} has to be set correctly to enable the @{b}DFA-Editor@{ub} to find the @{b}DFA-Preferences@{ub} program! This has usually already been done by the install program. @EndNode @Node "EditorMenuEditTemplate" "dfa.guide/EditorMenuEditTemplate" @Next "EditorMenuWriteAccess" @Prev "EditorMenuPreferences" @Toc "EditorMenus" Edit Template ------------- The window that pops up will be quite familiar to you, as it is exactly the same as in @{"Edit" Link "EditorEdit"} or @{"New" Link "EditorNew"}. You may enter several @{b}presets@{ub} here, which are automatically copied into the corresponding fields, just before you enter a @{b}new@{ub} address. The template strings are saved in the address file, so it is possible to have different templates for every address file. @EndNode @Node "EditorMenuWriteAccess" "dfa.guide/EditorMenuWriteAccess" @Next "EditorMenuSavePrefs" @Prev "EditorMenuEditTemplate" @Toc "EditorMenus" Write Access ------------ This menu item can only be selected, if you have activated the network mode before. Starting with version 2.0, @{b}DFA@{ub} supplies a simple network mode. This network mode has been developed to make it possible that several connected computers can use the same address file. The problem that comes up, when an address file is used by more than one user at the same time is the following: If several users change the address file at the same time, the last saved address file overwrites the previously saved ones. The previously saved changes are lost! @{b}DFA@{ub} tries to solve this problem in the following way: If the network mode is active, all operations that change the address database are forbidden, i.e. saving, changing, marking of addresses is not possible. It is allowed however, to view the addresses (@{b}Full@{ub}), to scroll within the address list, to print the addresses and so on. If you want to do some changes on the addresses, you have to obtain write access to the address file. This can be done using the AREXX command @{b}ATTEMPTLOCK@{ub} or by selecting the menu item @{b}Write Access@{ub} in the @{b}DFA-Editor@{ub}. If your try to get write access was successful, you may change the addresses. If you've completed your changes, you should free the write access using either the AREXX command @{b}FREELOCK@{ub} or the menu item @{b}Write Access@{ub} in the @{b}DFA-Editor@{ub}. After you have done so, other members of the LAN can get write access to this address file. Please note that you will only get advantages out of the network mode, if you have really installed a network @{b}and@{ub} access the @{b}same@{ub} address file from different computers! Activating the network mode on a computer that is not connected to a network has no advantages at all! @EndNode @Node "EditorMenuSavePrefs" "dfa.guide/EditorMenuSavePrefs" @Prev "EditorMenuWriteAccess" @Toc "EditorMenus" Save Preferences ---------------- As the window coordinates and several other settings of the @{b}DFA-Editor@{ub} are saved together with the preferences that can be tuned in the @{b}DFA-Preferences@{ub} program, there is the opportunity to save the preferences not only from within the @{b}DFA-Preferences@{ub} program, but from the @{b}DFA-Editor@{ub} as well using this menu item. @EndNode @Node "EditorFull" "dfa.guide/EditorFull" @Next "EditorEdit" @Prev "EditorMenus" @Toc "DFAEditor" @{b}Full@{ub} can only be selected, if there is a current address! If this is the case, another window pops up (title: @{b}Full address...@{ub}), which displays @{b}all@{ub} fields of the current address. If there is an external file for the current address, you may select the @{b}View external@{ub} button to start the ASCII viewer together with the corresponding external file. Please notice that the ASCII viewer of your choice may be entered in the @{b}DFA-Preferences@{ub} program (cf. @{"Edit" Link "EditorEdit"}). The listview that displays the different fields of the current address may be scrolled as follows: Cursor down The listview scrolls @{b}up@{ub}. Cursor up The listview scrolls @{b}down@{ub}. Below this listview there is a gadget panel that may be used to step through the addresses: @{b}*@{ub} @{b}First@{ub} The first entry of the address list is displayed. Besides the underlined letter you may alternatively use @{b}CRTL + Cursor Left@{ub} as the corresponding gadget shortcut. @{b}*@{ub} @{b}Last@{ub} The last entry of the address list is displayed. Besides the underlined letter you may alternatively use @{b}CRTL + Cursor Right@{ub} as the corresponding gadget shortcut. @{b}*@{ub} @{b}Prev. Sel.@{ub} If there is a selected item infront of the current one, it is is displayed. Besides the underlined letter you may alternatively use @{b}SHIFT + Cursor Left@{ub} as the corresponding gadget shortcut. @{b}*@{ub} @{b}Next Sel.@{ub} If there is a selected item behind of the current one, it is is displayed. Besides the underlined letter you may alternatively use @{b}SHIFT + Cursor Right@{ub} as the corresponding gadget shortcut. @{b}*@{ub} @{b}Prev.@{ub} The previous entry of the address list is displayed. Besides the underlined letter you may alternatively use @{b}Cursor Left@{ub} as the corresponding gadget shortcut. @{b}*@{ub} @{b}Next@{ub} The next entry of the address list is displayed. Besides the underlined letter you may alternatively use @{b}Cursor Left@{ub} as the corresponding gadget shortcut. @{b}Ok@{ub} closes the window, @{b}Edit@{ub} opens the @{b}Edit@{ub} window. The @{b}Edit@{ub} window is described in further detail in @{"Edit" Link "EditorEdit"}. @EndNode @Node "EditorEdit" "dfa.guide/EditorEdit" @Next "EditorNew" @Prev "EditorFull" @Toc "DFAEditor" If there exists a current address (cf. @{"Full" Link "EditorFull"}), a window pops up, where you may change any part of the address. The string gadgets have some additional features compared to the "original" ones: - Hit @{b}RETURN@{ub} to end the input to the current gadget and go to the next string or integer gadget. You may use the @{b}ENTER@{ub} key alternatively. - Hit @{b}SHIFT@{ub} @{b}RETURN@{ub} to end the input to the current gadget and go to the @{b}previous@{ub} gadget. - @{b}CURSOR UP@{ub} or @{b}CURSOR DOWN@{ub} brings the cursor to the previous or next string gadget respectively. - Hit @{b}ESCAPE@{ub} to cancel the input completely. The window which contains the gadget is closed and all previous input is discarded. - If the cursor stands within a string gadget, the gadget shortcuts can be reached by hitting @{b}RIGHT AMIGA@{ub}-@{b}letter@{ub} and @{b}SHIFT@{ub}. If you don't hit @{b}SHIFT@{ub} additionally, the keyboard shortcut is used either by the internal string gadget edit features (like @{b}RIGHT AMIGA X@{ub} or @{b}RIGHT AMIGA Q@{ub}) or by additional tools (like @{b}NewList@{ub}). There exist the following fields: Address Address First First name Name Name c/o may be used for additional information Street Street/No. Zip Zip City City State State Country Country Birthday Birthday Phone Telphone number Fax Telefax number Email1 email address # 1 Email2 email address # 2 Email3 email address # 3 Comment Comment Please notice that it is possible to enter more than one phone number into the @{b}Phone@{ub} field. These numbers can be dialed correctly as well, as long as you separate them by a pipe sign (@{b}|@{ub}). Using the @{b}Address selected@{ub} checkbox you may set (or unset) the selection state of the current address. If you hit @{b}External@{ub} you activate the ASCII-Editor (default: @{b}ed@{ub}). This makes sense if you want to enter a long text (for example: How to find the way to Joe User, living in New York City). When you have finished your inputs, save the file with the @{b}given name@{ub} and quit the editor. The @{b}DFA-Editor@{ub} remembers the file name, so it is possible from now on, to access this external file e.g. from the @{b}Full@{ub} window (cf. @{"Full" Link "EditorFull"}) or from the @{b}Edit@{ub} window to modify it. As soon as the there is an external file for the current address item, the @{b}Del.@{ub} button can be reached that makes it possible to delete an external file as soon as you no longer need it. All external files get their unique file name by @{b}DFA@{ub}. This file name is guarantied to be @{b}unique@{ub} within the given directory (default: @{b}s:DFAExternals@{ub}). @{b}DFA@{ub} only saves the filename -- not the file itself, so this is completely up to you. Please do not change the filename given by @{b}DFA@{ub}, as if you do so, @{b}DFA@{ub} will no longer be able to find this file! If you want to delete one (or more) external files, you have to use the @{b}Del.@{ub} function of this window. This is the only way to make sure that not only the file itself is deleted, but the filename, which is stored by @{b}DFA@{ub} as well! You may set your favourite ASCII editor as well as the wanted directory for the external files in the @{b}DFA-Preferences@{ub} program. Hit @{b}Ok@{ub} to use the changes; if you select @{b}Cancel@{ub} instead, all changes are discarded. @EndNode @Node "EditorNew" "dfa.guide/EditorNew" @Next "EditorSearch" @Prev "EditorEdit" @Toc "DFAEditor" @{b}New@{ub} opens a window that looks exactly like the @{b}Edit@{ub} window! The templates (cf. @{"Edit Template" Link "EditorMenuEditTemplate"}) have been copied into the corresponding fields and you may enter a new address now. All functions within this window are the same as in the @{b}Edit@{ub} window (see @{"Edit" Link "EditorEdit"} for details). @EndNode @Node "EditorSearch" "dfa.guide/EditorSearch" @Next "EditorPrint" @Prev "EditorNew" @Toc "DFAEditor" Search ====== You may enter several search criteria in this window. @{b}*@{ub} @{b}Search for@{ub} Here you may enter the search pattern. You may (and must) use the known @{b}AMIGA@{ub} patterns. It is needed to enter infront of and behind the search string either a @{b}#?@{ub} or a @{b}*@{ub} if you want to look for partial strings! This means, you have to input @{b}#?PartialString#?@{ub} instead of @{b}PartialString@{ub}. Let's say you want to search for first names that start with @{b}Mi@{ub}, you have to enter @{b}Mi#?@{ub}. If you want to look for cities that end in @{b}town@{ub}, you have to enter @{b}#?town@{ub}. The following patterns are supported: ? The question mark matches any single character. For example, the pattern matching string @{b}A?B@{ub} matches any string that is three letters long, that starts with an @{b}A@{ub} and ends with a @{b}B@{ub}. # The number sign matches strings containing zero or more repetitions of the expression that immediately follows the @{b}#@{ub} in the pattern matching string. For example, the pattern matching string @{b}#A@{ub} matches any string that consists of one or more of the @{b}A@{ub} character. The pattern matching string @{b}#?@{ub} matches any non-NULL string. The @{b}#@{ub} can apply to entire substrings delimited by parentheses. For example, the pattern string @{b}#(AB)@{ub} matches any string consisting of one or more repetitions of the substring @{b}AB@{ub} (@{b}AB@{ub}, @{b}ABAB@{ub}, @{b}ABABAB@{ub},...). % Matches the NULL string. | This is the OR symbol. This matches strings that contain the expressions on either side of the OR sign. The expressions and the OR symbol need to be enclosed in parentheses. For example, the pattern matching string @{b}(A|B)@{ub} matches the string @{b}A@{ub} or the string @{b}B@{ub}. The pattern matching string @{b}A(B|%|C)@{ub} matches the strings @{b}AB@{ub}, @{b}A@{ub}, and @{b}AC@{ub}. ~ The tilde negates the expression that follows it. All strings that do not match the expression that follows the tilde will match the expression with the tilde. For example, the pattern matching string @{b}~(#?.info)@{ub} matches any string that does not match the string @{b}#?.info@{ub} (does not end with the substring @{b}.info@{ub}). * The star is provided as an synonym to @{b}#?@{ub}. [ ] All characters within brackets indicate a character class. Any character in the character class qualifies. Within a character class, a character range can be indicated by specifing the start and stop character, separated with a minus sign. Note that character classes are case sensitive. If character classes are to be used in a case insensitive form, they should be translated to uppercase. Here are some examples: [ACF]#? matches strings starting with @{b}A@{ub}, @{b}C@{ub}, or @{b}F@{ub} [A-D]#? matches strings starting with @{b}A@{ub}, @{b}B@{ub}, @{b}C@{ub} or @{b}D@{ub} [~ACF]#? matches strings @{b}not@{ub} starting with @{b}A@{ub}, @{b}C@{ub} or @{b}F@{ub} ' The quote character neutralizes the special meaning of a special character. Here are some examples: '#'? matches only the literal string @{b}#?@{ub} '?(A|B|C|%)'# matches the literal strings @{b}?#@{ub}, @{b}?A#@{ub}, @{b}?B#@{ub}, @{b}?C#@{ub} " The quote itself ( ) Parentheses group special characters. The expression within the parentheses is a subpattern. @{b}*@{ub} @{b}Ignore case@{ub} If the box is "checked", the search will not be case sensitive. If the box is empty however, case will be noticed. @{b}*@{ub} @{b}All@{ub} Select all fields. @{b}*@{ub} @{b}None@{ub} Deselects all fields. @{b}*@{ub} @{b}Fields to search@{ub} You may select which fields you would like to search through. It is possible to toggle each single field. The default is to search trough all fields. @{b}*@{ub} @{b}Search@{ub} @{b}Search@{ub} starts the searching. If a matching item is found, the address listview scrolls to the corresponding place and the matching entry becomes the current one. @{b}*@{ub} @{b}Cancel@{ub} @{b}Cancel@{ub} terminates the search. @EndNode @Node "EditorPrint" "dfa.guide/EditorPrint" @Next "EditorDial" @Prev "EditorSearch" @Toc "DFAEditor" Print ===== This window contains all functions that may be used to print the addresses. @{b}*@{ub} @{b}Print@{ub} You can choose between all (@{b}All@{ub}), the marked (@{b}Selected@{ub}) and the active address (@{b}Active@{ub}). If there is an active item, it will be shown in the @{b}Active Item@{ub} field. @{b}*@{ub} @{b}Print to@{ub} You can either print to the printer (@{b}PRT:@{ub}) or to a file (@{b}File@{ub}). If you print your addresses to a file, the settings below don't take effect. Notice that always all parts of an address are written to the file! @{b}*@{ub} @{b}Print style@{ub} You may choose, whether the addresses are to be printed in @{b}NLQ@{ub} or @{b}Condensed@{ub} style (or both). If you select @{b}Formfeed@{ub}, a formfeed is performed after the very @{b}last@{ub} printed address entry. To switch this off will be useful, if you want to print a few address labels only and you don't want to waste these sheets. @{b}*@{ub} @{b}Print form@{ub} There are five different forms, between which you may choose: - Short address list - Full address list - Phonelist (fixed columns) - Mailing labels (70mm x 36mm) - Address cards @{b}*@{ub} @{b}Print@{ub} If you did select @{b}File@{ub} for output, a file requester will be opened, which allows you to enter the filename. Be careful! This output file is @{b}not@{ub} compatible to the internal address file format (default: @{b}s:adr.file@{ub}); so don't overwrite this (these) file(s). To write the addresses to a file may be useful if you want to export addresses, but don't wan't to use AREXX. If you send your addresses to the printer (@{b}PRT:@{ub}), another window is opened that displays the progress of printing. You may stop the output after every complete address (@{b}Cancel@{ub}). If only the active item is printed, no progress indicator is shown. @{b}*@{ub} @{b}Cancel@{ub} @{b}Cancel@{ub} terminates the complete printing process. Please notice: Of course the possibilities of @{b}DFA@{ub} to print addresses are a bit limited and don't have any chance to compete with the facilities given by e.g. a DTP program. I think however that it does make much more sense to let programs print your addresses that are specialized in printing. Such programs give you much more features and often result in a much better printing quality than an address utility could ever reach. So @{b}DFA@{ub} should be used to supply the stored addresses to (spezialized) printing programs and not not print the addresses by itself. An ideal mean for this purpose is the AREXX port for sure, which is not only part of @{b}DFA@{ub}, but of many printing programs as well. Even if your favourite printing program doesn't have an AREXX port, you may use @{b}DFA@{ub}'s AREXX interface to export and format the address, so other programs can easily use them. @EndNode @Node "EditorDial" "dfa.guide/EditorDial" @Prev "EditorPrint" @Toc "DFAEditor" For owners of modems only! If you have a modem connected to your computer, it will be possible to let the computer dial the phone number(s). If you have entered more than one number, it is @{b}strictly@{ub} recommended that you seperate them by a @{b}pipe@{ub} sign (@{b}|@{ub}). When you start dialing (hit @{b}Dial@{ub}), a window pops up that displays who is called. You can cancel the dialing at every time (@{b}Cancel@{ub}) or skip the current number (@{b}Skip@{ub}). The modem settings can be changed in the @{b}DFA-Preferences@{ub} program. @EndNode @Node "DFAPrefs" "dfa.guide/DFAPrefs" @Toc "Main" The DFA-Preferences Program *************************** The @{b}DFA-Preferences@{ub} program (filename: @{b}DFAPrefs@{ub}) may be used to configure @{b}DFA@{ub}. It can be started from the @{b}DFA-Editor@{ub} (menu item @{b}Settings->Preferences@{ub}) as well as directly from the Workbench or the Shell. @{" Tooltypes " Link "PrefsTooltypes"} @{" CLI parameter " Link "PrefsCLIParams"} @{" The main window " Link "PrefsMainWindow"} @{" Miscellaneous " Link "PrefsMisc"} AppIcon, Autosave, icon generation, network support @{" Address listview " Link "PrefsAList"} Format of the DFAEditor main (address) listview @{" Panel Listview " Link "PrefsPList"} Format of the "Panel" listview @{" Groups " Link "PrefsGroups"} Title and shortcut for the groups @{" Fonts " Link "PrefsFonts"} Fonts for the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program @{" Modem " Link "PrefsModem"} Modem configuration @{" Paths " Link "PrefsPaths"} File- and pathnames used by @{b}DFA@{ub} @{" Arexx-Commands " Link "PrefsArexxCmds"} Binding of AREXX scripts to function keys @{" Sort " Link "PrefsSort"} sort criteria for the addresses @EndNode @Node "PrefsTooltypes" "dfa.guide/PrefsTooltypes" @Next "PrefsCLIParams" @Toc "DFAPrefs" Tooltypes ========= If you click on the @{b}DFA-Editor@{ub} icon once and then activate the Information program of the Workbench, you may adjust the following tooltypes: @{b}*@{ub} @{b}@{b}PUBSCREEN@{ub}@{ub} If you enter the @{b}name@{ub} of a public screen together with this tooltype, you may select an alternate (public) screen for the @{b}DFA-Preferences@{ub} program to open on. For example: PUBSCREEN=TERM If the given public screen exists when the @{b}DFA-Preferences@{ub} program comes up, it opens its window(s) on this screen, otherwise on the default public screen, usually the Workbench screen. @{b}*@{ub} @{b}@{b}UPPERPUBSCREEN@{ub}@{ub} If you enter @{b}UPPERPUBSCREEN=YES@{ub}, you tell the @{b}DFA-Prefs@{ub} program to open its window(s) on the frontmost @{b}public@{ub} screen. If the current frontmost screen isn't public, the @{b}DFA-Preferences@{ub} program comes up on the screen you selected with the tooltype @{b}PUBSCREEN@{ub}; if this fails as well, the @{b}DFA-Preferences@{ub} program opens its window(s) on the default public screen. @{b}*@{ub} @{b}@{b}GUIDEFILE@{ub}@{ub} To make the online help work, the @{b}DFA-Preferences@{ub} program has to know where to find the online help file. This can be done via the tooltype @{b}GUIDEFILE@{ub}. This tooltype is usually already set by the install program. @EndNode @Node "PrefsCLIParams" "dfa.guide/PrefsCLIParams" @Next "PrefsMainWindow" @Prev "PrefsTooltypes" @Toc "DFAPrefs" CLI-Parameter ============= If you start the @{b}DFA-Preferences@{ub} program from the shell (or the CLI), it uses the @{b}tooltypes@{ub} of the corresponding @{b}.info@{ub} file! However, you may overwrite these setting by giving one or more of the following CLI parameters: PUBSCREEN/K, UPPERPUBSCREEN/K, GUIDEFILE/K This means, you may use... ... @{b}DFAPrefs PUBSCREEN=TERM@{ub} to make the @{b}DFA-Preferences@{ub} program open its window(s) on the public screen named @{b}TERM@{ub}. ... @{b}DFAPrefs UPPERPUBSCREEN=YES@{ub} to make the @{b}DFA-Preferences@{ub} program open its window(s) on the frontmost screen, as long as this is a public screen. ... @{b}DFAPrefs GUIDEFILE=Help:DFAPrefs.guide@{ub} to set another path for the online help file. @EndNode @Node "PrefsMainWindow" "dfa.guide/PrefsMainWindow" @Next "PrefsMisc" @Prev "PrefsCLIParams" @Toc "DFAPrefs" The DFA-Preferences Main Window =============================== From the main window you can reach all subwindows. You may either open one subwindow at a time or several subwindows at the same time. Furthermore the following functions may be reached via buttons: @{b}*@{ub} @{b}Save@{ub} Saves the preferences. @{b}*@{ub} @{b}Use@{ub} Saves the preferences temporarily to @{b}ENV:@{ub}, i.e. the preferences stay active until you reboot the computer. @{b}*@{ub} @{b}Remove DFA@{ub} Removes a running @{b}DFA@{ub} application, i.e. the @{b}DFA-Server@{ub} @{b}and@{ub} the @{b}DFA-Editor@{ub} will be terminated, if they are currently running. @{b}*@{ub} @{b}Quit@{ub} Quits the @{b}DFA-Preferences@{ub} program. You may reach the following functions via the @{b}Project@{ub} menu: @{b}*@{ub} @{b}About@{ub} In the @{b}About@{ub} window you'll find something useful about the program itself and the author: - the version number as well as a notice, if you are a registered user. - The copyright notice and the address of the author (incl. email address(es)). - Your name, address and the serial number if you are a registered user. @{b}*@{ub} @{b}Save@{ub} See above. @{b}*@{ub} @{b}Remove DFA@{ub} See above. @{b}*@{ub} @{b}Quit@{ub} See above. @EndNode @Node "PrefsMisc" "dfa.guide/PrefsMisc" @Next "PrefsAList" @Prev "PrefsMainWindow" @Toc "DFAPrefs" Miscelleneous ============= @{" Application Icon " Link "PrefsAppIcon"} @{" Auto save " Link "PrefsAutoSave"} @{" Generate Icon " Link "PrefsGenIcon"} @{" Secret Mode " Link "PrefsSecretMode"} @{" Networking " Link "PrefsNetworking"} @EndNode @Node "PrefsAppIcon" "dfa.guide/PrefsAppIcon" @Next "PrefsAutoSave" @Toc "PrefsMisc" Application Icon ---------------- The string gadgets @{b}XPos@{ub} and @{b}YPos@{ub} make it possible to enter the application icon's position on the Workbench screen (referring to the upper left corner of the screen) Alternatively to this direct input of raw coordinates there is a more convenient possibility to change the application icon's position: As soon as you click (once) on the cycle gadget @{b}Open position window@{ub}, a small window (title: @{b}Move me@{ub}) is opened. This window can be moved (using the mouse) on the Workbench. As soon as the position fits your wishes you should click on the gadget @{b}Close position window@{ub} (the same gadget as before, just with another text in it). The @{b}Move Me@{ub} window is closed and the new icon position is displayed in the @{b}XPos@{ub} and @{b}YPos@{ub} gadgets. Using the checkbox gadget @{b}Show@{ub}, you can switch the application icon on and off. Furthermore it can be used to make a previously changed icon position visible, by switching the application icon off and then on again. @EndNode @Node "PrefsAutoSave" "dfa.guide/PrefsAutoSave" @Next "PrefsGenIcon" @Prev "PrefsAppIcon" @Toc "PrefsMisc" Auto Save --------- There are several ways to make sure that your addresses are saved regularly: @{b}*@{ub} @{b}Save always@{ub} If you have changed some addresses using the @{b}DFA-Editor@{ub}, the address file is saved as soon as you leave the @{b}DFA-Editor@{ub} -- no matter if using @{b}Quit@{ub} or @{b}Remove@{ub}. @{b}*@{ub} @{b}Ask@{ub} If the addresses have been changed, a requester pops up as soon as you want to leave the @{b}DFA-Editor@{ub}, which asks you if you would like to save the addresses. @{b}*@{ub} @{b}Remove only@{ub} The changed addresses will only be saved, if the @{b}DFA-Editor@{ub} is left using the @{b}Remove@{ub} function (i.e. you quit the complete @{b}DFA@{ub} application), but not if you use the @{b}Quit@{ub} function. @{b}Be careful:@{ub} Please notice that the functions @{b}Quit@{ub} and @{b}Remove@{ub} of the @{b}DFA-Editor@{ub} are exactly the same, if you @{b}don't@{ub} have the @{b}DFA-Server@{ub} program running at the same time! If there is running only the @{b}DFA-Editor@{ub} and you've choosen @{b}Remove only@{ub} for auto save mode, changed addresses are @{b}not@{ub} saved, if you select @{b}Quit@{ub} in the @{b}DFA-Editor@{ub}. @EndNode @Node "PrefsGenIcon" "dfa.guide/PrefsGenIcon" @Next "PrefsSecretMode" @Prev "PrefsAutoSave" @Toc "PrefsMisc" Icon Creation ------------- If you want @{b}DFA@{ub} to save an icon together with the address files, you have to switch this checkbox to @{b}ON@{ub} state. To get an icon for every address database file make sense e.g. if you like to use @{b}DFA@{ub}'s application window. @EndNode @Node "PrefsSecretMode" "dfa.guide/PrefsSecretMode" @Next "PrefsNetworking" @Prev "PrefsGenIcon" @Toc "PrefsMisc" Secret Mode ----------- Not everyone likes @{b}DFA@{ub} informing everybody about how many addresses are sorted, saved, loaded and so on. If you select @{b}Secret Mode@{ub}, instead of the number of addresses, three dots are displayed. @EndNode @Node "PrefsNetworking" "dfa.guide/PrefsNetworking" @Prev "PrefsSecretMode" @Toc "PrefsMisc" Networking ---------- Starting with version 2.0, @{b}DFA@{ub} supplies a simple network mode. This network mode has been developed to make it possible that several connected computers can use the same address file. The problem that comes up, when an address file is used by more than one user at the same time is the following: If several users change the address file at the same time, the last saved address file overwrites the previously saved ones. The previously saved changes are lost! @{b}DFA@{ub} tries to solve this problem in the following way: If the network mode is active, all operations that change the address database are forbidden, i.e. saving, changing, marking of addresses is not possible. It is allowed however, to view the addresses (@{b}Full@{ub}), to scroll within the address list, to print the addresses and so on. If you want to do some changes on the addresses, you have to obtain write access to the address file. This can be done using the AREXX command @{b}ATTEMPTLOCK@{ub} or by selecting the menu item @{b}Write Access@{ub} in the @{b}DFA-Editor@{ub}. If your try to get write access was successful, you may change the addresses. If you've completed your changes, you should free the write access using either the AREXX command @{b}FREELOCK@{ub} or the menu item @{b}Write Access@{ub} in the @{b}DFA-Editor@{ub}. After you have done so, other members of the LAN can get write access to this address file. @{b}*@{ub} @{b}Network mode@{ub} The checkbox gadget @{b}Network mode@{ub} may be used to switch the network mode on and off. Please notice however that using this feature makes only sense, if you really have a network installed and want to access the same address file from several computers. @{b}*@{ub} @{b}Retries@{ub} Number of retries to get write access to the current address file. @{b}*@{ub} @{b}Retry delay@{ub} Number of seconds that may pass between two tries to get write access. @EndNode @Node "PrefsAList" "dfa.guide/PrefsAList" @Next "PrefsPList" @Prev "PrefsMisc" @Toc "DFAPrefs" Address Listview ================ This window may be used to configure the main (address) listview of the @{b}DFA-Editor@{ub}: Each line of the address listview contains one address. Each line may have up to eight columns. Each column can display any field of the particular address. @{b}*@{ub} @{b}Column@{ub} This cycle gadget supplies a mean to select the desired column. You may configure up to eight columns, i.e. @{b}Column 1@{ub} through @{b}Column 8@{ub}. @{b}*@{ub} @{b}Fields@{ub} This listview contains the field name of all address fields that may be used. Please notice that the @{b}Groups@{ub} entry displays all eight group flags of the particular address using the following format: 12345678 ...if there are @{b}all@{ub} groups flags set. For every group that isn't set, instead of the corresponding group number there will be displayed a minus sign (@{b}-@{ub}). Some examples: 123----- Only the groups 1,2 and 3 are set 1-3-5--- Only the groups 1,3 and 5 are set ------78 Only the groups 7 and 8 are set -------- No group flag is set @{b}*@{ub} @{b}Weight@{ub} The number given here is the percentage of the particular column referring to the complete line. Please notice that it is possible to give up to 100 %, but not more than this! If there is not enough space left for the column you're currently working on, you have to reduce one or more columns accordingly. If you enter a number into the @{b}Weight@{ub} gadget that is too large, the program corrects the value and replaces it with the highest possible number. As the display of the group flags needs a fixed number of eight characters, it is not possible to give a weight for this field. @{b}*@{ub} @{b}Free and Used@{ub} To give you a general view of the used and free space within the line, there are two gadgets, @{b}Used [%]@{ub} and @{b}Free [%]@{ub}, which display the used and free space respectively. @{b}*@{ub} @{b}Clear Column@{ub} To clear a column it is @{b}not@{ub} sufficient to set its weight to @{b}0@{ub}! If you want to clear a column, you have to select the desired column (using the @{b}Column@{ub} gadget) and then hit the @{b}Clear column@{ub} gadget. Please notice that "empty" columns are @{b}not@{ub} possible! Only the columns in front of the first cleared column are displayed. Example: You have set the columns 1,2,3 and 4 to the fields @{b}Name@{ub}, @{b}FirstName@{ub}, @{b}Phone@{ub} and @{b}Town@{ub}. If you clear column 3 (@{b}Phone@{ub}) and select @{b}Ok@{ub}, only columns 1 and 2 (@{b}Name@{ub} und @{b}FirstName@{ub}) are still visible. @{b}*@{ub} @{b}Ok und Cancel@{ub} With @{b}Ok@{ub} you accept the changes you've done; if the @{b}DFA-Editor@{ub} is currently running, the changes are applied to it and are visible at once. @{b}Cancel@{ub} discards the changes. This all may have sounded a bit complicated, so I'll give you an example that shall make clear in a step by step procedure, how to configure your "own" format for the address listview: Let's say, you want the following format of the listview's lines: 30% 30% 40% --- ...then you should do like this: Click on the @{b}Columns@{ub} gadget until @{b}Column 1@{ub} is shown. Now select @{b}First name@{ub} in the @{b}Fields@{ub} listview and enter @{b}30@{ub} into the @{b}Weight@{ub} string gadget. Click once on the @{b}Columns@{ub} gadget -- @{b}Column 2@{ub} appears. Select @{b}Name@{ub} in the @{b}Fields@{ub} listview and enter @{b}30@{ub} into the @{b}Weight@{ub} string gadget. Click on the @{b}Columns@{ub} gadget once again -- @{b}Column 3@{ub} appears -- and select @{b}Phone@{ub} from the @{b}Fields@{ub} listview. Please enter @{b}40@{ub} into the @{b}Weight@{ub} string gadget. One more click on the @{b}Columns@{ub} gadget brings @{b}Column 4@{ub} to front. Now select @{b}Group flags@{ub} from the @{b}Fields@{ub} listview. Please notice that the @{b}Weight@{ub} gadget is displayed "ghosted" now and therefore no input into this gadget is possible; this is not needed either as the group flags always need eight characters. Please click on the @{b}Columns@{ub} gadget one more time to make @{b}Column 5@{ub} visible. Select @{b}Clear column@{ub} to make sure that the 5th column is "clear". Hit @{b}Ok@{ub} to make the changes active -- if the @{b}DFA-Editor@{ub} program is currently running, all changes will be visible at once. @EndNode @Node "PrefsPList" "dfa.guide/PrefsPList" @Next "PrefsGroups" @Prev "PrefsAList" @Toc "DFAPrefs" Panel Listview ============== Below the address listview of the @{b}DFA-Editor@{ub} main window there is another listview, called "Panel listview". This is used to make further information about the current address visible. It is possible to display up to 16 lines. Every line can display any field of the address; the line title may be changed as well. Furthermore it is possible to adjust the number of lines that are visible at a time. @{b}*@{ub} @{b}Lines@{ub} Every click on the @{b}Lines@{ub} cycle gadget makes the next line number visible (@{b}Line 1@{ub} through @{b}Line 16@{ub}). After the last line number (16) @{b}Line 1@{ub} is displayed again. @{b}*@{ub} @{b}Fields@{ub} This listview corresponds to the one, you already got to know in @{"Address Listview" Link "PrefsAList"}. Using this listview, you may select, which field of the particular address you want to get displayed in the currently selected line (cf. @{b}Lines@{ub}). @{b}*@{ub} @{b}Title@{ub} It is possible to give any line title you like; for example @{b}Phone #:@{ub} for the @{b}Phone@{ub} field or @{b}Groups:@{ub} for the @{b}group selection@{ub}. If you want e.g. that all three email address are displayed among one another (i.e. Line 1 through line 3), it could be a good idea, to give the first line (@{b}EMail 1@{ub}) the title @{b}EMail:@{ub} and leave line 2 and line 3 without a line title. @{b}*@{ub} @{b}Clear line@{ub} Similarly to @{"Address Listview" Link "PrefsAList"} (see @{b}Clear Column@{ub}) is is needed here as well to explicitly delete lines you don't want to use any longer. Please notice that only lines infront of the first "cleared" line are displayed, even if there are lines with contents behind the first cleared line. This means that empty lines are not possible. @{b}*@{ub} @{b}Visible lines@{ub} It is possible (within certain values) to change the size of the panel listview using this slider gadget. You may have up to 12 lines visible at a time! Please notice that the @{b}DFA-Editor@{ub} reduces the number of visible lines automatically, if there is not enough space for the desired listview lines in the window. @{b}*@{ub} @{b}Ok and Cancel@{ub} Using @{b}Ok@{ub} you accept the changes and a currently running @{b}DFA-Editor@{ub} program is updated at once. @{b}Cancel@{ub} discards the changes. The following example may help you to understand the @{b}Panel@{ub} listview configuration more easily: Let's say you would like to get the following format in your @{b}Panel@{ub} listview <Contents> <Line 1> EMail: [EMail 1] <Line 2> [EMail 2] <Line 3> Comment: [Comment] Terms in @{b}[@{ub} and @{b}]@{ub} describe field names, terms in @{b}<@{ub} and @{b}>@{ub} serve as description. First click as long on the @{b}Lines@{ub} cycle gadget, until @{b}Line 1@{ub} appears (after the window has opened @{b}Line 1@{ub} is usually visible already). Now select @{b}EMail 1@{ub} from the @{b}Fields@{ub} listview and enter @{b}EMail:@{ub} into the @{b}Title@{ub} string gadget. Now click on the @{b}Lines@{ub} gadget once -- @{b}Line 2@{ub} should become visible. Select @{b}EMail 2@{ub} from the @{b}Fields@{ub} listview and delete the contents of the @{b}Title@{ub} string gadget, if it isn't empty already. One more click on the @{b}Lines@{ub} gadget brings @{b}Line 3@{ub} to front. Select @{b}Comment@{ub} from the @{b}Lines@{ub} listview and enter @{b}Comment@{ub} into the @{b}Title@{ub} string gadget. After one more click on the @{b}Lines@{ub} gadget please click on the @{b}Clear line@{ub} gadget, to delete line four if it isn't empty. Hit @{b}Ok@{ub} to accept the changes. If the @{b}DFA-Editor@{ub} is currently running, the changes will be made visible at once. @EndNode @Node "PrefsGroups" "dfa.guide/PrefsGroups" @Next "PrefsFonts" @Prev "PrefsPList" @Toc "DFAPrefs" Groups ====== First of all a few words about the group flags and their purpose and meaning: It is possible to separate your addresses into groups and set the different group flags for every address item. Let's say you're using the first three (out of a maximum of eight) group flags and you've named them @{b}Private@{ub}, @{b}Business@{ub} and @{b}Other@{ub} (see @{"Groups" Link "PrefsGroups"}, for more information). Now you can set the @{b}Private@{ub} flag to all private addresses, the @{b}Business@{ub} flag to all business related addresses and the @{b}Other@{ub} flag to all address that don't belong to any of these groups. Of course, you may set more than one flag at a time, if an address is a private one and business related as well, for example. In the main window of the @{b}DFA-Editor@{ub} you can select the groups you would like to see within the address listview (or use the AREXX command @{b}CHANGEGROUPS@{ub} accordingly). If you want to see the private and the business addresses, please activate both checkbox gadgets. Please notice that all actions, as for instance printing and searching is performed to the active (i.e. displayed) addresses only! In the @{b}Groups@{ub} window of the @{b}DFA-Preferences@{ub} (cf. @{"Groups" Link "PrefsGroups"}) you may set which kind of relation between the groups you like. If you have activated more than one group at the same time (in the example above @{b}Private@{ub} and @{b}Other@{ub}), you may select either the relation @{b}via 'OR'@{ub} or the relation @{b}via 'AND'@{ub}: @{b}*@{ub} @{b}via 'OR'@{ub} Every address that has at least one of the wanted flags set, is displayed. If you activate @{b}Private@{ub} and @{b}Other@{ub}, all addresses will be displayed that have either set the @{b}Private@{ub} @{b}or@{ub} the @{b}Other@{ub} flag @{b}or@{ub} both flags. @{b}*@{ub} @{b}via 'AND'@{ub} Only those addresses are shown that have set at least the groups you selected in the @{b}DFA-Editor@{ub} main window. If the @{b}Private@{ub} and the @{b}Other@{ub} flags are both set, only addresses will be shown that have at least the @{b}Private@{ub} @{b}and@{ub} the @{b}Other@{ub} flag set; addresses that have set only one of these flags are @{b}not@{ub} shown. Groups that don't have any group flags set, can be made visible by deselecting all the group flags in the @{b}DFA-Editor@{ub} main window (i.e. all check boxes are "empty"). Lets shift to the settings that are possible here: @{b}*@{ub} @{b}Groups@{ub} This cycle gadget allows you to set the group (@{b}Group 1@{ub} through @{b}Group 8@{ub}) you want to modify. @{b}*@{ub} @{b}Title@{ub} The name of the group can be entered into this string gadget. The desired keyboard shortcut has to be marked with a leading underscore (@{b}_@{ub}), for example: Group _1 The group's name is @{b}Group 1@{ub}, its shortcut is the digit @{b}1@{ub} Pri_vate @{b}Private@{ub} is used for the group name, the keyboard shortcut is the @{b}v@{ub} Other (_3) @{b}Other (3)@{ub} is the group's name, the digit @{b}3@{ub} its keyboard shortcut @{b}Please notice:@{ub} Even if it @{b}is@{ub} possible to use any keyboard shortcut you like, as long as it is an "usual" letter, you should remember that @{b}DFA@{ub} does not check if the keyboard shortcut you enter is unique within the @{b}DFA@{ub} application. Therefore you have to make sure by yourself that the keyboard shortcuts, you want to use, are not already be used by other gadgets. Please notice as well that the shortcut for the different groups are not only used within the @{b}DFA-Editor@{ub} main window, but have to be unique in e.g. the @{b}DFA-Editor@{ub} @{b}Edit@{ub} window as well. The shortcuts, which are guarantied to be unique within the complete @{b}DFA@{ub} application are the digits @{b}1@{ub} through @{b}8@{ub}, which is the default as well. The length of the group titles is limited to 15 digits, to make sure that no title overwrites the window contents and/or border. @{b}*@{ub} @{b}Group handling@{ub} This cycle gadget allows you to select the kind of relation of several group flags (see above for details). @{b}*@{ub} @{b}Ok und Cancel@{ub} After you've hit @{b}Ok@{ub}, the changes become active, if you hit @{b}Cancel@{ub} instead, all changes are lost. @EndNode @Node "PrefsFonts" "dfa.guide/PrefsFonts" @Next "PrefsModem" @Prev "PrefsGroups" @Toc "DFAPrefs" Fonts ===== The fonts that shall be used by the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program can be set in this window. If you don't change the default setting (@{b}Use System Font@{ub} for every font), all program parts use the fonts you set in the Font Preferences program of the Workbench. Alternatively you may set any font you like for each of the four fonts used. @{b}*@{ub} @{b}@{b}DFA-Editor@{ub}: Gadget font@{ub} Here you may enter the font, which is used for the gadget texts of the @{b}DFA-Editor@{ub}. @{b}*@{ub} @{b}@{b}DFA-Editor@{ub}: List font@{ub} For the different listviews of the @{b}DFA-Editor@{ub} a seperate font may be chosen. Please notice that only non-proportional fonts are allowed here. @{b}*@{ub} @{b}@{b}DFA-Preferences@{ub}: Gadget font@{ub} see above, @{b}DFA-Editor@{ub}: Gadget font. @{b}*@{ub} @{b}@{b}DFA-Preferences@{ub}: List font@{ub} see above, @{b}DFA-Editor@{ub}: List font. Please notice, however that even proportional fonts are allowed here! @EndNode @Node "PrefsModem" "dfa.guide/PrefsModem" @Next "PrefsPaths" @Prev "PrefsFonts" @Toc "DFAPrefs" Modem ===== The settings that can be done here, have only a meaning for you, if you have a modem connected to your computer and plan to use @{b}DFA@{ub} to dial the stored phone numbers. Furthermore you should have a phone connected to your modem! The following settings may be changed: @{b}*@{ub} @{b}Baud@{ub} This cycle gadget may be used to set the baud rate of the serial port. As the serial port is only used to send command sequences and not to transfer real data, the baud rate doesn't really matter; however, it should not be higher than the baud rate, your modem supports (default: @{b}1200@{ub}). @{b}*@{ub} @{b}Init String@{ub} The string that you enter into this string gadget, is used to init the modem. If you have a modem that supports the "Hayes" command sequences, the init command is usually @{b}ATZ@{ub} (default: @{b}ATZ~~~@{ub}). @{b}*@{ub} @{b}Hangup String@{ub} The string that is to be used to hang up the line, i.e. to terminate the connection, may be entered here (default: @{b}+++\rTH0\r@{ub}) @{b}*@{ub} @{b}Predial String@{ub} This string is sent to the modem just before the phone number itself. Some examples for "Hayes" compatible modems: ATDP Pulse dial (default) ATDT Tone dial ATDP#W Makes the modem wait for a dialtone after sending a number (@{b}#@{ub}). So it is possible to call from a extension line. Just substitute @{b}#@{ub} by the number you would usually enter to get a dialtone. @{b}*@{ub} @{b}Suff. Dial String@{ub} The string that has to be sent just after the phone number may be entered here. Please notice that this string has to be @{b}at least@{ub} a @{b}\r@{ub}, as the dialing does not work otherwise (default: @{b}\r@{ub}). @{b}*@{ub} @{b}Serial device@{ub} Here you may enter the name of a serial device that shall be used for dialing. Usually this is the Commodore @{b}serial.device@{ub}, which is the default. If you have an interface card with (an) additional serial interface(s), you can insert the new serial device here. @{b}*@{ub} @{b}Select device@{ub} Instead of typing the name of the serial device you can comfortably select it from a file requester. The selected device is inserted into the @{b}Serial device@{ub} field. @{b}*@{ub} @{b}Device unit@{ub} You may enter the number of the serial device here. Usually this is @{b}0@{ub}. However, if you have an interface card with more than one serial port, they are distinguishable by their numbers (@{b}0@{ub} and @{b}1@{ub} for example). @{b}*@{ub} @{b}Retries@{ub} If a line is busy, it is possible to tell @{b}DFA@{ub} to retry; the number of retries may be entered here. @{b}*@{ub} @{b}Redial delay@{ub} The time delay between two dial events. @{b}*@{ub} @{b}Use OwnDevUnit@{ub} The @{b}OwnDevUnit.library@{ub} gives you the chance to use @{b}DFA@{ub} for dialing, even if the serial port is permanently occupied by a program as the @{b}getty@{ub} for example. The requirement for this to work is that this program supports the @{b}OwnDevUnit.library@{ub} as well of course. If you don't use such a program, you may deactivate the @{b}Use OwnDevUnit@{ub} checkbox. If there is no @{b}OwnDevUnit.library@{ub} installed on your computer, it can't be used of course. The input you can do into @{b}Init String@{ub}, @{b}Hangup String@{ub}, @{b}PredialString@{ub} and @{b}Suff. Dial String@{ub}, can be found in the manual of your modem. In addition to the strings listed there, @{b}DFA@{ub} supports the following command sequences: @{b}*@{ub} @{b}@{b}~@{ub} (Tilde)@{ub} Causes a delay of about one second. @{b}*@{ub} @{b}@{b}\b@{ub} (Backspace)@{ub} Deletes the character to its left. @{b}*@{ub} @{b}@{b}\f@{ub} (Formfeed)@{ub} Performs a form feed. @{b}*@{ub} @{b}@{b}\n@{ub} (Linefeed)@{ub} Produces a line feed. @{b}*@{ub} @{b}@{b}\r@{ub} (Carriage return)@{ub} Performs a carriage return. @{b}*@{ub} @{b}@{b}\t@{ub} (Tab)@{ub} Inserts a @{b}Tab@{ub} character. @{b}*@{ub} @{b}@{b}\e@{ub} (ESC)@{ub} Inserts an @{b}Escape@{ub} character. @EndNode @Node "PrefsPaths" "dfa.guide/PrefsPaths" @Next "PrefsArexxCmds" @Prev "PrefsModem" @Toc "DFAPrefs" Paths and Filenames =================== The file and pathnames used by @{b}DFA@{ub} may be set here. More comfortable than to enter the pathname into the string gadgets manually is to hit the button just behind the corresponding string gadget. If you do so, a file requester pops up and you may select the desired file or pathname. @{b}*@{ub} @{b}Address file@{ub} This is the address file that is loaded automatically during the startup of @{b}DFA@{ub} (default: @{b}s:adr.file@{ub}). This filename will be used as well, if you select @{b}Save as default@{ub}. @{b}*@{ub} @{b}External files@{ub} The external files are saved in a directory of their own (default: @{b}s:DFAExternals@{ub}). @{b}*@{ub} @{b}File editor@{ub} To modify the external files, you need an ASCII editor. The @{b}ed@{ub}, which can usually be found in the @{b}C:@{ub} drawer of your workbench, is an appropriate tool for example (default: @{b}ed@{ub}). @{b}*@{ub} @{b}File viewer@{ub} To view the external files, you need a text viewer, as for example the @{b}more@{ub} program that comes along with your Workbench programs (default: @{b}more@{ub}). @EndNode @Node "PrefsArexxCmds" "dfa.guide/PrefsArexxCmds" @Next "PrefsSort" @Prev "PrefsPaths" @Toc "DFAPrefs" Arexx Scripts ============= It is possible to bind one AREXX script to every function key (@{b}F1@{ub} through @{b}F10@{ub}). If you don't like to enter the name of the AREXX script (including its path) by hand, you may alternatively hit the button gadget just behind the corresponding string gadget (keyboard shortcut: @{b}SHIFT@{ub} @{b}<digit>@{ub}). If you do so, a file requester will pop up and the desired AREXX script can be selected. The AREXX scripts you enter here can only be reached via the function keys from the main window of the @{b}DFA-Editor@{ub}. In the @{b}rexx@{ub} drawer of the @{b}DFA@{ub} distribution some example scripts can be found; all files suited for this purpose have the extension @{b}.dfa@{ub}. Hit @{b}Ok@{ub} to accept the changes or @{b}Cancel@{ub} to quit the window and discard the changes. @EndNode @Node "PrefsSort" "dfa.guide/PrefsSort" @Prev "PrefsArexxCmds" @Toc "DFAPrefs" Sorting ======= The addresses can be sorted by (nearly) every field of an address. To manage this, you may enter up to four sort criteria here. The most important one is @{b}Sort criteria 1@{ub}. If two addresses can't be distinguished by this criteria alone (e.g. if there are identical names), the second sort criteria (@{b}Sort criteria 2@{ub}) is used. If a distinction is still impossible, the third sort criteria is used and so @{b}*@{ub} @{b}Sort@{ub} Here you may choose which sort criteria you would like to change. @{b}*@{ub} @{b}Fields@{ub} You may select one address field from this listview for every sort criteria (@{b}Sort criteria 1@{ub} through @{b}Sort criteria 4@{ub}). @{b}*@{ub} @{b}Clear sort criteria@{ub} If you want to delete a sort criteria, please hit this button. @{b}*@{ub} @{b}Ok and Cancel@{ub} @{b}Ok@{ub} accepts the changes. Please notice that the addresses are @{b}not@{ub} resorted automatically. To sort your addresses using the modified sort criteria, you have to explicetly select @{b}Sort@{ub} in the @{b}DFA-Editor@{ub} (or use the corresponding AREXX command). @{b}Cancel@{ub} ignores the changes. @EndNode @Node "Legal" "dfa.guide/Legal" @Toc "Main" Legal stuff *********** @{" Licence " Link "Licence"} @{" Warranty " Link "Warranty"} @{" Copyright " Link "Copyright"} @EndNode @Node "Licence" "dfa.guide/Licence" @Next "Warranty" @Toc "Legal" Licence ======= 1. This licence applies to the product called @{b}DFA@{ub}, a package for the @{b}AMIGA@{ub} computer, published by Dirk Federlein under the concepts of @{b}Shareware@{ub}. The terms "Package", "@{b}DFA@{ub}" and "Archive" refer to this product. The licensee is addressed as "you". This license does not apply to third party supplied programs, found e.g. in the @{b}c@{ub} or @{b}libs@{ub} drawer of the original distribution archive. 2. You may use @{b}DFA@{ub} for a period of up to 21 days for evaluation. After that, you have to register. 3. This archive may be freely redistributed only @{b}without the keyfile@{ub}, which you got from me when you have registered. Please remember that the keyfile contains your name to prevent you from giving it away to others. 4. You are @{b}not allowed@{ub} to draw commercial profit out of distributing this package. You may charge a fee to recover distribution and copy costs. The fee for diskette distribution may @{b}not be more@{ub} than the cost to obtain a public domain diskette from Fred Fish. 5. You are @{b}not@{ub} allowed to manipulate any file of @{b}DFA@{ub} and distribute it under any or no name. Compression with common archivers like @{b}zoo@{ub} or @{b}lharc@{ub} is allowed. You are only allowed to redistribute the @{b}whole@{ub} original archive (@{b}without@{ub} the keyfile however). Some files @{b}may be@{ub} modified for your personal use: @{b}*@{ub} The AREXX scripts The example AREXX scripts which can be found in the @{b}Rexx@{ub} drawer of the original distribution may be modified and/or enhanced. @{b}*@{ub} The LOCALE files If you adopt the catalog translation files (extension @{b}.ct@{ub}), you will be able to translate all program texts of @{b}DFA@{ub} into your native language. If you do such changes, you may do so for your personal use; redistribution of modified files is not allowed. (Nevertheless the author would be happy, if you'd sent him your modified files, so that they may serve as a basis for an inclusion into future versions of @{b}DFA@{ub}) 6. If developers of commercial software would like to include certain parts of @{b}DFA@{ub} in their commercial products, they will have to contact the author of @{b}DFA@{ub} first, to ask for permission. 7. You agree to cease distributing @{b}DFA@{ub} if requested to do so by the author. 8. By copying, distributing and/or using @{b}DFA@{ub} you indicate your acceptance of this license to do so, and all its terms and conditions. 9. Each time you redistribute this package, the recipient automatically receives a license from the original licensor to copy, distribute and/or use this package subject to these terms and conditions. @{b}You may not impose any further restrictions on the recipients' exercise of the rights granted herin@{ub}. 10. As always, Fred Fish has got explicit permission to include this package into his wonderful "Fish Disk" collection, no matter if it is on floppy or compact disk. @EndNode @Node "Warranty" "dfa.guide/Warranty" @Next "Copyright" @Prev "Licence" @Toc "Legal" Warranty ======== This software is provided @{b}as is@{ub} without warranty of any kind, either expressed or implied. By using @{b}DFA@{ub}, you agree to accept the entire risk as to the quality and performance of this package. In no event (unless required by applicable law or agreed to in writing) will any copyright holder, or any other party who may redistribute this package as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use this package (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties), even if such holder or other party has been advised of the possibility of such damages. Of course, @{b}DFA@{ub} has been tested rather extensively before it was released. In case you find any bugs in @{b}DFA@{ub} I please you to send me a bug report. See @{"Bugreports" Link "Bugreports"}. @EndNode @Node "Copyright" "dfa.guide/Copyright" @Prev "Warranty" @Toc "Legal" Copyright ========= GUI created using Gadtoolsbox (37.300) (C) 1991-93 Jan van den Baard. AREXX interface created using Arexxbox (V1.12) (C) 1992-93 Michael Balzer. The MagicWB icons are (C) Copyright 1993-94 Martin Huttenloher Installer and Installer project icon (C) Copyright 1991-93 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and distributed under license from Commodore. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE. ALL USE IS AT YOUR OWN RISK. NO LIABILITY OR RESPONSIBILITY IS ASSUMED. Registered trademarks are @{b}not@{ub} marked separately. Therefore absence of a trademark does not imply they are free. @EndNode @Node "Registration" "dfa.guide/Registration" @Toc "Main" Registration ************ Since Version 2.1 of @{b}DFA@{ub} has been finished, it is an product with the @{b}SASG@{ub} quality brand. The advantages, which grow out of this can be looked up within the @{" Registration/Information " system DFA:C/Registration} program. Information about registration sites, the @{b}SASG@{ub}, the shareware fee, payment methods etc. can be found there as well. The registration program can be started either seperately or directly out of the about requester of @{b}DFA@{ub}. Before you register, you have the opportunity to test @{b}DFA@{ub} in great detail. However, when using the unregistered version you can't save the preferences (this feature is disabled); all changes you perform using the @{b}DFA-Preferences@{ub} program stay active only until you reboot your computer. The window positions are therefore @{b}not@{ub} saved as well. In spite of all this restrictions it should be possible to see if @{b}DFA@{ub} is what you expect. As soon as you use @{b}DFA@{ub} regularly, however not later than after 21 days, you have to register! You'll get your personal keyfile, a TeX manual (in German @{b}and@{ub} English) and an AMIGAGUIDE manual (German @{b}and@{ub} English). All manual files are on the disk only and @{b}not@{ub} printed! You'll find my address below, see @{"Important Addresses" Link "Addresses"}. @EndNode @Node "Updates" "dfa.guide/Updates" @Toc "Main" Updates ******* I'm continuously working on @{b}DFA@{ub} and I'll publish small updates from time to time. These updates will be fed into the following electronic nets: @{b}*@{ub} ADS Filenet @{b}*@{ub} AmiNet FTP Server If you have access to such a electronic net, you can get the latest version of @{b}DFA@{ub} quickly and cheaply. Many electronic mailboxes supply the latest version of @{b}DFA@{ub} as well, e.g. @{b}Publisher's Treff@{ub} 63739 Aschaffenburg Tel.: Germany-(0)6021-93435 @{b}Publisher's Treff@{ub} SASG Support BBS - All SASG products available 63739 Aschaffenburg Tel.: Germany-(0)6021-93435 Fido: 2:244/6302.0 You may get the latest version of @{b}DFA@{ub} off from that @{b}BBS@{ub} via FileRequest. The magic for the FileRequest is @{b}DFA@{ub}. Any other @{b}SASG@{ub} product may be requested as well. @{b}Incubus@{ub} 97074 W rzburg Tel.: Germany-(0)931-781464, -781465, -781467, -781468, -72695, -884703, -884726 Alternatively you may order your update directly from me. Please use the registration program for this purpose -- as you've already done when you've registered. Fred Fish will get @{b}DFA@{ub} to include it in his library. However, it will last a few weeks until @{b}DFA@{ub} finds its was on these floppy or compact disks respectively. @EndNode @Node "Bugreports" "dfa.guide/Bugreports" @Toc "Main" Bug Reports *********** Coming with version 2.0 I did many significant changes to @{b}DFA@{ub}. Usually this means that compared to @{b}DFA@{ub} V1.2x there will be some new bugs in it -- in spite of a long beta testing phase! This fact can be understood more easily, if you know that the source code of @{b}DFA@{ub} takes up about 1.2 MB up to now! So I ask you to report any bugs you discover. If you have any ideas what should be improved in future versions of @{b}DFA@{ub}, please feel free to write, (mail or email, doesn't matter) giving me any suggestions. Bug reports can be sent by ordinary or elecronic mail. The address can be found in @{"Important Addresses" Link "Addresses"}. @EndNode @Node "Addresses" "dfa.guide/Addresses" @Toc "Main" Important Addresses ******************* @{" The author's address " Link "MyAddress"} @{" Registration in Australia " Link "AustraliaRegSite"} @{" Registration in England " Link "EnglishRegSite"} @{" Registration in France " Link "FrenchRegSite"} @{" Registration in Germany " Link "GermanRegSite"} @{" Registration in the USA " Link "USARegSite"} @EndNode @Node "MyAddress" "dfa.guide/MyAddress" @Next "AustraliaRegSite" @Toc "Addresses" The author's address ==================== @{b}Home address:@{ub} Dirk Federlein Brunnengasse 11a 63741 Aschaffenburg Germany @{b}Study address:@{ub} Dirk Federlein Am Sonnenberg 34 97078 W rzburg Germany @{b}E-Mail:@{ub} UUCP: @{b}dirkf@alcmy.franken.de@{ub} @{b}or@{ub} @{b}dirk@alcmy.adsp.sub.org@{ub} FIDO: @{b}2:244/6302.12@{ub} E-mail reaches me always, no matter to which of the above addresses you write. If you prefer to send "normal" mail, you should send it to Aschaffenburg. @{b}Bank address:@{ub} Bayerische Vereinsbank Aschaffenburg Sort code: 795 200 70 Accont: 160 6 140 Germany @EndNode @Node "AustraliaRegSite" "dfa.guide/AustraliaRegSite" @Next "EnglishRegSite" @Prev "MyAddress" @Toc "Addresses" Registration in Australia ========================= @{b}Andre Lackmann@{ub} PO Box 259 Newport NSW 2106 Australia @{b}E-Mail:@{ub} UUCP: @{b}76711.710@compuserve.com@{ub} @EndNode @Node "EnglishRegSite" "dfa.guide/EnglishRegSite" @Next "FrenchRegSite" @Prev "AustraliaRegSite" @Toc "Addresses" Registration in England ======================= @{b}Paul Jewell@{ub} 7 Fairfield Avenue Victoria Park Cardiff Great Britain (Wales) @{b}E-Mail:@{ub} UUCP: @{b}Paul_Jewell@savanna.exnet.com@{ub} @{b}Bankverbindung:@{ub} Lloyds Bank Sort code: 30-98-94 Account: 7574426 @EndNode @Node "FrenchRegSite" "dfa.guide/FrenchRegSite" @Next "GermanRegSite" @Prev "EnglishRegSite" @Toc "Addresses" Registration in France ====================== @{b}Etienne Schneider@{ub} 1 impasse des Sans Boutons F-80000 Amiens France @{b}E-Mail:@{ub} UUCP: @{b}etienne.schneider@ramses.fdn.org@{ub} @EndNode @Node "GermanRegSite" "dfa.guide/GermanRegSite" @Next "USARegSite" @Prev "FrenchRegSite" @Toc "Addresses" Registration in Germany ======================= @{b}Christoph Reichert@{ub} Am Hasenkopf 4 63739 Aschaffenburg Deutschland @{b}E-Mail:@{ub} UUCP: @{b}chris@ptreff.ab.mayn.sub.de@{ub} @{b}Bank address:@{ub} Sparkasse Aschaffenburg - Alzenau Sort code: 795 500 00 Account: 528 01 77 Germany @EndNode @Node "USARegSite" "dfa.guide/USARegSite" @Prev "GermanRegSite" @Toc "Addresses" Registration in the USA ======================= @{b}Robert Blayzor@{ub} PO Box 807 Johnstown, NY 12095-0807 U.S.A. @{b}E-Mail:@{ub} UUCP: @{b}die@lsd.org@{ub} @EndNode @Node "Internal" "dfa.guide/Internal" @Toc "Main" Internal ******** @{" Locale Support " Link "IntLocaleSupport"} Native language support @{" The CheckBirthday Program " Link "CheckBirthday"} Never ever forget a birthday! @EndNode @Node "IntLocaleSupport" "dfa.guide/IntLocaleSupport" @Next "CheckBirthday" @Toc "Internal" Locale Support ============== While @{b}DFA@{ub} V1.2x supported seven different languages, version 2.0 of @{b}DFA@{ub} comes along only with english and german language support. This restriction has several reasons: 1. The english and german version of the catalog files can be done by myself. Therefore I am no longer -- especially when creating updates -- forced to get updated locale files from many different parts of this world @{b}in time@{ub}. 2. For version 2.0 of @{b}DFA@{ub} I enlarged the locale files by a big amount. To translate these files is a lot of work that I don't want to be done by other people than by myself. 3. The enormous effort to adopt the locale files (for updates), prevented me a long time from doing a major update at all. Please notice that all locale files have to be changed, even if I add only one single sentence or word! Now there is no longer such a reason (for me) to delay updates! 4. The number of registered users that prefer other languages than german or english is still quite low. This has been the reason not to put a french locale into @{b}DFA@{ub} V1.2x, as in the beginning there was no registered french user at all. Furthermore -- most people prefer the english program texts even if English isn't their native language. Since version 2.1 has been finished, the french program texts are available as well! @EndNode @Node "CheckBirthday" "dfa.guide/CheckBirthday" @Prev "IntLocaleSupport" @Toc "Internal" The CheckBirthday Program ========================= Since @{b}DFA@{ub} got its Arexx-Port, it comes along with an Arexx script that displays coming birthdays. This script had, besides several pros, one real con: It needed much time to process a (long) address list. Out of this reason @{b}DFA@{ub} now comes along with an addition tool that does the same job, but much faster. It can be started out of the shell, with the command: CheckBirthday ADR=ADRESSFILE/A BEFORE=DAYSBEFORE/N AFTER=DAYSAFTER/N DELAY/N The meaning of the different parameters: @{b}ADDRESSFILE@{ub} The address database file @{b}BEFORE@{ub} Number of days before the birthday @{b}AFTER@{ub} Number of days after the birthday @{b}DELAY@{ub} Delay in seconds after the output of all birthdays Starting from Workbench is possible as well! Please notice that you have to make sure that you have adjusted the tooltypes to your needs. These tooltypes have the same names as the shell parameter. Additionally the @{b}WINDOW@{ub} tooltype is available that gives you the chance to set the output window position and size, like: WINDOW=CON:20/20/400/200/Geburtstage/AUTO/CLOSE/WAIT @EndNode @Node "MinConfig" "dfa.guide/MinConfig" @Toc "Main" Needed Configuration ******************** The minimum configuration for the usage of @{b}DFA@{ub} consists of any @{b}AMIGA@{ub} computer that runs at least @{b}AMIGA-OS 2.0@{ub} and 1 MB RAM. As the addresses are completely kept in RAM, as more you have as better it is. A harddisk is not needed, but recommended. If you run (at least) Workbench 2.1 on your system, you may change the native language if you like (use the Locale preferences program of the Workbench to do so). If you run version 3.x of the operating system, you can enjoy some additional (mostly optical) features of this OS version. @EndNode @Node "Tips" "dfa.guide/Tips" @Toc "Main" Hints and Tips ************** Question: After I restarted the computer, @{b}DFA@{ub} has "forgotten" all window positions I'd adjusted before -- why? @{b}Answer:@{ub} To save the window positions, you have to save the @{b}DFA@{ub} preferences. This can be done for example by selecting the appropriate menu item (@{b}Settings->Save Preferences@{ub}) of the @{b}DFA-Editor@{ub}. Please remember that the settings and as a consequence of this the window positions as well, can only be saved in the registered version of @{b}DFA@{ub} (see @{"Registration" Link "Registration"}, for details). Question: After I entered another position for the application icon, it stayed on the same place as before. @{b}Answer:@{ub} Click on the @{b}Show@{ub} check box gadget in the Miscellaneous Window of the @{b}DFA-Preferences@{ub} program (cf. @{"Miscellaneous" Link "PrefsMisc"}) @{b}twice@{ub}. Now the application icon should appear on the desired position, as long as there is no other icon that occupies this position on the Workbench. Question: As soon as I want to modify anything, a requester appears which tells me that I need "write access" before I may change my addresses. @{b}Answer:@{ub} Switch off the network mode (see @{"Miscellaneous" Link "PrefsMisc"}). If you need the network mode, select @{b}Write Access@{ub} in the @{b}Settings@{ub} menu of the @{b}DFA-Editor@{ub}. Question: If I hit the @{b}HELP@{ub} key, I get no online help at all -- nothing happens! @{b}Answer:@{ub} Make sure that the online help files (@{b}DFAEditor.guide@{ub} and @{b}DFAPrefs.guide@{ub}) exist and the corresponding tooltypes of the @{b}DFA-Editor@{ub} and the @{b}DFA-Preferences@{ub} program are set correctly (cf. @{"Tooltypes" Link "PrefsTooltypes"}). Question: I appended an old @{b}DFA@{ub} file to the current address database, but the appended addresses are not displayed within the address listview! @{b}Answer:@{ub} Make sure that you activated the correct group flags. It might be that the appended addresses don't have any group flags set. If this is the case, you will have to @{b}deactivate@{ub} all group check boxes in the @{b}DFA-Editor@{ub} main window, to see these addresses. Question: If I access my addresses via AREXX, @{b}DFA@{ub} seems to find not all addresses -- sometimes it even finds no addresses at all! @{b}Answer:@{ub} Please notice that the AREXX commands access only the addresses that correspond to the current group selection! To make sure that all addresses can be reached by AREXX, you should either select all group flags in the @{b}DFA-Editor@{ub} main window or use the AREXX command @{b}CHANGEGROUPS@{ub} accordingly. Question: After I've entered a new address containing group flags that did @{b}not@{ub} match the current group selection, it was nevertheless displayed in the @{b}DFA-Editor@{ub}'s main window listview. Isn't this behaviour a bit inconsequent? @{b}Answer:@{ub} Yes, indeed. However, for many people it would be even more confusing, if the new address which they've just entered, would no be displayed. Question: After I've entered a new address, for the present it was displayed in the @{b}DFA-Editor@{ub}'s main window corretly. After I've resized the window, however, the address has disappeared! @{b}Answer:@{ub} This problem should be seen together with the previous question. After a new address is entered, it is shown in the listview, no matter if the group selection fits or not. As soon as the window is resized, however, the listview entries are reformatted and the group selection is noticed! This causes all entries to disappear that do not match the current group selection. Question: Although I have set the modem preferences as it is needed, my modem does not dial any telephone numbers. The phone number of the address to dial is displayed within the dial window, but the modem does nothing that looks like dialing! @{b}Answer:@{ub} Under some circumstances your modem does not like the baud rate you set in the @{b}System Preferences@{ub} (Serial). Decrease the baud rate (in the System Preferences!), until your modem dials correctly. @EndNode @Node "Thanks" "dfa.guide/Thanks" @Toc "Main" Thanks to... ************ Many people helped me to make @{b}DFA@{ub} what it is today. Therefore I would like to thank... ... @{b}Robert Blayzor@{ub} For supplying the registration site in the USA. ... @{b}Michael 'Mick' Hohmann@{ub} Tested the user aspects of @{b}DFA@{ub}. ... @{b}Martin 'XEN' Huttenloher@{ub} Painted the wonderful MagicWB icons (8 colors) If you like the icons coming with this distribution of @{b}DFA@{ub}, take a look at the complete collection of MagicWB icons by Martin Huttenloher. ... @{b}Kai Iske@{ub} My "oldest" beta tester. He already tested @{b}DFA@{ub} before version 1.0 has been published! For version 2.0 of @{b}DFA@{ub} he supplied me a fast sort routine. The @{b}RemindBirthday@{ub} utility is done by him as well. ... @{b}Katja and Paul Jewell@{ub} For the proof reading of the english manual and the english registration site. ... @{b}Andre Lackmann@{ub} For supplying the registration site in Australia. ... @{b}Etienne Schneider@{ub} For the french locale files and the french registration site. ... @{b}Stefan Stuntz@{ub} For many telephone chats and his understanding that @{b}DFA@{ub} still doesn't support his @{b}Magic User Interface@{ub} (@{b}MUI@{ub}). ... @{b}all others,@{ub} that are not explicitly listed here and have sent me bug reports and/or suggestions for improving @{b}DFA@{ub} Thanks a lot to all @{b}DFA@{ub} users to be so patient while waiting for @{b}DFA@{ub} V2.0 such a long time. I do really hope it is worth the time you've waited for it! @EndNode @Node "Index" "dfa.guide/Index" @Toc "Main" Index ***** @Index "Index" @{" (Un)set Groups " Link "EditorMenuSetGroups"} EditorMenuSetGroups @{" (Un)set Groups " Link "EditorMenuSetGroups"} EditorMenuSetGroups @{" ADDRESSFILE " Link "ServerTooltypes"} ServerTooltypes @{" ADDRESSFILE " Link "ServerCLIParams"} ServerCLIParams @{" CX_POPKEY " Link "ServerTooltypes"} ServerTooltypes @{" CX_POPKEY " Link "ServerCLIParams"} ServerCLIParams @{" CX_POPUP " Link "ServerCLIParams"} ServerCLIParams @{" CX_POPUP " Link "ServerTooltypes"} ServerTooltypes @{" CX_PRIORITY " Link "ServerCLIParams"} ServerCLIParams @{" CX_PRIORITY " Link "ServerTooltypes"} ServerTooltypes @{" DFAEDITOR " Link "ServerCLIParams"} ServerCLIParams @{" DFAEDITOR " Link "ServerTooltypes"} ServerTooltypes @{" DFAPREFS " Link "EditorTooltypes"} EditorTooltypes @{" DFAPREFS " Link "EditorCLIParams"} EditorCLIParams @{" DONOTWAIT " Link "ServerTooltypes"} ServerTooltypes @{" GUIDEFILE " Link "EditorCLIParams"} EditorCLIParams @{" GUIDEFILE " Link "EditorTooltypes"} EditorTooltypes @{" GUIDEFILE " Link "PrefsCLIParams"} PrefsCLIParams @{" GUIDEFILE " Link "PrefsTooltypes"} PrefsTooltypes @{" PORTNAME " Link "ServerTooltypes"} ServerTooltypes @{" PORTNAME " Link "ServerCLIParams"} ServerCLIParams @{" PUBSCREEN " Link "EditorTooltypes"} EditorTooltypes @{" PUBSCREEN " Link "PrefsCLIParams"} PrefsCLIParams @{" PUBSCREEN " Link "PrefsTooltypes"} PrefsTooltypes @{" PUBSCREEN " Link "EditorCLIParams"} EditorCLIParams @{" UPPERPUBSCREEN " Link "PrefsTooltypes"} PrefsTooltypes @{" UPPERPUBSCREEN " Link "PrefsCLIParams"} PrefsCLIParams @{" UPPERPUBSCREEN " Link "EditorCLIParams"} EditorCLIParams @{" UPPERPUBSCREEN " Link "EditorTooltypes"} EditorTooltypes @{" AREXX SCRIPTS " Link "Installation"} Installation @{" AREXX documentation " Link "ArexxBasics"} ArexxBasics @{" AREXX error codes " Link "ArexxErrorCodes"} ArexxErrorCodes @{" AREXX port name " Link "ArexxBasics"} ArexxBasics @{" AREXX scripts " Link "Installation"} Installation @{" AREXX scripts " Link "Installation"} Installation @{" About " Link "PrefsMainWindow"} PrefsMainWindow @{" About " Link "EditorMenuAbout"} EditorMenuAbout @{" About " Link "EditorMenuAbout"} EditorMenuAbout @{" Address " Link "Addresses"} Addresses @{" Address file " Link "PrefsPaths"} PrefsPaths @{" address file format " Link "EditorMenuOpen"} EditorMenuOpen @{" address files " Link "ArexxBasics"} ArexxBasics @{" Address list " Link "EditorMainWindow"} EditorMainWindow @{" Address listview " Link "EditorMainWindow"} EditorMainWindow @{" Address Listview " Link "PrefsAList"} PrefsAList @{" Address of the author " Link "EditorMenuAbout"} EditorMenuAbout @{" Address of the author " Link "PrefsMainWindow"} PrefsMainWindow @{" Addresses " Link "EditorMenuInfo"} EditorMenuInfo @{" Adress of the author " Link "MyAddress"} MyAddress @{" All " Link "EditorSearch"} EditorSearch @{" AMIGA pattern " Link "EditorSearch"} EditorSearch @{" Append " Link "EditorMenuAppend"} EditorMenuAppend @{" Append " Link "EditorMenuAppend"} EditorMenuAppend @{" AppIcon " Link "EditorMenuQuit"} EditorMenuQuit @{" AppIcon " Link "EditorMainWindow"} EditorMainWindow @{" Application Icon " Link "PrefsAppIcon"} PrefsAppIcon @{" Application Icon " Link "EditorMenuQuit"} EditorMenuQuit @{" Application icon " Link "EditorMainWindow"} EditorMainWindow @{" Application Icon Position " Link "PrefsAppIcon"} PrefsAppIcon @{" Application Window " Link "EditorMainWindow"} EditorMainWindow @{" Application-Icon " Link "AppIcon"} AppIcon @{" Arexx " Link "Arexx"} Arexx @{" Arexx Basics " Link "ArexxBasics"} ArexxBasics @{" Arexx commands " Link "ArexxCommands"} ArexxCommands @{" Arexx Port " Link "EditorMenuInfo"} EditorMenuInfo @{" Arexx return value " Link "ArexxReturnAddress"} ArexxReturnAddress @{" Arexx Scripts " Link "PrefsArexxCmds"} PrefsArexxCmds @{" ASCII editor " Link "PrefsPaths"} PrefsPaths @{" ASCII Viewer " Link "PrefsPaths"} PrefsPaths @{" Author's address " Link "PrefsMainWindow"} PrefsMainWindow @{" Auto Save " Link "PrefsAutoSave"} PrefsAutoSave @{" backup " Link "ArexxBasics"} ArexxBasics @{" Bank address " Link "GermanRegSite"} GermanRegSite @{" Bank address " Link "EnglishRegSite"} EnglishRegSite @{" Bank address " Link "MyAddress"} MyAddress @{" bank transfer " Link "GermanRegSite"} GermanRegSite @{" bank transfer " Link "MyAddress"} MyAddress @{" bank transfer " Link "EnglishRegSite"} EnglishRegSite @{" Baud " Link "PrefsModem"} PrefsModem @{" Bug Reports " Link "Bugreports"} Bugreports @{" Bug Reports " Link "Bugreports"} Bugreports @{" Button gadget " Link "UsingDFA"} UsingDFA @{" Calling " Link "EditorMenuDial"} EditorMenuDial @{" Calling " Link "PrefsModem"} PrefsModem @{" Calling " Link "EditorTools"} EditorTools @{" Cancel (Edit) " Link "EditorEdit"} EditorEdit @{" Cancel (Print) " Link "EditorPrint"} EditorPrint @{" Cancel (Search) " Link "EditorSearch"} EditorSearch @{" Change Templates " Link "EditorMenuEditTemplate"} EditorMenuEditTemplate @{" Check Box " Link "UsingDFA"} UsingDFA @{" CheckBirthday " Link "CheckBirthday"} CheckBirthday @{" Clear Column " Link "PrefsAList"} PrefsAList @{" Clear line " Link "PrefsPList"} PrefsPList @{" Clear mark " Link "EditorMainWindow"} EditorMainWindow @{" Clear sort criteria " Link "PrefsSort"} PrefsSort @{" CLI parameter of the DFA-Editor program " Link "EditorCLIParams"} EditorCLIParams @{" CLI-Parameter des DFA-Preferences-Programms " Link "PrefsCLIParams"} PrefsCLIParams @{" CLI-Parameter des DFA-Servers " Link "ServerCLIParams"} ServerCLIParams @{" Column " Link "PrefsAList"} PrefsAList @{" Commodity " Link "Commodity"} Commodity @{" Copy to Clipboard " Link "EditorMenuCopyToClip"} EditorMenuCopyToClip @{" Copy to Clipboard " Link "EditorMenuCopyToClip"} EditorMenuCopyToClip @{" Copyright " Link "Copyright"} Copyright @{" Copyright " Link "PrefsMainWindow"} PrefsMainWindow @{" Copyright " Link "EditorMenuAbout"} EditorMenuAbout @{" Cycle Gadget " Link "UsingDFA"} UsingDFA @{" default settings " Link "Quick Start"} Quick Start @{" Device unit " Link "PrefsModem"} PrefsModem @{" Dial " Link "EditorMenuDial"} EditorMenuDial @{" Dial " Link "EditorDial"} EditorDial @{" Dial " Link "EditorTools"} EditorTools @{" Dialing " Link "PrefsModem"} PrefsModem @{" Documentation for using AREXX " Link "ArexxBasics"} ArexxBasics @{" Edit " Link "EditorTools"} EditorTools @{" Edit " Link "EditorEdit"} EditorEdit @{" Edit " Link "EditorEdit"} EditorEdit @{" Edit " Link "EditorMenuEdit"} EditorMenuEdit @{" Edit " Link "EditorFull"} EditorFull @{" Edit " Link "EditorMenuEdit"} EditorMenuEdit @{" Edit Template " Link "EditorMenuEditTemplate"} EditorMenuEditTemplate @{" EMail address of the author " Link "EditorMenuAbout"} EditorMenuAbout @{" Error codes of AREXX " Link "ArexxErrorCodes"} ArexxErrorCodes @{" Exchange program " Link "Commodity"} Commodity @{" External " Link "EditorEdit"} EditorEdit @{" External file " Link "EditorEdit"} EditorEdit @{" External files " Link "PrefsPaths"} PrefsPaths @{" Features " Link "Features"} Features @{" Fields " Link "PrefsSort"} PrefsSort @{" Fields " Link "PrefsPList"} PrefsPList @{" Fields " Link "PrefsAList"} PrefsAList @{" Fields to search " Link "EditorSearch"} EditorSearch @{" File editor " Link "PrefsPaths"} PrefsPaths @{" file format " Link "EditorMenuOpen"} EditorMenuOpen @{" File Viewer " Link "PrefsPaths"} PrefsPaths @{" Filename " Link "ArexxBasics"} ArexxBasics @{" Find " Link "EditorMenuSearch"} EditorMenuSearch @{" find " Link "EditorTools"} EditorTools @{" First " Link "EditorFull"} EditorFull @{" Fonts " Link "PrefsFonts"} PrefsFonts @{" Format of the Address Field " Link "ArexxReturnAddress"} ArexxReturnAddress @{" format of the address file " Link "EditorMenuOpen"} EditorMenuOpen @{" Formfeed " Link "EditorPrint"} EditorPrint @{" Free " Link "PrefsAList"} PrefsAList @{" Full " Link "EditorMenuFull"} EditorMenuFull @{" Full " Link "EditorMenuFull"} EditorMenuFull @{" Full " Link "EditorFull"} EditorFull @{" Full " Link "EditorTools"} EditorTools @{" Generate Icon " Link "PrefsGenIcon"} PrefsGenIcon @{" Giving a filename " Link "ArexxBasics"} ArexxBasics @{" Group handling " Link "PrefsGroups"} PrefsGroups @{" Groups " Link "PrefsGroups"} PrefsGroups @{" Groups " Link "PrefsGroups"} PrefsGroups @{" Hangup String " Link "PrefsModem"} PrefsModem @{" Hardware " Link "MinConfig"} MinConfig @{" Hayes compatible " Link "PrefsModem"} PrefsModem @{" Hints and Tips " Link "Tips"} Tips @{" hotkey " Link "Commodity"} Commodity @{" hotkey " Link "ServerTooltypes"} ServerTooltypes @{" Hotkey " Link "EditorMenuQuit"} EditorMenuQuit @{" Hotkey " Link "EditorMainWindow"} EditorMainWindow @{" Ignore case " Link "EditorSearch"} EditorSearch @{" Important addresses " Link "Addresses"} Addresses @{" Info " Link "EditorMenuInfo"} EditorMenuInfo @{" Information " Link "EditorMenuInfo"} EditorMenuInfo @{" Init String " Link "PrefsModem"} PrefsModem @{" Installation " Link "Installation"} Installation @{" Installer " Link "Installation"} Installation @{" Installieren " Link "Installation"} Installation @{" interface card " Link "PrefsModem"} PrefsModem @{" interface card " Link "PrefsModem"} PrefsModem @{" Internal " Link "Internal"} Internal @{" keyboard usage " Link "UsingDFA"} UsingDFA @{" Kill " Link "EditorMenuKill"} EditorMenuKill @{" Kill " Link "EditorTools"} EditorTools @{" Kill " Link "EditorMenuKill"} EditorMenuKill @{" language " Link "Top"} Top @{" language " Link "Installation"} Installation @{" Last " Link "EditorFull"} EditorFull @{" Legal stuff " Link "Legal"} Legal @{" Licence " Link "Licence"} Licence @{" Lines " Link "PrefsPList"} PrefsPList @{" Listview " Link "UsingDFA"} UsingDFA @{" Listview (main window) " Link "EditorMainWindow"} EditorMainWindow @{" Load " Link "EditorMenuOpen"} EditorMenuOpen @{" Locale " Link "IntLocaleSupport"} IntLocaleSupport @{" locale support " Link "Installation"} Installation @{" Mark all " Link "EditorMainWindow"} EditorMainWindow @{" Mark by name " Link "EditorMainWindow"} EditorMainWindow @{" Marking addresses " Link "EditorMainWindow"} EditorMainWindow @{" Memory Condition " Link "EditorMenuInfo"} EditorMenuInfo @{" Menus " Link "EditorMenus"} EditorMenus @{" Miscelleneous " Link "PrefsMisc"} PrefsMisc @{" Modem " Link "PrefsModem"} PrefsModem @{" Native languages " Link "IntLocaleSupport"} IntLocaleSupport @{" Needed Configuration " Link "MinConfig"} MinConfig @{" network mode " Link "EditorMenuWriteAccess"} EditorMenuWriteAccess @{" Network mode " Link "PrefsNetworking"} PrefsNetworking @{" Networking " Link "PrefsNetworking"} PrefsNetworking @{" New " Link "EditorMenuNew"} EditorMenuNew @{" New " Link "EditorTools"} EditorTools @{" New " Link "EditorNew"} EditorNew @{" New " Link "EditorNew"} EditorNew @{" New " Link "EditorMenuNew"} EditorMenuNew @{" New address file " Link "EditorMenuNewFile"} EditorMenuNewFile @{" New file " Link "EditorMenuNewFile"} EditorMenuNewFile @{" New since version 1.2x " Link "ArexxImportant"} ArexxImportant @{" Next " Link "EditorFull"} EditorFull @{" Next Sel. " Link "EditorFull"} EditorFull @{" None " Link "EditorSearch"} EditorSearch @{" Ok (Edit) " Link "EditorEdit"} EditorEdit @{" Ok (Full) " Link "EditorFull"} EditorFull @{" Online Help " Link "UsingDFA"} UsingDFA @{" Open " Link "EditorMenuOpen"} EditorMenuOpen @{" order of the address fields " Link "ArexxImportant"} ArexxImportant @{" OwnDevUnit " Link "PrefsModem"} PrefsModem @{" Panel Listview " Link "PrefsPList"} PrefsPList @{" Panel-Listview " Link "EditorMainWindow"} EditorMainWindow @{" Paths and Filenames " Link "PrefsPaths"} PrefsPaths @{" Pattern " Link "EditorSearch"} EditorSearch @{" Phone " Link "PrefsModem"} PrefsModem @{" Phone " Link "EditorDial"} EditorDial @{" Phone " Link "EditorMenuDial"} EditorMenuDial @{" Phone " Link "EditorTools"} EditorTools @{" Port name for AREXX " Link "ArexxBasics"} ArexxBasics @{" Position of the Application Icon " Link "PrefsAppIcon"} PrefsAppIcon @{" Predial String " Link "PrefsModem"} PrefsModem @{" Preferences " Link "EditorMenuPreferences"} EditorMenuPreferences @{" Preferences " Link "EditorMenuPreferences"} EditorMenuPreferences @{" Presets " Link "EditorMenuEditTemplate"} EditorMenuEditTemplate @{" presets " Link "EditorNew"} EditorNew @{" Prev. " Link "EditorFull"} EditorFull @{" Prev. Sel. " Link "EditorFull"} EditorFull @{" Print " Link "EditorPrint"} EditorPrint @{" Print " Link "EditorMenuPrint"} EditorMenuPrint @{" Print " Link "EditorPrint"} EditorPrint @{" Print " Link "EditorMenuPrint"} EditorMenuPrint @{" Print " Link "EditorPrint"} EditorPrint @{" Print " Link "EditorTools"} EditorTools @{" Print " Link "EditorPrint"} EditorPrint @{" Print form " Link "EditorPrint"} EditorPrint @{" Print style " Link "EditorPrint"} EditorPrint @{" Print to " Link "EditorPrint"} EditorPrint @{" program language " Link "Top"} Top @{" program texts " Link "Top"} Top @{" Public Screen " Link "PrefsTooltypes"} PrefsTooltypes @{" Public Screen " Link "EditorTooltypes"} EditorTooltypes @{" Quick Start " Link "Quick Start"} Quick Start @{" Quit " Link "EditorMenuQuit"} EditorMenuQuit @{" Quit (DFA-Editor main window) " Link "EditorMainWindow"} EditorMainWindow @{" Quit Preferences " Link "PrefsMainWindow"} PrefsMainWindow @{" Radio button " Link "UsingDFA"} UsingDFA @{" Receiving AREXX commands " Link "ArexxBasics"} ArexxBasics @{" Redial delay " Link "PrefsModem"} PrefsModem @{" Registration " Link "Registration"} Registration @{" Registration " Link "Registration"} Registration @{" Registration in Australia " Link "AustraliaRegSite"} AustraliaRegSite @{" Registration in England " Link "EnglishRegSite"} EnglishRegSite @{" Registration in France " Link "FrenchRegSite"} FrenchRegSite @{" Registration in Germany " Link "GermanRegSite"} GermanRegSite @{" Registration in the USA " Link "USARegSite"} USARegSite @{" Remove " Link "EditorMenuRemove"} EditorMenuRemove @{" Remove " Link "EditorMenuRemove"} EditorMenuRemove @{" Remove (DFA-Editor main window) " Link "EditorMainWindow"} EditorMainWindow @{" Remove (DFA-Editor main window) " Link "EditorMenuRemove"} EditorMenuRemove @{" Remove DFA " Link "PrefsMainWindow"} PrefsMainWindow @{" Retries " Link "PrefsModem"} PrefsModem @{" Retries " Link "PrefsNetworking"} PrefsNetworking @{" Retry delay " Link "PrefsNetworking"} PrefsNetworking @{" Return of address items " Link "ArexxReturnAddress"} ArexxReturnAddress @{" RXERR_APPENDFAILED " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_CRTEXTIO " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_CRTPORT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_ENVCHANGED " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_MODIFIED " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOCURRENT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NODIR " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOEXTERNAL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOFILE " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOFILENAME " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOFIRST " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOICONIFY " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOLAST " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOLOAD " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOMEM " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKAPPEND " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKCLEAR " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKEDIT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKKILL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKNEW " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKSAVE " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKSELECT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONETWORKSORT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONEXT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NONEXTSEL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOPHONENUM " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOPREV " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOPREVSEL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NORELOAD " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOSAVE " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOSERIALDEV " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOTFOUND " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_NOWRITELOCK " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_OPNPRT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERBUSY " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERCONNECT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERERROR " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERNOCARRIER " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERNODIALTONE " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SEROK " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERRING " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERUNKNOWN " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SERVOICE " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_SYNTAX " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_WRITEALL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_WRITECURRENT " Link "ArexxErrorCodes"} ArexxErrorCodes @{" RXERR_WRITESEL " Link "ArexxErrorCodes"} ArexxErrorCodes @{" Save " Link "EditorMenuSave"} EditorMenuSave @{" Save " Link "EditorMenuSave"} EditorMenuSave @{" Save as default " Link "EditorMenuSaveasdefault"} EditorMenuSaveasdefault @{" Save as default " Link "EditorMenuSaveasdefault"} EditorMenuSaveasdefault @{" Save as... " Link "EditorMenuSaveas"} EditorMenuSaveas @{" Save as... " Link "EditorMenuSaveas"} EditorMenuSaveas @{" Save Preferences " Link "EditorMenuSavePrefs"} EditorMenuSavePrefs @{" Save Preferences " Link "PrefsMainWindow"} PrefsMainWindow @{" Save Preferences " Link "EditorMenuSavePrefs"} EditorMenuSavePrefs @{" Search " Link "EditorMenuSearch"} EditorMenuSearch @{" Search " Link "EditorMenuSearch"} EditorMenuSearch @{" Search " Link "EditorSearch"} EditorSearch @{" Search " Link "EditorTools"} EditorTools @{" Search " Link "EditorSearch"} EditorSearch @{" search " Link "EditorTools"} EditorTools @{" Search criteria " Link "EditorMenuSearch"} EditorMenuSearch @{" search criteria " Link "EditorTools"} EditorTools @{" Search for " Link "EditorSearch"} EditorSearch @{" Search Next " Link "EditorMenuSearchNext"} EditorMenuSearchNext @{" Search Next " Link "EditorTools"} EditorTools @{" Secret Mode " Link "PrefsSecretMode"} PrefsSecretMode @{" Select device " Link "PrefsModem"} PrefsModem @{" Selection " Link "EditorMainWindow"} EditorMainWindow @{" Selection: All " Link "EditorMainWindow"} EditorMainWindow @{" Selection: By name " Link "EditorMainWindow"} EditorMainWindow @{" Selection: Clear " Link "EditorMainWindow"} EditorMainWindow @{" Selection: Jump to " Link "EditorMainWindow"} EditorMainWindow @{" Serial device " Link "PrefsModem"} PrefsModem @{" serial interface " Link "PrefsModem"} PrefsModem @{" serial interface " Link "PrefsModem"} PrefsModem @{" Serial number " Link "EditorMenuAbout"} EditorMenuAbout @{" Serial number " Link "PrefsMainWindow"} PrefsMainWindow @{" Serielles Ger t " Link "PrefsModem"} PrefsModem @{" shared access " Link "EditorMenuWriteAccess"} EditorMenuWriteAccess @{" shortcut " Link "UsingDFA"} UsingDFA @{" Show Application Icon " Link "PrefsAppIcon"} PrefsAppIcon @{" Software " Link "MinConfig"} MinConfig @{" Sort " Link "EditorTools"} EditorTools @{" Sort " Link "PrefsSort"} PrefsSort @{" Sort " Link "EditorMenuSort"} EditorMenuSort @{" Sorting " Link "PrefsSort"} PrefsSort @{" String Gadget " Link "UsingDFA"} UsingDFA @{" Suff. Dial String " Link "PrefsModem"} PrefsModem @{" Syntax " Link "ArexxBasics"} ArexxBasics @{" Templates " Link "EditorNew"} EditorNew @{" Templates " Link "EditorMenuEditTemplate"} EditorMenuEditTemplate @{" Text Gadget " Link "UsingDFA"} UsingDFA @{" Text Viewer " Link "PrefsPaths"} PrefsPaths @{" Thanks to... " Link "Thanks"} Thanks @{" The CheckBirthday Program " Link "CheckBirthday"} CheckBirthday @{" The concept of DFA " Link "Concept"} Concept @{" The DFA-Editor program " Link "DFAEditor"} DFAEditor @{" The DFA-Preferences Main Window " Link "PrefsMainWindow"} PrefsMainWindow @{" The DFA-Server program " Link "DFAServer"} DFAServer @{" The Main Window " Link "EditorMainWindow"} EditorMainWindow @{" The Menu Items of the DFA-Editor " Link "EditorMenus"} EditorMenus @{" Then DFA-Preferences Program " Link "DFAPrefs"} DFAPrefs @{" Title " Link "PrefsGroups"} PrefsGroups @{" Title " Link "PrefsPList"} PrefsPList @{" Tool Gadgets " Link "EditorTools"} EditorTools @{" Tool Gadgets " Link "EditorTools"} EditorTools @{" Tooltypes " Link "ServerTooltypes"} ServerTooltypes @{" Tooltypes " Link "ServerTooltypes"} ServerTooltypes @{" Tooltypes for the DFA-Editor " Link "EditorTooltypes"} EditorTooltypes @{" Tooltypes of the DFA-Preferences programms " Link "PrefsTooltypes"} PrefsTooltypes @{" Updates " Link "Updates"} Updates @{" Usage of DFA " Link "UsingDFA"} UsingDFA @{" Use Preferences " Link "PrefsMainWindow"} PrefsMainWindow @{" Used " Link "PrefsAList"} PrefsAList @{" Verbergen " Link "EditorMenuQuit"} EditorMenuQuit @{" Version number " Link "PrefsMainWindow"} PrefsMainWindow @{" version number " Link "EditorMenuAbout"} EditorMenuAbout @{" Visible lines " Link "PrefsPList"} PrefsPList @{" Warranty " Link "Warranty"} Warranty @{" Weight " Link "PrefsAList"} PrefsAList @{" Write Access " Link "EditorMenuWriteAccess"} EditorMenuWriteAccess @{" Write Access " Link "EditorMenuWriteAccess"} EditorMenuWriteAccess @EndNode