home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / pier.shareware / pieros2 / GUIDOC21.ZIP / GFAQ.TXT < prev    next >
Encoding:
Text File  |  1994-05-05  |  14.2 KB  |  377 lines
  1.  
  2.     Frequently Asked Questions About Guidelines  - 26th April 1994
  3.     -----------------------------------------------------------------
  4.  
  5.  
  6.  This document aims to answer some of the more commonly asked questions 
  7.  regarding the Guidelines product from JBA.
  8.  
  9.  
  10.   - What is Guidelines?
  11.   - Who are JBA?
  12.   - What has changed since Version 2.0G?
  13.   - What else do I need to generate OS/2 PM Applications?
  14.   - Can I create non-GUI applications - and how about multi-threading?
  15.   - Why JOT ? 
  16.   - How good is the generated code?
  17.   - What if I find I need to accomplish tasks which are not possible within 
  18.       the JOT language?
  19.   - Is there an associated runtime module, and do I have to pay a per copy 
  20.       licence fee ? And what about sources?
  21.   - How do I report problems and get technical support ?
  22.   - How do I obtain fixes?
  23.   - What Guidelines products are currently available from JBA?
  24.   - What other extensions and controls are planned, and when?
  25.   - Does Guidelines support the User Interface Class Library provided 
  26.       with CSet++?
  27.   - What about cross platform development?
  28.   - How do I contact JBA?
  29.  
  30.  
  31.  
  32. -----------------------------------------------------------------------------
  33.  
  34.  - What is Guidelines?
  35.  
  36.  Guidelines is a 32 bit OS/2 hosted development tool which provides 
  37.  developers with a powerful way to interactively design and implement 
  38.  applications.
  39.  
  40.  The Graphical User Interface (GUI) portion of the application is created 
  41.  visually by direct manipulation of the various controls. In other words, the 
  42.  mouse is used to select the various windows and controls from a supported 
  43.  set, and position them on the screen. A number of functions allow for easy 
  44.  alignment and scaling of the controls to easily achieve a professional 
  45.  effect.
  46.  
  47.  Guidelines supports the event driven architecture of modern GUIs. The 
  48.  developer writes the code to respond to these events in a platform neutral 
  49.  high level language named JOT. 
  50.  
  51.  Guidelines provides an Integrated Development Environment (IDE), providing 
  52.  access to all aspects of application development via a common menu. An editor 
  53.  is provided for entry and modification of the supporting JOT code. 
  54.  
  55.  When an application has been written, Guidelines will generate native C++ 
  56.  Presentation Manager or Windows code and all the other supporting files 
  57.  (Makefiles, Resource files, IPF files etc) which make up that application. 
  58.  It will then invoke the developer's C++ compiler and other tools 
  59.  appropriately to create the final executable (EXE) or dynamic linked library 
  60.  (DLL) and any supporting help (HLP) files.
  61.  
  62.  Guidelines is a part of JBA's systems solutions strategy. It can be used to 
  63.  generate standalone OS/2 and Windows applications, or integrated with JBA's 
  64.  AS/400 extensions to generate large Client/Server applications.
  65.  
  66. -----------------------------------------------------------------------------
  67.  
  68.  - Who are JBA?
  69.  
  70.  JBA are one of the world's largest software developers for IBM's midrange 
  71.  market. They have direct and affiliate representation in many countries 
  72.  worldwide, including Canada, United States, Britain, Asia and Australia, and 
  73.  have been operating on this global basis for over 12 years.
  74.  
  75.  Guidelines is their first major product for the PC marketplace, forming an 
  76.  integral part of their overall Client/Server solutions strategy. 
  77.  
  78. -----------------------------------------------------------------------------
  79.  
  80.  - What has changed since Version 2.0G?
  81.  
  82.  A separate document which describes the changes is available as NEWFEAT.INF.
  83.  It is installed as part of the base pack, and available as part of 
  84.  GUIDOC.ZIP.
  85.  
  86.  In short, we have added Windows code generation capability plus support for 
  87.  Watcom and Borland compilers, and Profile (INI) functions, all as part of
  88.  this base release.
  89.  
  90. -----------------------------------------------------------------------------
  91.  
  92.  - What else do I need to generate applications?
  93.  
  94.  Guidelines generates the C++ code and supporting files for an application, 
  95.  but you will still need to have a supported C++ compiler and the toolkit for 
  96.  the platform for which you are targeting.
  97.  
  98.  Currently supported compilers include IBM's CSet++ 2.1A, Borland C++ for 
  99.  OS/2 V1.01, Watcom C++ V9.5 (for OS/2 targets) and Borland C++ for DOS/Win 
  100.  V3.1 (for Windows Targets). Support for EMX is not provided in this 
  101.  release but we expect to release an EMX version of the runtime library and 
  102.  environment in the near future. 
  103.  
  104.  
  105. -----------------------------------------------------------------------------
  106.  
  107.  - Can I create non-GUI applications - and how about multi-threading?
  108.  
  109.  Yes - Guidelines can generate straight character mode applications which  
  110.  do not have a PM message queue if needed. Multithreading support is also  
  111.  provided within JOT; this is true under both OS/2 and Windows.
  112.  
  113. -----------------------------------------------------------------------------
  114.  
  115.  - Why JOT ? 
  116.  
  117.  We decided to choose a new language for two main reasons.
  118.  
  119.   1. The language needs to be platform neutral, or well supported on all 
  120.      platforms to be targeted by Guidelines. 
  121.  
  122.   2. The syntax of the language should be easy to grasp by those coming from 
  123.      midrange and mainframe backgrounds, yet still provide some of the 
  124.      benefits of an object oriented language.
  125.  
  126.  
  127. -----------------------------------------------------------------------------
  128.  
  129.  - How good is the generated code?
  130.  
  131.  The C++ code generated by Guidelines is readable and commented throughout. 
  132.  It is similar to code created by a professional coder, so your investment is 
  133.  protected (it could easily be maintained outside the Guidelines environment 
  134.  if necessary).
  135.  
  136.  
  137. -----------------------------------------------------------------------------
  138.  
  139.  - What if I find I need to accomplish tasks which are not possible within the 
  140.    JOT language?
  141.  
  142.  The JOT language allows you several alternative ways to use C++ code in 
  143.  your design if this is more suitable, or isthe only way to solve a 
  144.  particular problem. Our aim, however, is to increase functionality of the 
  145.  language until this is a truly rare occurrence, so if you find this is the 
  146.  case, please let us know.
  147.  
  148. -----------------------------------------------------------------------------
  149.  
  150.  - Is there an associated runtime module, and do I have to pay a per copy 
  151.    licence fee ?
  152.  
  153.  Commonly used 'runtime' code is provided, to which generated code is linked. 
  154.  NO additional licence fees are required.
  155.  
  156. -----------------------------------------------------------------------------
  157.  
  158.  - How do I report problems and get technical support ?
  159.  
  160.  Support is primarily provided via CompuServe, in the "Other Vendors" section 
  161.  (section 1) of OS2AVEN. Address support enquiries to "Guidelines Support" at 
  162.  Id 100316,3353 either as private email, or as a general message on the forum. 
  163.  A general message will allow others to see your question, and any answers, 
  164.  so this is the preferred option.
  165.  
  166.  On Internet, you can post enquiries to the Guidelines support staff on 
  167.  Compuserve by mailing to 100316.3353@compuserve.com. Officially, support is
  168.  only provided to users who have purchased the product. However, we will 
  169.  endeavour to answer all questions, even on the base version obtained FOC.
  170.  
  171.  The file GPROB.TXT contains a problem reporting sheet which can be mailed 
  172.  directly to the above Id. Giving us this information will allow us to narrow 
  173.  down problems more quickly. We expect to acknowledge, via email, any 
  174.  submitted reports within 2 working days, although resolution of the problem 
  175.  may take longer. Any Guidelines files demonstrating the problem should be 
  176.  compressed using PKZIP or a compatible utility and sent to the above ID as 
  177.  mail, not uploaded to the (public) forum libraries.
  178.  
  179. -----------------------------------------------------------------------------
  180.  
  181. - How do I obtain fixes?
  182.  
  183.  As fixes become available, these will be downloadable from the CompuServe 
  184.  libraries (currently section 1 library of OS2AVEN), and other electronic
  185.  channels (FidoNet, Internet etc).
  186.  
  187.  Major fix releases will be available on other media via the JBA sales 
  188.  channels.
  189.  
  190. -----------------------------------------------------------------------------
  191.  
  192. - What Guidelines products are currently available from JBA?
  193.  
  194.  To allow developers to choose a configuration of Guidelines which best suits 
  195.  their development needs, a number of packs are available in addition to the 
  196.  base product. These contain additional controls and functionality.
  197.  
  198.  
  199.  * GUIDELINES BASE PACK
  200.  
  201.    This contains the basic Guidelines tool, providing full function design 
  202.    and code generation facilities. Support for the following CUA '89 
  203.    controls is also provided.
  204.  
  205.             Frame/Dialogs
  206.             List Box 
  207.             Combo Box
  208.             Entry Field
  209.             Multiple-line Entry Field
  210.             Scroll Bars
  211.             Static Controls 
  212.                 - Text
  213.                 - Icon
  214.                 - Bitmap
  215.                 - Rectangle 
  216.                 - Group Box
  217.            
  218.             Button Controls 
  219.                 - Push button 
  220.                 - Radio Button
  221.                 - Check Box
  222.                 - 3-state Button
  223.  
  224.    Also included is the picture control, which provides for enhancing the 
  225.    appearance of your application. This supports animated bitmaps and icons 
  226.    in pushbuttons and static panels.
  227.  
  228.             Picture Control
  229.                 - Picture Button
  230.                 - Multi-state Button
  231.                 - Animated Button
  232.                 - Toggle Button
  233.                 - Set Button
  234.                 - Picture Panel
  235.  
  236.             Profile File support
  237.                 - a set of functions to read and write to INI files
  238.  
  239.  
  240.  * EXTENDED CONTROL PACK
  241.  
  242.    The extended controls pack extends the range of controls supported by 
  243.    Guidelines to include all of those supported under OS/2 2.1 to the CUA '91 
  244.    standard. In particular, these include:
  245.  
  246.     Container
  247.     Value Set
  248.     Notebook
  249.     Spin Button
  250.     Slider
  251.  
  252.    In addition, extensions are provided which add to the functionality of 
  253.    JOT:
  254.  
  255.     DDE - provides access to OS/2's Dynamic Data Exchange facilities
  256.  
  257.     File I/O - provides file and directory manipulation functions
  258.  
  259.     Standard Dialogs - support for OS/2's standard font and file selection 
  260.                        dialogs, 
  261.  
  262.     Timer - provides timers plus extensive date and time formatting routines.
  263.  
  264.  
  265.  * ADVANTAGE CONTROL PACK
  266.  
  267.    The Advantage Pack supplies additional visual controls specially written 
  268.    for Guidelines (not natively supported by OS/2).
  269.  
  270.     Status Bars - provides a number of status fields, usually across the 
  271.                   bottom of a dialog or frame window.
  272.  
  273.     Button Bar  - Similar to the toolbar, this control is usually used to
  274.                   to contain picture buttons.
  275.  
  276.     Tool Bar    - provides horizontal and vertical toolbars, on which other 
  277.                   controls may be placed for rapid access.
  278.  
  279.     Color Wheel - allows selection of a color in a similar manner to the 
  280.                   system color wheel (including shade bar).
  281.  
  282.     Gauge       - three types of gauge are provided, a bar, a rotary needle
  283.                   gauge and a 'thermometer' type gauge.
  284.  
  285.  
  286.  * DOCUMENTATION PACK
  287.  
  288.    This pack contains full hard-copy documentation for Guidelines, including 
  289.    all the additional control packs. 
  290.  
  291.  
  292.  * AS/400 EXTENSIONS
  293.  
  294.    A number of connectivity solutions are available from JBA to provide 
  295.    interoperability with IBMs AS/400 midrange. Please contact JBA to discuss 
  296.    your requirements.
  297.  
  298.  
  299. -----------------------------------------------------------------------------
  300.  
  301. - What other extensions and controls are planned, and when?
  302.  
  303.  The BUSINESS CONTROL PACK will include the following controls:
  304.  
  305.   - Business Graphics
  306.   - Q+E Database Library support
  307.   - ODBC Support
  308.   - Extended Entry Field Control
  309.  
  310.  
  311. -----------------------------------------------------------------------------
  312.  
  313.  - Does Guidelines support the User Interface Class Library provided with 
  314.    CSet++?
  315.  
  316.  Currently Guidelines neither requires, nor supports this library.
  317.  
  318. -----------------------------------------------------------------------------
  319.  
  320.  - Can I add my own extensions and controls to Guidelines?
  321.  
  322.  Guidelines was developed with this in mind, and all language extensions and 
  323.  controls are registered externally with the base product. Currently the API 
  324.  to support this is not exposed, but we expect to document and publish it in 
  325.  an upcoming release.
  326.  
  327. -----------------------------------------------------------------------------
  328.  
  329.  - What about cross platform development?
  330.  
  331.  Guidelines supports the generation of programs to run under Windows 3.1
  332.  and WinOS/2 as well as OS/2. Guidelines itself will still only run under 
  333.  OS/2 but will  generate code for a Windows target environment and use a 
  334.  DOS/Windows compiler to generate executables.
  335.  
  336.  Other possible targets are being investigated at this time.
  337.  
  338. -----------------------------------------------------------------------------
  339.  
  340.  - How do I contact JBA?
  341.  
  342.  *PHONE
  343.  
  344.  JBA may be contacted by telephone for Guidelines enquiries at the following 
  345.  offices:
  346.                        Africa:                +27 11 804 5062
  347.                        Australasia:             To be advised
  348.                        Europe (UK):              081 899 5600
  349.                        North America;            416 940 2442
  350.  
  351.  * FAX
  352.  
  353.  To purchase Guidelines, send a FAX to "Guidelines Purchase" on:
  354.  
  355.        Birmingham, UK:             +44 (0)21 753 1559
  356.  
  357.  
  358.  * COMPUSERVE
  359.  
  360.    Address orders and order enquiries to:
  361.  
  362.         "Guidelines Purchase" at 73022,35
  363.             (73022.35@compuserve.com)
  364.  
  365.    Address technical enquiries to:
  366.  
  367.         "Guidelines Tech Support" at 100316,3353
  368.             (100316.3353@compuserve.com)
  369.  
  370.  
  371. ───────────────────────────────────────────────────────────────────────
  372.  
  373. *   IBM, C Set++, Operating System/2, OS/2 and Presentation Manager are
  374.     trademarks or registered trademarks of International Business
  375.     Machines Corporation. Borland C++ is a trademark of Borland International,
  376.     inc, and Watcom is a trademark of Watcom International Corporation.
  377.