NOTE: ===== Using the linkable files in BROLNK.ZIP, you will be able to create a Demo Version of BroPlus 2.50 that has no feature limitations, but will time out 5 minutes after startup. After time-out, it can be restarted any number of times. Link Instructions: ================== Unzip the file BROLNK.ZIP into a working directory for linking of the libraries and .OBJ files. As of this version of BroPlus, the custom linking process has been greatly simplified. All you need to do is run BLMAKE.BAT (or, if you don't own a copy of Blinker, run RTLMAKE.BAT). Then, simply respond to the questions and prompts appearing on the screen. At the end of the process you will have created a custom Demo version of BRO.EXE according to your own specifications. You won't have to deal with the annoying details of the custom link script which was created during this process! Before starting, be sure your compile/link environment is properly set up for Clipper version 5.2. Also, you must ensure that any CA-Clipper or 3rd-party files that are required for your particular choice of RDD configuration are indeed available AND can be found by your linker. If, at the end of the linking process, your linker reports any missing files, please verify that: 1) your DOS environment variables LIB and OBJ are properly set, e.g. SET LIB=C:\CLIPPER5\LIB SET OBJ=C:\CLIPPER5\OBJ Of course, your directories may be named differently. 2) any 3rd-party .LIB and .LNK files reside in the \CLIPPER5\LIB subdirectory, or the directory where they reside is appended to the SET LIB environment variable, e.g. SET LIB=C:\CLIPPER5\LIB;C:\COMIX 3) any 3rd-party .OBJ files reside in the \CLIPPER5\OBJ subdirectory, or the directory where they reside is appended to the SET OBJ environment variable, e.g. SET OBJ=C:\CLIPPER5\OBJ;C:\SIX2\OBJ Further customization of BroPlus -------------------------------- Modification of BroPlus source code files should ONLY be necessary in these specific situations: - If you need to add your own functions in source code form to BroPlus, you may add it to the file STARTUP.PRG. - If you need to write your own startup code, e.g. for custom password verification before a user may be allowed to start BroPlus, you may do so inside the function StartUp() in STARTUP.PRG - If you are using a different swap utility than Blinker's "SwpRunCmd()", e.g. the Overlay() library, modify BROSWAP.PRG, then compile: clipper BROSWAP /m/n/a/w - If you wish to modify the default color settings for BroPlus, modify either BROCOLOR.PRG (uses high-intensity background colors) or BROCOLNB.PRG (no high-intensity background colors), then compile: clipper BROCOLOR /m/n/a/w or clipper BROCOLNB /m/n/a/w After modifying and compiling the source code, simply run BLMAKE.BAT or RTLMAKE.BAT. For a Quick Start: ================== - Create a directory on your Hard Disk ( e.g. C:\BROPLUS ) - copy BRO.EXE and the help files BROPLUS*.HLP into this directory - modify your AUTOEXEC.BAT file: - add the directory where BRO.EXE is located to your PATH statement - add the following line to your AUTOEXEC.BAT file SET BRO= where: == directory where Global Settings File BRO.INI is saved to / restored from e.g.: SET BRO=C:\BROPLUS Note that there is NO space before or after the "=" sign. - It is recommended to add the parameters SWAPPATH: and TEMPPATH: to your SET CLIPPER environment variable, where and should be a directory on your local hard disk. E.g.: SET CLIPPER=SWAPPATH:"C:\TEMP";TEMPPATH:"C:\TEMP" Virtual memory swap files, and temporary files created during indexing/sorting, will then be created in the specified directory instead in the default directory. - make sure the FILES setting in your CONFIG.SYS file is high enough - reboot your Computer - type BRO on the DOS Prompt ============================================================================= Here are some guidelines on how to use this demo: Three database files are provided: TESTNTX.DBF - has an attached DBT file (TESTNTX.DBT), an attached .DBV file (TESTNTX.DBV, to store FlexFile Data), and 3 NTX files: TESTAGE.NTX, TESTNAME.NTX, TSTSTATE.NTX. To successfully open this DBF, the DBFNTX driver must be in control. Before opening, press , select "Default Database Driver", choose "DBFNTX", select "Default Index Extension", enter ".NTX". Next, press , select "Database Selection", pick "TESTNTX.DBF". To open the index files, press , select "Index Selection", then choose any or all of the belonging .NTX files. TESTSIX.DBF - has an attached FPT file (TESTSIX.FPT), and 3 Index files: TESTSIX.CDX (structural, compound index), TSTSTATE.IDX (non-compound index), and TSTRYO.IDX ("Roll Your Own" Index). To successfully open this DBF, the SIXCDX driver must be in control. Before opening, press , select "Default Database Driver", choose "SIXCDX", select "Default Index Extension", enter ".IDX". Next, press , select "Database Selection", and pick "TESTSIX.DBF". The structural index is automatically opened with the database. To select a specific tag within the structural index, press , select "Tag information/selection", then select any of the tags in the list. To open any of the .IDX index files, press , select "Index Selection". then choose any or both of the available .IDX files. STATES.DBF - has no attached Memo file, and can therefore be opened either under "DBFNTX", or under "SIXCDX". Depending on the controlling driver, either open STATES.NTX or STATES.IDX as index for this DBF. Restoring a view from a predefined View file: To restore a view, either type from the DOS command line: BRO /V or, from the Bro+ interface, press , then select "Restore View" and pick one of the offerings. Four view files are included with this demo: NTXRELAT.BRO and SIXRELAT.BRO both demonstrate the relational paradigm in a Split screen format. The child database (TESTNTX.DBF or TESTSIX.DBF) will move in sync with movement of the record pointer in the parent database (STATES.DBF), and show only child records that match the current parent key. MIXRDD.BRO also uses the split screen format, to show in one window TESTNTX.DBF (under DBFNTX control), in the other window TESTSIX.DBF (under SIXCDX control). SIXRYO.BRO shows how a database (TESTSIX.DBF) can be open in two areas at a time, by using a different Alias name for each area. The primary area in the upper window is under control of the full index, the secondary area has the "Roll Your Own" index open. To add a key from the primary index to the RYO index, press from the desired record, and watch the record being added to the Browse screen in the RYO area. To drop a key from the RYO index, press to select the RYO area, and press on the key to be dropped. You can navigate through the Menu system, to explore and modify the settings for these views, or you can create your own views by pressing and selecting "Save current View". At any time you may press to read Context sensitive Help. As you get more familiar with BroPlus, you may start using Hot-keys instead of going through the Menu system. Let me repeat: This demo let's you do everything that the production version allows. You may create or modify databases, create indexes, add tags to or delete tags from a CDX, etc. It is only limited by a time-out after 5 minutes. For more information, read BROGUIDE.TXT ============================================================================= You can contact us on CompuServe or by phone: U.S.A. SmartCode Programming phone 818-710-9323 22323-6 Sherman Way fax 818-710-9391 Suite 185 BBS 818-986-5781 West Hills, CA 91303 CIS 73760,1102 BroPlus is available in Europe through 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커 � Adress: Tel.:+49-40-7661290 � � SOFTSOL GmbH Fax :+49-40-7665664 � � Neue Str.35a BBS :+49-40-7665527 � � 21073 Hamburg CIS : 100112,3401 � � Germany Fido: 2:240/5300 � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸 =============================================================================