Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 632.lha / KCommodity_v1.63 / KCommodity.Doc.pp / KCommodity.Doc

Wrap

Text File | 1992-05-14 | 38.0 KB | 902 lines

***************************************************************************** K K CCCC OOO M M M M OOO DDDD I TTTTT Y Y K K C O O MM MM MM MM O O D D I T Y Y KK C O O M M M M M M M M O O D D I T Y K K C O O M M M M M M O O D D I T Y K K CCCC OOO M M M M OOO DDDD I T Y ***************************************************************************** KCommodity V1.63, a multifunctional commodity for the Amiga running under OS 2.0. ***************************************************************************** ***************************************************************************** KCommodity V1.63 is ShareWare. So all you folks out there who like my program and use it frequently please send a little donation of about 20.-DM or $20. to the address given way down that document. I think it`s accurate, since I included the whole source, which in fact may be helpful for some of you. The advantage of paying the shareware is that registered users of KCommodity will automatically receive the latest versions of my program included with a printout of this document. Maybe it will then be set with TeX and put together to a nice manual. But anyway, anyone who wants to report something about KCommodity (like Bugs, further enhancements ...) can contact me... Another word : I DO NOT TAKE ANY RESPONSIBILITY OF DAMAGES OCCURED DURING THE USAGE OF KCOMMODITY. THIS PROGRAM HAS BEEN TESTED AND I USE IT IN MY EVERY DAY WORK. ANYWAY, NO PROGRAMMER IS AWARE OF BUGS HE MIGHT PRODUCE. SO DON`T HARM ME IN THE CASE OF DAMAGE. (HARM MURPHY :-)) All you guys out there who put Public Domain, FreeWare, ShareWare, GiftWare software on your disks and request more than 10 DM or the same amount in any other currency leave your fingers off this program ! This is not `quite` helpfull keeping up these sorts of software. I included the source for KCommodity. This one is written in Assembler with all the includes you need. (I was too lazy to put them into one source file :-)) You can spread this program to whoever and whereever you want as long as you don`t use it for commercial purposes and the distribution is kept as is. It was written using DevPac version 3.01. This version of KCommodity can only be assembled under DevPac V3.01 or later versions since there are some opcodes only known to DevPac V3.01. ***************************************************************************** What the heck is KCommodity V1.63 ? ----------------------------------- It unites several tiny thingies which will be quite helpfull in your everyday use of your Amiga. First of all there is the Window-Activator of KeyActivate (from which KCommodity derived), which does more than the usual activators like AutoPoint from the workbench. These activators had one big problem : They always deactivated a stringgadget when the mousepointer was moved out of the window containing the stringgadget. That was a bug I really was crazy about. So I first wrote KeyActivate which activated a window by pressing a key and leaving that silly bug far, far behind. Being so happy about what I had achieved on that new Operating System I continued my work to have a more flexible, short commodity. Since I have plenty of tools running on my machine I really thought it to be a good idea if all, or even some of the mostly used options were put into a small and efficient commodity, so that I don`t have to start dozens of tools on startup. The other advantage is that it can have whatever I want and that all routines could be coded so they would fit my needs (not to forget any users out there which might find it useful too). So KCommodity grew and grew and other tools running got less. And here it is : KCommodity V1.63 Installation of KCommodity V1.63 -------------------------------- Simply copy KCommodity to any location you prefer and place the supplied KCXPREFFILE to ENVARC:. This file ist configured with the default values. If you want to make use of KCommodity`s online help then copy the KCX drawer to ENVARC: Starting KCommodity V1.63 ------------------------- - If you start KCommodity while startup of your system (WBStartUp) you have to add the DONOTWAIT tooltype to your list of tooltypes. The supplied icon has all the known tooltypes in it`s list set to the default values. - You have to Run/RunBack KCommodity when started from CLI/SHELL No matter how you start KCommodity the program will first read in the preferences file (if it exists) and then examines the ToolTypes. This means the ToolTypes override your preferences. If the NOICON ToolType is not set KCommodity will display an AppIcon. When clicked onto that icon KCommodity`s main window will popup. Additionaly there is a new MenuItem (KCX Main-Window) in the Tools-Menu with the same function. Terminating KCommodity ---------------------- There are several ways to terminate KCommodity. - Using the QUIT gadget or the 'Q'-Key within the control window - Starting KCommodity once again. - Using the Exchange program. No matter which way you choose to terminate the program it will take a short amount of time, since there may be some IORequests pending. Actions KCommodity can perform ------------------------------- - Windowactivation - Can be switched between KeyStroke and MouseMode and even turned off. - Clockdisplay - Has several options. Displaying the time with/without seconds, Displaying a date in either american or german notation, Displaying a weekday either full length or only three chars. All options can be combined, but if you turn on the clock the time (hour:minutes) will always be shown. And an accumulated online time, so that you know how long you`ve been online for a session. By pressing the Page-HotKey (RALT HELP) you can change between several display modes. (Time<->Memory) - Memory usage - Displays the free Chip- and FastMemory, total free memory, or graphical display of free memory. - Alarmfunction - Alarmtime can be set with/without seconds but you must at least enter hour and minutes of your requested alarmtime. Can also be turned off. - Environment variables - The current system time including day (full string), date either american or german format and time are stored within three global environment variables called DAY, DATE, TIME (what else) - Revision control system - Keeps track of any changes made to a source (well you have to tell the program what you`ve done) and adjusts revision numbers and defines for use in "$VER" strings in C, Assembler and Pascal source codes. - Screen/Mouse Blanker - The timeouts can be defined in a range from 1-999 seconds. When a key is pressed the mousepointer is automatically blanked. - Window-Cycling - This is for the easy moving of windows to the back/front of other window without hitting the depth-gadget. The left mousebutton in conjunction with the selected qualifier brings the window underneith the mousepointer to front. Using the right mousebutton in conjunction with the qualifier brings the window behind all others. - KeyStroke-Clicker - Like on professional keyboards a click is heard when a key is pressed. Volume can be adjusted. - Telefone bill calculator - Keeps track of your telefone costs due to heavy modem fun. - LeftyMouse option - Activating this option will cause KCommodity to swap the left/right mouse buttons. - ESC-WindowClose - Windows with a CloseGadget can now be close using the ESC-Key. Either with or without a qualifier. Any string gadgets that may be active at this point are deactivated first. - HotKey Shell-Start - Start a shell with your own parameters. Default HotKey is : ALT SHIFT S - Mapping of german "Umlauts" - This is usefull for the german "modem freaks" under you. You know that german "Umlauts" are not allowed on international EchoMail areas or even on some other german areas. So writing a text which contains german "Umlauts" isn`t quite funny, since you have to write two chars instead of only one. This function maps the german "Umlauts" to "normal" chars. How to deal with KCommodity ? ----------------------------- First of all there are the ToolTypes which are to be used when starting from Shell/CLI the same way as started from WorkBench. Here they are : ToolType Description Default ----------------------------------------------------------------- CXPRIORITY=n Priority of Broker 5 CXPOPKEY=s PopUpKey for Window LCOMMAND HELP CXPOPUP=YES|NO PopUp on startup NO PORTNAME=s Set name for ARexx-Port KComm.1 TOOLPRI=n Priority of Program 21 (Must be > 21) NOICON Don`t display AppIcon --- Special infos about dealing with StringGadgets of KCommodity ------------------------------------------------------------ Each window of KCommodity (except for the small StatusWindow and the Logwindow) has a menu attached to it. Most (or even all) of the given menuitems have a keyboard-shortcut. So while you`re in a StringGadget you normaly have to deactivate the StringGadget first to get access to a menu-shortcut. Not with KCommodity. Just use the shortcut you like and KCommodity will perform the action you wanted it to do :-) It will then reactivate the last gadget again if needed. The two MAGIC keystrokes RIGHT AMIGA X/Q which are mapped with edit functions within StringGadgets may be needed for menu-shortcuts sometimes. To have these two executed the way the others are executed simply press the shortcut combined with any SHIFT (eg. RAMIGA-SHIFT-Q to quit KCommodity ... dare you). There are more functions within KCommodity for editing StringGadgets. - The next available String/Integer-Gadget will be activated after a RETURN. - The previous String/Integer-Gadget will be activated after a SHIFT-RETURN. - Pressing ESC does the same as pressing HELP -> It escapes the String/ Integer-Gadget without activating the next one. - As mentioned -> Menu-Shortcuts from within String/Integer-Gadgets. - Using CURSOR UP/DOWN to get to the previous/next gadget. - Using CONTROL CURSOR LEFT/RIGHT to get to the previous/next word. Standard editing modes are supported too : - TAB activates the next available String/Integer-Gadget - SHIFT-TAB does the opposite - HELP is used to escape String/Gadgets. - RIGHT AMIGA-X clears the input buffer. - RIGHT AMIGA-Q restores the previous input buffer. Online-Help Function of KCommodity ---------------------------------- If you press HELP within one of the following windows a small help text will be shown describing the window`s purpose. Main window, Bill window, Preferences window and HotKeys window Since these windows all have menus attached to themselves there is another possibility to get Online-Help : Position your mouse over the menu-item you want help for and press the HELP-Key. The Help window openes up. Within the Help window you can scroll through the help text using the gadget on the right or your cursor keys. The cursor keys are mapped as follows : CUROSR UP Move one line upward CUROSR DOWN Move one line downward SHIFT-CURSOR UP Move one page upward SHIFT-CURSOR DOWN Move one page downward Configurating KCommodity while runtime. --------------------------------------- Just press your PopUp-HotKey (default : LCOMMAND HELP), select the AppIcon , the "KCX Main-Window" MenuItem of Tools-Menu, or select the SHOW gadget of the Exchange program of your WorkBench and a window will pop up displaying several gadgets. - Window activate Enable/Disable windowsctivation. - MouseMode Enable/Disable window activation via mouse. If unset a keystroke will activate windows. - Display clock/mem Turn on display for clock/memory. - Display in window Display clock/memory within a window - Show secondz Additionaly display seconds. - Show date Display date. - American date Display date in english notation. If unset it will be shown in german notation. - Show day Show name of current day. - Short day string Only three chars per day. - Alarm on Turn alarm on/off. - Key-Click Turn KeyStroke-Clicker on/off. - Write environment Save day, date and time to environment variables called DAY, DATE and TIME (what else). - Window cycling Enable/Disable cycling of windows. - WB to front Enable/Disable pop to front of workbench, when KCommodity`s main window is opened. - LeftyMouse Activate LeftyMouse option. - ESC WindowClose Enable/Disable option for closing a window on Key-Stroke. - Map "Umlauts" Enable/Disable mapping of "Umlauts" - Win Qualifier Click on this gadget to change the qualifier for use with the window-cylce option. The shown qualifier will be the one to be used to bring a window to front/back. Use left button for popping a window to front and the right button for popping a window behind all others. - ESC Qualifier This one is to be used to change the qualifier for the ESC-Key to close windows. If a gadget is active on the current window this function is ineffective. NOTE ON CLI-WINDOWS : NEVER USE THIS FUNCTION WHILE A PROGRAM IS RUNNING AND BLOCKING THE CLI/SHELL. - Alarm time Change/Enter alarm time. You must at least enter hour:minutes (seconds are optional). Any errors in alarm time will be trapped and if one was found the time is reset to the previously used. - User Shell Lets you define the parameters for the new shell - Screen time You can enter a timeout value for the screen-blanking. 1-999 seconds. If entered 0 the screenblanker will be disabled. Entering a negative value will also cause the previous value to be restored. - Mouse time Same as above, but for the timout value of mouse-blanking. - Click vol You can enter a new volume of the click sound. Illegal values ( < 0, > 64 ) will be ignored and the value is reset to the previous value. - Telefone bill... Pops up the window telling you how much the current call will cost. Changes on timezones and tariff can be made here. - Telefone prefe .. Within this window you can customize the times for one unit and the cost of unit itself. You can also specify a new logfile the logs of each call should be written to. Finally you can retrieve the total cost of your calls. - HotKeys... Let the HotKeys window popup - Load Prefs... You guessed it : A FileRequester will pop up giving the possibility to select new preferences. - Save Prefs... This one`s easy. You can save the current settings to a file using a FileRequester. - Enable Enable KCommodity`s broker. - Disable Disable KCommodity`s broker (NOTE : All HotKeys are also disabled. You have to use Exchange, the AppIcon, or the MenuItem to pop up the window again.) - Hide Hide the window - Quit Leave KCommodity - CLOSEGADGET same as Hide. All gadgets can also be selected using a keystroke. The keystroke for a gadget is marked by an underscore in the gadget`s text. Alternatively you can select menu items or use their ShortCuts. While any of KCommodity`s windows is present and moved the program will remember it`s positions so that every time you pop up the window again it will be located to it`s previous position. The menus of KCommodity`s Main window ------------------------------------- - Project - Load Preferences... Load new preferences for KCommodity - Save Preferences Save current preferences to file specified by "Save preferences as..." or to default : ENV:KCXPREFFILE. If you want to keep the prefs permanently then you will have to use "Save preferences as...". - Save Preferences as... Specify a new name for preferences and write prefs to this file. - Enable Same functions as mentiond above - Disable - Hide - About... Displays a short "about" and gives you the possibility to print out a registration form to PRT: - Quit Guess what ??? - Enable/Disable These are menu alternatives for the Gadget-ShortCuts. The have the same ShortCuts as the ones for the Gadgets. - Other settings You can activate the StringGadgets via menu. - Windows Open the different windows KCommodity provides. The HotKeys window ------------------ Shown are 6 string gadgets giving the possibility to change KCommodity`s HotKeys. Simply enter the new ones. If the alternative HotKey could not be installed KCommodity uses the last one. NOTE : Make sure that the HotKeys you enter are not already in use by other programs so that it doesn`t conflict. HotKey-Definitions ------------------ Here is a list of descriptive strings for defining the HotKeys. Just type them down the way you like, they are case-insensitive and take the form : [<qualifier> [<qualifier>...]] <key> Qualifiers alt either Alt key ralt right Alt key lalt left Alt key shift either Shift key rshift right Shift key lshift left Shift key capslock Caps Lock key rcommand right Amiga key lcommand left Amiga key control Control key numericpad Enables the use of a key on the numeric keypad rbutton Click the right mouse button midbutton Click the middle mouse button leftbutton Click the left mouse button newprefs Preferences changed diskremoved Disk removed diskinserted Disk inserted Keys a .. z, 0 .. 9, etc. Normal keys f1 .. f10 Function keys up, down, left, right Cursor keys help Help key del Delete key return Return key enter Enter key (only in conjunction with 'numericpad') backspace Backspace key esc Escape key space Space key comma Comma key upstroke Upstroke key The Revision Control System --------------------------- This one`s my favorite :-) While working on a program the programmer sometimes (not all of them) wants to know what he changed since his last changes (or working version). So a revision control system may be helpful in keeping track of the revisions made to a program. That`s where KCommodity`s revision control systems gets to work. Imagine you`ve just added a new, great function to you program and you want to put the info about what you`ve done into your source code, so that you can see how development processed during the last times. Entering the log message 'by hand' isn`t quite satisfactory. Wouldn`t it be nice if these things were formatted by a program ? This is it, what KCommodity does for you. And even more. It increases the current revision number every time you use it on your source and adds a define/macro for the revision at the bottom of the revision header for use in a "$VER:..." string so that the program VERSION can print out the current version of a program. How to use it ? This function can only be accessed using ARexx. The syntax is : REVISE FileName (ASM|C|PAS) So just enter a filename and an identifier (ASM for Assembler source, C for C source or PAS for Pascal source) and KCommodity gets to work. First it checks whether a header is already persent in the current file. This header doesn`t have to be on top of the file. KCommodity searches within the first 15 lines of your source so you can insert lines in front of the header. Having recognized that no header is present a window pops up asking for a purpose message (this message can have 5 lines with 75 chars per line). Just enter a message as you wish. When pressing RETURN the next string gadget will be activated. If it was the last gadget the first gadget will activated. You can use HELP for escaping any string/integer gadget without activating the next one. TAB-Key cycles the string/integer gadgets downward. SHIFT-TAB does the opposite. The two integer gadgets at the bottom of the window are used to enter a revisionnumber to start/continue with. Simply enter the new revision number and KCommodity will properly insert it. If nothing is entered or if you enter 0.0 then KCommodity will use 1.0 (on first revision) or will continue with the next higher revision (1.0 -> 1.01). Having finished your inputs you can either cancel the system by pressing the CANCEL-Gadget, the C-Key, the CLOSE-Gadget or the ESC-Key. Otherwise you can press the OK-Gadget or the O-Key to continue. KCommodity now starts to build up the header. It will be initialized with a standard Log Message (will be "initial relase"), the purpose message (without any blank lines you might have eneterd to save space) and of course the first define for your "$VER:...". Behind the revision number it will create a define for the revision date, so that you can put the date into messages of your program. The remaining part of your "original" will just be appended to the "new" file. KCommodity will store the result of the creation in a temporary file in T:, so make sure you have enough Disk/RAM space and that you`ve assigned T: to a directory you desire. Having done it`s job, KCommodity copys the temporary file back to the original and then deletes the temp file. Revision of an already revised source : KCommodity again searches for the header string within the first 15 lines of your file in the specified language. If it is successful, it will pop up a Log Message window. (if not, the purpose and initial release part will be worked through) The control of this window is the same as for the purpose window. Having finished your input KCommodity again gets to work. It increases the revision number (or even takes the user-defined), adds the new LogMessage in front of the previous one and refreshs the defines, so that the revision number reflects the current revision and that the date does the same. NOTE: If the first define is not present or is not located right after the header KCommodity "thinks" that the user is fed up with the defines and just leaves them out and continues it`s work without defines. Finally it just appends the rest of the "original". It then copys the temp file to the original and deletes the temp file..... This is what a revision header would look like in an Assembler source : (having revision 1.01. That means one change made since initial release. revision was made on 05-Jan-92) ; ; Maximum of 14 lines above header allowed (after creation of header) ; ;* $Revision Header built by KCommodity by Kai Iske *** (do not edit) ********** ;* ;* Copyright by <COMPANY> ;* ;* File : <this would be the name of the file> ;* Created on : Sunday, 05-01-92 02:27:25 ;* Created by : <AUTHOR> ;* Current revision : V1.01 ;* ;* ;* Purpose ;* ------- ;* This is just a test for the purpose string ;* and a second line ;* ;* Revision V1.01 ;* -------------- ;* changed on Sunday, 05-01-92 02:27:45 by <AUTHOR>. LogMessage : ;* And a test for a LogMessage ;* second line ;* third line ;* ;* Revision V1.00 ;* -------------- ;* --- Initial release --- ;* ;******************************************************************************* REVISION MACRO ; This is the macro for the revision number dc.b "1.01" ENDM REVDATE MACRO ; This is the macro for the revision date dc.b "05-Jan-92" ENDM ; ; This is where your program might start ; Just use these macros in your sources. An implementation could look like like this : dc.b "This is my program V" REVISION dc.b " created on (" REVDATE dc.b ")",0 Never forget a trailing 0-Byte at then end of the string. NOTE TO PREVIOUS USERS : You wil have to change the layout of the defines to have KCommodity remake them. So just remake the defines to the new format. The defines for C and Pascal sources take the same names and are handeled the same way. NOTE FOR PASCAL SOURCES: In order to have the defines available, KCommodity adds the CONTS qualifier right after the revision header. So you have to put all other constants behind the ones defined by KCommodity. Otherwise your source will get mixed up. To have the <COMPANY> and <AUTHOR> fields filled in you have to set two environment variables (for example like this) : SetEnv COMPANY "My Company" SetEnv AUTHOR "Hey that`s me" If one variable or both of them could not be found by KCommodity it will set the unset field to "--- Unknown ---". When CANCEL was hit within the Purpose/LogMessage window REVISE will return FALSE (0) in the ARexx-Variable RESULT. Otherwise if OK was hit REVISE will return TRUE (1). So you can distinguish whether to continue your ARexx-Script or not. So enjoy this feature of KCommodity helping you to keep track of revisions. Telefone bill calculator ------------------------ This one is seperated into two windows you can get to by using the "Telefone bill..." / "Bill preferences..." Gadgets. Let`s get to the preferences. This window shows six integer gadgets near to each other. Two in a row represent the normal and cheap tariffs for one of the three timezones KCommodity manages. Simply enter the amount of seconds for one unit you would like to have. For example here are the settings for the current tariffs in Germany. We have three different zones (that`s why I`ve only implemented three for now) and two tariffs. Normal Time/Unit 1 : 360 Means 6 minutes for one unit Cheap Time/Unit 1 : 720 12 . . . The times default to the current tariffs of the german telefone company. The next one is the gadget which represents the cost for one unit. This one is made in 1/100 that means cents, Pfennige.... Just enter your local costs. Now following are two mutual exclude gadgets for setting the default timezone and tariff. These settings will be stored in the preferences file and will be loaded each startup, so that the settings of the bill window will default to the mostly used. Use the "PopUp Bill window" gadget so that the bill window will popup on carrier detection. With a deselected "Log calls" gadget the data of a call will not be saved to the specified file. To get rid of a log file simply press the "Clear log" gadget. On pressing the "Save Log to..." a FileRequester will popup giving you the possibility to specify a new logfile your logs will be written to next time. If you are already shure where to put it you can simply enter the name of the log file into the string gadget next to the "Save Log to..."-gadget. The next one`s an easy one. "Total sum..." will open up a window showing the contents of your specified logfile. After all calls of one day have been listed KCommodity will print out the sum for that day. At the end of the logfile you are given the total costs for all the phone calls made. The Bill window. This one reflects the current time, online time and costs arising from the current/last phone call. Within this window there are two gadgets giving you the possibility to change the timezone/tariff for the call. Just click on the zone/tariff gadget you like to use for this call. If you are already online KCommodity will recalculate the costs, so that changing the settings will allways result in the correct costs for a call. Underneith these gadgets the cost for one hour of a phone call will be shown according to the current settings. ARexx-Capability ---------------- There is another possibility to configure KCommodity or even retrieve settings of the program. First of all here come the ARexx commands KCommodity can deal with. ACTIVATE 1|0 Enable/Disable Window-Activation MOUSEMODE 1|0 Enable/Disable SUN-Style Window-Activation SHOWCLOCK 1|0 Enable/Disable Clock/Memory displaying CLOCKWIN 1|0 Enable/Disable Clock/Memory window CLOCKWINPOS 'X/Y' Set Clock/Memory window to new position SHOWDATE 1|0 Enable/Disable viewing of date SHOWDAY 1|0 Enable/Disable viewing of day SHORTDAY 1|0 Only display 3 chars for the day SHOWSECS 1|0 Enable/Disable viewing of seconds AMIDATE 1|0 Enable/Disable american date-format PAGEKEY 'string' Set HotKey for changing Clock/Memory displays PAGENUM (0-4) Number of page to be displayed ALARM 1|0 Enable/Disable alarm ALARMTIME 'hh:mm[:ss]' Set alarm time SETENV 1|0 Enable/Disable writes of date/time to env vars SCREENTIME 'secs' New timeout value for screen blanking MOUSETIME 'secs' New timeout value for mouse blanking CYCLEWIN 1|0 Enable/Disable window-cycling CYCLEKEY (0-3) Specify new qualifier number for Window-Cycling CLICK 1|0 Enable/Disable keystroke-clicking CLICKVOL (0-64) Set new volume for clicking LOGCALLS 1|0 Log each phone call BILLWINPOS 'X/Y' Set new position for BillWindow BILLPOPUP 1|0 Enable/Disable PopUp of Window on Carrier Detect PREFSWINPOS 'X/Y' Set new position for preferences window WBFRONT 1|0 Enable/Disable popup of WorkBench LEFTYMOUSE 1|0 Enable/Disable LeftyMouse ESCCLOSE 1|0 Enable/Disable ESC-WindowClose ESCKEY (0-4) Qualifier-number for ESC-WindowClose MAPUMLAUT 1|0 Enable/Disable mapping of "Umlauts" CLEARLOG Clears the log file LOADPREFS 'string' Load a preferences file specified by 'string' SAVEPREFS 'string' Save preferences to file specified by 'string' CXPOPKEY 'string' Change PopUp HotKey for control window BILLKEY 'string' Set new Bill window HotKey PREFSKEY 'string' Set new Preferences window HotKey HOTWINKEY 'string' Set new HotKeys window HotKey SHELLKEY 'string' Set new Shell HotKey UMLAUTKEY 'string' Set neu "Umlauts" HotKey SHELLCOMM 'string' Set new NewShell-Command ENABLE Enable Commodity`s work (HotKeys, Activation) DISABLE Disable " " " HIDE Hide the control window of KCommodity POPUP Let the control window popup STATUS Returns information about settings (see below) REVISE 'File' [C|ASM] Start the revision control system NOTE : All parameters surrounded by ' have to be given in quotes, so that ARexx doesn`t complain about it. Values for PAGENUM 0 : Display time 1 : Display free Chip/Fast memory seperately 2 : Display total free memory 3 : Display free memory as a gauge 4 : Display online time Values for CYCLEKEY 0 : Any alt key 1 : Any amiga key 2 : Any shift key 3 : Control key Values for ESCKEY 0 : Any alt key 1 : Any amiga key 2 : Any shift key 3 : Control key 4 : none List of STATUS numbers KCommodity currently recognizes ------------------------------------------------------ 1 Value : Priority of the whole program 2 Value : Priority of Broker. 3 String : POPUPKEY (default : LCOMMAND HELP). 4 BOOL : Should KCommodity pop up on startup 5 BOOL : State of activation (ON/OFF) 6 BOOL : SUN-Style mode (ON/OFF) 7 BOOL : Clock/Memory display (ON/OFF) 8 BOOL : Clock/Memory window (ON/OFF) 9 String : Returns position of Clock/Memory window Takes the form X/Y. 10 BOOL : Display date (ON/OFF) 11 BOOL : Display day (ON/OFF) 12 BOOL : Display seconds (ON/OFF) 13 BOOL : American date-format (ON/OFF) 14 String : Returns HotKey for changing Clock/Memory displays 15 LONG : Number of currently displayed page (0-4) 16 BOOL : Are we to alarm at alarmtime (YES/NO) 17 String : Returns currently set alarm time (hh:mm[:ss]) 18 BOOL : Is Broker (HotKeys, Activation) disabled (YES/NO) 19 BOOL : Tell us whether control window is popped up (YES/NO) 20 BOOL : Tell us whether environment vars are activated (YES/NO) 21 BOOL : Tell us whether to display the full day string (YES/NO) 22 LONG : Returns timeout value for screen blanking (0 = disabled) 23 LONG : Returns timeout value for mouse blanking (0 = disabled) 24 BOOL : Window-Cycling enabled (YES/NO) 25 LONG : Number of cycle qualifier (0-3) 26 BOOL : KeyStroke-Clicking enabled (YES/NO) 27 LONG : Volume for KeyStroke-Clicking (0-64) 28 BOOL : Logging of phone calls enabled/disabled (YES/NO) 29 String : Position of Bill window 30 BOOL : PopUp on Carrier Detect of Bill window (YES/NO) 31 String : Position of preferences window 32 BOOL : PopUp WB on openup of main window (YES/NO) 33 BOOL : LeftyMouse enabled (YES/NO) 34 BOOL : ESC-WindowClose enabled (YES/NO) 35 LONG : Qualifier for ESC-WindowClose (0-4) 36 String : HotKey for popping up Bill window 37 String : HotKey for popping up Preferences window 38 String : HotKey for popping up HotKeys window 39 String : HotKey for popping up a new shell 40 String : HotKey for changing "Map Umlauts" mode 41 String : Parameters for execution with NewShell 42 BOOL : Mapping of "Umlauts" enabled/disabled (YES/NO) NOTE: (ON/OFF) and (YES/NO) are not strings in that case, these are just boolean values, which take the value of 1 or 0 according to current settings. REMEMBER: The default Port for ARexx commands is KComm.1. So if you didn`t change the default name issue ADDRESS 'KComm.1' at the top of your scripts to access KCommodity. Enhancements to come. --------------------- Waiting for suggestions. -------------------------------------------------------------------------- To contact me just write to : Kai Iske Brucknerstrasse 18 6450 Hanau 1 Germany Tel.: +49-(0)6181-850181 (weekdays only from 6:00 PM) or send an E-Mail to : FIDO : 2:249/40.11, Kai Iske SMBX : GURU:SNAKE ZNET : SNAKE%HTH@AMNET.ZER ANNET: SNAKE%HTH.AMN or on a local BBS without net support : Star League BBS: 069/5927709 Pyramania BBS: 069/543603 HitchHicker BBS: 069/5975113 They all are located in Frankfurt/M GERMANY. These are the places I usually can be found most of the time. Just write an E-Mail to SNAKE. You can also get the latest releases of KCommodity there. Otherwise you might get it from one of the next Fred Fish Disks or KickStart Disks. Just let me know about any questions and suggestions.........