home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbcolbrowse.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.8 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89              dbcolbrowse
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbcolbrowse
  6.  
  7.   FUNCTION:
  8.        Determine whether the source of a regular result column is updat-
  9.        able via the DB-Library browse-mode facilities.
  10.  
  11.   SYNTAX:
  12.        DBBOOL dbcolbrowse(dbproc, colnum)
  13.  
  14.        DBPROCESS *dbproc;
  15.        int       colnum;
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbcolbrowse             Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o dbcolbrowse() is one of the DB-Library  browse  mode  routines.
  30.          See the Introduction for a detailed discussion of browse mode.
  31.        o dbcolbrowse() provides a way to determine whether the  database
  32.          column  that's  the  source  of  a  regular (i.e., non-compute)
  33.          result column in a select-list is updatable via the  DB-Library
  34.          browse-mode facilities.  This routine is useful in examining ad
  35.          hoc queries.  If the query has been hardcoded into the program,
  36.          dbcolbrowse() is obviously unnecessary.
  37.  
  38.        o To be updatable, a column must  be  derived  from  a  browsable
  39.          table (i.e., the table must have a unique index and a timestamp
  40.          column) and cannot be the result  of  a  SQL  expression.   For
  41.          example, in the following select-list:
  42.  
  43.             select title, category=type, wholesale=(price * 0.6) ... for browse
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89              dbcolbrowse
  47.   ______________________________________________________________________
  48.  
  49.          result columns 1 and 2 ("title" and "category") are  updatable,
  50.          but  column 3 ("wholesale") is not, because it is the result of
  51.          an expression.
  52.  
  53.        o The  application  can  call  dbcolbrowse()   any   time   after
  54.          dbresults().
  55.        o To determine the name of the source column given  the  name  of
  56.          the result column, use dbcolsource().
  57.  
  58.        o Example 7 in the DB-Library  Reference  Supplement  contains  a
  59.          call to dbcolbrowse().
  60.  
  61.   PARAMETERS:
  62.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  63.            connection for a particular front-end/SQL Server process.  It
  64.            contains all the information that DB-Library uses  to  manage
  65.            communications and data between the front end and SQL Server.
  66.  
  67.  
  68.   dbcolbrowse             Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.        colnum -  The number of the result  column  of  interest.  Column
  71.            numbers start at 1.
  72.  
  73.   RETURNS:
  74.        TRUE or FALSE.
  75.  
  76.   SEE ALSO:
  77.        dbcolsource, dbqual, dbtabbrowse, dbtabcount,  dbtabname,  dbtab-
  78.        source, dbtsnewlen, dbtsnewval, dbtsput
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.