═══ 1. ! Note ═══ Product Documentation Information. Y.A.M. COMPUTERS (1982) Ltd. (Y.A.M) PROVIDES THIS INFORMATION "AS IS", WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. Y.A.M. may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time. It is possible that this information may contain reference to, or information about, Y.A.M. products (programs), programming, or services that have not been announced in your country. Such references or information must not be construed to mean that Y.A.M. intends to announce such Y.A.M. products, programming, or services in your country. OpenWin (C) Copyright Y.A.M. Computers (1982) Ltd. 1991.All rights reserved. OpenWin Program License Agreement STATEMENT OF LIMITED WARRANTY OpenWin REGISTRATION CARD ═══ 2. OpenWin Program License Agreement ═══ OpenWin Program License Agreement BEFORE OPENING AND USING THIS PACKAGE, YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS. OPENING THIS PACKAGE OR USING THIS PACKAGE INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH THEM, YOU SHOULD PROMPTLY RETURN THE PACKAGE UNOPENED AND YOUR MONEY WILL BE REFUNDED. THE LICENSE HEREIN IS VALID ONLY FOR USERS THAT HAVE PURCHASED THE PRODUCT FROM Y.A.M. COMPUTERS OR ITS LICENSED DISTRIBUTORS. This is a license agreement and not an agreement for sale. Y.A.M. owns all copyrights to the program - "OpenWin" henceforth the Program. You obtain no rights other than the license granted you by this agreement. Title to the enclosed copy of the Program, and any copy made from it, is retained by Y.A.M.. Y.A.M. licenses your use of the program. You assume all responsibility for the selection of the program to achieve your intended results and for the installation of, use of, and results obtained from, the program. LICENSE You may: 1. Use the program on only one machine and only one user may operate it at any one time, unless permission to use it on more than one machine at any one time is granted in attached Special License Information ; 2. Make a copy of the Program for backup or modification purposes only in support of your authorized use. However, programs marked "Copy Protected" limit copying; 3. Transfer possession of copies of the program to another party by transferring this copy of the OpenWin Program License Agreement, the License Information, and all other documentation, along with at least one complete, unaltered copy of the program. You must, at the same time, either transfer to such other party or destroy all other copies of the program in your possession, including modified copies or portions of the Program merged into other programs. Such transfer of possession terminates your license from Y.A.M.. Such other party shall be licensed, under the terms of this agreement, upon acceptance of this agreement by its initial use of the program. You shall reproduce and include the copyright notice(s) on all such copies of the Program, in whole or in part. You may not: 1. Use, copy, modify, merge, or transfer copies of the Program except as provided in this agreement; 2. Perverse assemble or reverse compile the program, and/or 3. Sub license, rent, lease or assign the program or any copy thereof. LIMITED WARRANTY Warranty details and limitations are described in the Statement of Limited Warranty which is attached. Y.A.M. provides a three-month limited warranty on the media for all programs. For selected programs, as indicated on the outside of the package, a limited warranty on the program is available. The applicable warranty period is measured from the date of delivery to the original user as evidenced by a Certain Programs receipt., as indicated on the outside of the package, are not warranted and are provided "AS IS." SUCH WARRANTIES ARE IN LIEU OF ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. LIMITATION OF REMEDIES Y.A.M.'s entire liability and your exclusive remedy shall be as follows: 1. Y.A.M. will provide the warranty described in Y.A.M.'s statement of Limited Warranty. If Y.A.M.'s authorized distributor does not replace defective media or, if applicable, make the Program operate as warranted, or replace the Program with a functionally equivalent program, all as warranted, you may terminate your license and your money will be refunded upon the return of all of your copies of the Program. 2. For any claim arising out of Y.A.M.'s limited warranty, or for any other claim whatsoever related to the subject matter of this agreement, Y.A.M.'s liability for actual damages, regardless of the form of action, shall be limited to the money paid to Y.A.M., its authorized dealer, or its approved supplier for the license for the program that caused the damage, or that is the subject matter of, or is directly related to, the cause of action. This limitation will not apply to claims for personal injury or damages to real or tangible personal property caused by Y.A.M.'s negligence. 3. In no event will Y.A.M. be liable for any lost profits, lost savings, or any incidental damages or other consequential damages , even if Y.A.M., its authorized dealer, or its approved supplier, has been advised of the possibility of such damages, or for any claim by you based on a third party claim. GENERAL You may terminate your license at any time by destroying all copies of the Program in your possession, or as otherwise described in this agreement. Y.A.M. may terminate your license if you fail to comply with the terms and conditions of this agreement. Upon such termination, you agree to destroy all copies of the Program in your possession. Any attempt to sub-license, rent, lease or assign, or, except as expressly provided herein, to transfer any copy of the program is void. You agree that you are responsible for payment of any taxes, including personal property taxes, resulting from this agreement. No action, regardless of form, arising out of this agreement may be brought by either party more than two years after the cause of action has arisen, except for breach of the provisions in the section entitled "License", in which event four years shall apply. This agreement will be construed under the laws of Israel. ═══ 3. Statement of limited warranty ═══ STATEMENT OF LIMITED WARRANTY (MEDIA AND PROGRAM) Y.A.M. Computers (1982) Ltd. (Y.A.M.) grants the following limited warranty for this Y.A.M. Licensed Program - OpenWin (Program), if this copy of the program is delivered by Y.A.M., a Y.A.M. authorized dealer for this program, or any other Y.A.M. approved supplier for this program to a user (supplier). Such a user is referred to herein as "original user." A "user" shall mean a customer who acquired possession of and is licensed to use this copy of the program for his own use, or for use within his own business enterprise, and not for re-marketing. Any unused portion of the warranty period may be conveyed to another user. 1. MEDIA The Warranty Period for the media on which the program is recorded is for three months from the date of its delivery to the original user, as evidenced by a receipt. Y.A.M. warrants that this media will be free from defects in material and workmanship under normal use during the warranty period. If notified during the warranty period that the media contains such defects, your media supplier will replace such media. If the media supplier is unable to deliver replacement media, you may terminate your license and your money will be refunded upon return of all copies of the program in your possession. 2. PROGRAM The warranty period for this program is for three months from the date of its delivery to the original user, as evidenced by a receipt. Y.A.M. warrants that this program, if unaltered, will conform to its program specifications during the warranty period, when such program is properly used on a machine for which it was designed. If notified during the warranty period that the program contain s defects such that it does not conform to its program specifications, Y.A.M. will 1) attempt to make the program operate as warranted a) if prior to the service expiration date, by providing a correction, or b) if after the service expiration date, by providing any existing corrections, or 2) replace the program with a functionally equivalent program, as determined by Y.A.M.. In the event that Y.A.M. does not provide such a remedy, you may terminate your license and your money will be refunded upon return of all of your copies of the program. Y.A.M. does not warrant that any other defects in the program will be corrected or that the operation of the program will be uninterrupted. This limited warranty will apply only if the program is licensed. THIS WARRANTY IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. This limited warranty gives you specific legal rights. Following the end of the warranty period, program services may be available until the service expiration date. The license information contains details on such availability. If you have a question as to where you may obtain warranty service, see the statement of service in the license information for this program. ═══ 4. Registration ═══ Before you start using OpenWin you are requested to register your OpenWin copy by completing and sending the enclosed OpenWin Registration Card. If you have an Unregistered Copy of OpenWin Light you will be able to use it as well under the limits described in the Product Definition. You are requested to register your copy of OpenWin Light by completing and sending the enclosed OpenWin Light Registration Card. . When you receive a registration code (provided with the product or after registration), you can change the " UNREGISTERED COPY, Not for Sale." title to the title you have specified in on your Purchasing / registration form. To do this activate the OpenWin Development Module. Select the Registered option from the action bar. Type the requested title and the password and press O.K. (The requested company title must be the one you have specified on your Purchasing / registration form.) ═══ 4.1. ! OpenWin Registration Card. ═══ Please use OpenWin Light Registration Card. ═══ 4.2. ! OpenWin Light Registration Card. ═══ OpenWin Light Registration Card To register your copy of OpenWin Light, just complete and send this form: To :Y . A . M .Computers . Fax: 972-52-901423 Telephone: 972-52-901416 CompuServe E-Mail: 100310,10 Mail: Y.A.M. Ltd., P.O.B. 2426, Raanana 43663, Israel Name: ___________________________________________________ Company: _________________________________________________ Street: __________________________________________________ City / State / Country: ______________________________________________ Zip/Postal Code: __________ Phone: _______________ Fax: ______________ Requested Company Title __________________________________________ (Please specify a title that will be used as your application's title) I would like more information about becoming an OpenWin distributor ___ We are interested in the development market for: ___ Windows ___ OS/2 ___ Unix/Motif We estimate our OpenWin unit sales volume to be _________ copies. Please register my copy of OpenWin Light for: ___Windows ($99) ___ OS/2 ($99) Add $14 per copy for shipping and handling. And charge my ___ Visa ___ MasterCard ___ Diners Club Number: __________________________________________________ Expiration Date: __/____ Signature: ______________ * Prices are subject to change at any time without prior notice. ═══ 5. ! Product Definition. ═══ The OpenWin manual describes most of the OpenWin package's capabilities. If you are using OpenWin Light which is the stand alone single database version of OpenWin, you should be aware that: 1. OpenWin Light uses one non-SQL file handler bound in the product (dBASE files format compatible file handler). 2. Your application can use external commands by shelling, but you cannot define new OpenWin commands as described in OpenWin Programming guide User Defined Routines chapter. The above mentioned does not apply to the full OpenWin package Unregistered OpenWin Light limits You may use your evaluation copy of OpenWin Light before registering it for a 90 day evaluation period under the following limitations: 1. Your OpenWin Light application title will be "UNREGISTERED COPY, Not for sale.". 2. Your OpenWin Light data files size will be limited to 25K bytes and approximately 100 records. 3. Your OpenWin Light task can use up to 3 tables within a single task. 4. The non-SQL file handler bound in the product is C-Index/II. As soon as you have registered your copy of OpenWin Light you will get a new copy of OpenWin Light. These limitations will be removed and the file handler bound in the product will be dBASE files format compatible. ═══ Help for Help ═══ Choose this option in order to receive information on how to use Help Menus, Extended Help Menus, Keys Help, or the Main Help Index. Help for Help This help window. Extended Help Gives general help/information for the use of OpenWin's on-line help. Keys Help A listing of keyboard functions. Help Index Displays an index of all help items. ═══ Extended help ═══ It is possible to receive extended help for each part of the OpenWin program. This help can be accessed at any time by pressing the F1 key. The help system is context-sensitive and will automatically bring you to the related area. (If your present position has no specific help, this screen will appear.) ═══ Keys Help ═══ OpenWin is using the system keys assignment. ═══ 6. User Help Panel 1 ═══ Type here the help you wish associate with this resource. ═══ 7. User Help Panel 2 ═══ Type here the help you wish to associate with this resource. ═══ 8. User Help Panel 3 ═══ Type here the help you wish to associate with this resource. You can define other resources if you wish. ═══ 9. # OpenWin Run time Help ═══ This help is designed for end users with applications developed by OpenWin. ═══ 10. Run ═══ In order to run an application, select it from the list after you have activated the run module. ═══ 11. Multi-line window ═══ Applications developed with OpenWin may contain multi-line windows. On the action bar of such a window you will see several editing options, for example: Exit Edit Move Paint To select an editing option, use the mouse, or press Alt and the underlined letter. You can use the mouse or the Tab key to move between fields. Fields which can receive input are surrounded by a light frame. In order to confirm input, use the Enter key or touch a field with the mouse on a field which cannot receive input. ═══ 12. Printing ═══ If your application enables printing data, you will get a Printer Selection menu before the printing starts. If no printer is defined in your application environment, you will be able to select the screen as the output target. Select the desired printer and press "OK". ═══ 13. Password ═══ If a Password window is displayed, you must type in the User Password and the General Password to continue. Press ACCEPT after you have typed in the correct password. If you do not know the password, press CANCEL and call your system manager. ═══ 14. Utilities ═══ Under the Utilities option, you will find utilities used during development. 1. User Permeations 2. Lister 3. Printers 4. Locking Resources ═══ 15. User Permeations ═══ The User utility defines access rights to system resources from OpenWin tasks and the OpenWin environment. When you enter the User utility for the first time, use the system password - OPENWIN After you have defined your system manager password with the same permission as that of the OPENWIN password, delete the OPENWIN password. A "Job" is a group of operations for which you wish to control the access rights. It may be an application, a menu option, a task, a routine, or one line within a task. There are two options in the utility module: 1. Input 2. Output See also "Passwrd" - OpenWin environment command, "Ckpw" logic flow command. ═══ 15.1. Input ═══ The Input Module contains three windows: 1. USER HANDLING 2. JOB HANDLING 3. PERMISSION HANDLING ═══ 15.2. USER HANDLING ═══ In USER HANDLING, a user password is entered into the system. This window has the following structure: User password. is a code identifying the user or user's group. General code. is a parameter which allows you to define the access rights for users with the same password. Work code. is a numeric code used to define access rights for the user from an OpenWin environment menu.The application's menu command, Passwrd, puts the Work code into the result variable. Description. Includes a text string describing the user's access rights. ═══ 15.3. JOB HANDLING ═══ In JOB HANDLING, the default access to a job is defined. This window has the following structure: Job code identifies the job . Enter the job name here and refer to it whenever you use the Logic Flow "Ckpw" command in order to get the permission a user has for this job A "Job" is a group of operations on which you wish to control the access rights. It may be an application, a menu option, a task, a routine, or one line within a task. Access You must select an access from the list. If a user has no other permission in the PERMISSION HANDLING for this job code, the access defined here will be returned by the Ckpw command as a result. Description includes a text string describing the job. ═══ 15.4. User permeations ═══ In PERMISSION HANDLING, each user receives access rights to a specific job. This window has the following structure: User password. is a code identifying the user or user's group which can be selected from the list of passwords in the USER HANDLING window. Job code.can be selected from the job list in the JOB HANDLING window. Group and Sub are numeric codes which allow you to define different access rights to the job defined for several users with the same password. The value "0" indicates that this applies to all of the groups (Sub-groups). Zero may be used for one or both variables. Access You must select an access from the list. It will be returned by the Ckpw command as a result. Description includes a text string describing the user's access rights. ═══ 15.5. Output ═══ The Output Module contains three printing options: USER HANDLING, JOB HANDLING and PERMISSION HANDLING. ═══ 16. Lister ═══ The lister utility enables you to print your environment, table definitions, view definitions and task sources. ═══ 17. Printers ═══ The printer utility enables you to define new Printer Control Files. ═══ 18. Locking Resources ═══ the Locking Resources status while IN USE. When using this utility, be very careful not to change the normal behavior of the application ═══ 19. Batch Building ═══ In order to maintain large applications you may rebuild and link an application from a batch file. To do so, you should add the /B qualifier to the command and specify an errors messages file name. a BTH extension will be add to this file name. Following are the building commands formats- Build Environment- BV [Environment file name] /BErrors Build Tables - BLDTBL [Table definition file name] /BErrors (Batch tables building dose not overwrite existing tables) Build Views - BLDVEW [View definition file name] /BErrors (Batch views building dose not overwrite existing views) Build Tasks - BX [Task definition file name] /BErrors Link Tasks - LN [Table definition file name] /O /BErrors (You must specify the /O (overwrite) qualifier)