home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / build_xact_string.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89        build_xact_string
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  build_xact_string
  6.  
  7.   FUNCTION:
  8.        Build a name for a distributed transaction.
  9.  
  10.   SYNTAX:
  11.        void build_xact_string(xact_name, service_name, commid, result)
  12.  
  13.        char      *xact_name;
  14.        char      *service_name;
  15.        DBINT     commid;
  16.        char      *result;
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   build_xact_string       Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o This routine builds a name string for  use  in  the  SQL  BEGIN
  30.          TRANSACTION  and  PREPARE  TRANSACTION of a SQL Server transac-
  31.          tion. If SQL Server has to recover  the  transaction,  it  uses
  32.          information  encoded in the name to determine which commit ser-
  33.          vice to contact  and  which  transaction  in  that  service  to
  34.          inquire  about.  The application should issue a SQL BEGIN TRAN-
  35.          SACTION using the string built by build_xact_string().
  36.  
  37.   PARAMETERS:
  38.        xact_name -  The application or user name  for  the  transaction.
  39.            This  name gets encoded in the name string but is not used by
  40.            the commit service or SQL Server. It serves to  identify  the
  41.            transaction for debugging purposes.
  42.        service_name -  The name that will be used by SQL Server to  con-
  43.            tact  the  commit  service, should it be necessary to recover
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89        build_xact_string
  47.   ______________________________________________________________________
  48.            the transaction.  If service_name is NULL, the name  DSCOMMIT
  49.            is used.
  50.        commid -  The number used by the commit service to  identify  the
  51.            transaction.   commid  is  the number returned by the call to
  52.            start_xact().
  53.        result -  Address of buffer where the  string  should  be  built.
  54.            The space must be allocated by the caller.
  55.  
  56.   RETURNS:
  57.        None.
  58.  
  59.   SEE ALSO:
  60.        commit_xact, start_xact
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.