home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / open_commit.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89              open_commit
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  open_commit
  6.  
  7.   FUNCTION:
  8.        Establish a connection with the commit service.
  9.  
  10.   SYNTAX:
  11.        DBPROCESS *open_commit(login, servername)
  12.  
  13.        LOGINREC  *login;
  14.        char      *servername;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   open_commit             Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine calls dbopen() to establish a connection with  the
  28.          commit  service. A call to open_commit() must precede any calls
  29.          to  other  commit  service  routines,  such  as   start_xact(),
  30.          commit_xact(),  abort_xact(), remove_xact(), and scan_xact(). A
  31.          session  with  the  commit  service  is   closed   by   calling
  32.          close_commit().
  33.        o This routine returns a DBPROCESS structure, which  is  used  to
  34.          communicate  with  the  commit  service.  The DBPROCESS must be
  35.          dedicated to its role with the commit service and should not be
  36.          used otherwise in the distributed transaction.
  37.  
  38.   PARAMETERS:
  39.        login -  This is a LOGINREC containing information about the user
  40.            initiating the session, such as login name, password, options
  41.            desired.  The LOGINREC must have been obtained from  a  prior
  42.            call to the DB-Library routine dblogin(). The caller may wish
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89              open_commit
  47.   ______________________________________________________________________
  48.            to initialize fields in the LOGINREC. See the manual page for
  49.            dblogin() for more details.
  50.        servername -  The  name  of  the  commit  service;  for  example,
  51.            DSCOMMIT_SALESNET.   If servername is NULL, the name DSCOMMIT
  52.            is used. The name cannot contain a period (".")  or  a  colon
  53.            (":").
  54.  
  55.   RETURNS:
  56.        A pointer to a DBPROCESS structure to be used in subsequent  com-
  57.        mit service calls, or NULL if the open failed.
  58.  
  59.   SEE ALSO:
  60.        dblogin, dbopen
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.