home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbdead.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  900 b   |  34 lines
  1. .Na "DBDEAD" 
  2. .Aa
  3. .Fu
  4. Determine whether a particular DBPROCESS is dead.
  5. .Ih "DBPROCESS, dead"
  6. .Sy
  7. .Sf "DBBOOL DBDEAD(dbproc)"
  8. .Sp "DBPROCESS" "*dbproc"
  9. .Co
  10. .Bl
  11. This macro indicates whether or not the specified DBPROCESS is dead. 
  12. It is particularly useful in user-supplied error handlers.
  13. .Bl
  14. If a DBPROCESS \f2is\f1 dead, then almost
  15. every \*L routine which receives it as a parameter will immediately fail,
  16. calling the user-supplied error handler.
  17. .Bl
  18. \f3Note:\f1  If there is no user-supplied error handler, a dead DBPROCESS will 
  19. cause the affected \*L routines not to fail, but to abort the program.
  20. .Bz
  21. .Pa
  22. .Pi dbproc
  23. A pointer to the DBPROCESS structure that provides the connection
  24. for a particular front-end/\*S process.  It contains all the
  25. information that \*L uses to manage communications and data between the
  26. front end and \*S.
  27. .in -.375i
  28. .Re
  29. .br
  30. TRUE or FALSE.
  31. .Sa
  32. dberrhandle,
  33. errors
  34.