home *** CD-ROM | disk | FTP | other *** search
/ Datatid 1999 #6 / Datatid_1999-06.iso / internet / Tango352Promo / P.SQL / PTKPKG.1 / OS2DBSET.HLP (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1998-09-30  |  8.8 KB  |  263 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Pervasive Software Setup Utility ΓòÉΓòÉΓòÉ
  3.  
  4. Pervasive Software Setup Utility 
  5.  
  6. The Setup utility enables you to modify the settings for a number of Pervasive 
  7. Software components. These components include the MicroKernel Database Engine, 
  8. the Scalable SQL Engine, the Scalable SQL Communications Manager, the Btrieve 
  9. Communications Manager and the local Requester components. The settings for 
  10. these components are stored in a configuration database suitable for the 
  11. platform. The first time components are loaded, they generate default values in 
  12. the configuration database. These defaults are adequate for many installations 
  13. but may need to be changed if : 
  14.  
  15. - Your Btrieve or Scalable SQL-based applications require that you adjust the 
  16. settings. Refer to the documentation included with the application for more 
  17. information. 
  18.  
  19. - You want to optimize the settings so that the components provide the services 
  20. you need without using more memory than necessary. (The memory requirements 
  21. stated in the manual provide guidelines for optimizing use of your computer's 
  22. resources.) 
  23.  
  24. Configuring Components on Remote Servers 
  25.  
  26. The Setup utility allows you to connect to remote servers to configure the 
  27. components on that remote server. You can remotely configure the following 
  28. components: 
  29.  
  30. - MicroKernel Database Engine 
  31.  
  32. - Btrieve Communications Manager 
  33.  
  34. - Scalable SQL Engine 
  35.  
  36. - Scalable SQL Communications Manager 
  37.  
  38. When the Setup utility is run, it first looks for components on the local 
  39. machine. If it finds no components it can configure on the local machine, the 
  40. Component List Box will contain no entries. 
  41.  
  42. To connect to a remote server, click on the Connect button. Enter the name of 
  43. the server to which you want to connect. When you click the OK button, an 
  44. attempt to make a connection to the names server will be made. If the 
  45. connection succeeds, the Setup utility will look for components on the remote 
  46. machine. Again, if no components on the remote server can be found, the 
  47. Component List Box will contain no entries. 
  48.  
  49. Changing Settings 
  50.  
  51. Following is a description of each of the controls on the Setup window and how 
  52. you use them to change settings. 
  53.  
  54. Components List Box: 
  55.  
  56. Contains the database components which you can configure. Select the component 
  57. for which you want to view or modify settings. 
  58.  
  59. Categories List Box: 
  60.  
  61. Contains the categories of settings for the component you have selected. Select 
  62. the category for which you want to view or modify settings. 
  63.  
  64. Category Description Text: 
  65.  
  66. Contains an overview of the selected settings category. 
  67.  
  68. Settings List Box: 
  69.  
  70. Contains the configurable settings for the selected category. Select the 
  71. setting which you want to view or modify. 
  72.  
  73. Setting Description Text: 
  74.  
  75.  Contains an overview description of the selected setting. 
  76.  
  77. Settings Group: 
  78.  
  79. Contains controls for the current setting. The controls vary depending upon the 
  80. type of setting. The current value is the only editable value. 
  81.  
  82. Note: Any settings labeled "Advanced" are intended for experienced users who 
  83. need to perform fine-tuning or debugging operations. The default values for 
  84. these settings are sufficient for most installations. 
  85.  
  86.  Here are the different types of settings and the controls used to set them: 
  87.  
  88. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  89. ΓöéSetting Type       ΓöéControls                         Γöé
  90. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  91. ΓöéBoolean:           ΓöéDefault                          Γöé
  92. Γöé                   ΓöéCurrent ( On / Off )             Γöé
  93. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  94. ΓöéNumeric:           ΓöéDefault                          Γöé
  95. Γöé                   ΓöéMinimum                          Γöé
  96. Γöé                   ΓöéMaximum                          Γöé
  97. Γöé                   ΓöéCurrent                          Γöé
  98. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  99. ΓöéSelection:         ΓöéDefault                          Γöé
  100. Γöé                   ΓöéSelection ( List or radio        Γöé
  101. Γöé                   Γöébuttons)                         Γöé
  102. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  103. ΓöéDirectory/File     ΓöéDefault                          Γöé
  104. ΓöéPath:              ΓöéCurrent (Path)                   Γöé
  105. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  106. ΓöéOthers:            ΓöéSome settings, like tracing, haveΓöé
  107. Γöé                   Γöéa set of controls which are      Γöé
  108. Γöé                   Γöéspecific to only that setting.   Γöé
  109. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  110.  
  111. Save Button: 
  112.  
  113. Saves all changed settings to the configuration database. In most cases you 
  114. must unload and restart the component for the setting changes to take affect. 
  115.  
  116. Exit Button: 
  117.  
  118. Closes the Setup Utility without saving any changed settings. 
  119.  
  120. Help Button: 
  121.  
  122. Shows this help screen. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 2. Maintaining Named Databases ΓòÉΓòÉΓòÉ
  126.  
  127. Maintaining Named Databases 
  128.  
  129. A named database has a logical name that allows users to identify it without 
  130. knowing its actual location. When you name a database, you associate that name 
  131. with a particular dictionary directory path and one or more data file paths. 
  132. When you log in to the SQL Interface using a database name, the SQL Interface 
  133. uses the name to find the database dictionary and data files. A named database 
  134. enables you to do the following: 
  135.  
  136. - Define triggers 
  137.  
  138. - Define primary and foreign keys 
  139.  
  140. - Bind a database 
  141.  
  142. - Suspend a database's integrity constraints 
  143.  
  144. - You use the Maintain Named Database feature to bind and name databases. 
  145.  
  146. Maintain Named Database Dialog Box Elements 
  147.  
  148. Database Names: 
  149.  
  150. Lists the available named databases. 
  151.  
  152. Dictionary Location: 
  153.  
  154. Displays the location of the DDF files for the selected database. 
  155.  
  156. Itegrity Enforced: 
  157.  
  158. Displays whether Pervasive.SQL is enforcing integrity constraints (including 
  159. security, referential integrity and triggers) on the database. 
  160.  
  161. Bound: 
  162.  
  163. Displays when the database is bound. For more information about bound 
  164. databases, please refer to the Pervasive.SQL Programmer's Guide. 
  165.  
  166. Data File Locations: 
  167.  
  168. Displays the location for the data files. 
  169.  
  170. Create: 
  171.  
  172. Allows you to create a new named database. 
  173.  
  174. Modify: 
  175.  
  176. Allows you to modify the properties of the current database. 
  177.  
  178. Delete: 
  179.  
  180. Deletes the database from the DBNAMES.CFG file. For bound databases this 
  181. operation alos deletes the associated dictionary files. For unbound databases, 
  182. this operation does not delete any files. 
  183.  
  184. Bind: 
  185.  
  186. Makes the database a bound database.  NOTE:  To bind successfully, an existing 
  187. database cannot reference dictionary or data files referenced by another named 
  188. database. If your database does share dictionary or data files, you must ensure 
  189. that all named databases sharing the dictionary files are unbound. 
  190.  
  191. Unbind: 
  192.  
  193. Makes the database an unbound database and changes the status of each 
  194. dictionary and data file to unbound. NOTE:  Because the engine automatically 
  195. stamps a file as bound if it has a trigger, a foreign key, or a primary key 
  196. referenced by a foreign key, you may unbind the database, but have some files 
  197. that remain bound. 
  198.  
  199. Check: 
  200.  
  201. Determines whether the entry for this database in the DBNAMES.CFG file 
  202. accurately reflects the existing dictionary and data files. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 3. Add Named Database ΓòÉΓòÉΓòÉ
  206.  
  207. Add Named Database 
  208.  
  209. To create a bound database: 
  210.  
  211. 1. In the Database Name field, enter the name of the database. Do not specify a 
  212. database name that includes spaces. The SQL Interface displays the name only up 
  213. to the embedded space, so the name My DB is advertised as My. 
  214.  
  215. 2. By default, Integrity Enforced setting is enabled. This setting determines 
  216. whether Pervasive.SQL enforces integrity constraints (including security, 
  217. referential integrity, and triggers) on the database, regardless of whether the 
  218. database is bound. 
  219.  
  220. In general, you should not disable integrity enforcement. However, you may want 
  221. to suspend integrity constraints to facilitate bulk data loads. 
  222.  
  223. 3. By default, the Bound setting is enabled which determines that a database is 
  224. bound. When you create a bound database, the SQL Interface creates the 
  225. appropriate dictionary files. 
  226.  
  227. You cannot create a bound database for which the dictionary files already 
  228. exist. If you have existing dictionary files, first create an unbound database, 
  229. then use the Bind button in the Maintain Named Databases dialog box. 
  230.  
  231. 4. Specify the dictionary location for the database in the Dictionary Location 
  232. field. This location must be on the same server to which you are connected. 
  233.  
  234. For NetWare, enter a path in the form of vol:\path. For Windows NT, enter a 
  235. path in the form drive:\path where drive should be a local drive letter. 
  236.  
  237. 5. Specify the location of the data file(s) in the Data File Locations field. 
  238. Click Add to enter a location in the Location pop-up dialog. 
  239.  
  240. If you are specifying paths to data files on this server, specify paths the 
  241. same as you did in the Dictionary Location field. If you are entering paths to 
  242. data files on another server, specify the full name. For NetWare, specify the 
  243. path in the form \\server\vol1\path (UNC format) or server\vol1:\path; for 
  244. Windows NT and Windows 9X, specify the path in the form 
  245. \\server\sharename\path. 
  246.  
  247. You can click Delete if you decide not include a specific data file location. 
  248.  
  249. 6. Click OK to create the named database and close the dialog box, or click 
  250. Cancel to close the dialog box without saving changes. 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 4. Modify a named database ΓòÉΓòÉΓòÉ
  254.  
  255. To modify a named database 
  256.  
  257. 1. Add or modify data file locations. 
  258.  
  259. You cannot modify the Database Name or Dictionary Location for bound databases 
  260. or for databases that contain triggers or foreign keys. 
  261.  
  262. 2 Click OK to save your modifications. Otherwise, click Cancel to close this 
  263. dialog without saving changes.