@database AmiComSysMUI.guide @master AmiComSysMUI.guide @index ACSindex @$VER: AmiComSysMUI.guide 1.31 (16.11.97) @author "Håkan Parting"@(c) "Håkan Parting 1997" @FONT times.font 15 @WORDWRAP @node "Main" "Contents" @{b}@{fg shine}Amiga Communication System 1.15-MUI@{ub}@{fg shine}@{fg back}@{fg text} http://amicomsys.tibb.at Copyright © 1997 Håkan Parting All rights reserved. ShareWare Read History for new features ... Read upgrade to 1.15 to upgrade. @{"Copyright and disclaimer" link "Copyright"} @{fg shine}This work is mine, but I'm not responsible for any damage.@{fg text} @{"ShareWare registration" link "registration"} @{fg shine}What I want from you@{fg text} @{"Introduction" link "Intro"} @{fg shine}What is this?@{fg text} @{"Requirements" link "Requirements"} @{"Installation" link "Install"} @{fg shine}How to install@{fg text} @{"Upgrade to 1.15" link "upgrade"} @{"Usage" link "Usage"} @{fg shine}How to use it.@{fg text} @{"Features" LINK "Features"} @{fg shine}The user interface ...@{fg text} @{"Settings" LINK "Settings"} @{"ARexx interface" LINK "ARexx"} @{"History" link "history"} @{fg shine}Fixed bugs and improvements.@{fg text} @{"To do" link "todo"} @{fg shine}Future@{fg text} @{"Bugs" link "bugg"} :-( @{"The Author" link "me"} @{fg shine}Contact me!@{fg text} @{"Credits" link "thanks"} @{"Updates" link "updates"} @{fg shine}Where to find updates@{fg text} @{"Trademarks" link "trademarks"} @{"Index" link "ACSindex"} @endnode @node "Copyright" "Copyright" @{b}@{u}@{fg shine}COPYRIGHT@{uu}@{fg text} @{b}AmiComSys - Amiga Communication System Copyright 1997 Håkan Parting@{ub} @{b}All rights reserved.@{ub} @{b}The unregistered Amiga Communication System - AmiComSys is ShareWare@{ub} and may be freely spread, if no files are added, deleted or modified. If you register you will get a personalized keyfile which will enable all features. @{b}That keyfile is private and only the licensee is allowed to use it, on one computer at a time.@{ub} The licensee is not allowed to use his/her keyfile on any public machine - Amiga. @{b}The AmiComSys keyfile is NOT public domain and may not be spread freely. If you do so it's considered as an act of piracy.@{ub} Magazines are allowed to distribute the AmiComSys archive on their Coverdiscs, @{b}but then I would appreciate if you send @{"me" link "me"} something, for instance a copy of your mag.@{ub} Aminet and Aminet CD have my permission to distribute AmiComSys. BBS:es are allowed to distribute AmiComSys if they do not take out any download fee. Nobody but myself are allowed to make any profit from AmiComSys. PD-companies are allowed to distribute AmiComSys if they only take out the cost of copying and disk (max. 25 SEK, £3, 5 DM). @{u}@{fg shine}@{b}DISCLAIMER@{fg text}@{uu}@{ub} @{b}THIS SOFTWARE IS PROVIDED "AS IS". NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION OF THIS SOFTWARE, AND ALL USE IS AT YOUR OWN RISK. THE AUTHOR DO NOT ASSUME ANY RESPONSIBILITY OR LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE.@{ub} @{ub} @endnode @node "registration" "Registration" @{b} @{fg shine}@{u}ShareWare registration@{uu}@{fg text}@{ub} @{b}If you use AmiComSys regularly and like it you have to register.@{ub} If you register you will get a personalized keyfile, which will enable all features. The unregistered AmiComSys has this disadvantages: * All @{"security options" link "securitysettings"} is disabled, e.g messages can not be turned off. * @{"Send confirmation" link "settings"} is always enabled. * A @{"NotifyArexx.amicomsys" link "notifyarexx"} script can not be used. By registering you support the shareware concept and will help me to improve AmiComSys, and in further development on Amiga, the computer we all like so much ... The registration fee is currently (May be increased in the future): For an uuencoded emailed keyfile: @{b}80 SEK OR 12 US$@{ub} For a keyfile on disk sent to you: @{b}100 SEK OR 15 US$@{ub} Send the fee in bills with a letter telling me that you want to be a registered user of AmiComSys. No other currencies than US Dollar or Swedish Crowns (SEK) are accepted. @{b}Don't forget to include your name, address and emailaddress. If you register for someone other than yourself you most also include his/her name, address and emailaddress.@{ub} The fee may also be transfered to one of the accounts below or sent with an international money order. @{b}Eurocheques are NOT accepted!@{ub} They are not cashable in Sweden. @{b}If you want to have an emailed keyfile do this, step by step:@{ub} 1. Send the fee to me with your name, address, and email address by ordinary mail. 2. Do you have a public PGP key? @{"Yes!" link "yespgp"} @{"No!" link "nopgp"} BANK-ACCOUNTS: FOR SWEDES: Du kan sätta in avgiften på mitt PostGiro 421 38 50-3. Du kan också sätta in pengar på konto 5392-00-39742 i SE-Banken. Det går också att girera till detta genom att sätta in pengarna på bankens PostGiro 54 68 73-1. Betalningsmottagare: "SE-Banken 5392". Glöm inte att skriva föjande på meddelandedelen: "Insättes på konto 5392-00-39742, Håkan Parting". Inga meddelanden till mig kan lämnas på inbetalningskortet. OTHERS: Please transfer money to bank account 5392-00-39742 in the bank "Skandinaviska Enskilda Banken" of Sweden, Håkan Parting. @endnode @node "yespgp" "Yes" 3. Send me the shareware fee. 4. Email me your Public PGP Key. 5. When I've received your payment I will send you the key PGP-encoded. 6. PGP-decode the file AmiComSys.key you get from me, and copy it to your AmiComSys directory. 7. It is now ready to use. @endnode @node "nopgp" "No" 3. Send me the shareware fee. 4. Run the AmiComSysRegister program in the AmiComSys/Register directory. 5. The file AmiComSys/Register/AmiComSys.key1 is then created. 6. Email AmiComSys.key1 to me either uuencoded or MIMEd. 7. When I've received your payment I will send you the key uuencoded. 8. When you get the response from me, copy the file AmiComSys.key2 to your AmiComSys/Register/ directory. 9. Run the program AmiComSysMakeKey in the AmiComSys/Register directory. 10. Your keyfile is now ready to use. It is installed in the AmiComSys directory. @endnode @node "updates" "Updates" @{b}@{fg shine}@{u}Updates@{ub}@{uu}@{fg text} The most recent version can always be found on Aminet:comm/net/AmiComSys.lha (e.g. wuarchive.wustl.edu, ftp.sunet.se/pub/aminet, ftp.netnet.net) Latest version always available at my homepage: http://hem.passagen.se/hparting/amigapa.html or http://amicomsys.tibb.at @endnode @node "Intro" "Introduktion" @{b}@{fg shine}@{u}Introduction@{ub}@{fg text}@{uu} AmiComSys is a AMarquee client program which you use to send messages to other people on a tcp/ip-net - e.g Internet. Now you can say Hi! to your friends on the net, or just see if they are connected. You can: * send text messages * send chat requests * send WEB-requests. * transfer files. * have a public chat Future updates will include support for personal chat and more. Both Gadtools- and MUI-GUI-version available. Please put it in your Online-script or wbstartup drawer and enjoy ... AmiComSys requires amarquee.library v.45+ in LIBS:. Get it from the AMarquee-package - aminet:comm/net/AMarqueeX.xx.lha Note that the above only apply if your friends is using AmiComSys, and have an Amiga. ( An IBM-PC-version of AMarquee.library would be nice, or better a java class :-)) Features: * Send text messages. * Includes a client list, which shows people which have logged in. * Send WEB- or Chat-requests. * Totally Font Sensitive UserInterface. * A message history buffer, which saves all the received messages. * Logging * MUI and a GadTools-version. * Arexx interface * File transmission. * Public chat (HotLine) See @{"To do" link "todo"}. @endnode @node "Requirements" "Requirements" @{b}@{fg shine}@{u}Requirements@{ub}@{fg text}@{uu} An Amiga with Kickstart V37+ (WB 2.04+) An tcp/ip-stack like Miami, AmiTCP3.0b2+ or INET225. The shared library AMarquee.library v.45+. Aminet:comm/net/AMarqueex.xx.lha MUI 3.8 for the MUI-version. The MUI costum class NList.mcc. Aminet:dev/mui/MCC_NList0_75.lha @endnode @node "Install" "Installation" @{b}@{fg shine}@{u}Installation@{ub}@{fg text}@{uu} Just copy all the files to wherever you want, but please preserve the file structure. AmiComSys.MUI is ready to be run. If you put AmiComSys in WBStartup drawer you must set the PROGDIR ToolType to the path of your AmiComSys directory. If you don't arexx scripts will not work. (SendWEB and SendFTP). Note: The Gadtools-version is now available in another archive at aminet and other sources: aminet:comm/net/AmiComSys.lha I recommend you to check the Time Zone settings( under the Program tab). The time zone should be right if you have configured Workbench Locale preferences appropriate, but if it's Distant Savings Time you must check the checkbox (mostly in the summer time). AMarquee v.45+ must be installed on your system. Can be found on aminet:comm/net/Amarqueex.xx.lha @endnode @node "upgrade" "Upgrade to 1.15" @{b}@{fg shine}@{u}Upgrade from an earlier version@{ub}@{fg text}@{uu} @{b}New files since version 1.14abc is:@{ub} AmiComSys/AmiComSys.MUI AmiComSys/AmiComSys.MUI.info AmiComSys/AmiComSysMUI.guide AmiComSys/Contrib/AmiComSys.dock AmiComSys/Rexx/SendWEB.amicomsys AmiComSys/Rexx/SendFTP.amicomsys @endnode @node "Usage" "Usage" @{b}@{fg shine}@{u}Usage@{ub}@{fg text}@{uu} @{b}If to use it from Workbench:@{ub} Just doubleclick the icon. @{b}TOOLTYPES:@{ub} CX_POPUP=Yes/No: Not for MUI-version, can be set in MUI-Prefs. Should AmiComSys open its window at startup? Default is Yes. CX_POPKEY=lalt shift a : The hotkey which will cause AmiComSys to Show its window. Default is lalt shift a. CX_PRIORITY= -128 - 127 : The commodities priority. Default is 0. Server = anyone.domain.anywhere : The server which AmiComSys will connect to. Defaults to amicomsys.tibb.at. Port = amarqueed port: The AMarqueed port which the server uses. Defaults to 2957, which is the official AMarqueed Port. ICONIFIED = Yes/No: Not for MUI-version, can be set in MUI-Prefs. Just Check iconify at start. If yes, AmiComSys will startup iconified. For this to apply CX_POPUP must be set to No. Default is Yes. MULTIPLE = Yes/No: If yes, Several copies of AmiComSys may be started. Bear in mind that they must connect to different servers for this to work. It's possible to fake this if you connect to localhost and set the environmental variable AMARQUEED_FAKECLIENT to different hostnames. e.g. setenv AMARQUEED_FAKECLIENT /number.com/AmiComSys Default is No. Does not work in the MUI-version yet. REALNAME = Yes/No: If yes, AmiComSys will read the environmental variable REALNAME and use its value as RealName. Miami sets this variable automatically. Default is Yes. USERNAME = Yes/No: If yes, AmiComSys will read the environmental variables LOGNAME, USER or USERNAME and use its value as Login. Miami sets USERNAME automatically. Default is Yes. LOGIN = : The loginname you want to use in AmiComSys. NAME = : The realname you want to use. COMMENT = : The comment you want to be showed next to your name. EMAIL = : Your email address. It will not be showed for others. It will has a usage in a future version. HOMEPAGE = : FTPSITE = : RECONNECT = Yes/No: Specify if you want AmiComSys to try to reconnect when no connection could be established or the connection is lost, or just quit. Useful if you start AmiComSys from an Online-script. Defaults to Yes. If you put AmiComSys in the WBStartup drawer RECONNECT should be Yes, and if you run AmiComSys from an Online-script RECONNECT should be set to No. If yes, AmiComSys will try to reconnect one time every minute if connection is lost. Notice that it will connect immediately if the main window is activated. PROGDIR = Set it to the path to your AmiComSys directory if you start AmiComSys from another directory than it's own, e.g. WBStartup drawer. This is needed so AmiComSys can find the rexx directory and the config files. @{b}If to use it from Shell:@{ub} The command line is: AmiComSys CX_POPUP=Yes/No CX_POPKEY=hotkey CX_PRIORITY=0 Server/S Port/N ICONIFIED=Yes/No MULTIPLE=Yes/No REALNAME=Yes/No USERNAME=Yes/No LOGIN= NAME= COMMENT= EMAIL= RECONNECT=Yes/No HOMEPAGE FTPSITE PROGDIR= All tooltypes above can also be used exactly the same as command line arguments. e.g. AmiComSys Server=amicomsys.tibb.at Port=2957 Reconnect=No @{b}@{b} For more settings see @{"Settings" LINK "Settings"}. @endnode @node "Settings" "Settings" @{fg shine}@{u}@{b}Settings@{ub}@{uu}@{fg text} The settings window can be reached by pick the menu Settings/General. With it you can set the values which AmiComSys always read in at startup. The settings is saved to the file AmiComSys.config If you start AmiComSys without command line arguments all settings in that file will be used. Parameters given as TOOLTYPES when start from WorkBench or as command line arguments from CLI @{b}will override this settings@{ub}. @{b}General@{ub} settings: @{"Logging" link "loggingsettings"} @{"Personal" link "personalsettings"} @{"Program" link "programsett"} @{"Server" link "serversettings"} @{"Security" link "securitysettings"} @{"Time Zone" link "timezonesettings"} @{"Misc" link "miscsettings"} @{b}Save preferences@{ub} Save the settings to disk. @{b}Notice that the TOOLTYPES will override the saved values in the file AmiComSys.config. So if change something in the settings and it does not seem to be changed the next time you start AmiComSys you probably have set the same KEYWORD in the ToolTypes to another value.@{ub} @endnode @node "loggingsettings" "Logging Settings" @{fg shine}@{u}@{b}Logging settings@{ub}@{uu}@{fg text} @{i}Can be found under the Program-tab.@{ui} @{b}Path@{ub} - The path to where you want to save the log file. @{b}Level@{ub} - The logging level: None - No logging. Simple - Onlines and offlines is logged. Everything - In addition to above program end and start and client info updates is logged. @{b}Append date@{ub} - The date will be appended to the file name. @endnode @node "miscsettings" "Misc Settings" @{fg shine}@{u}@{b}Misc settings@{ub}@{uu}@{fg text} @{b}Use NotifyArexx.amicomsys@{ub} - Check this box if you want to use the @{"NotifyArexx feature" link "notifyarexx"}. Unregistered users can not use this feature. @{b}WEB-Browser-Path@{ub} Type in the path to your web-browser (e.g. Ibrowse, Voyager) here. It will be used by the SendWeb-function. @{b}FTP-Program-Path@{ub} Type in the path to your ftp-client (e.g. AmFTP, AmiFTP) here. It will be used by the SendFTP-function. @endnode @node "programsett" "Program Settings" @{fg shine}@{u}@{b}Program function@{ub}@{uu}@{fg text} @{b}IconifyWhenClose@{ub} - If checked AmiComSys will be iconified when you press the close button. If not will go into hide state. The window can be showed aain by using the hotkey. Default is unchecked. @{b}Multiple copies@{ub} - Same as TOOLTYPE MULTIPLE If checked, Several copies of AmiComSys may be started. Bear in mind that they must connect to different servers for this to work. It's possible to fake this if you connect to localhost and set the environmental variable AMARQUEED_FAKECLIENT to different hostnames. e.g. setenv AMARQUEED_FAKECLIENT /amiga.com/AmiComSys Default is unchecked. @{b}Iconified@{ub} - Same as TOOLTYPE ICONIFIED If checked, AmiComSys will start iconified. For this to work CX_POPUP must be set to No. Default is Yes. Does not have a function in the MUI-version, the same thing can be set in MUI-Prefs, at "iconify at start". @{b}Reconnect@{ub} - Same as TOOLTYPE RECONNECT Specify if you want AmiComSys to try to reconnect when no connection could be established or the connection is lost, or just quit. Useful if you start AmiComSys from an Online-script. Defaults to Yes, i.e. checked. If you put AmiComSys in WBStartup drawer RECONNECT should be Yes, and if you run AmiComSys from an Online-script RECONNECT should be set to No. If yes, AmiComSys will try to reconnect one time every minute if connection is lost. Notice that it will connect immediately if the main window is activated. @{b}Beep when new message@{ub} Beep when a new message is received. Default is checked; Yes. @{b}Send confirmation@{ub} Specify if you want a requester to pop up when you send a message asking you if you are sure you want to send it. . @{"Logging" link "loggingsettings"} @{"Time Zone" link "timezonesettings"} @endnode @node "timezonesettings" "TimeZone Settings" @{fg shine}@{u}@{b}Time Zone settings@{ub}@{uu}@{fg text} The only thing you must set here is the Distant Savings Time checkbox. @{b}Distant Savings Time@{ub} If it is Distant Savings Time (DST) check this. Currently it's normal time. @{b}Get GMT offset from@{ub} The number of hours from Greenwich Mean Time is read from Locale-preferences by default, but if it is not right you can set it in the string field below the radio buttons. It shall be in hours from GMT. If your time zone for instance is one hour (+0100,MET) east of GMT set it to GMT + 01 Hour. It shall be negative if your time zone is west of GMT, and positive if you live east of GMT. If you do not set this correctly the time stamp on your messages won't be right. (The online time will be wrong too ...) (Not for you, but for others ...) @endnode @node "serversettings" "Server Settings" @{fg shine}@{u}@{b}Server settings@{ub}@{uu}@{fg text} @{b}Server@{ub} - Same as TOOLTYPE Server The AMarqueed server AmiComSys will connect to. Defaults to amicomsys.tibb.at. Instead of the hostname the IP-address can be given. @{b}Port@{ub} -Same as TOOLTYPE Port The port which AmiComSys connects to the server. Defaults to 2957, which is the official AMarquee Port. @endnode @node "personalsettings" "Personal Settings" @{fg shine}@{u}@{b}Personal settings@{ub}@{uu}@{fg text} @{b}Login@{ub} -Same as TOOLTYPE LOGIN The Loginname you want to use in AmiComSys. If the checkbox is unchecked then the login name will be get from the environmental variables USER or USERNAME. Same as ToolType USERNAME. @{b}RealName@{ub} - Your real name. If the checkbox is unchecked then the real name will be get from the environmental variable REALNAME. Same as ToolType REALNAME. @{b}Comment@{ub} - The comment you want to be showed in AmiComSys. The maximum numbers of character is currently 150. @{b}Email@{ub} - Same as TOOLTYPE EMAIL Your email address. @{b}HomePage@{ub} - Same as TOOLTYPE HOMEPAGE Your homepage address. @{b}FTPSite@{ub} - Same as TOOLTYPE FTPSITE Your ftp site's address. @endnode @node "securitysettings" "Security Settings" @{fg shine}@{u}@{b}Security settings@{ub}@{uu}@{fg text} @{b}Enable Messages@{ub} This must be checked if you want to receive messages. @{b}Enable MultiMess@{ub} This must be checked if you want to receive messages sent with pattern matching (MultiSend). @{b}MessAccess@{ub} With this you can enable or disable messages from specified host with an ordinal Amiga wildcard pattern. With this wildcard you describe the authorized hosts which are allowed to send you a message. Default is #?, which means that anybody may send you a message. (e.g #?.se, means that only Swedish host may send you messages.) (#?.se|#?.com|#?.edu) gives message access to host with .se, .com or .edu domains. @{b}Banned@{ub} With this option you can disable messages from specified users, with patternmmatching (wildcard). e.g. (amigafan|ibmfan) will not allow amigafan and ibmfan to send messages to you. @endnode @node "Features" "Features" @font Courier.font 15 @{b}@{fg shine}@{u}Features@{ub}@{fg text}@{uu} AmiComSys contains a listview, some buttons and a menu. @{" C l i e n t l i s t " link "clientlist"} @{" SendFile " link "sendfilebut"}@{" Version " link "versionbut"} Pattern @{" " link "Patternstr"}@{"MultiSend" link "MultiSend"}@{" Message type " link "messtype"} Message @{" " link "Messagestr"}@{" Send " link "sendbut"} @{b}Close Gadget@{ub} Will hide/iconify, or close the window. @{b}Menu@{ub} @{b}@{fg shine}Project/@{fg text}@{ub} @{b}About@{ub} - Shows info about AmiComSys. @{b}Iconify@{ub} - Iconifies the window. @{b}Quit@{ub} - Will quit AmiComSys. @{b}@{fg shine}Windows/@{fg text}@{ub} @{b}Message history@{ub} All the messages you send and receive is saved to this history buffer. @{b}@{"HotLine" link "hotline"}@{ub} Public chat. @{b}@{fg shine}@{"ARexx/" link "arexxmenu"}@{fg text}@{ub} @{b}Execute arexx script@{ub} - Execute an ARexx script @{b}Add arexx script@{ub} - Add an ARexx script to the menu. @{b}@{fg shine}@{"Settings/" link "Settings"}@{fg text}@{ub} @{b}General ...@{ub} - Opens up the @{"settings window" link "Settings"}. @{b}MUI ...@{ub} - Opens up the MUI-Settings. @{b}Save preferences@{ub} Saves the settings to disc. @{"Message requester" link "messagereq"} AmiComSys has its own requester. @endnode @node "clientlist" "Client List" @{b}@{fg shine}@{u}Client list@{ub}@{fg text}@{uu} All connected clients are showed in this list. You can select an entry. If you doubleclick an entry, an requester will appear, which contains information about that client. (i.e realname, host, login and comment) There are three buttons in this requester: HTTP - Send the homepage address of the selected client to your Web browser, using the arexx script @{"SendWEB.amicomsys" link "SendWEB"}. FTP - Send the ftp site of the selected client to your web browser/ftp client, using the arexx script @{"SendFTP.amicomsys" link "SendFTP"}. Cancel - Do nothing, just continue. In front of the clientname three different charachters may appear: ^ : The user has his HotLine-window open. # : The user is testing AmiComSys, and therefore is unregistered. * : The user has decided to register, and therefore have possibiblity to turn off messagehandling and bann users. @endnode @node "versionbut" "Version button" @{b}@{fg shine}@{u}Version button@{ub}@{fg text}@{uu} @{b}Version@{ub} Sends an Version request to the selected client. You will then get the version information of the AmiComSys the client is using. The Client owner will not notice anything. @endnode @node "sendfilebut" "Send File" @{b}@{fg shine}@{u}Send File button@{ub}@{fg text}@{uu} With this feature you can send a file to another client. Just click the button - Pick a file and press Send. A transmission window will open showing some statistics. To Abort the transmission: close the transmission window. @{b} When someone sends a file to you@{ub} A requester will then open asking you whether you will download the file or not. The receiver will see a similar window, and can also abort the transmission by closing the window. With AmiComSys 1.15+ this feature is multithreaded. You can send several files simultaneously. There's a maxiumum of 40 simultaneously open transmission windows. @endnode @node "Patternstr" "Pattern field" @{b}@{fg shine}@{u}Pattern field@{ub}@{fg text}@{uu} In the string gadget "Pattern:" you specify which hosts shall get your message when you transmit them by pressing the @{"MultiSend-button" link "MultiSend"}. e.g. #?.se will send the message to every swede, which is connected to the server. @endnode @node "MultiSend" "MultiSend button" @{b}@{fg shine}@{u}MultiSend button@{ub}@{fg text}@{uu} If you press this button the message will be sent to every client, which host name match with the specified wild card in the @{"Pattern field" link "Patternstr"}. @endnode @node "Messtype" "Message type cycle" @{b}@{fg shine}@{u}Message type cycle@{ub}@{fg text}@{uu} There are three kind of messages. With this cycle gadget you specify which you want to use: @{b}Message@{ub} - A text message. @{b}Chat request@{ub} - A chat request. Use this if you want to chat with someone using IRC. Type in the IRC channel in the message field. @{b}WEB request@{ub} - A WEB request. With this you can send a home page address to a client. Type in the home page address in the message field. The receipient will then get a requester asking him/her if he/she wants to show the specified page. The page address will then be sent to his/her web browser using the arexx script @{"SendWEB.amicomsys" link "SendWEB"}. Ibrowse, Voyager, AWeb and Amosaic is supported. ARexx must be running. The Arexx-server is started with the RexxMast program found in the SYS:system directory. Of course a Web-browser must be running too. If it is not the system will ask for a path to your web browser. The path included in the SendWEB.amicomsys script is not right. You have to change this ... See @{"SendWEB.amicomsys" link "SendWEB"}. @endnode @node "Messagestr" "Message text field" @{b}@{fg shine}@{u}Message field@{ub}@{fg text}@{uu} All messages are typed into this field. There is maximum number of character limit of 1000. The @{"Send button" link "sendbut"} is automatically pressed if you press enter in this gadget. @endnode @node "sendbut" "Send button" @{b}@{fg shine}@{u}Send button@{ub}@{fg text}@{uu} Sends the message in the message field to the selected client in the client list. A confirmation requester will pop up before it is sent asking if you are sure. The @{"send confirmation" link "programfunction"} can be turned off when press the Send button. ( Not when you press enter in the client field.) @endnode @node "ARexx" "ARexx interface" @{b}@{fg shine}@{u}ARexx interface@{ub}@{fg text}@{uu} With the ARexx interface you can receive information from AmiComSys, like clients hostname, login or name. AmiComSys's ARexx port is AMICOMSYS, and it understands the following commands: @{b}DISCONNET@{ub} - Log out from server. @{b}SHOW@{ub} - Shows the main window. @{b}HIDE@{ub} - Hide the windows. @{b}ICONIFY@{ub} - Iconify the windows. HIDE and ICONIFY do the same thing in the MUI-version. @{b}QUIT@{ub} - Quits AmiComSys. @{b}STEM .@{ub} - Use it with GET to get the result included in structure. e.g. GET STEM info. @{b}VAR @{ub} - Copy the result to the variable . @{b}GET@{ub} - Get information from AmiComSys. @{b}Parameters:@{ub} CLIENTLIST - Get info from clientlist. e.g. GET STEM info. CLIENTLIST @{b}Results: info.@{ub} connected - Connceted to server. 0 = no, 1 = yes. browserpath - The path to the web-browser. ftpprgpath - The path to the ftp-client. @{i}The following needs the parameter CLIENTLIST specidied@{ui} numclients - Number of connected clients. selected - The index of the selected client. hostnames - An array of the hostnames of the clients. e.g. hostnames.0 for the first one. usernames - An array of the usernames of the clients. realnames - An array of the realnames of the clients. comments - An array of the comments of the clients. homepages - An array of the homepage addresses of the clients. ftpsites - An array of the ftpsite addresses of the clients. onlinetimes - An array of the onlinetimes of the clients. login - Your user name. realname - Your real name. comment - Your comment. email - Your email. homepage - Your homepage. ftpsite - Your ftpsite. onlinetime - The time when you started AmiComSys. @{b}SET@{ub} - Set information in AmiComSys. @{b}Parameters:@{ub} LOGPATH - The path to the logging file. LOGLEVEL - The logging level. LOGIN - The Login name. REALNAME - The Real name. COMMENT - The comment. UPDATE - Update the information on the server. To make the changes apply give the command SET UPDATE. See rexx/AmiComSysTest.rexx for examples. In the rexx directory there are some arexx scripts which is started at different occasions: @{"NotifyArexx.amicomsys" link "notifyarexx"} - When the client list change. @{"SendWEB.amicomsys" link "sendweb"} - Homepage address to web-browser. @{"SendFTP.amicomsys" link "sendftp"} - FTP address to ftp-client. The program includes a menu @{"Arexx" link "arexxmenu"}. @endnode @node "sendweb" "SendWEB" @{b}@{fg shine}@{u}SendWEB@{ub}@{fg text}@{uu} You send a WEB-request by changing the message type to WEB, type the homepage address in the message field and then press SEND. When one get a WEB-request message it pops up a requester asking if you want to show the homepage. When you press the SHOW button the arexx script SendWEB.amicomsys is started. It will try to connect to IBrowse, Voyager, AWeb and AMosiac. If it succed it will send the homepage address to the web-browser. If your Web-browser is not started this will not succed. To start it automatically: enter the path to your web-browser in the Misc-settings. Make sure you have the latest rexx-scripts. (SendWEB.amicomsys). @endnode @node "sendftp" "SendFTP" @{b}@{fg shine}@{u}SendFTP@{ub}@{fg text}@{uu} In the client info requester, which will appear if you doubleclick on a client, there is a FTP button. When you press this button the arexx script SendFTP.amicomsys is started. It will try to connect to IBrowse, Voyager, AWeb and AMosiac. If it succed it will send the ftp address to the web-browser. If your Web-browser is not started this will not succed. To start it automatically: enter the path to your ftp-client in the Misc-settings. Make sure you have the latest rexx-scripts. (SendFTP.amicomsys). This could be changed to a real FTP client if you prefer that. But if a web-browser is started the address will be sent to it ... @endnode @node "notifyarexx" "Notify ARexx" @{b}@{fg shine}@{u}NotifyARexx@{ub}@{fg text}@{uu} The arexx script NotifyARexx.amicomsys is run whenever something happens with the client list. Use this script to tell other application that the client list is updated. It's registered only. @endnode @node "arexxmenu" "ARexx menu" @{b}@{fg shine}@{u}Arexx menu@{ub}@{fg text}@{uu} In the ARexx menu you can execute arexx scripts and add arexx scripts to the fast menu. @{b}Execute arexx script@{ub} - Executes an arexx script. (An ASL filerequester pops up). @{b}Add arexx script@{ub} - Adds an arex script to the fast menu. (an ASL filerequester pops up). @{b}@{i}fastmenu items ,,,@{ui}@{ub} Pick one of the items and that script will be executed. There are some scripts in the rexx/ directory: Ping.rexx - Pings the selected client. (A window is opened). Finger.rexx - Fingers the selected client. (A window is opened). AmiComSysTest.rexx - Outputs the whole client list to a window. Note that these scripts will not work if you do not have ping or finger in the AMITCP:bin/ directory. If you want another program to use the host name of the selected client, just make a copy of the Ping.rexx script and make appropriate changes. ADDRESS AMICOMSYS; OPTIONS RESULTS; GET stem info. CLIENTLIST; /* "stem info." inserts the results to the structure 'info.'. */ /* "var s" would have inserted all the results to one string in s. */ /* "CLIENTLIST": We want to read the client list information. */ s=info.selected; ADDRESS COMMAND "AMITCP:bin/Ping " info.hostnames.s; /* To start another application just change ping to any other program name */ @endnode @node "hotline" "Hot Line (Public chat)" @{b}@{fg shine}@{u}HotLine (public chat)@{ub}@{fg text}@{uu} This is a public chat window. You only receive chat messages when the HotLine window is opened (to iconify is not to close). @{b}Topic:@{ub} Here you enter the topic, if you want to change it. @{b}Say:@{ub} Here you enter what you want to say. @{b}Disconnect/Connect-button:@{ub} Press this if you want to disconnect while the window is opened. You can reconnect by pressing the Connect-button. Note: All people who have their Hotline-window open will have a ^ in front of their username in the clientlist. @endnode @node "messagereq" "Message requester" @{b}@{fg shine}@{u}Message requester@{ub}@{fg text}@{uu} AmiComSys uses its own message requester. It does not block other traffic, like the usual AmigaOS one. It is always centered. The buttons have these shortcuts: The right button: ESCape or the underlined character. The left button: Return or the underlined character. You don't have to close a requester before you can get or send another message. The message text requesters also has this: A message field and a send button. You can use these to reply, without opening the main window. The requester will not close when you press the Send-button or Enter in the message-field. This requester could also include other features later. @endnode @node "bugg" "Bugs" @{b}@{fg shine}@{u}Bugs@{ub}@{fg text}@{uu} Known bugs: * Probably some memory leakage. (most caused by amarquee.lib.) If you find a bug, please tell @{"me" link "me"}. Before you send me a bug report make sure that you have the most recent version of AmiComSys. I want to know: 1. description of the bug( when?, how?, what happen?) 2. your name, address and email-address, if you have one. 3. which version of AmiComSys do you use? 4. your computer configuration. @endnode @node "me" "Contact me" @{b}@{fg shine}@{u}The author@{ub}@{fg text}@{uu} If you have suggestions, want to report a bug, just want to say something, or want to register write to me at the address below: Snail-mail: Håkan Parting Organistv. 11 SE-17579 Järfälla Sweden E-mail: hparting@hem.passagen.se id96_har@isk.kth.se Homepage: http://hem.passagen.se/hparting http://www.isk.kth.se/~id96_har FidoNet: Hakan Parting@2:204/255 Don't send your mail to both the email-addresses. Mail sent to one of them is forwarded to the other. My computer system is: Amiga 1200Tower/68030/50MHz/18MB/540MB/CD-Drive/USR Sportster Voice 33.6. AmigaOS & pOS Prerelease (it's looking damn good :-). Other programs by me is: VersionWB ****** Current Version is 2.7 (08.07.97) aminet:util/sys/VersionWB An AmigaDos Version replacement which supports XFD and shows version info in a requester. **********GlossTask********** Current version is 1.71 (08.01.97). aminet:misc/edu/GlossTask.lha The GlossTask is the program with which you do your glossary home work with. It can test you from one language to another. The program is managed by mouse, has many features and is very easy to use :-). Of course you can save your vocabulary list for use at another occasion. @endnode @node "trademarks" "Trademarks" @{b}@{fg shine}@{u}Trademarks@{ub}@{fg text}@{uu} Amiga and Workbench is a registered trademark of Amiga International Inc., Gateway 2000. Trademarks mentioned are owned by their respective owners. @endnode @node "todo" "To do" @{b}@{fg shine}@{u}To do@{ub}@{fg text}@{uu} Future versions will include: Search feature. File server features. Localization. Notification when someone with a specified email address connects. Possibility to load preferences from disc. Private chat. more ? Is anything missing, tell @{"me" link "me"}. @endnode @node "history" "History of changes" @{b}HISTORY@{ub} @{fg shine}1.8 (08.04.1997) ----------------@{fg text} First Official release on Aminet. @{fg shine}1.9 (18.04.1997) ----------------@{fg text} BUGFIX: When starting a new copy of AmiComSys when another already is running an "error:" was showed. BUGFIX: It was very instable when connected to Internet. It worked good when connected to localhost. Strange :-( Hope it's better now. BUGFIX: Rewrote the hide, show and iconify handling. BUGFIX: Some memory leakage is fixed, but there is still some left, but it seems to be in amarquee.library :-( NEW: AmiComSys's window now appear directly. The wait for connect is no longer there thanks to amarquee.library v.41. NEW: Messages has now a limit of 900 characters. NEW: Wordcutting feature implemented, which means that a the messages will be divided into several lines if it exceeds the req_maxchars parameter. NEW: Message access setting implemented. Give an ordinal Amiga wildcard in Config/MessAccess describing the authorized hosts which are allowed to send you a message. Default is #?, which means that anybody may send you a message. (e.g #?.se, means that only Swedish host may send you messages.) (registered). BUGFIX: AMarquee Client TCP Handler must use a higher task priority than AmiComSys. If you use Executive you must set AMarquee Client TCP Handler to TASK-NOSCHEDULE-ABOVE. If not AmiComSys will get a Server error, when its window is activated, and AmiComSys will quit. This is fixed in amarquee.library V42. NEW: Messaging may be turned off. (registered). NEW: The web-address sent in a WEB-message can be sent to your WEB-browser: Ibrowse, Voyager, AWeb and Amosaic is supported. ARexx must be running and 'rx' must be in the current path. Insert "Path ADD" if it is not. 'rx' should be in the SYS:rexxc directory. @{fg shine}1.10 (01.06.1997) ----------------@{fg text} BUGFIX: Messages from amarquee.lib was not always freed, causing Enforcer-hits. Thanks Jeremy Friesner, USA, who reported this bug! NEW: Users can now be banned, which means that they can not send messages to you. NEW: NAME and COMMENT added to arguments and ToolTypes. e.g AmiComSys "COMMENT=No comment!" NEW: Send messages with patternmatching. e.g. #?.com, send to all .com-hosts. NEW: Multi messages (sent with patternmatching) can be turned off. (registered) NEW: Will try to reconnect one time every minute if connection is lost. Notice that it will connect immediately if the main window is activated. Useful if you put AmiComSys in WBStartUp drawer. NEW: New tooltype and setting: Reconnect=Yes/No. Specify if you want AmiComSys to try to reconnect when connection is lost or just quit. Useful if you start AmiComSys from an Online-script. NEW: New layout in settings window. NEW: MUI-version. BUGFIX: Settings were not read correctly. BUGFIX: There was a little trouble to find the arexx-script. NEW: New AMarquee/AmiComSys-server hosted by Thomas Steinbichler at amicomsys.tibb.at. NEW: Email-settings, both as a TOOLTYPE and in general settings. Your email will not be showed for others, but will have a usage in a later version. @{fg shine}1.11 (29.06.1997) ----------------@{fg text} NEW: AmiComSys homepage is at http://amicomsys.tibb.at NEW: Inputs in MainWindow is not freezed when settings window is open. BUGFIX: Stack overflow led to a crash. A stack of 4096 bytes shall now be sufficient for the GadTools version. The MUI-version's stack is automatically set to 8192 bytes. NEW: The settings is now divided into several windows for the GadTools version. NEW: The main window is now resizable. NEW: Logging implemented. Can be set in the logging settings. NEW: Message history implemented. Can be found in the Windows/Message History menu. NEW: The SEND button is automatically pressed when you press ENTER/TAB in the message string gadget. NEW: When a new message arrives the Amiga beeps. Can be set on/off in Program function settings. NEW: The send-off time for a message will be showed in title of the message requester. NEW: The client user's online time is now showed in the client info. NEW: The positions and sizes of the main and history window are saved to disc. @{fg shine}1.11a (01.07.1997) -----------------@{fg text} BUGFIX: V1.11 crashed after you, or somone other who are logged in, have changed your/their command line to a length longer 50 charachers. :-( Maximum length is 150 characters. Removed some debugging output. .-) @{fg shine}1.11b (01.07.1997) -----------------@{fg text} BUGFIX: Ooops!!! Sending messages did not work. Unfortunately I can't stop the last update to appear on aminet :-( This is the result when one works days and night ... @{fg shine}1.12 (02.08.1997) ----------------@{fg text} NEW: ARexx support added. These commands are available: SHOW, HIDE, ICONIFY, QUIT. (ICONIFY and HIDE has no differance in MUI-version). GET. See @{"ARexx Support" link "arexx"}. NEW: New menu, Arexx, where you can execute and add arexx scripts. BUGFIX(MUI-version): When three or more clients were logged in the client list went totally messed up. One client pointed to another's information. Messages could there fore be sent to wrong client. By mistake I used an undocumented feature of MUI (the listview entries were moved like in a queue). But fortunately the GadTools-version worked okey. Bug reported by Alex Tucker, Singapore. Thanks! BUGFIX(MUI-version): WEB-Request did not work. NEW: The client list is now only updated once when a client log in. NEW: A new logglevel, Everything. Simple logs onlines and offlines, and Everything logs start, end and client info updates too. NEW: Added homepage and ftpsite to Settings and tooltypes. NEW: Added HTTP and FTP buttons to Client Info (Double click on the client in the Client list). NEW: Added Send Confirmation to settings. You can specify if you want the confirmation requester when you press the SEND button. (only registered version) BUGFIX(MUI-version): Enforcer hit when it recieved a message. BUGFIX: Enforcer hit when someone logged out. NEW: New users are now inserted at the bottom of the client list. NEW: An Arexx-script: NotifyArexx.amicomsys is executed when the client list is updated. @{fg shine}1.12a (04.08.1997) ----------------@{fg text} BUGFIX: Could hang the computer when the settings window were closed :-( BUGFIX: Could log onlines twice (I hope it's fixed now ...). NEW: The GadTools-version in smaller now :-) @{fg shine}1.13 (17.08.1997) MUI ----------------@{fg text} NEW: The mui-version and the Gadtools version is now divided into two archives: AmiComSys.lha and AmiComSysMUI.lha. NEW: To start AmiComSys with Run >NIL: AmiComSys had it's disadvantages, the output from the arexx-scripts were sent to NIL:. This led to problems because mostly you start it that way in a login-script ... Now AmiComSys has its own console window both when started from Workbench and from CLI. NEW: A new Tooltype PROGDIR. Set it to the path to your AmiComSys directory if you start AmiComSys from another directory than it's own, e.g. WBStartup drawer. This is needed so AmiComSys can find the rexx directory and the config files. NEW: @{"New arexx commands" link "Arexx"}. RealName, Login, comment, logpath, loglevel and onlinetime. NEW: File transmission. NEW: Set the time offset to Greenwich Mean Time in Program funcion settings. This makes the time values (in client info and message headers) right. If you for example live one time zone east of GMT you set this to -60. (-60 minutes), which is Central Europe Time (CET). You really don't need to set this, because it's read from your Locale-preferences. If it's Distant Savings Time you must check the checkbox. NEW: The executable is smaller now :) @{fg shine}1.13a (18.08.1997) ----------------@{fg text} BUGFIX: The stack size in AmiComSys's icon was to low (4096). It shall be 8192 bytes. If the icon stack size is to low it should be set automatically, but a link object file had disappeared from my make file, so this was not the case :-() You noticed this bug if you couldn't start AmiComSys or if it crashed. @{fg shine}1.14 (27.09.1997) ----------------@{fg text} NEW: Nonblocking message requesters implemented. They does not block other traffic. @{"See ..." link "messagereq"} BUGFIX: Incompatability with Reqtools filerequesters fixed. Reported by Richard Lake. Thanks! NEW: Does now use the public MUI class NList.mcc, which fully replace the MUI lists, by Gilles Masson. It's @{"required" link "requirements"}. BUGFIX: Crashed when there were start-errors (no mem, couln't open library). Reported by Darius Mazurkiewicz. Thanks! NEW: HotLine implemented (Windows menu). Now you can have a public chat with others logged into server. @{"See ..." link "hotline"} BUGFIX: MUI-window is now refreshed while a file requester is open. NEW: Fonts turned tiny when a long text appeared in clientinfo. Now wordwraps the text. (Possible MUI-bug?) BUGFIX: There were no beep when a sendfile message arrived. NEW: The pre-AmiComSys version 1.11 message format is now considered obsolete. This means that the support for pre-1.11 will be romoved. NEW: Changed time zone settings to a better one (like Gadtools version). @{"See ..." link "timezonesettings"} NEW: Changed the settings tab names: New: Personal, Misc , Security->Network, Function->Program. NEW: Moved security settings to the Network tab. NEW: The client select marker now stay on the selected one when someone logout or login. NEW: Username & Realname chaos solved. New realname and username settings. @{"See ..." link "personalsettings"} NEW: NotifyArexx.amicomsys script is now settable in the Misc-tab in general settings. It's now registered only. @{fg shine}1.14a (30.09.1997) -----------------@{fg text} NEW: Does now check the version number of NList.mcc. It must be 19+. NEW: Added a notice at the settings save button. When you put AmiComSys in WBStartup you must set the ToolType PROGDIR in the icon to the path of your AmiComSys directory, where your settings are saved. BUGFIX: The messagerequester didn't check the button texts height. NEW: Inserted a message-field and a Send-button into the message requester. Now it's possible to reply, without open the ACS main window. @{fg shine}1.14b (30.09.1997) -----------------@{fg text} BUGFIX: MUI-requesters does not open up when the main window is iconified. So the Send feature in message requester did not work, if send confirmation was on. (Only registered users can set it off). @{fg shine}1.14c (12.10.1997) -----------------@{fg text} BUGFIX: The File-transmission feature (SendFile) should work well now. BUGFIX: The message requesters now fall back to a recoverable Alert if the window could not be created. (Like AmigaOS-EasyRequest should do, but still does not :-() NEW: Replaced more Easy-requesters with my own one. @{fg shine}1.15 (16.11.1997) -----------------@{fg text} NEW: AmiComSys now requires AMarquee.library version 45+. NEW: The Distant Savings Time setting in TimeZone-settings is now off by default. It should be off for now (it's normal time you know). BUGFIX: Problems if you have put AmiComSys in your WBStartup. Entries in the list from the last time you were online is still there when you go online again. Bug reported by Thomas Svenson and Sonat Böler. Thanks! BUGFIX: If you have noticed that you are still logged in to server some minutes after you went offline with your tcp/ip-stack, without first quit AmiComSys: Just save your settings, and you want notice doublicates, anymore. Actually the old copies of your client is removed from server when you log in again. NEW: As I said above you stay logged in to server for 10 minutes if you do not quit AmiComSys before shutting down your Internet-connection. Now it is possible to tell AmiComSys to log out from server, without quiting. There's a new arexx command DISCONNECT. Insert the following to your offline.script if you don't want to quit AmiComSys before going offline. rx "ADDRESS AMICOMSYS; DISCONNECT" BUGFIX: The message "Could not send message" could pop up without reason. Reported by Thomas Steinbichler. Thanks! BUGFIX: The HotLine-textbuffer could be saved with some text doubled up. Reported by Pete (isnibs). Thanks! NEW: Browserpath and ftp-program-path added to Misc-settings. NEW: Arexx commands GET BROWSERPATH and GET GET FTPPRGPATH added. NEW: The rexx-scripts, in the rexx-directory, SendWEB.amicomsys and SendFTP.amicomsys were updated. You should now enter the path to your webbrowser and ftp-program in the Misc-settings. NEW: The data (YYMMDD) can now be automatically appended to logging path. Optional via the Program-settings. NEW: Obsolete message handling is removed. This means you can't send or receive messaged with/from users of version 1.10-. NEW: Implemented support for AMarquee-System-message. Can only be sent by the server operator from an admin-application. BUGFIX: "Connection broken by sender" was showed when the tcp-ip-stack was shut down. NEW: SendFile feature is now multithreaded. This means you don't have to wait for a file to be sent before you can send another. You can also receive several files at once. BUGFIX: IconifyWhenClose setting was not active directly after the setting had been altered. Reported by Sonat Böler. Thanks! NEW: Now it's possible to see who has the HotLine-window open. A ^ is inserted in front of the client name when the window is open. NEW: Did some changes which is invisible for the user, but will make it possible to implement features in the future. NEW: A dock-picture is now included in the archive. Thanks to Dirk Tietke for giving it to me! NEW: The former icon was saved faulty. NewIcons allocated very much pens to show it. So please exchange it with the new one. @endnode @node "thanks" "Thanks to" @{apen 2}@{b}I would like to thank@{ub}@{apen 1} Jeremy Friesner for AMarquee.library. Thomas Steinbichler for the full-time AmiComSys server site at amicomsys.tibb.at. Michael Balzer for ARexxBox. It makes Arexx much simpler. Gilles Masson for NList.mcc. It makes the lists userfriendly. Dirk Tietke for the AmiComSys.dock. For bug reports and suggestions: Jeremy Friesner. Thomas Steinbichler, Austria. Alex Tucker, Singapore Richard Lake, UK. Darius Mazurkiewicz. Thomas Svenson, Sweden. Sonat Böler, Sweden. Pete (isnibs), UK. @endnode @node "ACSindex" "Index" @{"Arexx Interface" link "ARexx"} Arexx-scripts: @{"NotifyArexx.amicomsys" link "notifyarexx"} @{"SendWEB.amicomsys" link "sendweb"} @{"SendFTP.amicomsys" link "sendftp"} @{"Buttons" link "features"} @{"Beep()" link "programsett"} @{"Client Info" link "clientlist"} @{"Command line parameters" link "usage"} @{"Distant Savings Time" link "timezonesettings"} Gadgets in main window: @{"Clientlist" link "clientlist"} @{"Message field" link "Messagestr"} @{"Message type" link "messtype"} @{"MultiSend" link "MultiSend"} @{"Pattern field" link "Patternstr"} @{"Send" link "sendbut"} @{"SendFile" link "sendfilebut"} @{"Version" link "versionbut"} @{"HotLine" link "hotline"} @{"Menus" link "features"} @{"Message requester" link "messagereq"} @{"Public chat" link "hotline"} @{"Send a file" link "sendfilebut"} Settings: @{"Logging" link "loggingsettings"} @{"Program function" link "programfunction"} @{"Server/Personal info." link "serversettings"} @{"Security" link "securitysettings"} @{"TimeZone" link "timezonesettings"} @{"Start web browser" link "SendWEB"} @endnode