home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a063 / 6.img / SAMPLE / APTFORMS / README < prev    next >
Encoding:
Text File  |  1991-04-15  |  7.0 KB  |  216 lines
  1. This directory contains the source files for the 3GL APT-Library example 
  2. programs, documented in the APT-Library Reference Supplement for your
  3. APT application development platform.
  4.  
  5.  
  6. There are two example programs:
  7.  
  8.    1. The Sales Application.  This example provides an
  9.       introduction to APT-Library programming.  It 
  10.       illustrates a number of APT-Library routines and 
  11.       includes two forms and thirteen external procedures.
  12.     
  13.    2. The Fssql Demo.  This example illustrates the 
  14.       capabilities of the fssql routine.  
  15.  
  16.  
  17. After installing the APT-Execute software, follow the basic steps listed
  18. below to use each of these examples.
  19.  
  20.  
  21.  
  22. THE SALES APPLICATION
  23.  
  24.  
  25. A. Source Files
  26.  
  27.    The Sales Application uses the following source files:
  28.  
  29.        C code:
  30.            aforms.h
  31.            se_main.c
  32.            adisc.c
  33.            clcst.c
  34.            clrfd.c
  35.            errhndlr.c
  36.            dscin.c
  37.            gthdr.c
  38.            strin.c
  39.            titin.c
  40.            inval.c
  41.            msghndlr.c
  42.            print.c
  43.            rgdsc.c
  44.  
  45.        Form definition files:
  46.            sdsc_3.frm
  47.            sntr_3.frm
  48.  
  49.        Batch file:
  50.            makesale.bat
  51.  
  52.        Response file:
  53.            sales.lnk
  54.  
  55.  
  56. B. Building the Sales Application Executable
  57.  
  58.    To build the "sales" executable, you must have Microsoft C compiler
  59.    version 6.0 and DOS/16M (from Rational Systems, Inc.) installed on your
  60.    PC.  The INCLUDE environment variable must be set to include the
  61.    "include" directory provided with your compiler.  The LIB environment
  62.    variable must be set to include the "lib" directory provided with your
  63.    compiler.  The paths to the Microsoft compiler, the Microsoft linker, and
  64.    the Rational utilities must be on your PATH environment variable.
  65.  
  66.    The following files MUST also be copied into the sample\aptforms
  67.    directory:
  68.        msc60l.lib (from Rational),
  69.        int10.exp (from Rational),
  70.        mouse33.exp (from Rational),
  71.        emineti.exp (a part of the SYBASE Net-Library product), and
  72.        loader.exe (from Rational).
  73.  
  74.    The batch file, makesale.bat, compiles and links the "sales" 
  75.    executable.  It uses the Microsoft compiler and linker, the response
  76.    file, sales.lnk, and DOS/16M's makepm and splice to create a
  77.    protected mode executable.
  78.  
  79.    To make an executable, enter:
  80.        makesale 
  81.  
  82.    This creates an executable called "sales.exe".
  83.  
  84.  
  85. C. Running the Sales Application Executable
  86.  
  87.    Before running the executable, make sure the following are true:
  88.  
  89.        1. The Net-Library software necessary for APT-Execute has been
  90.           configured correctly and is loaded.
  91.  
  92.           Use the dbping utility program shipped with Net-Library
  93.           to verify that your network and Net-Library software is
  94.           able to connect your PC to SQL Server.
  95.  
  96.        2. You have a SQL Server login and the "pubs" database has 
  97.           been installed on SQL Server. 
  98.  
  99.           If you have a DB-Library product with the isql utility installed 
  100.           on your PC, you can verify this yourself.  Otherwise, your 
  101.           SQL Server system administrator can verify this for you. 
  102.  
  103.        3. Your SYBASE environment variable is set to the
  104.           drive and directory path for the SYBASE home directory.
  105.           Use the "set" command without arguments to display the 
  106.           current settings of all your environment variables:
  107.                set
  108.  
  109.           If the SYBASE environment variable is not set, set it
  110.           appropriately.  For example: 
  111.                set SYBASE=C:\sql
  112.  
  113.        4. Your SYBFORMLIST environment variable includes your
  114.           sample\aptforms directory.
  115.  
  116.           If the SYBFORMLIST environment variable is not set correctly, set
  117.           it appropriately.  For example: 
  118.                set SYBFORMLIST=<SYBASE>\sample\aptforms
  119.  
  120.           Where <SYBASE> is the value of your SYBASE environment variable.
  121.  
  122.    To run the Sales Application, enter:
  123.                sales
  124.     
  125.     
  126.  
  127. THE FSSQL DEMO
  128.  
  129.  
  130. A. Source Files
  131.  
  132.    The Fssql Demo uses the following source files:
  133.  
  134.        C code:
  135.            aforms.h
  136.            fssql_d.c
  137.         
  138.        Form definition file:
  139.            basic_1.frm
  140.  
  141.        Batch file:
  142.            makedemo.bat
  143.  
  144.        Response file:
  145.            demo.lnk
  146.  
  147.  
  148. B. Building the Fssql Demo Executable
  149.  
  150.    To build the "demo" executable, you must have Microsoft C compiler
  151.    version 6.0 and DOS/16M (from Rational Systems, Inc.) installed on your
  152.    PC.  The INCLUDE environment variable must be set to include the
  153.    "include" directory provided with your compiler.  The LIB environment
  154.    variable must be set to include the "lib" directory provided with your
  155.    compiler.  The paths to the Microsoft compiler, the Microsoft linker, and
  156.    the Rational utilities must be on your PATH environment variable.
  157.  
  158.    The following files MUST also be copied into the sample\aptforms
  159.    directory:
  160.        msc60l.lib (from Rational),
  161.        int10.exp (from Rational),
  162.        mouse33.exp (from Rational),
  163.        emineti.exp (a part of the SYBASE Net-Library product), and
  164.        loader.exe (from Rational).
  165.  
  166.    The batch file, makedemo.bat, compiles and links the "demo" 
  167.    executable.  It uses the Microsoft compiler and linker, the response
  168.    file, demo.lnk, and DOS/16M's makepm and splice to create a
  169.    protected mode executable.
  170.  
  171.    To make an executable, enter:
  172.        makedemo 
  173.  
  174.    This creates an executable called "demo.exe".
  175.  
  176.  
  177. C. Running the Fssql Demo Executable
  178.  
  179.    Before running the executable, make sure the following are true:
  180.  
  181.        1. The Net-Library software necessary for APT-Execute has been
  182.           configured correctly and is loaded.
  183.  
  184.           Use the dbping utility program shipped with Net-Library
  185.           to verify that your network and Net-Library software is
  186.           able to connect your PC to SQL Server.
  187.  
  188.        2. You have a SQL Server login and the "pubs" database has 
  189.           been installed on SQL Server. 
  190.  
  191.           If you have a DB-Library product with the isql utility installed 
  192.           on your PC, you can verify this yourself.  Otherwise, your 
  193.           SQL Server system administrator can verify this for you. 
  194.  
  195.        3. Your SYBASE environment variable is set to the
  196.           drive and directory path for the SYBASE home directory.
  197.           Use the "set" command without arguments to display the 
  198.           current settings of all your environment variables:
  199.                set
  200.  
  201.           If the SYBASE environment variable is not set, set it
  202.           appropriately.  For example: 
  203.                set SYBASE=C:\sql
  204.  
  205.        4. Your SYBFORMLIST environment variable includes your
  206.           sample\aptforms directory.
  207.  
  208.           If the SYBFORMLIST environment variable is not set correctly, set
  209.           it appropriately.  For example: 
  210.                set SYBFORMLIST=<SYBASE>\sample\aptforms
  211.  
  212.           Where <SYBASE> is the value of your SYBASE environment variable.
  213.  
  214.    To run the Fssql Demo, enter:
  215.                demo
  216.