home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbdead.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.5 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                   DBDEAD
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBDEAD
  6.  
  7.   FUNCTION:
  8.        Determine whether a particular DBPROCESS is dead.
  9.  
  10.   SYNTAX:
  11.        DBBOOL DBDEAD(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o This macro indicates whether or not the specified DBPROCESS  is
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBDEAD                  Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          dead.
  27.  
  28.          It is particularly useful in user-supplied error handlers.
  29.  
  30.        o If a DBPROCESS is dead, then almost  every  DB-Library  routine
  31.          which receives it as a parameter will immediately fail, calling
  32.          the user-supplied error handler.
  33.        o Note:  If there is  no  user-supplied  error  handler,  a  dead
  34.          DBPROCESS  will  cause  the affected DB-Library routines not to
  35.          fail, but to abort the program.
  36.  
  37.   PARAMETERS:
  38.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  39.            connection for a particular front-end/SQL Server process.  It
  40.            contains all the information that DB-Library uses  to  manage
  41.            communications and data between the front end and SQL Server.
  42.  
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                   DBDEAD
  47.   ______________________________________________________________________
  48.  
  49.   RETURNS:
  50.        TRUE or FALSE.
  51.  
  52.   SEE ALSO:
  53.        dberrhandle, errors
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.