CD Actual 14

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

/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / os2 / GCPTLK11 / GCPTALK.ZIP / GCPCLM.HLP (.txt) < prev next >

Wrap

OS/2 Help File | 1995-08-21 | 25.3 KB | 620 lines

ΓòÉΓòÉΓòÉ 1. Title Page ΓòÉΓòÉΓòÉ GCPCLM The Gibbon Common Logon Manager Copyright (c) 1995 by Gibbon Computer Products, Inc. All rights reserved. The Gibbon Common Logon Manager (CLM) is a program that can either be started manually, or will be automatically started whenever a Gibbon application that uses TCP/IP networking is started. The primary service it provides is to act as a single point of contact for other applications that need to know who you are, and if you are currently available. Once you start and configure CLM, it sits in the background and waits for other applications to request information. While it's waiting, it will periodically poll other sources for user id information. Copyrights and Trademarks Legal Notices About Gibbon Computer Products, Inc. Contact Information Shareware Registration Gibbon Common Logon Manager ΓòÉΓòÉΓòÉ 1.1. Copyrights and Trademarks ΓòÉΓòÉΓòÉ The stylized GCP logo is a trademark of Gibbon Computer Products, Inc. GCP and the Gibbon label for computer software and hardware products are trademarks of Gibbon Computer Products, Inc. IBM and OS/2 are registered trademarks of International Business Machines Corporation, Armonk, N.Y. This product includes software developed by the University of California, Berkeley and its contributors. PGP is a trademark of Philip R. Zimmermann. ΓòÉΓòÉΓòÉ 1.2. Legal Notices ΓòÉΓòÉΓòÉ Copyright and License This document, the executable program file(s), accompanying DLL's, configuration files, command files, and additional documentation ("the software") are copyrighted by the author. The copyright owner hereby licenses you to use the sofware given these restrictions: 1. No changes may be made to any part of the software other than the "branding" of the executables with registration information, and those changes commonly made to configuration files. 2. The software package must be distributed in its entirety. The package is a ZIP file containing: a. An archive file containing the executable program file, DLL's, support files and documentation. b. A PGP detached signature file which is used to verify the authenticity of the above archive file. c. A documentation file d. A registration form e. An installation program Any distribution of this package must contain all the original files in their original formats. Any changes to the inner archive file will cause the PGP signature file to be invalid. This is strictly against the terms of this license. The outer ZIP file may be changed to add BBS comments, if desired. 3. A trial period is assigned to each piece of software. The trial period is defined as a number of days or a number of uses of the program, whichever is greater. A typical trial is thirty days or thirty uses. Usage is counted when a program is started. See the Product Information panel for the usage counts for this particular software. Use beyond this trial period is prohibited without registering the software. Warning: Once the trial period has passed, this program will no longer function. 4. No fee or charge is to be collected for the distribution of the software in excess of $10.00US to cover the costs of materials, handling, postage and general overhead. WARRANTY DISCLAIMER Gibbon Computer Products, Inc. makes no warranty of any kind, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software and accompanying documentation. IN NO EVENT SHALL GIBBON COMPUTER PRODUCTS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SIMILAR DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF, MISUSE OF OR INABILITY TO USE THIS PROGRAM, EVEN IF GIBBON COMPUTER PRODUCTS, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ΓòÉΓòÉΓòÉ 1.3. About Gibbon Computer Products, Inc. ΓòÉΓòÉΓòÉ Gibbon Computer Products, Inc. (GCP) is a small company founded in 1994 by John C. Frickson. In January of 1995 this became a full-time operation. The goal at GCP is to provide quality software for the IBM OS/2 operating system. If you use any of the packages from GCP, please register them. Your support is needed for GCP to stay in business. This plea also goes for any other shareware package you use. Many small businesses and individuals who created good software have ceased doing so due to lack of support. GCP currently has several products available and is working on others. While we think we have some pretty good ideas, your input as to what kinds of software you would like to see is always welcome. See the Contact Information section for various ways to communicate with GCP, and for ways to get information about other software packages produced by GCP. ΓòÉΓòÉΓòÉ 1.4. Contact and Product Information ΓòÉΓòÉΓòÉ Contact Information Gibbon Computer Products, Inc. can be contacted in a variety of ways. The information presented below may change in the future, so more current documentation will be more likely to have accurate information. U.S. Mail Gibbon Computer Products, Inc. 9864 Palm Street NW Coon Rapids, MN 55433 USA Telephone +1 612 754 6557 Internet EMail support@gibbon.com (for support and information) frickson@gibbon.com (John C. Frickson, President) FTP ftp.gibbon.com WWW http://www.gibbon.com/ Gopher gopher.gibbon.com Product Information A catalog of current products is available via ftp as /pub/gcp/catalog or from the WWW server as http://www.gibbon.com/catalog. The status of projects currently being worked on is available from the WWW server. The URL is http://www.gibbon.com/projects.html FAQs While this documentation is pretty complete, there are still questions and problems that sometimes come up. When this happens, the answers are gathered together and put into a FAQ (Frequently Asked Questions document.) These FAQs can be accessed from both the FTP server the the directory /pub/gcp/faq and from the Web server at http://www.gibbon.com/faq. If you have any questions or problems, you should check for a FAQ. The answers you seek may have already been answered. Mailing Lists There are also two mailing lists available. gibbon The gibbon list is an open, unmoderated list. It is a list for users of GCP products and other interested parties, where people can ask questions, share ideas, and get support. To subcribe, send EMail to gibbon-request@gibbon.com and have the word subscribe as the body of the message. gibbon_announce The gibbon_announce list is an open list. Anyone can subscribe, but it is for information only, and only Gibbon Computer Products, Inc. can post messages to the list. The purpose of this list is for announcements of new products, updates to existing products, bugs in currently released products, beta test programs, and other information of interest to the users of GCP software. To subcribe, send EMail to gibbon_announce-request@gibbon.com and have the word subscribe as the body of the message. ΓòÉΓòÉΓòÉ 1.5. Shareware Registration ΓòÉΓòÉΓòÉ This is shareware, not freeware. You may use this program for a trial period to determine if you like it and if it suits your needs. The trial period is defined as either thirty days or thirty uses of the program, whichever is greater. Use beyond this trial period is prohibited without registering the software. Warning: Once the trial period has passed, this program will no longer function. A registration form has been included in the package. When you have sent in the form along with payment, you will receive a Registration Reply Form with your name and serial number, and instructions on how to brand the software with this information. At the time this is being written (June, 1995) Gibbon Computer Products, Inc. is able to accept payment in the following ways: o A check in U.S. funds drawn on a U.S. bank or a branch of a U.S. bank. o An International Money Order o Compuserve shareware registration service (GO SWREG) The registration id is 6164. o VISA or MasterCard. ΓòÉΓòÉΓòÉ 2. Gibbon Common Logon Manager ΓòÉΓòÉΓòÉ The Gibbon Common Logon Manager (CLM) runs in the background and waits for other applications to request information. Other Gibbon applications (primarily servers) often need to know who, if anyone, is currently logged on to the system. CLM responds to these requests by providing the user id and logon status. While it's waiting for these requests, it periodically polls other sources for user ids. CLM also acts as an Identification Server, as described in RFC-1413. See the secion on IDENTD for more information about this service. CLM is configured using a notebook containing four pages. These four pages are: User Info Page 1 of 2 This page describes you. What your name (user id) is, and if you're accepting calls or not. User Info Page 2 of 2 This page is used to indicate if other sources are to be queried for user id information, and how often those queries should occur. Identd This page is used to enable or disable the Identification Server. General This page is used to configure automatic shutdown of CLM, and whether or not CLM should be minimized on startup. There are three standard pushbuttons at the bottom of each notebook page. The three standard pushbuttons are: Save This pushbutton is used to save the current configuration to the GIBBON.INI file. Help This pushbutton is one of the ways you can cause the help window to be displayed. Product Info This pushbutton is used to display the Product Information window. ΓòÉΓòÉΓòÉ 2.1. Standard Pushbuttons ΓòÉΓòÉΓòÉ This section describes the three standard pushbuttons that are on the bottom of all four pages of the notebook.. ΓòÉΓòÉΓòÉ 2.1.1. Save pushbutton ΓòÉΓòÉΓòÉ The Save pushbutton is used to save the configuration as it is currently set up in the four pages of the notebook. This configuration information is saved to the GIBBON.INI file, and is reloaded when you restart the Gibbon Common Logon Manager. This allows you to have a standard configuration. ΓòÉΓòÉΓòÉ 2.1.2. Help pushbutton ΓòÉΓòÉΓòÉ The Help pushbutton is one of the ways you can cause the help window to be displayed. You can select a control on one of the notebook pages and click on the Help pushbutton to display help information for the selected control. Another way to display help information for the selected control is to select the control and press the F1 key. ΓòÉΓòÉΓòÉ 2.1.3. Product Info pushbutton ΓòÉΓòÉΓòÉ The Product Info pushbutton is used to display the Product Information window. This is the same as the Logo window that is displayed when you start the Gibbon Common Logon Manager program. It displays the name and version of the program, to whom it is registered, the serial number, copyright information, and a brief description. ΓòÉΓòÉΓòÉ 2.2. User Info Page 1 of 2 ΓòÉΓòÉΓòÉ The User Info notebook page describes you. What your name (logon id) is, and if you're accepting calls or not. In addition to the three standard pushbuttons (Save, Help, and Product Info) it contains the following controls: o I'm Here radio button o Not Taking Calls radio button o I'm Not Here radio button o Who Am I combo box o Add ID pushbutton o Delete ID pushbutton ΓòÉΓòÉΓòÉ 2.2.1. I'm Here Radio Button ΓòÉΓòÉΓòÉ This is a radio button that, when selected, lets the daemons know that you are at the workstation. If you are running the Gibbon Talk Daemon, for example, this radio button lets the Talk Daemon know that you are accepting talk requests. ΓòÉΓòÉΓòÉ 2.2.2. Not Taking Calls Radio Button ΓòÉΓòÉΓòÉ This is a radio button that, when selected, lets the daemons know that you are at the workstation, but are not taking calls. If you are running the Gibbon Talk Daemon, for example, this radio button lets the Talk Daemon know that you are not accepting talk requests at this time. ΓòÉΓòÉΓòÉ 2.2.3. I'm Not Here Radio Button ΓòÉΓòÉΓòÉ This is a radio button that, when selected, lets the daemons know that you are not at the workstation (or at least, you don't want anyone to know you're there.) ΓòÉΓòÉΓòÉ 2.2.4. User ID Combo Box ΓòÉΓòÉΓòÉ This is a combo box that contains a list of user id's. It is used to indicate who you are. The user id's in this list can come from a number of places. You can manually add or remove user ids from the list using the Add ID and Delete ID pushbuttons. Also, user ids may be added to the list automatically, depending on the settings given on User Info Page 2 of 2. ΓòÉΓòÉΓòÉ 2.2.5. Add ID Pushbutton ΓòÉΓòÉΓòÉ This pushbutton is used to add a user id to the User ID combo box. To add a new user id to the list, type in the user id and press the Add ID pushbutton. The new user id will be added to the list and selected as the current user id. ΓòÉΓòÉΓòÉ 2.2.6. Delete ID Pushbutton ΓòÉΓòÉΓòÉ This pushbutton is used to delete a user id from the User ID combo box. To delete a user id, select the user id to be deleted, and press the Delete ID pushbutton. The selected user id will be removed from the list, and the first entry in the list of remaining user ids will be selected as the current user id. ΓòÉΓòÉΓòÉ 2.3. User Info Page 2 of 2 ΓòÉΓòÉΓòÉ This page controls how user ids are gathered from other sources. In addition to the three standard standard pushbuttons (Save, Help, and Product Info) it contains the following controls: o Match Dialer ID checkbox o Match Dialer Time spinbutton o Get ID's from PASSWD file checkbox o Get ID's from PASSWD file Time spinbutton o Get ID's from TCPOS2.DLL checkbox o Get ID's from TCPOS2.DLL Time spinbutton o Auto Logoff checkbox o Auto Logoff Time spinbutton ΓòÉΓòÉΓòÉ 2.3.1. Match Dialer ID Checkbox ΓòÉΓòÉΓòÉ This is a checkbox that, when checked, tells the Common Logon Manager to monitor the Warp Internet Dialer. When you connect to your Internet Access Provider, the Dialer application changes the \TCPIP\ETC\TCPOS2.INI file with your current user id. CLM will watch for this and change its idea of who you are to match. This check happens periodically. The amount of time between each check is set using the Match Dialer Time spinbutton. ΓòÉΓòÉΓòÉ 2.3.2. Match Dialer ID Spinbutton ΓòÉΓòÉΓòÉ If the Match Dialer Time checkbox is checked, the Common Logon Manager will monitor the Warp Internet Dialer. When you connect to your Internet Access Provider, the Dialer application changes the\TCPIP\ETC\TCPOS2.INI file with your current user id. CLM will watch for this and change its idea of who you are to match. The Match Dialer ID Spinbutton is used to indicate how often this check is performed. If you haven't changed the setting, it defaults to fifteen seconds. You can set the period to anything in the range of zero to 999 seconds. If you set it to zero, CLM will only perform this check when it starts, and will not do periodic checks. ΓòÉΓòÉΓòÉ 2.3.3. Get ID's from PASSWD file ΓòÉΓòÉΓòÉ This is a checkbox that, when checked, tells the Common Logon Manager to check the \TCPIP\ETC\PASSWD file for user ids. If that file exists, CLM will read through it, and add any user ids it finds to the User ID combo box. This check happens periodically. The amount of time between each check is set using the Get ID's from PASSWD file Time spinbutton. ΓòÉΓòÉΓòÉ 2.3.4. Get ID's from PASSWD file Spinbutton ΓòÉΓòÉΓòÉ If the Get ID's from PASSWD file checkbox is checked, the Common Logon Manager will check the \TCPIP\ETC\PASSWD file for user ids. If that file exists, CLM will read through it, and add any user ids it finds to the User ID combo box. The Get ID's from PASSWD file Spinbutton is used to indicate how often this check is performed. If you haven't changed the setting, it defaults to fifteen minutes. You can set the period to anything in the range of zero to 999 seconds. If you set it to zero, CLM will only perform this check when it starts, and will not do periodic checks. If you add a user id to the PASSWD file, the next time CLM checks this file, the new user id will automatically be added to the User ID combo box. ΓòÉΓòÉΓòÉ 2.3.5. Get ID's from TCPOS2.DLL ΓòÉΓòÉΓòÉ This is a checkbox that, when checked, tells the Common Logon Manager to check the \TCPIP\ETC\TCPOS2.DLL file for user ids. If that file exists, CLM will read through it, and add any user ids it finds to the User ID combo box. The user ids in this file are put there by the Warp Internet Dialer applications. This check happens periodically. The amount of time between each check is set using the Get ID's from TCPOS2.DLL Time spinbutton. ΓòÉΓòÉΓòÉ 2.3.6. Get ID's from TCPOS2.DLL Spinbutton ΓòÉΓòÉΓòÉ If the Get ID's from TCPOS2.DLL checkbox is checked, the Common Logon Manager will check the \TCPIP\ETC\TCPOS2.DLL file for user ids. If that file exists, CLM will read through it, and add any user ids it finds to the User ID combo box. The user ids in this file are put there by the Warp Internet Dialer applications. The Get ID's from TCPOS2.DLL Spinbutton is used to indicate how often this check is performed. If you haven't changed the setting, it defaults to fifteen minutes. You can set the period to anything in the range of zero to 999 seconds. If you set it to zero, CLM will only perform this check when it starts, and will not do periodic checks. ΓòÉΓòÉΓòÉ 2.3.7. Auto Logoff Checkbox ΓòÉΓòÉΓòÉ This is a checkbox that, when checked, tells the Common Logon Manager to automatically set your status to Not Here (i.e. Not Logged On) if there has been no activity in the amount of time specified by the Auto Logoff Spinbutton. Any keyboard or mouse activity will reset the timer. Warning: Keyboard or mouse activity in a full-screen session will not reset the timer. When the timer expires, User Info Page 1 of 2 and the title bar will be changed. The CLM notebook will also be brought to the top to make sure you are aware of the change in status. If it has been minimized or hidden, it will be restored. ΓòÉΓòÉΓòÉ 2.3.8. Auto Logoff Spinbutton ΓòÉΓòÉΓòÉ If the Auto Logoff checkbox is checked, the Common Logon Manager will automatically set your status to Not Here (i.e. Not Logged On) if there has been no keyboard or mouse activity. The Auto Logoff Spinbutton is used to set the timeout. If you haven't changed the setting, it defaults to fifteen minutes. You can set the period to anything in the range of one to 999 minutes. Warning: Keyboard or mouse activity in a full-screen session will not reset the timer. ΓòÉΓòÉΓòÉ 2.4. Identd Notebook Page ΓòÉΓòÉΓòÉ In addition to the three standard pushbuttons (Save, Help, and Product Info) the Identd notebook page contains an Enable IDENTD checkbox. This control is used to enable or disable the Identification server. See the section on IDENTD for more information about this service. ΓòÉΓòÉΓòÉ 2.5. Enable IDENTD Checkbox ΓòÉΓòÉΓòÉ This control is used to enable or disable the Identification server. See the section on IDENTD for more information about this service. ΓòÉΓòÉΓòÉ 2.6. General Notebook Page ΓòÉΓòÉΓòÉ The General Notebook Page is used to configure startup and shutdown options for the Gibbon Common Logon Manager. In addition to the three standard pushbuttons (Save, Help, and Product Info) this notebook page contains the following controls: o Shutdown Time spinbutton o Start Minimized checkbox ΓòÉΓòÉΓòÉ 2.6.1. Shutdown Time Spinbutton ΓòÉΓòÉΓòÉ The Shutdown Time spinbutton is used to tell the Gibbon Common Logon Manager (CLM) when it should shut down, or terminate itself. It can be set to any value in the range of zero to 999 minutes. If you haven't changed the setting, it will default to 15 minutes. Setting the spinbutton to zero wil disable automatic shutdown. CLM will reset the timer any time you make any changes to the settings. Some of the other Gibbon Computer Products applications that use TCP/IP networking will periodically send requests to CLM. These requests can either be for user id information and logon status, or they can be "keep alive" polls. These requests will also reset the timer. Any access to the Identification Server will also reset the timer. If the timer reaches the time set by the spinbutton, CLM will shut itself down and the program will terminate. ΓòÉΓòÉΓòÉ 2.6.2. Start Minimized Checkbox ΓòÉΓòÉΓòÉ The Start Minimized checkbox is used to tell the Gibbon Common Logon Manager (CLM) whether or not to start minimized. If it's checked, CLM will start minimized, and you will have to restore it to check or change any of the settings. If it's not checked, CLM will start normally, displaying the configuration notebook. ΓòÉΓòÉΓòÉ 3. IDENTD - Identification Server ΓòÉΓòÉΓòÉ The Gibbon Common Logon Manager program includes an RFC-1413 compliant Identification Server. This is enabled by default, but can be disabled using the Enable IDENTD checkbox. The Identification Protocol provides a means to determine the identity of a user of a particular TCP connection. It is not normally used for security, authentication or access control, but for information and auditing. It is similar to the Caller ID service provided by some phone companies. Here's an example of how it works: You start Gibbon Talk and want to talk to joe@bighost.bigschool.edu. The Gibbon Talk Daemon will send a request to the computer named bighost asking if joe is available. If he is, the Talk Daemon will tell bighost to inform joe that you want to talk to him. bighost will put an entry in its log files saying that its talk daemon was contacted by you. If you are not running the Identification Server, this entry will look something like this: May 2 00:12:15 vervet in.ntalkd[10043]: connect from os2host.advantis.com If you are running the Identification Server, this entry will will now include your user id. It will look something like this: May 2 00:12:15 vervet in.ntalkd[10043]: connect from fred@os2host.advantis.com Enabling the Identification Server is considered a "nice" thing to do when you access other hosts on the Internet. One very good reason for enabling the Identification Server is for problem tracking. Taking the example above, suppose there's a bug in the Gibbon Talk Daemon (this of course couldn't happen, but this is just an example.) This bug causes the Talk Daemon to send a flurry of requests to bighost, which overloads bighost and causes it to crash. The system administrator for bighost would probably want to contact you to let you know you have buggy software. Without the Identification Server running, the only information he has is your host id. He might try sending email to root@os2host.advantis.com, but that probably won't get through to you. If you are running the Identification server, he would know to send the email to fred (who supposedly is you.) You would then get the email, and would forward it to Gibbon Computer Products, who would then know about the problem and get it fixed. ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ Copyright (c) 1983 Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the University of California, Berkeley and its contributors. 4. Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ PGP is a trademark of Philip R.