home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / bcp_setl.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                 BCP_SETL
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  BCP_SETL
  6.  
  7.   FUNCTION:
  8.        Set the LOGINREC for bulk copy operations.
  9.  
  10.   SYNTAX:
  11.        RETCODE BCP_SETL(loginrec, enable)
  12.  
  13.        LOGINREC  *loginrec;
  14.        DBBOOL    enable;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   BCP_SETL                Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This macro sets a field in the LOGINREC  structure  that  tells
  28.          SQL Server  that  the DBPROCESS connection may be used for bulk
  29.          copy operations.  For it to have any effect, it must be  called
  30.          before dbopen(), the routine that actually allocates the DBPRO-
  31.          CESS structure.
  32.        o Applications that allow users to make ad hoc queries  may  want
  33.          to  avoid  calling  this  macro  (or to call it with the enable
  34.          parameter FALSE), in order to keep users from initiating a bulk
  35.          copy  sequence  via SQL commands. Once a bulk copy sequence has
  36.          begun, it cannot be stopped via an ordinary SQL command.
  37.  
  38.        o For information on the bcp utility program, see its manual page
  39.          in the Commands Reference.
  40.  
  41.   PARAMETERS:
  42.        loginrec -  This is a pointer to a LOGINREC structure, which will
  43.            be  passed  as  an  argument  to dbopen(). You can get one by
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                 BCP_SETL
  47.   ______________________________________________________________________
  48.            calling dblogin().
  49.        enable -  This is a Boolean value (TRUE or FALSE),  which  speci-
  50.            fies  whether  or  not to enable bulk copy operations for the
  51.            resulting DBPROCESS. By default, DBPROCESSes are not  enabled
  52.            for bulk copy operations.
  53.  
  54.   RETURNS:
  55.        SUCCEED or FAIL.
  56.  
  57.   SEE ALSO:
  58.        bcp_init,  dblogin,  dbopen,  DBSETLAPP,  DBSETLHOST,  DBSETLPWD,
  59.        DBSETLUSER
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.   BCP_SETL                Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.