home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbmoretext.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               dbmoretext
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbmoretext
  6.  
  7.   FUNCTION:
  8.        Send part of a text or image value to SQL Server.
  9.  
  10.   SYNTAX:
  11.        RETCODE dbmoretext(dbproc, size, text)
  12.  
  13.        DBPROCESS *dbproc;
  14.        DBINT     size;
  15.        BYTE      *text;
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbmoretext              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o This routine is used in conjunction with dbwritetext() to  send
  30.          a  large SYBTEXT or SYBIMAGE value to SQL Server in the form of
  31.          a number of smaller chunks.  This is particularly  useful  with
  32.          operating  systems  unable  to  allocate  extremely  long  data
  33.          buffers.
  34.        o dbmoretext() and dbwritetext() are used in  updates  only,  and
  35.          serve to replace the Transact-SQL UPDATE statement.
  36.  
  37.        o dbsqlok() and dbresults() must be called before the first  call
  38.          to dbmoretext() and after the last call to dbmoretext().
  39.        o See the dbwritetext() manual page for more information, includ-
  40.          ing an example that uses dbmoretext().
  41.  
  42.   PARAMETERS:
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               dbmoretext
  47.   ______________________________________________________________________
  48.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  49.            connection for a particular front-end/SQL Server process.  It
  50.            contains all the information that DB-Library uses  to  manage
  51.            communications and data between the front end and SQL Server.
  52.        size -  The size, in bytes, of this particular part of  the  text
  53.            or  image  value being sent to SQL Server.  It is an error to
  54.            send more text or image bytes to SQL Server than were  speci-
  55.            fied in the call to dbwritetext().
  56.        text -  A pointer to the text or image portion to be written.
  57.  
  58.   RETURNS:
  59.        SUCCEED or FAIL.
  60.  
  61.   SEE ALSO:
  62.        dbtxptr, dbtxtimestamp, dbwritetext
  63.  
  64.  
  65.  
  66.  
  67.