home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / smxbs100.zip / SOMXBASE.INF (.txt) < prev    next >
OS/2 Help File  |  1995-09-25  |  26KB  |  1,091 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. SOMXBASE -  Object-Oriented Access to dBase Databases. ΓòÉΓòÉΓòÉ
  3.  
  4. Version 1.00 SOMXBase is a dBase database engine for programmers interested in 
  5. using SOM. 
  6.  
  7. SOM - System Object Module is a object-oriented programming interface that 
  8. remains language neutral. For more information on SOM please review IBM 
  9. documentation and other user guides. 
  10.  
  11. By providing a language neutral interface, SOMXBase allows any language that is 
  12. SOM aware to access dBase files. 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 1.1. American Coders Ltd. ΓòÉΓòÉΓòÉ
  16.  
  17. American Coders, LTD. 
  18.  
  19. Post Office Box 97462 
  20.  
  21. Raleigh, NC   27624 
  22.  
  23. (919); 846-2014 
  24.  
  25. Compuserve ID: 74150,2370 
  26.  
  27. Internet ID: joe@usacoder.rtp.nc.us. 
  28.  
  29. Copyright 1995 American Coders LTD Raleigh NC USA 
  30.  
  31. Programming Solutions For Your Business 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 1.2. How To Register Your Copy ΓòÉΓòÉΓòÉ
  35.  
  36. We have several methods for you to register your copy of SOMXBase. 
  37.  
  38. o Registration Form. 
  39.  
  40. The cost for registering SOMXBase is $95.00.At this time, the program is 
  41. limited in functionality so the price may seem high. But we will grant early 
  42. registers of the product an extension on the number of updates and not just 
  43. fixes. 
  44.  
  45. If registed before Jan.31, 1996 a registered user will receive updates 
  46. throughout 1996. 
  47.  
  48. There is also a shipping and handling charge. For U.S.and Canada registrations 
  49. it is $10.00, all other international orders $15.00. 
  50.  
  51. If you are planning to order ten (10); or more copies use the SITELICE.DOC in 
  52. your package. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 1.2.1. Registration Form. ΓòÉΓòÉΓòÉ
  56.  
  57. Print out the file REGISTER.FRM. Attach a check and mail to us using the 
  58. address on the form (or see above);. 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 1.3. Version Changes. ΓòÉΓòÉΓòÉ
  62.  
  63. Version 1.00 Sept 30,1995. 
  64.  
  65. Initial release. 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 2. What Is SOMXBase & What It Isn't ΓòÉΓòÉΓòÉ
  69.  
  70. SOMXBase is a programmer's tool to access dBase III and IV files. It provides a 
  71. object-oriented interface to DBF, MDX and DBT files. 
  72.  
  73. By providing a class object, known as xdbf, a program is provided a simple API 
  74. to read, write, and update the database. 
  75.  
  76. Using an object-oriented tool, we will be able to enhance and extend the 
  77. functionality of SOMXBase through the use of such features as Inheritance and 
  78. Polymorhphism. And by encapsulating the data and methods of SOMXBase we can 
  79. provide an upwardly compatible interface without comprimising future 
  80. development. 
  81.  
  82. There is one exception to the above statement. In the future we may introduce a 
  83. new class for database fields. With this in mind, it may be necessary to alter 
  84. some of these datatypes. 
  85.  
  86. Though SOMXBase is an object-oriented programming tool, the database is not and 
  87. should not be considered object-oriented. Though, hopefully, over the life of 
  88. this project we will be able to allow these types of database to become 
  89. object-oriented-like. 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 2.1. Requirements. ΓòÉΓòÉΓòÉ
  93.  
  94. The following is a brief discussion of what is needed to develop with SOMXBase. 
  95.  
  96. An operating system environment. 
  97.           OS/2 Version 2.x and Warp. 
  98. A SOM Enabled Compiler 
  99.           At this time, SOMXBase has been tested with IBM C/Set++. 
  100. A Requirement To Develop An Object-Oriented Application. 
  101.           Sorry, we can't help you there. 
  102.  
  103.  
  104. ΓòÉΓòÉΓòÉ 3. Included Code. ΓòÉΓòÉΓòÉ
  105.  
  106. Along with the SOMXBASE.DLL there are several other files that you will need to 
  107. compile a client program. At this time only c-language based files are 
  108. included. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 3.1. Public INCLUDE File To Access xdbf Class. ΓòÉΓòÉΓòÉ
  112.  
  113. The following is a copy of the somxbase.h file. 
  114.  
  115. /*
  116.  * This file was generated by the SOM Compiler.
  117.  * FileName: somxbase.h.
  118.  * Generated using:
  119.  *     SOM Precompiler spc: 1.22
  120.  *     SOM Emitter emith: 1.11
  121.  */
  122.  
  123. /*
  124.  *    somxbase.csc
  125.  *
  126.  *    a class defining a set of objects (somxbases)
  127.  */
  128.  
  129.  
  130. #ifndef somxbase_h
  131. #define somxbase_h
  132.  
  133.  
  134. #include <som.h>
  135.  
  136. /*
  137.  * Define the class name as an object type
  138.  */
  139. #ifndef xdbf
  140. #define xdbf SOMAny
  141. #endif
  142. #include <somobj.h>
  143.  
  144. #define xdbf_MajorVersion 0
  145. #define xdbf_MinorVersion 0
  146.  
  147. /*
  148.  * External name shortening if required
  149.  */
  150. #ifdef SOM_USE_SHORT_EXTERNAL_NAMES
  151. #define xdbfNewClass c
  152. #pragma linkage(c, system)
  153. #define xdbfClassData d
  154. #define xdbfCClassData x
  155. #endif /* SOM_USE_SHORT_EXTERNAL_NAMES */
  156. /*--------------Migration------------*/
  157. #define xdbf_classObj xdbfClassData.classObject
  158. #define _xdbf xdbf_classObj
  159.  
  160. /*
  161.  * New and Renew macros for xdbf
  162.  */
  163. #define _xdbfNew() (_somNew(xdbfClassData.classObject))
  164. #define xdbfNew() \
  165.      ( xdbfClassData.classObject \
  166.           ? _xdbfNew() \
  167.           : ( xdbfNewClass(xdbf_MajorVersion, xdbf_MinorVersion), _xdbfNew() ) )
  168. #define xdbfRenew(buf) \
  169.      ( _somRenew(xdbfClassData.classObject, buf) )
  170.  
  171. /*
  172.  * New Method: open
  173.  */
  174. typedef short    SOMLINK somTP_xdbf_open(xdbf *somSelf,
  175.           char *dbfname);
  176. #pragma linkage(somTP_xdbf_open, system)
  177. typedef somTP_xdbf_open *somTD_xdbf_open;
  178. #define somMD_xdbf_open "----"
  179. #define xdbf_open(somSelf,dbfname) \
  180.     (SOM_Resolve(somSelf, xdbf, open) \
  181.      (somSelf,dbfname))
  182. #define _open xdbf_open
  183.  
  184. /*
  185.  * New Method: read
  186.  */
  187. typedef short    SOMLINK somTP_xdbf_read(xdbf *somSelf);
  188. #pragma linkage(somTP_xdbf_read, system)
  189. typedef somTP_xdbf_read *somTD_xdbf_read;
  190. #define somMD_xdbf_read "----"
  191. #define xdbf_read(somSelf) \
  192.     (SOM_Resolve(somSelf, xdbf, read) \
  193.      (somSelf))
  194. #define _read xdbf_read
  195.  
  196. /*
  197.  * New Method: write
  198.  */
  199. typedef short    SOMLINK somTP_xdbf_write(xdbf *somSelf);
  200. #pragma linkage(somTP_xdbf_write, system)
  201. typedef somTP_xdbf_write *somTD_xdbf_write;
  202. #define somMD_xdbf_write "----"
  203. #define xdbf_write(somSelf) \
  204.     (SOM_Resolve(somSelf, xdbf, write) \
  205.      (somSelf))
  206. #define _write xdbf_write
  207.  
  208. /*
  209.  * New Method: go_to
  210.  */
  211. typedef short    SOMLINK somTP_xdbf_go_to(xdbf *somSelf,
  212.           int recno);
  213. #pragma linkage(somTP_xdbf_go_to, system)
  214. typedef somTP_xdbf_go_to *somTD_xdbf_go_to;
  215. #define somMD_xdbf_go_to "----"
  216. #define xdbf_go_to(somSelf,recno) \
  217.     (SOM_Resolve(somSelf, xdbf, go_to) \
  218.      (somSelf,recno))
  219. #define _go_to xdbf_go_to
  220.  
  221. /*
  222.  * New Method: update
  223.  */
  224. typedef short    SOMLINK somTP_xdbf_update(xdbf *somSelf);
  225. #pragma linkage(somTP_xdbf_update, system)
  226. typedef somTP_xdbf_update *somTD_xdbf_update;
  227. #define somMD_xdbf_update "----"
  228. #define xdbf_update(somSelf) \
  229.     (SOM_Resolve(somSelf, xdbf, update) \
  230.      (somSelf))
  231. #define _update xdbf_update
  232.  
  233. /*
  234.  * New Method: close
  235.  */
  236. typedef short    SOMLINK somTP_xdbf_close(xdbf *somSelf);
  237. #pragma linkage(somTP_xdbf_close, system)
  238. typedef somTP_xdbf_close *somTD_xdbf_close;
  239. #define somMD_xdbf_close "----"
  240. #define xdbf_close(somSelf) \
  241.     (SOM_Resolve(somSelf, xdbf, close) \
  242.      (somSelf))
  243. #define _close xdbf_close
  244.  
  245. /*
  246.  * New Method: getfld
  247.  */
  248. typedef short    SOMLINK somTP_xdbf_getfld(xdbf *somSelf,
  249.           char *fldname,
  250.           char *flddata);
  251. #pragma linkage(somTP_xdbf_getfld, system)
  252. typedef somTP_xdbf_getfld *somTD_xdbf_getfld;
  253. #define somMD_xdbf_getfld "----"
  254. #define xdbf_getfld(somSelf,fldname,flddata) \
  255.     (SOM_Resolve(somSelf, xdbf, getfld) \
  256.      (somSelf,fldname,flddata))
  257. #define _getfld xdbf_getfld
  258.  
  259. /*
  260.  * New Method: setfld
  261.  */
  262. typedef short    SOMLINK somTP_xdbf_setfld(xdbf *somSelf,
  263.           char *fldname,
  264.           char *flddata);
  265. #pragma linkage(somTP_xdbf_setfld, system)
  266. typedef somTP_xdbf_setfld *somTD_xdbf_setfld;
  267. #define somMD_xdbf_setfld "----"
  268. #define xdbf_setfld(somSelf,fldname,flddata) \
  269.     (SOM_Resolve(somSelf, xdbf, setfld) \
  270.      (somSelf,fldname,flddata))
  271. #define _setfld xdbf_setfld
  272.  
  273. /*
  274.  * New Method: whaterror
  275.  */
  276. typedef char *   SOMLINK somTP_xdbf_whaterror(xdbf *somSelf);
  277. #pragma linkage(somTP_xdbf_whaterror, system)
  278. typedef somTP_xdbf_whaterror *somTD_xdbf_whaterror;
  279. #define somMD_xdbf_whaterror "----"
  280. #define xdbf_whaterror(somSelf) \
  281.     (SOM_Resolve(somSelf, xdbf, whaterror) \
  282.      (somSelf))
  283. #define _whaterror xdbf_whaterror
  284.  
  285. /*
  286.  * Declare the class creation procedure
  287.  */
  288. SOMEXTERN SOMAny * SOMLINK xdbfNewClass(integer4 scemajorVersion,
  289.           integer4 sceminorVersion);
  290. #pragma linkage(xdbfNewClass, system)
  291.  
  292. /*
  293.  * Declare the class data structure
  294.  */
  295. SOMEXTERN struct xdbfClassDataStructure {
  296.      SOMAny *classObject;
  297.      somMToken open;
  298.      somMToken read;
  299.      somMToken write;
  300.      somMToken go_to;
  301.      somMToken update;
  302.      somMToken close;
  303.      somMToken getfld;
  304.      somMToken setfld;
  305.      somDToken file;
  306.      somDToken error;
  307.      somMToken whaterror;
  308. } xdbfClassData;
  309.  
  310. /*
  311.  * Declare the C specific class data structure
  312.  */
  313. SOMEXTERN struct xdbfCClassDataStructure {
  314.      somMethodTab *parentMtab;
  315.      somDToken instanceDataToken;
  316. } xdbfCClassData;
  317.  
  318. #endif       /* somxbase_h */
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 3.2. Language-Neutral  Form. ΓòÉΓòÉΓòÉ
  322.  
  323. IBM recommends that this file be published to users of the class. 
  324.  
  325. # This file was generated by the SOM Compiler.
  326. # FileName: somxbase.sc.
  327. # Generated using:
  328. #     SOM Precompiler spc: 1.22
  329. #     SOM Emitter emitcsc: 1.10
  330.  
  331. --    somxbase.csc
  332. --
  333. --    a class defining a set of objects (somxbases)
  334.  
  335. #include <somobj.sc>
  336.  
  337. class: xdbf,
  338.     file stem = somxbase;
  339.  
  340.  
  341. parent class: SOMObject;
  342.  
  343.  
  344. release order:
  345.     open, read, write,
  346.     go_to, update, close,
  347.     getfld, setfld, file,
  348.     error, whaterror;
  349.  
  350. methods:
  351.  
  352.  
  353.     --  group: access_methods
  354.  
  355.     short    open(char *dbfname);
  356.  
  357.     short    read();
  358.  
  359.     short    write();
  360.  
  361.     short    go_to(int recno);
  362.  
  363.     short    update();
  364.  
  365.     short    close();
  366.  
  367.     short    getfld(char *fldname,
  368.           char *flddata);
  369.  
  370.     short    setfld(char *fldname,
  371.           char *flddata);
  372.  
  373.     char *   whaterror();
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ 3.3. Sample Make File ΓòÉΓòÉΓòÉ
  377.  
  378. This is a sample make file that can be used with NMAKE. 
  379.  
  380.  
  381. # Created by IBM WorkFrame/2 MakeMake at 05:01:26 on 09/21/95
  382. #
  383. # This makefile should be run in the following directory:
  384. #   d:\somxbase
  385. #
  386. # The actions included in this makefile are:
  387. #   COMPILE::C Set ++ Compile
  388. #   LINK::Link
  389.  
  390. .all: \
  391.   .\sample.EXE
  392.  
  393. .SUFFIXES: .c
  394.  
  395. .c.obj:
  396.       icc.exe /Ss /Q /Ti /G4 /C %s
  397.  
  398. .\sample.EXE: \
  399.     .\sample.obj \
  400.     {$(LIB)}somxbase.lib \
  401.     {$(LIB)}som.lib \
  402.     sample.mak
  403.       link386.exe @<<
  404.          /PM:VIO /DE /NOI /NOLOGO +
  405.         .\sample.obj
  406.         sample.EXE
  407.  
  408.         somxbase +
  409.         som
  410.         ;
  411. <<
  412.  
  413. .\sample.obj: \
  414.     d:\somxbase\sample.c \
  415.     {d:\somxbase;$(INCLUDE);}somxbase.h \
  416.     sample.mak
  417.  
  418.  
  419. ΓòÉΓòÉΓòÉ 4. The Class Interface ΓòÉΓòÉΓòÉ
  420.  
  421. In SOM, an application program that defines and uses a SOM class is a Client 
  422. program. 
  423.  
  424. Like all SOM enabled objects SOMXBase provides you with a class to build your 
  425. objects on. The class, xdbf, is used to define your database object.This object 
  426. is defined in the C include file "somxbase.h" which is included with your 
  427. package. You define the database class as a pointer to the class xdbf. This 
  428. pointer is known as  an "Instance" of the class. 
  429.  
  430. Also SOMXBase provides the functions, or in SOM-speak,  methods,  to access a 
  431. database. Methods are referenced in your program by prefixing the method name 
  432. with the underscore '_' character. Most methods require one parameter, usually 
  433. the defined class object. 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ 4.1. Defining A Pointer To The Class Instance ΓòÉΓòÉΓòÉ
  437.  
  438. Description. 
  439.  
  440. Defines an addres placeholder for the class instance. 
  441.  
  442. Purpose. 
  443.  
  444. The program needs to be able to address the instance to be processed by the 
  445. class methods. 
  446.  
  447. Format. using the C format 
  448.  
  449. It's rather simple: 
  450.  
  451.    #include "somxbase.h"
  452.    int main();
  453.        { xdbf  *database; ...
  454.  
  455. In the above example we have defined a class instance known as database. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 4.2. Creating An Instance of a Database Object ΓòÉΓòÉΓòÉ
  459.  
  460. Description. 
  461.  
  462. Assigns an addres to the class instance. Purpose. 
  463.  
  464. The program completes the addressability to the instance . 
  465.  
  466. Format. 
  467.  
  468. name = _xdbfNew(); 
  469.  
  470. Parameters. 
  471.  
  472. N/A 
  473.  
  474. Return Value in name  Description 
  475.  
  476. NULL 
  477.           SOM error 
  478.  
  479. some address 
  480.           normal 
  481.  
  482. An example: 
  483.  
  484.    #include "somxbase.h"
  485.    int main();
  486.        { xdbf  *database;
  487.          database = xdbfNew();...
  488.  
  489.  
  490. ΓòÉΓòÉΓòÉ 4.3. _open ΓòÉΓòÉΓòÉ
  491.  
  492. Description. 
  493.  
  494. Prior to processing a database file, the file must be opened. When your 
  495. procedure opens the database file several activities occur. 
  496.  
  497. o The database file is opened. 
  498. o MDX files, if dBase IV format dbf,  are opened. 
  499.  
  500. Purpose. 
  501.  
  502. To open the database for processing. 
  503.  
  504. Format. 
  505.  
  506. _open(instance, dbfname); 
  507.  
  508. Parameters. 
  509.  
  510. instance 
  511.           The pointer to the instance of the class object. 
  512. dbfname 
  513.           The name of your database as it is known to the operating system. 
  514.  
  515. Return Value  Description 
  516.  
  517. 0 
  518.           Normal 
  519.  
  520. 1 
  521.           Failure 
  522.  
  523. The following example opens the machines database. 
  524.  
  525.    #include "somxbase.h"
  526.    int main();
  527.        { xdbf  *database;
  528.          int rc;
  529.          database = xdbfNew();
  530.          rc = _open(database, "x:\machines.dbf");
  531.          if (rc); {
  532.              printf("Something not right\n");
  533.              exit;
  534.            }...
  535.  
  536.  
  537. ΓòÉΓòÉΓòÉ 4.4. _read ΓòÉΓòÉΓòÉ
  538.  
  539. Description. 
  540.  
  541. To read data from the database. 
  542.  
  543. Purpose. 
  544.  
  545. This method will read a record from the database.  Your program will need to 
  546. use the _getfld method to processes the data. 
  547.  
  548. Format. 
  549.  
  550. _read(instance); 
  551.  
  552. Parameters. 
  553.  
  554. instance 
  555.           The pointer to the instance of the class object. 
  556.  
  557. Return Value  Description 
  558.  
  559. 0 
  560.           Normal 
  561.  
  562. 1 
  563.           Failure 
  564.  
  565.    int main();
  566.        { xdbf  *database;
  567.          int rc;
  568.          database = xdbfNew();
  569.          rc = _open(database, "x:\machines.dbf");
  570.          if (rc); {
  571.              printf("Something not right\n");
  572.              exit;
  573.            }
  574.          rc = _read(database);
  575.          if (rc); {
  576.              printf("Something not right\n");
  577.              exit;
  578.            }...
  579.  
  580.            }...
  581.  
  582.  
  583. ΓòÉΓòÉΓòÉ 4.5. _getfld ΓòÉΓòÉΓòÉ
  584.  
  585. Description. 
  586.  
  587. Load the contents of a database field into memory. 
  588.  
  589. Purpose. 
  590.  
  591. To make the  data available to your program. 
  592.  
  593. Format. 
  594.  
  595. _getfld(instance, name, data); 
  596.  
  597. Parameters. 
  598.  
  599. instance 
  600.           The pointer to the instance of the class object. 
  601. name 
  602.           The name of the field in the database. 
  603. data 
  604.           Some character pointer. 
  605.  
  606. Return Value  Description 
  607.  
  608. 0 
  609.           Normal 
  610.  
  611. 1 
  612.           Failure 
  613.  
  614. The following example shows how data is assign to a database. 
  615.  
  616.    #include "somxbase.h"
  617.    int main();
  618.        { xdbf  *database;
  619.          int rc;
  620.          char *name, *location;
  621.          database = xdbfNew();
  622.          rc = _open(database, "x:\machines.dbf");
  623.          if (rc); {
  624.              printf("Something not right\n");
  625.              exit;
  626.            }
  627.          rc = _read(database);
  628.          if (rc); {
  629.              printf("Something not right\n");
  630.              exit;
  631.            }...
  632.          rc = _getfld(database, "Name", name);
  633.          if (rc); {
  634.              printf("Something not right\n");
  635.              exit;
  636.            }
  637.          rc = _getfld(database, "Location", location);
  638.          if (rc); {...
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ 4.6. _setfld ΓòÉΓòÉΓòÉ
  642.  
  643. Description. 
  644.  
  645. Sets the contents of a database field. 
  646.  
  647. Purpose. 
  648.  
  649. To prepare data for the database. 
  650.  
  651. Format. 
  652.  
  653. _setfld(instance, name, data); 
  654.  
  655. Parameters. 
  656.  
  657. instance 
  658.           The pointer to the instance of the class object. 
  659. name 
  660.           The name of the field in the  database to receive the data. 
  661. data 
  662.           Some character string. 
  663.  
  664. Return Value  Description 
  665.  
  666. 0 
  667.           Normal 
  668.  
  669. 1 
  670.           Failure 
  671.  
  672. The following example shows how data is assign to a database. 
  673.  
  674.    #include "somxbase."h
  675.    int main();
  676.        { xdbf  *database;
  677.          int rc;
  678.          database = xdbfNew();
  679.          rc = _open(database, "x:\machines.dbf");
  680.          if (rc); {
  681.              printf("Something not right\n");
  682.              exit;
  683.            }
  684.          rc = _setfld(database, "Name", "Springer");
  685.          if (rc); {
  686.              printf("Something not right\n");
  687.              exit;
  688.            }
  689.          rc = _setfld(database, "Location", "Building 6 Room A");
  690.          if (rc); {...
  691.  
  692.  
  693. ΓòÉΓòÉΓòÉ 4.7. _write ΓòÉΓòÉΓòÉ
  694.  
  695. Description. 
  696.  
  697. To place data into the database. 
  698.  
  699. Purpose. 
  700.  
  701. The  _write method physically commits the data to the database.  The data is 
  702. appended to the file. 
  703.  
  704. Format. 
  705.  
  706. _write(instance); 
  707.  
  708. Parameters. 
  709.  
  710. instance 
  711.           The pointer to the instance of the class object. 
  712.  
  713. Return Value  Description 
  714.  
  715. 0 
  716.           Normal 
  717.  
  718. 1 
  719.           Failure 
  720.  
  721.    int main();
  722.        { xdbf  *database;
  723.          int rc;
  724.          database = xdbfNew();
  725.          rc = _open(database, "x:\machines.dbf");
  726.          if (rc); {
  727.              printf("Something not right\n");
  728.              exit;
  729.            }
  730.          rc = _setfld(database, "Name", "Springer");
  731.          if (rc); {
  732.              printf("Something not right\n");
  733.              exit;
  734.            }
  735.          rc = _setfld(database, "Location", "Building 6 Room A");
  736.          if (rc); {
  737.              printf("Something not right\n");
  738.              exit;
  739.            }
  740.          rc = _write(database);
  741.          if (rc); {
  742.              printf("Something not right\n");
  743.              exit;
  744.            }...
  745.  
  746.  
  747. ΓòÉΓòÉΓòÉ 4.8. _update ΓòÉΓòÉΓòÉ
  748.  
  749. Description. 
  750.  
  751. To update existing data in the database. 
  752.  
  753. Purpose. 
  754.  
  755. The _update physically commits the data to the database.  The data is replaced 
  756. in  the file. 
  757.  
  758. Format. 
  759.  
  760. _update(instance); 
  761.  
  762. Parameters. 
  763.  
  764. instance 
  765.           The pointer to the instance of the class object. 
  766.  
  767. Return Value  Description 
  768.  
  769. 0 
  770.           Normal 
  771.  
  772. 1 
  773.           Failure 
  774.  
  775.    int main();
  776.        { xdbf  *database;
  777.          int rc;
  778.          database = xdbfNew();
  779.          rc = _open(database, "x:\machines.dbf");
  780.          if (rc); {
  781.              printf("Something not right\n");
  782.              exit;
  783.            }
  784.          rc = _read(database);
  785.          if (rc); {
  786.              printf("Something not right\n");
  787.              exit;
  788.            }
  789.          rc = _setfld(database, "Location", "Building 7 Room D Aisle 14B");
  790.          if (rc); {
  791.              printf("Something not right\n");
  792.              exit;
  793.            }
  794.          rc = _update(database);
  795.          if (rc); {
  796.              printf("Something not right\n");
  797.              exit;
  798.            }...
  799.  
  800.  
  801. ΓòÉΓòÉΓòÉ 4.9. _go_to ΓòÉΓòÉΓòÉ
  802.  
  803. Description. 
  804.  
  805. Allows to reposition the record pointers. 
  806.  
  807. Purpose. 
  808.  
  809. To read a particular record by its record number. 
  810.  
  811. Format. 
  812.  
  813. _go_to(instance, recno); 
  814.  
  815. Parameters. 
  816.  
  817. instance 
  818.           The pointer to the instance of the class object. 
  819. recno 
  820.           signed long record number. 
  821.  
  822. Return Value  Description 
  823.  
  824. 0 
  825.           Normal 
  826.  
  827. 1 
  828.           Failure 
  829.  
  830.    int main();
  831.        { xdbf  *database;
  832.          int rc;
  833.          char *name, willbe[] = "Springer - 100";
  834.          database = xdbfNew();
  835.          rc = _open(database, "x:\machines.dbf");
  836.          if (rc); {
  837.              printf("Something not right\n");
  838.              exit;
  839.            }
  840.          rc = _go_to(database,100);
  841.          if (rc); {
  842.              printf("Something not right\n");
  843.              exit;
  844.            }
  845.          rc = _getfld(database, "Name", name);
  846.          if (rc); {
  847.              printf("Something not right\n");
  848.              exit;
  849.            }
  850.         printf("Changing record 100 from %s to %s\n",name, willbe);
  851.          rc = _setfld(database, "Name", willbe);
  852.          if (rc); {
  853.              printf("Something not right\n");
  854.              exit;
  855.            }
  856.          rc = _update(database);
  857.          if (rc); {
  858.              printf("Something not right\n");
  859.              exit;
  860.            }...
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 4.10. _whaterror ΓòÉΓòÉΓòÉ
  864.  
  865. Description. 
  866.  
  867. To get a more specific error other than 1. 
  868.  
  869. Purpose. 
  870.  
  871. The error handling is weak at best (for the time being).  To get specific error 
  872. messages use this function. 
  873.  
  874. Format. 
  875.  
  876. _whaterror(instance) 
  877.  
  878. Parameters. 
  879.  
  880. instance 
  881.           The pointer to the instance of the class object. 
  882.  
  883. Return Value  Description 
  884.  
  885. some character string. 
  886.           Normal 
  887.  
  888.    int main();
  889.        { xdbf  *database;
  890.          int rc;
  891.          char *name, willbe[] = "Springer - 100";
  892.          database = xdbfNew();
  893.          rc = _open(database, ".dbf");
  894.          if (rc); {
  895.             printf("open failed with a reason of %s\n",_whaterror(database));
  896.             exit;
  897.           }
  898.  
  899.  
  900. ΓòÉΓòÉΓòÉ 4.11. _close ΓòÉΓòÉΓòÉ
  901.  
  902. Description. 
  903.  
  904. To close the database correctly. 
  905.  
  906. Purpose. 
  907.  
  908. To free the database for other applications to use and update all database 
  909. information 
  910.  
  911. Format. 
  912.  
  913. _close(instance) 
  914.  
  915. Parameters. 
  916.  
  917. instance 
  918.           The pointer to the instance of the class object. 
  919.  
  920. Return Value  Description 
  921.  
  922. 0 
  923.           Normal 
  924.  
  925. 1 
  926.           Failure 
  927.  
  928.    int main();
  929.        { xdbf  *database;
  930.          int rc;
  931.          database = xdbfNew();
  932.          rc = _open(database, "x:\machines.dbf");
  933.          if (rc); {
  934.             printf("open failed with a reason of %s\n",_close(database));
  935.             exit;
  936.           }
  937.           rc = _close(database);
  938.            if (rc); {
  939.               printf("close failed with a reason of %s\n",_close(database));
  940.               exit;
  941.             }
  942.  
  943.  
  944. ΓòÉΓòÉΓòÉ 5. Error Messages. ΓòÉΓòÉΓòÉ
  945.  
  946. This is a list of possible error messages and the offending method 
  947.  
  948. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  949. ΓöéError Message       ΓöéMethod    ΓöéDescription                                       Γöé
  950. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  951. ΓöéError will opening  Γöé_open     ΓöéAn operating system error occurred while trying toΓöé
  952. Γöéfile XX             Γöé          Γöéopen the file.  XX represents the return code fromΓöé
  953. Γöé                    Γöé          Γöéthe operating system.                             Γöé
  954. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  955. ΓöéError will opening  Γöé_open     ΓöéAn operating system error occurred while trying toΓöé
  956. Γöéproduction mdx file Γöé          Γöéopen the mdx file associated with the DBF file.   Γöé
  957. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  958. Γöéend of file         Γöé_read     ΓöéNormal end of file                                Γöé
  959. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  960. ΓöéInvalid record      Γöé_go_to    ΓöéRecord number parameter is either less than 1 or  Γöé
  961. Γöénumber              Γöé          Γöégreater than the total number of records in the   Γöé
  962. Γöé                    Γöé          Γöédatabase.                                         Γöé
  963. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  964. Γöéinvalid record      Γöé_update   ΓöéThe record pointer was not positioned on a valid  Γöé
  965. Γöéposition            Γöé          Γöérecord.  This usually occurs if no record has beenΓöé
  966. Γöé                    Γöé          Γöéread or when an end of file occurred.             Γöé
  967. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  968. ΓöéUnknown field       Γöé_getfld   ΓöéThe field identified by the second parameter is   Γöé
  969. Γöé                    Γöé          Γöénot part of the database.                         Γöé
  970. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  971. ΓöéUnknown field       Γöé_setfld   ΓöéThe field identified by the second parameter is   Γöé
  972. Γöé                    Γöé          Γöénot part of the database.                         Γöé
  973. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  974. Γöélogic fldptr value  Γöé_setfld   ΓöéThe field associated with a logic field is either Γöé
  975. Γöéinvalid, value set  Γöé          Γöénot 0, 1, 'T', 'F', 'Y' or 'N'.                   Γöé
  976. Γöéto 'F'              Γöé          Γöé                                                  Γöé
  977. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  978. ΓöéCan't allocate memo Γöé_setfld   ΓöéInternal processing error. Please contact us if   Γöé
  979. Γöéspace               Γöé          Γöéthis occurs.                                      Γöé
  980. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  981. ΓöéBad field type when Γöé_setfld   ΓöéField type is not defined to SOMXBASE. At this    Γöé
  982. Γöégetting field value Γöé          Γöétime the only valid field types are C,  D,  L,  M Γöé
  983. Γöé                    Γöé          Γöéand N.                                            Γöé
  984. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  985. ΓöéBad date found,     Γöé_setfld   ΓöéThe field is not in the format of CCYYMMDD.  WhereΓöé
  986. Γöéchanged to all      Γöé          ΓöéCC  is century, YY is year, MM is month and DD is Γöé
  987. Γöéspaces              Γöé          Γöéday.                                              Γöé
  988. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  989.  
  990.  
  991. ΓòÉΓòÉΓòÉ 6. Shareware ΓòÉΓòÉΓòÉ
  992.  
  993. DEFINITION OF SHAREWARE 
  994.  
  995. Shareware distribution gives users a chance to try software before buying it. 
  996. If you try a Shareware program and continue using it, you are expected to 
  997. register. Individual programs differ on details -- some request registration 
  998. while others require it, some specify a maximum trial period. With 
  999. registration, you get anything from the simple right to continue using the 
  1000. software to an updated program with printed manual. 
  1001.  
  1002.  
  1003. ΓòÉΓòÉΓòÉ 6.1. Copyright ΓòÉΓòÉΓòÉ
  1004.  
  1005. Copyright laws apply to both Shareware and commercial software, and the 
  1006. copyright holder retains all rights, with a few specific exceptions as stated 
  1007. below. Shareware authors are accomplished programmers, just like commercial 
  1008. authors, and the programs are of comparable quality. (In both cases, there are 
  1009. good programs and bad ones!) The main difference is in the method of 
  1010. distribution. The author specifically grants the right to copy and distribute 
  1011. the software, either to all and sundry or to a specific group. For example, 
  1012. some authors require written permission before a commercial disk vendor may 
  1013. copy their Shareware. 
  1014.  
  1015.  
  1016. ΓòÉΓòÉΓòÉ 6.2. Distribution. ΓòÉΓòÉΓòÉ
  1017.  
  1018. Shareware is a distribution method, not a type of software. You should find 
  1019. software that suits your needs and pocketbook, whether it's commercial or 
  1020. Shareware. The Shareware system makes fitting your needs easier, because you 
  1021. can try before you buy. And because the overhead is low, prices are low also. 
  1022. Shareware has the ultimate money-back guarantee -- if you don't use the 
  1023. product, you don't pay for it. 
  1024.  
  1025.  
  1026. ΓòÉΓòÉΓòÉ 7. Disclaimer ΓòÉΓòÉΓòÉ
  1027.  
  1028. DISCLAIMER - AGREEMENT 
  1029.  
  1030. Users of SOMXBase  must accept this disclaimer of warranty: "SOMXBase  is 
  1031. supplied as is. The author disclaims all warranties, expressed or implied, 
  1032. including, without limitation, the warranties of merchantability and of fitness 
  1033. for any purpose. The author assumes no liability for damages, direct or 
  1034. consequential, which may result from the use of SOMXBase ." 
  1035.  
  1036.  
  1037. ΓòÉΓòÉΓòÉ 8. Sharing SOMXBase ΓòÉΓòÉΓòÉ
  1038.  
  1039. SOMXBase  is a "shareware program" and is provided at no charge to the user for 
  1040. evaluation. Feel free to share it with your friends, but please do not give it 
  1041. away altered or as part of another system. The essence of "user-supported" 
  1042. software is to provide personal computer users with quality software without 
  1043. high prices, and yet to provide incentive for programmers to continue to 
  1044. develop new products. If you find this program useful and find that you are 
  1045. using SOMXBase  and continue to use SOMXBase  after a reasonable trial period, 
  1046. you must make a registration payment of $95.00 to American Coders, Ltd. The 
  1047. $95.00 registration fee will license one copy for use on any one computer at 
  1048. any one time. You must treat this software just like a book. An example is that 
  1049. this software may be used by any number of people and may be freely moved from 
  1050. one computer location to another, so long as there is no possibility of it 
  1051. being used at one location while it's being used at another. Just as a book 
  1052. cannot be read by two different persons at the same time. 
  1053.  
  1054.  
  1055. ΓòÉΓòÉΓòÉ 8.1. Commercial Users ΓòÉΓòÉΓòÉ
  1056.  
  1057. Commercial users of SOMXBase  must register and pay for their copies of 
  1058. SOMXBase  within 30 days of first use or their license is withdrawn. 
  1059. Site-License arrangements may be made by contacting American Coders, Ltd. 
  1060.  
  1061.  
  1062. ΓòÉΓòÉΓòÉ 8.2. Distributing ΓòÉΓòÉΓòÉ
  1063.  
  1064. Anyone distributing SOMXBase  for any kind of remuneration must first contact 
  1065. American Coders, Ltd. at our address. below for authorization. This 
  1066. authorization will be automatically granted to distributors recognized by the 
  1067. (ASP) as adhering to its guidelines for shareware distributors, and such 
  1068. distributors may begin offering SOMXBase  immediately (However American Coders, 
  1069. Ltd. must still be advised so that the distributor can be kept up-to-date with 
  1070. the latest version of SOMXBase .). 
  1071.  
  1072.  
  1073. ΓòÉΓòÉΓòÉ 8.3. Pass Along ΓòÉΓòÉΓòÉ
  1074.  
  1075. You are encouraged to pass a copy of SOMXBase  along to your friends for 
  1076. evaluation. Please encourage them to register their copy if they find that they 
  1077. can use it. All registered users will receive a copy of the latest version of 
  1078. the SOMXBase system. 
  1079.  
  1080.  
  1081. ΓòÉΓòÉΓòÉ 9. Ombudsman Statement ΓòÉΓòÉΓòÉ
  1082.  
  1083. This program is produced by American Coders, LTD, a member of the Association 
  1084. of Shareware Professionals (ASP).  ASP wants to make sure that the shareware 
  1085. principle works for you.  If you are unable to resolve a shareware-related 
  1086. problem with an ASP member by contacting the member directly, ASP may be able 
  1087. to help.  The ASP Ombudsman can help you resolve a dispute or problem with an 
  1088. ASP member, but does not provide technical support for members' products. 
  1089. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 
  1090. USA, FAX 616-788-2765 or send a CompuServe message via CompuServe Mail to ASP 
  1091. Ombudsman 70007,3536.