home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbsetifile.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.7 KB  |  50 lines
  1. .Na "dbsetifile" 
  2. .Aa
  3. .Fu
  4. Specify the name and location of the SYBASE \f2interfaces\f1 file.
  5. .Ih "interfaces file, specifying name and location of"
  6. .Sy
  7. .Sf "void dbsetifile(filename)"
  8. .Sp "char" "*filename"
  9. .Co
  10. .Bl
  11. This routine lets the application specify the name and location of the
  12. \f2interfaces\f1 file that will be searched during every subsequent call to \f2dbopen()\fP.
  13. The \f2interfaces\f1 file contains the name and network address of every \*S available on the network.
  14. .Bl
  15. If \f2dbsetifile()\fP has not been called, a call to \f2dbopen()\f1 will
  16. initiate the following default behavior:  \*L will first attempt to use a
  17. file named ``interfaces'' in the directory named by the SYBASE environment variable or
  18. logical name.
  19. .Ih "SYBASE environment variable"
  20. .Ih "SYBASE logical name"
  21. If SYBASE has not been set,
  22. \*L will attempt to use a file called ``interfaces'' in the home
  23. directory of the user named ``sybase''.
  24. .Bl
  25. \f3Note for OS/2, MS-DOS, and Macintosh programmers:\f1
  26. A call to \f2dbsetconnect()\f1 supersedes the \f2interfaces\f1 file entirely.
  27. It provides \f2dbopen()\f1 with the information it would otherwise need to
  28. obtain from the \f2interfaces\f1 file.
  29. If \f2dbsetconnect()\f1 has been called, \f2dbopen()\f1 never
  30. looks for an \f2interfaces\f1 file, but instead uses the information provided by
  31. \f2dbsetconnect()\f1.
  32. .Bl
  33. For more information on the \f2interfaces\f1 file, see the \f2SYBASE Installation
  34. Guide\f1.
  35. .Bz
  36. .Pa
  37. .Pi filename
  38. The name of the \f2interfaces\f1 file that gets
  39. searched during every subsequent call to
  40. \f2dbopen()\fP. If this parameter is NULL, 
  41. \*L will revert to its default \f2interfaces\f1
  42. filename (see above).
  43. .in -.375i
  44. .Re
  45. .br
  46. None.
  47. .Sa
  48. dbopen,
  49. dbsetconnect
  50.