home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbasedoc.zip / README.OS2 < prev    next >
Text File  |  1995-10-19  |  19KB  |  443 lines
  1. ____________________________________________________________________
  2. ********************************************************************
  3. ____________________________________________________________________
  4.  
  5.                              Technical README - OS/2
  6.  
  7.  
  8.   Welcome to Guidelines version 3.2 technical notes.
  9.  
  10.   Version                   Comment
  11.   ────────────────────────────────────────────────────────────────────────
  12.   3.2   16/10/95 RAP    Creation
  13.  
  14. ____________________________________________________________________
  15. ********************************************************************
  16. ____________________________________________________________________
  17.  
  18.  
  19. ─ CONTENTS ───────────────────────────────────────────────────────────────
  20.   ─────────
  21.  
  22.   1.0  Using GUI files from previous Guidelines versions.
  23.  
  24.   2.0  Third party tools and Guidelines.
  25.  
  26.   3.0  Running applications generated by previous Guidelines releases.
  27.  
  28.   4.0  Running generated OS/2 applications on OS/2 Warp.
  29.  
  30.   5.0  Notes on OS2 Designer
  31.  
  32.   6.0  Extra instructions for - SQL.
  33.  
  34.   7.0  Extra instructions for - Image.
  35.  
  36. ____________________________________________________________________
  37. ********************************************************************
  38. ____________________________________________________________________
  39.  
  40.   ──────────────────────────────────────────────────────
  41. ─ 1.0 USING GUI FILES FROM PREVIOUS GUIDELINES VERSIONS ─────────────────
  42.   ──────────────────────────────────────────────────────
  43.  
  44.   Guidelines 3.2 is able to use GUI files saved by earlier versions of
  45.   Guidelines, and will automatically convert older GUI formats to the
  46.   current format.  Unless you use new controls, functions, or features
  47.   introduced by Guidelines 3.2, you may also use GUI files saved by
  48.   Guidelines 3.2 with Guidelines releases 3.1GA and 3.1GA+PIP.
  49.  
  50.   Please Note: Some Product Improvements may not be available without
  51.   regeneration and recompilation of application code.
  52.  
  53.   ─────────────────────────────────────
  54. ─ 2.0 THIRD PARTY TOOLS AND GUIDELINES ──────────────────────────────────
  55.   ─────────────────────────────────────
  56.  
  57.   The Guidelines Designer is now fully compatible with the popular 4OS2 
  58.   aftermarket replacement command interpreter from JP Software.
  59.   
  60.   Object Desktop, the Workplace Shell enhancement product from StarDock
  61.   systems, has been tested by StarDock and is fully compatible with the
  62.   Guidelines Designer and generated OS/2 applications.  The NPS Workplace
  63.   Shell enhancer is also compatible with the Guidelines Designer and
  64.   generated OS/2 applications.
  65.  
  66.   ──────────────────────────────────────────────────────────────────
  67. ─ 3.0 RUNNING APPLICATIONS GENERATED BY PREVIOUS GUIDELINES RELEASES ────
  68.   ──────────────────────────────────────────────────────────────────
  69.  
  70.   Existing applications will not be affected by fixes and updates to the
  71.   Guidelines Runtime libraries unless they were created to use the
  72.   dynamic versions of those libraries.  Applications that were created to
  73.   use the static versions of the runtime libraries will need to be
  74.   regenerated with Guidelines 3.2 and relinked with the latest static
  75.   runtime libraries in order to receive any benefit from this release of
  76.   Guidelines.
  77.  
  78.   Existing applications generated by Guidelines releases 2.1a(65), 3.1GA,
  79.   and 3.1GA+PIP that were created to use the dynamic versions of the
  80.   Guidelines Runtime libraries will run over the libraries provided in
  81.   Guidelines 3.2.
  82.  
  83.   If you intend to run OS/2 applications created by previous releases of
  84.   Guidelines over the Guidelines 3.2 Runtime libraries, you *must*
  85.   ensure that you replace the GUICRT.DLL provided by the earlier release
  86.   by the GUICRT.DLL provided with Guidelines 3.2.  Using an older
  87.   version of GUICRT.DLL with the Guidelines 3.2 Runtime may cause
  88.   program errors.  The current GUICRT.DLL is now a forwarder DLL, provided
  89.   for backwards compatibility only, which forwards to GCRTOI2D.DLL.
  90.  
  91.   Please note that you will not be able to run applications generated by
  92.   Guidelines 3.2 on top of earlier Guidelines Runtime libraries.
  93.  
  94.   ─────────────────────────────────────────────────────
  95. ─ 4.0 RUNNING GENERATED OS/2 APPLICATIONS ON OS/2 WARP ──────────────────
  96.   ─────────────────────────────────────────────────────
  97.  
  98.   Running a Guidelines generated application on an OS/2 machine that does
  99.   not have Guidelines installed requires you to install some of the
  100.   Guidelines runtime support files on that machine.  This can be done as
  101.   follows:
  102.  
  103. EITHER:
  104.  
  105.      Use the Installer to load the runtime objects only for the packs used
  106.      by the application. This is the easiest method, but there is a tendency
  107.      for too much detail to be loaded this way.
  108.  
  109. OR:
  110.  
  111.   ( These instructions assume that your development machine has Guidelines
  112.     installed in C:\GUIDE and that you wish to install the Guidelines
  113.     runtime support onto drive C:  on the target machine.  The asterisks
  114.     mark steps that apply specifically to installing Client-Server Support
  115.     on the target machine which may be omitted if CSS is not required by
  116.     your application. )
  117.  
  118.     1.  Create a new directory tree on the target machine to contain the
  119.         Guidelines runtime files :
  120.  
  121.         MD C:\GUIDE
  122.         MD C:\GUIDE\BIN
  123.         MD C:\GUIDE\DLL
  124.         MD C:\GUIDE\DATA
  125.         MD C:\GUIDE\HELP
  126.  
  127.     2.  Copy the following Guidelines dynamic link libraries from the
  128.         C:\GUIDE\DLL directory on your development machine to C:\GUIDE\DLL
  129.         on the target machine:
  130.  
  131.         All *OI*.DLL, *OI1*.DLL, and *OI2*.DLL
  132.  
  133.         This will load up more than is necessary, but some IBM VisualAge 
  134.         objects (*OI2*) are forwarder objects for IBM Cset 2.01. The 
  135.         complexity of the setup means that fully laying it out in text 
  136.         format would be too complicated and subject to error.
  137.     
  138.    *3.  Copy the following CSS programs from C:\GUIDE\BIN on your
  139.         development machine to C:\GUIDE\BIN on your target machine :
  140.  
  141.         JCFO0000.EXE    JCHO0000.EXE    JCBO0000.EXE    JCUO0000.EXE
  142.  
  143.    *4.  Copy the following CSS data files from C:\GUIDE\DATA on your
  144.         development machine to C:\GUIDE\DATA on your target machine :
  145.  
  146.         GETCHRID.CLP    FILESYN.DAT     HOSTAPPL.DAT    CODEPAGE.DAT
  147.         HOSTLINK.DAT    APPLICAT.INI    LOCATION.DAT    JBAGTAB.DAT
  148.         USERHOST.DAT    MSG*.IDX        MSG*.DAT        RSQ*.ICO
  149.         JCFO0000.ICO    JCHO0000.ICO    JCBO0000.ICO    JCUO0000.ICO
  150.         JOT3.ICO
  151.  
  152.    *5.  Copy the following CSS help files from C:\GUIDE\HELP on your
  153.         development machine to C:\GUIDE\HELP on your target machine :
  154.  
  155.         JCFO0000.HLP    JCHO0000.HLP    JCBO0000.HLP    JCUO0000.HLP
  156.  
  157.     6.  Refer to the extra sections if SQL or Image extensions are required.
  158.  
  159.     7.  Add the following to the LIBPATH statement in CONFIG.SYS :
  160.  
  161.         C:\GUIDE\DLL
  162.  
  163.     8.  Add the following to the SET PATH statement in CONFIG.SYS :
  164.  
  165.         C:\GUIDE\BIN
  166.  
  167.     9.  Add the following to the SET DPATH statement in CONFIG.SYS :
  168.  
  169.         C:\GUIDE\HELP
  170.  
  171.     10. Add the following to the SET HELP statement in CONFIG.SYS :
  172.  
  173.         C:\GUIDE\HELP
  174.  
  175.    *11. Set the following variables in CONFIG.SYS :
  176.  
  177.         SET BINDPATH=C:\GUIDE\BIN
  178.         SET JBAFILES=C:\GUIDE\DATA
  179.         SET JBAPASSWRD=C:\GUIDE\DATA
  180.         SET CSSXLAT=C:\GUIDE\DATA\JBAGTAB.DAT
  181.         SET CSSSYN=C:\GUIDE\DATA\FILESYN.DAT
  182.         SET CSSLOC=C:\GUIDE\DATA\LOCATION.DAT
  183.  
  184.         SET CSSUSER=xxxxxxxxxx
  185.  
  186.         where xxxxxxxxxx is the user profile defined as being the local
  187.         logon userid within CSS configuration (see below).
  188.  
  189.     12. Shut down and restart the machine so that changes in CONFIG.SYS
  190.         take effect.
  191.  
  192.    *13. For ease of use, create new program objects in Workplace Shell
  193.         for the CSS utility programs that you copied earlier :
  194.  
  195.         C:\GUIDE\BIN\JCFO0000.EXE   "CSS Configuration"
  196.         C:\GUIDE\BIN\JCHO0000.EXE   "Maintain Host Applications"
  197.         C:\GUIDE\BIN\JCBO0000.EXE   "CSS Backup/Restore"
  198.         C:\GUIDE\BIN\JCUO0000.EXE   "Maintain CSS Users"
  199.         C:\GUIDE\BIN\RSQ90OXX.EXE   "SQL Configuration"
  200.         C:\GUIDE\BIN\JMCO0000.EXE   "Message Class Browser"
  201.  
  202.         You can create the new program objects by dragging and dropping a
  203.         Program template from your Templates folder, or by running the
  204.         following REXX script (copy and paste from this document and save
  205.         as a CMD file) from the command line:
  206.  
  207.         /*Script start*/
  208.         /* Script to create CSS utility program objects on the Workplace   */
  209.         /* Shell desktop on a target machine without Guidelines installed. */
  210.         /* (c) Copyright 1995 JBA Software Products.  All rights reserved. */
  211.  
  212.         call RxFuncAdd 'SysCreateObject', 'RexxUtil', 'SysCreateObject'
  213.  
  214.         if \ SysCreateObject("WPProgram","CSS Configuration","<WP_DESKTOP>",
  215.                     ,"OBJECTID=<GUIDELINES_CSS_CONFIG>;",
  216.                     ||"EXENAME=JCFO0000.EXE;",
  217.                     ||"ICONFILE=C:\GUIDE\DATA\JCFO0000.ICO",
  218.                     ,"Update")
  219.             say "CSS Configuration program object creation failed!"
  220.  
  221.         if \ SysCreateObject("WPProgram","Maintain Host Applications",
  222.                     ,"<WP_DESKTOP>",
  223.                     ,"OBJECTID=<GUIDELINES_HOST_MAINT>;",
  224.                     ||"EXENAME=JCHO0000.EXE;",
  225.                     ||"ICONFILE=C:\GUIDE\DATA\JCHO0000.ICO",
  226.                     ,"Update")
  227.             say "Host Apps program object creation failed!"
  228.  
  229.         if \ SysCreateObject("WPProgram","CSS Backup/Restore","<WP_DESKTOP>",
  230.                     ,"OBJECTID=<GUIDELINES_CSS_BACKUP>;",
  231.                     ||"EXENAME=JCBO0000.EXE;",
  232.                     ||"ICONFILE=C:\GUIDE\DATA\JCBO0000.ICO",
  233.                     ,"Update")
  234.             say "CSS Backup/Restore program object creation failed!"
  235.  
  236.         if \ SysCreateObject("WPProgram","Maintain CSS Users","<WP_DESKTOP>",
  237.                     ,"OBJECTID=<GUIDELINES_CSS_USERS>;",
  238.                     ||"EXENAME=JCUO0000.EXE;",
  239.                     ||"ICONFILE=C:\GUIDE\DATA\JCUO0000.ICO",
  240.                     ,"Update")
  241.             say "CSS Users program object creation failed!"
  242.  
  243.         if \ SysCreateObject("WPProgram","CSS Configuration","<WP_DESKTOP>",
  244.                     ,"OBJECTID=<GUIDELINES_CSS_CONFIG>;",
  245.                     ||"EXENAME=JCFO0000.EXE;",
  246.                     ||"ICONFILE=C:\GUIDE\DATA\JCFO0000.ICO",
  247.                     ,"Update")
  248.             say "CSS Configuration program object creation failed!"
  249.  
  250.         if \ SysCreateObject("WPProgram","SQL Configuration","<WP_DESKTOP>",
  251.                     ,"OBJECTID=<GUIDELINES_SQL_CONFIG>;",
  252.                     ||"EXENAME=RSQ90OXX.EXE;",
  253.                     ||"ICONFILE=C:\GUIDE\DATA\RSQ90OXX.ICO",
  254.                     ,"Update")
  255.             say "SQL Configuration program object creation failed!"
  256.  
  257.         if \ SysCreateObject("WPProgram","Message Class Browser",
  258.                     ,"<WP_DESKTOP>",
  259.                     ,"OBJECTID=<GUIDELINES_MSG_BROWSER>;",
  260.                     ||"EXENAME=JMCO0000.EXE;",
  261.                     ||"ICONFILE=C:\GUIDE\DATA\JMCO0000.ICO",
  262.                     ,"Update")
  263.             say "Message Browser program object creation failed!"
  264.  
  265.         /*Script end*/
  266.  
  267.    *14. Run the CSS Configuration program (either from File Manager or
  268.         from the icons that you have set up in Program Manager) and
  269.         maintain the local logon user ID (xxxxxxxxxx).
  270.  
  271.   You may now install and run your application.
  272.  
  273.  
  274.   ─────────────────────────────────
  275. ─ 5.0 NOTES ON GUIDELINES DESIGNER ──────────────────────────────────
  276.   ─────────────────────────────────
  277.   
  278. ══ Changes to directory structure ═════════════════════════════════════════════
  279.  
  280.     The directory structure of the Designer has changed with this release.
  281.     Users upgrading from previous versions of Guidelines should read the
  282.     installation instructions that accompany the product and also :
  283.  
  284.  1. Open the environment details dialogues for all of the compilers that
  285.     they use and modify the include and library paths to point to
  286.     \GUIDE\INCLUDE and \GUIDE\LIB respectively, instead of to \GUIDE\SYS.
  287.  
  288.  2. Modify their GUE variable in \CONFIG.SYS to include \GUIDE\GUE on its
  289.     path.
  290.  
  291.  3. Add \GUIDE\HELP to their DPATH in \CONFIG.SYS.
  292.  
  293.  4. Ensure that LIBPATH in \CONFIG.SYS includes \GUIDE\DLL and not
  294.     \GUIDE\SYS.
  295.  
  296.  
  297. ══ Changes to compiler support ════════════════════════════════════════════════
  298.  
  299.  1. This release now supports IBM VisualAge C++ 3.00.  Users installing
  300.     IBM CSet++ 2.01 will automatically load VisualAge as it is used by 
  301.     Guidelines itself. The environment paths for the two compilers must 
  302.     be separated. Follow the procedure below to set the environments correctly:  
  303.  
  304.       (1)   Bring up the Output|Environment... dialog.
  305.       (2)   Select the compiler to be used and select [Edit] then [OK].
  306.       (3)   Click on [Default] to reset to the new compiler options.
  307.       (4)   Click on [Paths] and edit the environment variables, so that they
  308.             resemble the details below.
  309.       (5)   Click on [OK].
  310.       (6)   Click on [OK].
  311.  
  312.  
  313. Sample Environment settings:
  314.  
  315.      Key Description                              Example
  316.  
  317.      <a> Drive and path for OS2                  c:\os2
  318.      <b> Drive and path for OS2 Toolkit          c:\toolkt21
  319.      <c> Drive and path for CSet 2.01            c:\ibmcpp
  320.      <d> Drive and path for Guidelines           c:\guide
  321.      <e> Drive and path for Visual Age 3.00     c:\ibmcpp30
  322.      <f> Drive and path for temp directory       c:\temp
  323.  
  324.  
  325. Environment Details for OS/2 IBM CSet++ 2.01
  326.  
  327.   COMSPEC=<a>\cmd.exe
  328.   PATH=.;<b>\os2bin;<c>\bin
  329.   DPATH=.;<b>\ipfc;<c>\locale;<c>\help;<c>\sys
  330.   INCLUDE=.;<d>\include;<b>\cplus\os2h;<c>\include;<c>\ibmclass
  331.   LIB=.;<d>\lib;<b>\os2lib;<c>\lib
  332.   IPFC=<b>\ipfc
  333.   TMP=<f>
  334.  
  335. Environment Details for OS/2 IBM VisualAge C++ 3.00
  336.  
  337.   COMSPEC=<a>\cmd.exe
  338.   PATH=.;<e>\bin
  339.   DPATH=.;<e>\locale;<e>\help;<e>\sys
  340.   INCLUDE=.;<d>\include;<e>\include;<e>\include\os2
  341.   LIB=.;<d>\lib;<e>\lib
  342.   IPFC=<e>\ipfc
  343.   TMP=<f>
  344.  
  345.   Note, if extensions have been installed in a directory <i>
  346.   which is not <d> then add
  347.   ;<i>\include
  348.   to the end of each INCLUDE environment variable and
  349.   ;<i>\Lib
  350.   to the end of each LIB environment variable.
  351.  
  352.  
  353.  2. Guidelines now attempts to link using the compiler driver wherever 
  354.     practical rather than calling the linker directly.  This means that 
  355.     some of the compiler command lines have changed.  This means that
  356.     makefiles for IBM CSet++ 2.01 and IBM VisualAge C++ 3.00 will 
  357.     now work the same way. Users of IBM CSet++ 2.01 that have upgraded
  358.     from a previous version of Guidelines should open the Environment 
  359.     Details dialog for that compiler and click on the [Default] button to
  360.     reconfigure the command lines.
  361.  
  362.  
  363. ══ Changes to using Guidelines ════════════════════════════════════════════════
  364.  
  365.  1. Multiline JOT comments are now available.  The `{*' pair will begin a
  366.     multiline comment, and the '*}' pair must occur somewhere later in the
  367.     same action module to terminate it.  The `C:' prefix for embedded C++
  368.     and the ';' single-line comment character will not be treated
  369.     specially within a multiline JOT comment.
  370.  
  371.     A second comment style, the `{**}' pairs were chosen over the C++ 
  372.     `/**/' or Modula `(**)' comment delimiters because those latter may
  373.     occur as part of legal JOT code.
  374.  
  375.  2. Warning Error in RC Compile due to FID_CLIENT
  376.         The header where FID_CLIENT is defined is part of the OS/2 
  377.         Developers' Toolkit. It appears that although the resource 
  378.         compiler is using the new C++ rules for manifest constants,
  379.         the OS/2 headers have not been updated to reflect this. To
  380.         be raised with IBM.
  381.  
  382.  3. Variable 'y1' no longer allowed after recompile on 3.2
  383.         Certain functions now include the math.h file during compilation.
  384.         'y1' is a standard global variable of this file. Standard C library 
  385.         functions such as these (and many more like 'abort', 'exit',
  386.         'rand', 'free' etc) must be avoided by developers. The full 
  387.         list of these can be found in the compiler manuals.
  388.  
  389.  4. I cannot link my IBM CSet++ 2.01 applications any more !  I get strange 
  390.     errors about files called "-Feblah.exe".
  391.         This is because linking with the IBM C++ compilers is no longer
  392.         performed by calling the linker directly.  In the environment details
  393.         dialog for IBM CSet++ 2.01 (under Output|Environment...) click on
  394.         the [Default] button, which will correct the linker command line.
  395.  
  396.  5. On OS/2 2.1x the control co-ordinates on the Designer window are not
  397.     updated dynamically as I drag and drop controls about !
  398.         This is due to the internal changes in Presentation Manager between
  399.         OS/2 2.x and OS/2 3.x.  For the technically minded, the reason is that
  400.         during a WinTrackRect call OS/2 2.x updates the 16-bit version of the
  401.         tracking structure, whereas OS/2 3.x updates the 32-bit version of the
  402.         tracking structure.  Guidelines 2.10a(65) was the last release to
  403.         support the 16-bit PM structures.  The solution is to upgrade to OS/2
  404.         3.x.
  405.  
  406.  6. Guidelines is no longer generating my LNK files !
  407.         Only DOS compilers have a 127 character command line length limit.
  408.         Guidelines now places all files and options on the command line when
  409.         linking using an OS/2 compiler, instead of generating response files.
  410.  
  411.  7. My application keeps reporting "Window not loaded" errors !
  412.         A common applications programming error is to use a property of a
  413.         window before it has been loaded (either via .Invoke() or .Load()).
  414.         The most common instance of this mistake is to set the .Parent
  415.         property of a window and then to .Load it (set the .Parent property
  416.         after loading, instead).
  417.  
  418.         Whereas previous versions of the Guidelines Runtime would only note
  419.         some accesses to properties of unloaded windows, this version will
  420.         note *all* such accesses.  So errors that went unreported before will
  421.         now be reported to you.
  422.  
  423.  
  424.   ─────────────────────────────────
  425. ─ 6.0 EXTRA INSTRUCTIONS FOR - SQL ──────────────────────────────────
  426.   ─────────────────────────────────
  427.  
  428.   To load SQL for runtime use, the CSS environment variables BINDPATH and
  429.   JBAFILES are required. See the section on CSS environment variables above.
  430.  
  431.   ───────────────────────────────────────────────
  432. ─ 7.0 EXTRA INSTRUCTIONS FOR - NEW IMAGE EXTENSION ─────────────────
  433.   ───────────────────────────────────────────────
  434.  
  435.   The following files are also required for runtime installation of the Image 
  436.    control:
  437.         FOMonOS2 FOColOS2 KIPPO* KSEO   (all .DLLs)
  438.  
  439. ____________________________________________________________________
  440. ********************************************************************
  441. ____________________________________________________________________
  442.  
  443.