home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / bcp_collen.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.7 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               bcp_collen
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  bcp_collen
  6.  
  7.   FUNCTION:
  8.        Set the program variable data length for the current copy IN.
  9.  
  10.   SYNTAX:
  11.        RETCODE bcp_collen(dbproc, varlen, table_column)
  12.  
  13.        DBPROCESS *dbproc;
  14.        DBINT     varlen;
  15.        int       table_column;
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   bcp_collen              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o The bcp_collen() function allows  you  to  change  the  program
  30.          variable  data  length  for a particular column while running a
  31.          copy IN via calls to bcp_bind().
  32.        o Initially, the program variable data length is determined  when
  33.          bcp_bind()  is  called.  If  the  program  variable data length
  34.          changes between calls to bcp_sendrow(), and no length prefix or
  35.          terminator  is  being  used, you may call bcp_collen() to reset
  36.          the length.  The next call to bcp_sendrow() will use the length
  37.          you just set.
  38.  
  39.        o There must be a separate bcp_collen() call for every column  in
  40.          the table whose data length you want to modify.
  41.        o For information on the bcp utility program, see its manual page
  42.          in the Commands Reference.
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               bcp_collen
  47.   ______________________________________________________________________
  48.  
  49.   PARAMETERS:
  50.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  51.            connection for a particular front-end/SQL Server process.  It
  52.            contains all the information that DB-Library uses  to  manage
  53.            communications and data between the front end and SQL Server.
  54.        varlen -  The length of the  program  variable,  which  does  not
  55.            include  the  length of the length prefix or terminator. Set-
  56.            ting varlen to 0 signifies that the data is NULL. Setting  it
  57.            to -1 signifies that the data is variable-length and that the
  58.            length will be determined by the length prefix or terminator.
  59.            If  both a length prefix and a terminator exist, bcp will use
  60.            the one that results in the shortest  amount  of  data  being
  61.            copied.
  62.        table_column -  The column in the SQL Server table to  which  the
  63.            data will be copied. Column numbers start at 1.
  64.  
  65.  
  66.  
  67.  
  68.   bcp_collen              Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.  
  71.   RETURNS:
  72.        SUCCEED or FAIL.
  73.  
  74.   SEE ALSO:
  75.        bcp_bind, bcp_colptr, bcp_sendrow
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.