home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbhasretstat.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.8 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89             dbhasretstat
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbhasretstat
  6.  
  7.   FUNCTION:
  8.        Determine whether the current command or  remote  procedure  call
  9.        generated a return status number.
  10.  
  11.   SYNTAX:
  12.        DBBOOL dbhasretstat(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbhasretstat            Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine determines whether the current  Transact-SQL  com-
  28.          mand or remote procedure call generated a return status number.
  29.          Status numbers are returned by all stored procedures running on
  30.          a  SQL Server  whose  version  is  4.0  or above.  Since status
  31.          numbers are a feature of stored procedures, only a remote  pro-
  32.          cedure call or an EXECUTE command can generate a status number.
  33.        o The dbretstatus() routine  actually  gets  the  status  number.
  34.          Stored procedures that complete normally return a status number
  35.          of 0.  For a list of return status numbers,  see  the  Commands
  36.          Reference.
  37.  
  38.        o When executing a  stored  procedure,  the  server  returns  the
  39.          status  number  immediately  after returning all other results.
  40.          Therefore, the application can call dbhasretstat()  only  after
  41.          processing   the   stored   procedure's   results   by  calling
  42.          dbresults(), as well as dbnextrow() if appropriate.  (Note that
  43.          a stored procedure can generate several sets of results-one for
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89             dbhasretstat
  47.   ______________________________________________________________________
  48.          each SELECT it  contains.   Before  the  application  can  call
  49.          dbhasretstat()  or  dbretstatus(), it must call dbresults() and
  50.          dbnextrow() as many times  as  necessary  to  process  all  the
  51.          results.)
  52.  
  53.        o The order in which the application processes the status  number
  54.          and any return parameter values is unimportant.
  55.        o For an example of this routine, see Example 8 in the DB-Library
  56.          Reference Supplement.
  57.  
  58.   PARAMETERS:
  59.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  60.            connection for a particular front-end/SQL Server process.  It
  61.            contains all the information that DB-Library uses  to  manage
  62.            communications and data between the front end and SQL Server.
  63.  
  64.   RETURNS:
  65.  
  66.  
  67.  
  68.   dbhasretstat            Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.        TRUE or FALSE.
  71.  
  72.   SEE ALSO:
  73.        dbnextrow,   dbresults,   dbretdata,   dbretstatus,    dbrpcinit,
  74.        dbrpcparam, dbrpcsend
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.