home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / vprxeval.zip / read.me < prev    next >
Text File  |  1993-08-26  |  15KB  |  383 lines
  1. ************************************************************
  2. * VisPro/REXX 1.1 (tm) EVALUATION VERSION READ.ME (8/93)
  3. * COPYRIGHT (c) 1993 by HockWare Inc.
  4. *
  5. * This evaluation version of VisPro/REXX can only be used
  6. * for purposes of evaluating the VisPro/REXX 1.1 product.
  7. * Other uses, including production, are prohibited.
  8. * The Product Information window always appears before a form is
  9. * opened and before the Test Session is opened to remind you of
  10. * the intended use.  These do not appear in the product version
  11. * of VisPro/REXX
  12. *
  13. * VisPro/REXX is... Visual Programming with REXX
  14. *
  15. * "...OS/2's time may be here, thanks to a $299 tool called
  16. * Visual Programming with REXX which brought the house down at
  17. * a recent OS/2 conference in Colorado...it is to REXX and OS/2
  18. * what Visual Basic is to Windows and Dos."
  19. *
  20. * Robert X. Cringely
  21. * Infoworld, January 25, 1993
  22. *
  23. * Now you can unleash the power of the REXX language in a GUI
  24. * environment with an easy-to-use visual programming tool.
  25. * VisPro/REXX offers a CUA '91 interface, WYSIWYG editors, and
  26. * drag-drop programming--features that allow you to visually
  27. * construct OS/2 2.0 applications in record time.
  28. *
  29. * Who says powerful results can't be easy to achieve?
  30. *
  31. * Because VisPro/REXX is completely integrated with the OS/2
  32. * 2.0 Workplace Shell, you can leverage your existing skills.
  33. * VisPro/REXX offers multiple views, drag-drop interaction, pop
  34. * up menus, settings notebooks, direct editing, and other CUA
  35. * '91 features, and supports the OS/2 2.0 font and color palettes.
  36. * Even users with little or no knowledge of programming become
  37. * productive VisPro/REXX users in no time.
  38. *
  39. * Here's what you can do with VisPro/REXX:
  40. *
  41. * -Quickly prototype and develop OS/2 2.0 CUA '91 applications
  42. * -Generate a small, single .EXE file for license-free
  43. *  distribution
  44. *
  45. * -Build client-server programs
  46. * -Migrate existing REXX procedures to the OS/2 2.0 GUI
  47. *  environment
  48. *
  49. * VisPro/REXX gives you access to these OS/2 2.0 programming
  50. * features:
  51. *
  52. * -Buttons, lists, graphics, sliders, and all the CUA '91 controls
  53. * -Business graphics
  54. * -APPC, HLLAPI, and OS/2 2.0 Database Manager
  55. *
  56. * Best of all, it's small
  57. *
  58. * System requirements:
  59. * OS/2 2.0, 5 Mb memory
  60. * 2 Mb hard disk space
  61. *
  62. * $299 Introductory price + shipping and handling
  63. *
  64. * HockWare, Inc.
  65. * P.O. Box 336
  66. * Cary, NC 27512-0336
  67. *
  68. * Sales (919)387-7391
  69. * Fax (919)380-0757
  70. *
  71. *
  72. ************************************************************
  73.  
  74.  
  75.   ABOUT VISPRO/REXX
  76.   =================
  77.  
  78.   VisPro/REXX allows you to use the REXX Programming language to create
  79.   powerful applications with a graphical user interface.  The applications
  80.   you create might be for your own use, or they may be distributed to other
  81.   people free of charge.
  82.  
  83.  
  84.   VisPro/REXX is easy to use because it hides all the complexities of OS/2
  85.   2.0 Presentation Manager programming.  You use FORMS to create your
  86.   projects; each form represents a window that the user of your application
  87.   will see.  The objects that you use to create your applications are
  88.   represented graphically on a TOOL BAR.  You simply select the objects you
  89.   want to use in your application and then copy them to the CANVAS, which
  90.   is the area in which you lay out or design your applications.
  91.  
  92.  
  93.   JUST LIKE THE WORKPLACE SHELL
  94.   =============================
  95.  
  96.   VisPro/REXX is fully integrated into the Workplace Shell.  This means
  97.   that if you are familiar with the Workplace Shell, VisPro/REXX will look
  98.   and feel natural and intuitive.  VisPro/REXX employs such features as
  99.   drag and drop, direct editing, pop-up menus, multiple views, and setting
  100.   notebooks.  VisPro/REXX supports the OS/2 font or color palettes so you
  101.   can easily change the font and color of your objects.
  102.  
  103.  
  104.   DRAG AND DROP PROGRAMMING
  105.   =========================
  106.  
  107.   VisPro/REXX provides drag and drop capacities throughout the product.
  108.   The most distinctive of these capacities is drag and drop programming.
  109.   You begin by specifying an event for an object (for example, the user
  110.   selects a push button).  Select the object and drag it to the Event
  111.   window.  In the Event window, a window appears, allowing you to select
  112.   the action you want to perform.  The choices are presented in simple
  113.   terms, and you do not need to know the REXX statement for the action you
  114.   select; VisPro/REXX generates it for you.
  115.  
  116.  
  117.   HANDLING OF ALL OS/2 CONTROLS
  118.   =============================
  119.  
  120.   All OS/2 controls, including CUA 91 controls, are handled.  VisPro/REXX
  121.   is the only REXX development environment which handles containers,
  122.   value set, sliders, spin boxes, notebooks, @@@
  123.  
  124.  
  125.   MULTITHREADING OF REXX CODE
  126.   ===========================
  127.  
  128.   All REXX code is invoked in a thread which is different from the
  129.   user interface thread.  This allows the user interface to be responsive
  130.   at all times, even if the application is still handling a REXX event.
  131.  
  132.  
  133.  
  134.   THE BUSINESS GRAPHICS BONUS
  135.   ===========================
  136.  
  137.   VisPro/REXX comes with its own business graphics capability.  These
  138.   graphics can be used, for example, to monitor your company's financial
  139.   status.  To incorporate business graphics into your application, you
  140.   simply select the business graphic object from the tool bar and add it to
  141.   the canvas.  The business graphics include pie charts, bar charts,
  142.   stacked bar charts, line charts, and area charts.
  143.  
  144.  
  145.   THE STORY BEHIND VISPRO/REXX
  146.   ============================
  147.  
  148.   HockWare developed VisPro/REXX with a small team of developers that have
  149.   highly-developed skills in CUA '91 user interface design, Presentation
  150.   Manager and OS/2 Workplace Shell programming, object-oriented
  151.   programming, and data base design.  HockWare has an ideal:  to create
  152.   visually appealing, easy to use graphical user interface products that
  153.   allow you to take advantage of the rich function built into OS/2.
  154.  
  155.   The graphical user interface provided by OS/2's Workplace Shell makes it
  156.   easy for you to exploit the function of OS/2, and VisPro/REXX's
  157.   interface emulates the Workplace Shell.  Because of the consistency in
  158.   VisPro/REXX's interface, you can begin designing your own Presentation
  159.   Manager applications for OS/2 in no time at all.
  160.  
  161.  
  162.   ACHIEVING THE CUA '91 IDEAL
  163.   ===========================
  164.  
  165.   The objective of the common user access (CUA) '91 standard is to make all
  166.   OS/2 products share the same look and feel.  Once you learn one
  167.   object-oriented CUA '91 application, you can go to another CUA '91
  168.   application and immediately begin using it.  HockWare understands the CUA
  169.   '91 standards thoroughly, and we put this ideal into practice for
  170.   VisPro/REXX.  Because it is a truely CUA '91 conforming project,
  171.   VisPro/REXX is itself and exemplary OS/2 application.
  172.  
  173.  
  174.   ABOUT YOUR EVALUATION VERSION OF VISPRO/REXX
  175.   ============================================
  176.  
  177.   You have received an evaluation version of VisPro/REXX.  Using the
  178.   evaluation version, you can create an application consisting of a single
  179.   form, and you can test and interact with this single-form application.
  180.   The evaluation version does not support multiple forms and it does not
  181.   allow you to build the application to create a stand along executable
  182.   file.
  183.  
  184.   THE VISPRO/REXX EVALUATION VERSION IS NOT INTENDED FOR PRODUCTION
  185.   PURPOSES; IT IS PROVIDED FOR YOU TO GET TO KNOW THE VISPRO/REXX PRODUCT
  186.   SO YOU CAN DECIDE WHETHER YOU WANT TO PURCHASE IT.  THE FOLLOWING SECTION
  187.   DESCRIBES WHAT THE VISPRO/REXX PRODUCT COMES WITH.
  188.  
  189.  
  190.   WHAT THE VISPRO/REXX PRODUCT PROVIDES
  191.   =====================================
  192.  
  193.   1- A license to use the VisPro/REXX product.
  194.  
  195.   2- All the function of VisPro/REXX, including the ability to create
  196.      multiple forms and build applications for distribution to other users.
  197.  
  198.   3- A self-running demonstration of VisPro/REXX.
  199.  
  200.   4- Complete online help.
  201.  
  202.   5- Sample programs that help you learn how to use VisPro/REXX and that
  203.      you can use as a model for creating your own applications.
  204.  
  205.   6- A 200-page graphically-illustrated guide that includes overview and
  206.      conceptual information, task descriptions, trouble shooting
  207.      techniques, and instructions for reproducing a simple application and
  208.      an advanced sample application that ships with VisPro/REXX.
  209.  
  210.   7- A registration card you can return to us, entitling you to product
  211.      updates and 90 days free technical support
  212.  
  213.  
  214.  
  215.   GETTING STARTED WITH YOUR EVALUATION VERSION OF VISPRO/REXX
  216.   ===========================================================
  217.  
  218.   Once you install your evaluation version of VisPro/REXX, you can use the
  219.   online help to get information about how to use the product.
  220.   Instructions for installing the evaluation version, opening a project,
  221.   and using the online help are provided in the following sections.
  222.  
  223.  
  224.  
  225.   INSTALLING YOUR EVALUATION VERSION OF VISPRO/REXX
  226.   =================================================
  227.  
  228.   To use VisPro/REXX, you must have OS/2 2.0 or any later version
  229.   installed on your system.  VisPro/REXX requires approximately 1.4
  230.   megabytes of free disk space.  If you are installing on OS/2 2.1, be
  231.   sure to select the REXX option.
  232.  
  233.   Note:  no version of VisPro/REXX should not be running if you reinstall
  234.   the evaluation version of VisPro/REXX.  If this occurs, close all
  235.   VisPro/REXX windows, reboot and then start the installation over.
  236.  
  237.   To install the VisPro/REXX evaluation version, complete the following
  238.   steps:
  239.  
  240.   1) Place the evaluation diskette in the drive you want to install from.
  241.  
  242.   2) Press the right mouse button to get a pop-up menu on the diskette
  243.      drive you are using.
  244.  
  245.   3) Select the arrow on the Open menu item.
  246.  
  247.   4) Select Icon View.
  248.  
  249.   5) Double-click on the SETUP.EXE program, which has the VisPro/REXX icon
  250.  
  251.   6) Select the drive you want to install the evaluation version on beside
  252.      'Install on drive'.
  253.  
  254.   7) If you want to change the path you are installing on, type the path
  255.      name in the Install path field.
  256.  
  257.   8) Select Install
  258.  
  259.   9) Select Install on the Installation Progress window.
  260.  
  261.   10) When the installation is complete, the Installation Complete window
  262.       appears.
  263.  
  264.   11) Select OK.
  265.  
  266.       Note:  If you select a drive other than the C: drive or if
  267.       VisPro/REXX was previously installed on a drive other than the
  268.       C: drive, your CONFIG.SYS is automatically updated, and you must
  269.       reboot before using the product.
  270.  
  271.       The Projects folders appear on the OS/2 desktop.
  272.  
  273.   12) Double Click on the Projects folder.
  274.  
  275.       You will see the PROJECTS Icon View window appear.  This window
  276.       contains the following:
  277.  
  278.         -Project template:  Allows you to create new projects.
  279.  
  280.         -REXX Information online reference:  Allows you to get information
  281.          about REXX.
  282.  
  283.         -Tutorial/Demo:  Contains a demonstration of VisPro/REXX
  284.  
  285.         -Color palette:  Allows you to change colors on your form.
  286.  
  287.         -Font palette:  Allows you to change the font on your form.
  288.  
  289.  
  290.  
  291.   CREATING A VISPRO/REXX PROJECT
  292.   ==============================
  293.  
  294.   When you open the VisPro/REXX folder you created during installation, you
  295.   see a template called Project. You can drag a new folder off the Project
  296.   template and use it as your new project, which will become your
  297.   application.
  298.  
  299.   To open your new project, complete the following steps:
  300.  
  301.   1) Open the Projects folder on your desktop.  To do so, double-click on
  302.      the folder.
  303.  
  304.   2) Create a new Project folder.  To do so, press the right mouse button
  305.      and drag a folder off the Project template in the PROJECTS - Icon View
  306.      window.
  307.  
  308.      A Project folder appears.
  309.  
  310.   3) Rename your project folder.  To do so, select the Projects folder and
  311.      press Alt while you click the left mouse button.  Type the name you
  312.      want to assign to your new application.
  313.  
  314.   4) Click outside of the folder.
  315.  
  316.   5) Open your Project folder.  To do so, double-click on the folder.
  317.  
  318.      The icon view for your new application appears.  You will see a Main
  319.      icon.  The Main icon is the form you use to begin designing your
  320.      application.  After your application is complete, do not delete, move,
  321.      or rename the Main form.
  322.  
  323.  
  324.  
  325.   OPENING THE MAIN FORM
  326.   =====================
  327.  
  328.   To begin creating your application, you can open the Main form in one of
  329.   two ways:
  330.  
  331.   METHOD A:
  332.  
  333.   Double-click on the Main icon.  The form appears in the Layout view,
  334.   presenting the tool bar and the canvas.  This view allows you to easily
  335.   design your form.
  336.  
  337.   METHOD B:
  338.  
  339.   Select the Main icon, and them click the right mouse button to get the
  340.   pop-up menu for the Main icon.  Select Open.  A cascading menu appears,
  341.   allowing you to select the view you want to begin working with.  The
  342.   Layout view is recommended for designing the layout of your form.
  343.  
  344.   The evaluation version of VisPro/REXX allows you to create only a
  345.   single-form application.  The product version of VisPro/REXX allows you
  346.   to create multiple-form applications.
  347.  
  348.  
  349.  
  350.   USING VISPRO/REXX'S ONLINE HELP
  351.   ===============================
  352.  
  353.   VisPro/REXX includes an extensive online help system that you can use if
  354.   you have questions while you are working.  To get information about how
  355.   the online help works, select the Help menu.  A cascading menu appears,
  356.   presenting the following menu items:
  357.  
  358.      Help Index....
  359.      General Help....
  360.      Using Help....
  361.      Product information....
  362.  
  363.   You can select any of these items.  To find out what information each of
  364.   these items provides, highlight the item (use the arrow keys), and then
  365.   press F1.
  366.  
  367.   Note:  You can browse the help using the online help Contents.  To use
  368.   the Contents, select the OPTIONS menu from within any help window, and
  369.   then select CONTENTS.
  370.  
  371.  
  372.  
  373.   USING THE REXX INFORMATION ONLINE REFERENCE
  374.   ===========================================
  375.  
  376.   If you require information about REXX, you can use the REXX Information
  377.   online reference that comes with OS/2 2.0.  If you did not include this
  378.   reference when you installed OS/ 2 2.0 on your workstation, you will have
  379.   to do a selective install.  To use the reference, double click on the
  380.   REXX Information icon in the PROJECTS-Icon View window.
  381.  
  382.  
  383.