OS/2 Professional/OS2PRO194.ISO/os2/info/demo/openwin/rarse.hlp

OS/2 Help File | 1993-02-23 | 21.2 KB | 586 lines

ΓòÉΓòÉΓòÉ 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: [phone]

  Telephone: [phone]

  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.


ΓòÉΓòÉΓòÉ <hidden> 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.


ΓòÉΓòÉΓòÉ <hidden> 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.)


ΓòÉΓòÉΓòÉ <hidden> 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)