home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / gbase321.zip / README.WIN < prev   
Text File  |  1995-10-19  |  17KB  |  394 lines
  1. ____________________________________________________________________
  2. ********************************************************************
  3. ____________________________________________________________________
  4.  
  5.                           Technical README for Windows
  6.  
  7.  
  8.   Welcome to Guidelines version 3.2 technical notes.
  9.  
  10.   Version               Comment
  11.   ────────────────────────────────────────────────────────────────────────
  12.   3.2   25/08/95 RAP    Created 
  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 Windows applications on OS/2 Warp.
  29.  
  30.   5.0  Running generated Windows applications on DOS + Windows.
  31.  
  32.   6.0  Development considerations for Windows applications.
  33.  
  34.   7.0  Notes on Designer (for Windows compilers)
  35.  
  36.   8.0  Extra information - SQL.
  37.  
  38.   9.0  Extra information - Image.
  39.  
  40.  10.0  Extra information - Notes.
  41.  
  42. ____________________________________________________________________
  43. ********************************************************************
  44. ____________________________________________________________________
  45.  
  46.   ──────────────────────────────────────────────────────
  47. ─ 1.0 USING GUI FILES FROM PREVIOUS GUIDELINES VERSIONS ─────────────────
  48.   ──────────────────────────────────────────────────────
  49.  
  50.   Guidelines 3.2 is able to use GUI files saved by earlier versions of
  51.   Guidelines, and will automatically convert older GUI formats to the
  52.   current format.  Unless you use new controls, functions, or features
  53.   introduced by Guidelines 3.2, you may also use GUI files saved by
  54.   Guidelines 3.2 with Guidelines releases 3.1GA and 3.1GA+PIP.
  55.  
  56.   ─────────────────────────────────────
  57. ─ 2.0 THIRD PARTY TOOLS AND GUIDELINES ──────────────────────────────────
  58.   ─────────────────────────────────────
  59.  
  60.   The Guidelines Designer is now fully compatible with the popular 4DOS
  61.   aftermarket replacement command interpreter from JP Software.
  62.   Guidelines will now properly handle the case where you have installed
  63.   4DOS as your default command interpreter for Virtual DOS Machines and
  64.   you use a DOS-based compiler such as Borland C++ 4.0 or 4.5.
  65.  
  66.   Because the batch file generated by the Guidelines Designer to run your
  67.   DOS compiler still must function with COMMAND, it is inadvisable for
  68.   4DOS users to alias standard commands such as IF, SET, PATH, and GOTO as
  69.   this may interfere with operation.
  70.  
  71.  
  72.   ──────────────────────────────────────────────────────────────────
  73. ─ 3.0 RUNNING APPLICATIONS GENERATED BY PREVIOUS GUIDELINES RELEASES ────
  74.   ──────────────────────────────────────────────────────────────────
  75.  
  76.   Existing applications will not be affected by fixes and updates to the
  77.   Guidelines Runtime libraries unless they were created to use the
  78.   dynamic versions of those libraries.  Applications that were created to
  79.   use the static versions of the runtime libraries will need to be
  80.   regenerated with Guidelines 3.2 and relinked with the latest static
  81.   runtime libraries in order to receive any benefit from this release of
  82.   Guidelines.
  83.  
  84.   Existing applications generated by Guidelines releases 2.1a(65), 3.1GA,
  85.   and 3.1GA+PIP that were created to use the dynamic versions of the
  86.   Guidelines Runtime libraries will run over the libraries provided in
  87.   Guidelines 3.2.
  88.  
  89.   Please note that you will not be able to run applications generated by
  90.   Guidelines 3.2 on top of earlier Guidelines Runtime libraries.
  91.  
  92.  
  93.   ───────────────────────────────────────────────────────
  94. ─ 4.0 RUNNING GENERATED WINDOWS APPLICATIONS ON OS/2 WARP ────────────────
  95.   ───────────────────────────────────────────────────────
  96.  
  97.   In order for Guidelines to run programs, generated with one of the
  98.   Windows compilers, from within the Designer on OS/2 Warp 3.00 (either
  99.   Warp FullPack or Warp for Windows, including the Connect versions), the
  100.   default Win-OS/2 settings must be changed.
  101.  
  102.   Under Warp, if a Windows program is run from the Designer when the
  103.   Seamless Sessions setting is enabled (from the Output|Options menu of
  104.   the Designer) and the Win-OS/2 settings are configured to not use
  105.   fastload or are configured to start Win-OS/2 in Standard Mode instead of
  106.   Enhanced Compatibility Mode, the Windows application may not start and a
  107.   SYS3175 error may occur.  To correct this, and allow Windows programs to
  108.   be run on the Warp desktop from the Designer, either
  109.  
  110.     (i)   turn off the Seamless Sessions setting in Guidelines, or
  111.  
  112.     (ii) "pre-load" an Enhanced Mode common session by running a Windows
  113.           application from the Workplace Shell desktop that has been
  114.           configured to run seamlessly on the desktop in Enhanced
  115.           Compatibility Mode (i.e. `Win-OS/2 Window' is checked in its
  116.           settings notebook, `Separate Session' is not, and WIN_RUN_MODE
  117.           in the settings dialogue is set to "3.1 Enhanced
  118.           Compatibility"), or
  119.  
  120.     (iii) ensure that an Enhanced Mode common session is fast-loaded by
  121.           opening the `Win-OS/2 Setup' notebook in your `System Setup'
  122.           folder (accessible from the Desktop popup menu), turning on
  123.           `Fastload' and `Win-OS/2 Window', and ensuring that WIN_RUN_MODE
  124.           in the settings dialogue is set to "3.1 Enhanced Compatibility".
  125.  
  126.   Guidelines generated Windows applications will then run when you select
  127.   the Run option from within Guidelines.
  128.  
  129.   ───────────────────────────────────────────────────────────
  130. ─ 5.0 RUNNING GENERATED WINDOWS APPLICATIONS ON DOS + WINDOWS ────────────
  131.   ───────────────────────────────────────────────────────────
  132.  
  133.   Running a Guidelines generated application on a DOS + Windows machine
  134.   requires you to install some of the Guidelines runtime support files on
  135.   that machine.  This can be done as follows:
  136.  
  137.  
  138. EITHER:
  139.  
  140.      Use the Installer to load the runtime objects only for the packs
  141.      used by the application. This is the easiest method, but there is
  142.      a tendency for too much detail to be loaded this way.
  143.  
  144. OR:
  145.  
  146.  
  147.   ( These instructions assume that your development machine has Guidelines
  148.     installed in C:\GUIDE and that you wish to install the Guidelines
  149.     runtime support onto drive C:  on the target machine.  The asterisks
  150.     mark steps that apply specifically to installing Client-Server Support
  151.     on the target machine which may be omitted if CSS is not required by
  152.     your application. )
  153.  
  154.     1.  Create a new directory tree on the target machine to contain the
  155.         Guidelines runtime files :
  156.  
  157.         MD C:\GUIDE
  158.         MD C:\GUIDE\BIN
  159.         MD C:\GUIDE\DLL
  160.         MD C:\GUIDE\DATA
  161.         MD C:\GUIDE\HELP
  162.  
  163.     2.  Copy the following dynamic link libraries from the C:\GUIDE\DLL
  164.         directory on your development machine to C:\GUIDE\DLL on the
  165.         target machine:
  166.  
  167.            All *WB*.DLL, *WB2*.DLL, and *WB3*.DLL. 
  168.            Also all FCL*.DLL and GCWB*.DLL for CUA controls in Windows.
  169.  
  170.         This will load up more than is necessary, but some Guidelines 
  171.         Utilities require Borland 4.5 objects even when running in a 
  172.         Borland 4.0 environment. The complexity of the setup means that
  173.         fully laying it out in text format would be too complicated and 
  174.         subject to error.
  175.  
  176.     3.  Copy the Borland C++ runtime library DLLs (BC40RTL.DLL and
  177.         BC450RTL.DLL) from your development machine to C:\WINDOWS on the
  178.         target machine.
  179.  
  180.    *4.  Copy the following CSS programs from C:\GUIDE\BIN on your
  181.         development machine to C:\GUIDE\BIN on your target machine :
  182.  
  183.         JCFW0000.EXE    JCHW0000.EXE    JCBW0000.EXE    JCUW0000.EXE
  184.         EDTGTAB.EXE
  185.  
  186.    *5.  Copy the following CSS data files from C:\GUIDE\DATA on your
  187.         development machine to C:\GUIDE\DATA on your target machine :
  188.  
  189.         GETCHRID.CLP    FILESYN.DAT     HOSTAPPL.DAT    CODEPAGE.DAT
  190.         HOSTLINK.DAT    APPLICAT.INI    LOCATION.DAT    JBAGTAB.DAT
  191.         USERHOST.DAT
  192.  
  193.    *6.  Copy the following CSS help files from C:\GUIDE\HELP on your
  194.         development machine to C:\GUIDE\HELP on your target machine :
  195.  
  196.         CSSERR.MSG      EDTGTAB.MSG     ASU01OID.MSG
  197.  
  198.     7.  Ensure that SHARE is loaded in DOS by adding the following line to
  199.         CONFIG.SYS if it is not already present (normally this will have
  200.         been done for you when you installed DOS).
  201.  
  202.         INSTALL=C:\DOS\SHARE.EXE
  203.  
  204.    *8.  Set the following variables in CONFIG.SYS (if you are using Novell
  205.         DOS 4.0 or earlier or Microsoft DOS 5.0 or earlier you may use
  206.         AUTOEXEC.BAT instead) :
  207.  
  208.         SET BINDPATH=C:\GUIDE\BIN
  209.         SET JBAFILES=C:\GUIDE\DATA
  210.         SET JBAPASSWRD=C:\GUIDE\DATA
  211.         SET CSSXLAT=C:\GUIDE\DATA\JBAGTAB.DAT
  212.         SET CSSSYN=C:\GUIDE\DATA\FILESYN.DAT
  213.         SET CSSLOC=C:\GUIDE\DATA\LOCATION.DAT
  214.  
  215.         SET CSSUSER=xxxxxxxxxx
  216.  
  217.         where xxxxxxxxxx is the user profile defined as being the local
  218.         logon userid within CSS configuration (see below).
  219.  
  220.      9. Add the following to the PATH statement in CONFIG.SYS (or
  221.         AUTOEXEC.BAT) :
  222.  
  223.         C:\GUIDE\DLL;C:\GUIDE\BIN;C:\GUIDE\HELP
  224.  
  225.     10. Reboot the machine so that the changes in AUTOEXEC.BAT and
  226.         CONFIG.SYS take effect.
  227.  
  228.    *11. For ease of use, create a new program group in Program Manager
  229.         entitled "CSS Utilities" and create icons in that group for each
  230.         of the CSS utility programs as follows :
  231.  
  232.         C:\GUIDE\BIN\JCFW0000.EXE   "CSS Configuration"
  233.         C:\GUIDE\BIN\JCHW0000.EXE   "Maintain Host Applications"
  234.         C:\GUIDE\BIN\JCBW0000.EXE   "CSS Backup/Restore"
  235.         C:\GUIDE\BIN\JCUW0000.EXE   "Maintain CSS Users"
  236.         C:\GUIDE\BIN\RSQ90WBD.EXE   "SQL Configuration"
  237.         C:\GUIDE\BIN\JMCW0000.EXE   "Message Class Browser"
  238.  
  239.    *12. Run the CSS Configuration program (either from File Manager or
  240.         from the icons that you have set up in Program Manager) and
  241.         maintain the local logon user ID (xxxxxxxxxx).
  242.  
  243.   You may now install and run your application.
  244.  
  245.   ───────────────────────────────────────────────────────
  246. ─ 6.0 DEVELOPMENT CONSIDERATIONS FOR WINDOWS APPLICATIONS ────────────────
  247.   ───────────────────────────────────────────────────────
  248.  
  249.   The manual 'Guidelines Programming for Microsoft Windows' supplied with
  250.   the Windows Code Enabler pack describes the major differences between
  251.   programming for OS/2 WARP and Microsoft Windows.
  252.  
  253. Help text
  254. ─────────
  255.  
  256.   Guidelines will generate a HPJ (Help Project File) and a RTF (the
  257.   equivalent of an .IPF file). The Help compiler uses both of these
  258.   files to create the .HLP file. Partial IPF tag interpretation is
  259.   performed. As the IPF tags are not fully parsed (they are merely scanned
  260.   for keywords) any errors in the IPF code will more than likely generate
  261.   invalid RTF code.
  262.  
  263.   The following tags are supported when Help text is compiled for Windows:-
  264.  
  265. Paragraphs       :p
  266. Hilited Phrases  :hpn
  267. Hyper-links      :link  (supports reftype hd (header) and fn (footnote))
  268. Multiple fonts   :font
  269. Multiple Colors  :color
  270. Margins          :lm (left margin) and rm: (right margin)
  271. Bitmaps          :artwork (linkfile/fit is ignored, center is runin)
  272. Other tags       .br (break) :xmp (all other tags are ignored
  273.  
  274.  
  275.   ─────────────────────────────────
  276. ─ 7.0 NOTES ON GUIDELINES DESIGNER ──────────────────────────────────
  277.   ─────────────────────────────────
  278.  
  279. ══ Changes to directory structure ═════════════════════════════════════════════
  280.  
  281.     The directory structure of the Designer has changed with this release.
  282.     Users upgrading from previous versions of Guidelines should read the
  283.     installation instructions that accompany the product and also :
  284.  
  285.  1. Open the environment details dialogues for all of the compilers that
  286.     they use and modify the include and library paths to point to
  287.     \GUIDE\INCLUDE and \GUIDE\LIB respectively, instead of to \GUIDE\SYS.
  288.  
  289.  2. Modify their GUE variable in \CONFIG.SYS to include \GUIDE\GUE on its
  290.     path.
  291.  
  292.  3. Add \GUIDE\HELP to their DPATH in \CONFIG.SYS.
  293.  
  294.  4. Ensure that LIBPATH in \CONFIG.SYS includes \GUIDE\DLL and not
  295.     \GUIDE\SYS.
  296.  
  297.  
  298. ══ Changes to compiler support ════════════════════════════════════════════════
  299.  
  300.  1. This release now supports Borland C++ 4.5 for DOS+Windows.  Users 
  301.     installing Borland C++ 4.0 will automatically load Borland 4.5 as it 
  302.     is used by Guidelines itself. The environment paths for the two 
  303.     compilers must be separated. Follow the procedure below to set 
  304.     the environments correctly:
  305.  
  306.       (1)   Bring up the Output|Environment... dialog.
  307.       (2)   Select the compiler to be used and select [Edit] then [OK].
  308.       (3)   Click on [Default] to reset to the new compiler options.
  309.       (4)   Click on [Paths] and edit the environment variables, so that they
  310.             resemble the details below.
  311.       (5)   Click on [OK].
  312.       (6)   Click on [OK].
  313.  
  314. Sample Environment settings:
  315.  
  316.      Key Description                         Example
  317.  
  318.      <d> Drive and path for Guidelines       c:\guide
  319.      <f> Drive and path for temp directory   c:\temp
  320.      <g> Drive and path for Borland 4.0      c:\bc4
  321.      <h> Drive and path for Borland 4.5      c:\bc45
  322.  
  323. Environment Details for Windows Borland C++ 4.0
  324.  
  325.   PATH=.;<g>\bin
  326.   INCLUDE=.;<d>\include;<g>\include
  327.   LIB=.;<d>\lib;<g>\lib
  328.  
  329. Environment Details for Windows Borland C++ 4.5
  330.   PATH=.;c:<h>\bin
  331.   INCLUDE=.;<d>\include;<h>\include
  332.   LIB=.;<d>\lib;c:<h>\lib
  333.  
  334.   Note, if extensions have been installed in a directory <i>
  335.   which is not <d> then add
  336.   ;<i>\include
  337.   to the end of each INCLUDE environment variable and
  338.   ;<i>\Lib
  339.   to the end of each LIB environment variable.
  340.  
  341.  
  342. ══ Changes to using Guidelines ════════════════════════════════════════════════
  343.  
  344.  1. People generating Windows applications may find several places where
  345.     behaviour that has a visual impact on their applications has been
  346.     fixed by the new Runtime.  In particular, they may find that the
  347.     Activate() and the Dismiss() methods to work in the correct manner,
  348.     that child windows can now be activated (this is a Guidelines-supplied
  349.     extension to the functionality of "raw" Windows, which does not allow
  350.     windows other than top-level windows to be activated), and that the
  351.     behaviours of non-modal and child dialogues have been corrected.
  352.  
  353.  2. Active windows function differently between Windows and Presentation
  354.     Manager. Whereas in PM all Windows between the focused window and
  355.     the desktop are active and will receive activation events (allowing dialogs
  356.     to be created in child windows and still respond correctly), in Windows,
  357.     only top-level windows may be active and will be sent activate events.
  358.  
  359.     Guidelines 3.2 now provides the superior functionality of Presentation 
  360.     Manager for Guidelines applications running on Windows. This is a change
  361.     from the previous version, where the native behaviour of both platforms
  362.     was adhered to.
  363.  
  364.  3. The Guidelines Runtime has been enhanced to use 3D input fields. This 
  365.     feature will be used on new and existing 3.1A applications as the runtime
  366.     is backwardly compatible. This function may be switched off at design time
  367.     by specifying not to use borders.
  368.  
  369.   ────────────────────────────────
  370. ─ 8.0 EXTRA INSTRUCTIONS FOR - SQL ──────────────────────────────────
  371.   ────────────────────────────────
  372.  
  373.   To load SQL for runtime use, the CSS environment variables BINDPATH and
  374.   JBAFILES are required. See the section on CSS environment variables above.
  375.  
  376.   ───────────────────────────────────────────────
  377. ─ 9.0 EXTRA INSTRUCTIONS FOR - NEW IMAGE EXTENSION ─────────────────
  378.   ───────────────────────────────────────────────
  379.  
  380.   The following files are also required for runtime installation of the 
  381.   Image control:
  382.         FOMonImg FOColImg (all .DLLs)
  383.         GGLUWB*D.DLL (prerequisite for Image)
  384.         KF-911 software engine provided with image should be installed.
  385.  
  386.   ───────────────────────────────────
  387. ─ 10.0 EXTRA INSTRUCTIONS FOR - NOTES ───────────────────────────────
  388.   ───────────────────────────────────
  389.  
  390.   Note that most of the Lotus Notes functions use handles to files 
  391.   and databases. Any handles passed as parameters MUST be valid, 
  392.   otherwise a PC lock may result. This is especially noticeable 
  393.   with closing files and databases.
  394.