home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / start_xact.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.2 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               start_xact
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  start_xact
  6.  
  7.   FUNCTION:
  8.        Start a distributed transaction using the commit service.
  9.  
  10.   SYNTAX:
  11.        DBINT start_xact(connect, application_name, xact_name, site_count)
  12.  
  13.        DBPROCESS *connect;
  14.        char      *application_name;
  15.        char      *xact_name;
  16.        int       site_count;
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   start_xact              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o This routine records the start  of  a  distributed  transaction
  30.          with the commit service.  A record is placed in the commit ser-
  31.          vice containing the commid, which is a number that caller  sub-
  32.          sequently  uses  to identify the transaction to the commit ser-
  33.          vice.
  34.  
  35.   PARAMETERS:
  36.        connect -  A pointer to the DBPROCESS used  to  communicate  with
  37.            the commit service.
  38.        application_name -  The name of the application. This name can be
  39.            anything the application chooses. It will appear in the table
  40.            maintained by the commit service but is not used by the  com-
  41.            mit service or the SQL Server recovery system.
  42.        xact_name -  The name of the transaction. This name  will  appear
  43.            in  the  table  maintained  by the commit service and must be
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               start_xact
  47.   ______________________________________________________________________
  48.            supplied as part of the  transaction  name  string  built  by
  49.            build_xact_string().   The name cannot contain a period (".")
  50.            or a colon (":").
  51.        site_count -  The number of sites participating in  the  transac-
  52.            tion.
  53.  
  54.   RETURNS:
  55.        An integer called the commid. This number is used to identify the
  56.        transaction  in  subsequent calls to the commit service.  In case
  57.        of error, this routine will return 0.
  58.  
  59.   SEE ALSO:
  60.        abort_xact,    build_xact_string,    commit_xact,    remove_xact,
  61.        scan_xact, stat_xact
  62.  
  63.  
  64.  
  65.  
  66.  
  67.