


    readme.rlz (c)Copyright Sequiter Software Inc., 1990-1994.
       All rights reserved.
       ----------------------------------------------------------

                           Table of Contents

       I.    Using CodeBasic with Realizer 2.0 

               A) Files
               
               B) Syntax differences

               C) Function Aliases

       II.   Running the examples

       -----------------------------------------------------------

       I.    Using CodeBasic with Realizer 2.0


       A) Files

       The following CA-Realizer specific files are installed when
       you select this option from the install menu.


       File:                   Purpose:

       CB51A.RLZ               These two files form the equivalent of the
       CB51B.RLZ               VB support file CODEBASE.BAS. The file has
                               been split, due to its size. These files
                               should be 'run' in any application that uses
                               the CodeBasic DLL.

                               These files are installed in the \WSUPPORT
                               subdirectory.         


       BEGIN.RLZ               These files are the CA-Realizer equivalents
       USER.RLZ                of the Visual Basic projects BEGIN.MAK
       USER_RLZ                and USER.MAK, as documented in the CodeBasic
                               User's Guide. These files are installed
                               in the \WSAMPLES subdirectory.

                               Referring to these examples will 
                               provide insight into the differences
                               between using CodeBasic with Realizer
                               versus Visual Basic.


       B) Syntax differences

       The CodeBasic documentation uses Visual Basic keywords and 
       syntax throughout. When reading the documentation, the following 
       differences between Visual Basic and Realizer Basic should be 
       noted:


         Pointers
         ~~~~~~~~
            i) In certain situations, some CodeBasic function require 
               that string parameters be passed as NULL string pointers. In 
               Visual Basic this is accomplished by passing a NULL string 
               (""). In Realizer Basic, this is accomplished by passing the 
               expression 'Pointer(0)' instead. For example:
       
               VB Syntax:  ind& = i4open( db&, "" )  'Open production index

               Realizer:   ind  = i4open( db, Pointer(0))  'Same operation


               Any reference to a NULL string in the CodeBasic documentation 
               can be replaced with the Pointer() function. The one exception
               is the i4create() function. The syntax for this function 
               does not change.
      

           ii) The CodeBasic function d4createCB() and i4createCB() take a 
               pointer value as their second parameter. Again, the Pointer() 
               function must be used.

               VB Syntax:      db&  = d4createCB( cb&, FldInfo& )
                               ind& = i4createCB( db&, TagInfo& )

               Realizer:       db   = d4createCB( cb, Pointer(FldInfo))
                               int  = i4createCB( db, Pointer(TagInfo))


          iii) The CodeBasic function relate4next() takes a single parameter
               as a LONG value, which represents a MASTER4 pointer. The 
               variable you pass to relate4next() MUST be declared as LONG. 
               That is, you cannot let Realizer implicitly data type this 
               variable.

               Incorrect Example:
                       
                       Sub Test()
                       
                               relation = relate4init(dbfPtr)

                               relation = relate4next(relation)   'Causes GPF

                               ...


               Correct Example:
                       
                       Sub Test()
            
                               Dim Local relation As Long

                               relation = relate4init(dbfPtr)

                               relation = relate4next(relation)   'OK

                       ...

         Other differences
         ~~~~~~~~~~~~~~~~~
                              
               - There is No 'Call' keyword in Realizer Basic. 
               
               - There are no parenthesis used when calling a function
                 or procedure that has no parameters.
  


       C)   Function Aliases


       Realizer limits the names of functions/procedures to 16 characters.
       Because some of the CodeBasic function names are longer, they
       have been aliased to shorter names. The following table lists
       these names.
  

               Function Name                  Alias

               code4defaultUniqueError        code4defUnqErr  
               code4fieldNameError            code4fldNmeErr
               code4lockAttempts              code4lockAtt
               code4memExpandBlock            code4memExpBlk
               code4memExpandData             code4memExpData
               code4memExpandIndex            code4memExpInd
               code4memExpandTag              code4memExpTag
               code4memSizeBlock              code4memSzBlk
               code4memSizeBuffer             code4memSzBuf
               code4memSizeMemo               code4memSzMemo
               code4memSizeMemoExpr           code4memSzMemExp
               code4memSizeSortBuf            code4memSzSrtBuf
               code4memSizeSortPool           code4memSzSrtPl
               code4memStartBlock             code4memStBlk
               code4memStartData              code4memStData
               code4memStartIndex             code4memStIndex
               code4optimizeWrite             code4optWrite
               code4tagNameError              code4tagNameErr

               relate4createSlave             relate4createSlv
               relate4errorAction             relate4errAction
               relate4skipEnable              relate4skpEnable
               relate4dateFormat              relate4dateFmt
               relate4printerSelect           relate4printSel


       You can change any alias if you wish, by modifying the support
       file CB51A.RLZ, which contains the function declarations.

       ----------------------------------------------------------

       II. Running the examples

       
       As mentioned in section I, the \WSAMPLES directory contains
       the BEGIN and USER examples. These examples are documented 
       in the 'Getting Started with CodeBasic 5.1' booklet, and the 
       CodeBasic User's Guide respectively.

       - For the BEGIN example, the 5 point instructions listed on Pg 17 of 
         the Getting Started booklet apply to CA-Realizer as well, with the
         following changes:

       
          3. Copy the necessary support files to your working directory.

             For CA-Realizer, the necessary support files are CB51A.RLZ
             and CB51B.RLZ instead of CODEBASE.BAS. These files can
             be found in the \WSUPPORT subdirectory.


          5. Start Visual Basic and run BEGIN.MAK

             For CA-Realizer run BEGIN.RLZ.


       - For the USER example, load and run the file USER.RLZ. Please
         note that you do not have to modify the 'fPath' variable as
         documented on page 41 of the User's Guide. 


       ------------------------- END -----------------------------





