home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbrpwset.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  3.3 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                 dbrpwset
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbrpwset
  6.  
  7.   FUNCTION:
  8.        Add a remote password to the LOGINREC structure.
  9.  
  10.   SYNTAX:
  11.        RETCODE dbrpwset(loginrec, srvname, password, pwlen)
  12.  
  13.        LOGINREC  *loginrec;
  14.        char      *srvname;
  15.        char      *password;
  16.        int       pwlen;
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbrpwset                Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o A Transact-SQL command batch or stored procedure running on one
  30.          SQL Server  may  call  a  stored  procedure  located on another
  31.          SQL Server.  To accomplish this server-to-server communication,
  32.          the first SQL Server, connected to the application through dbo-
  33.          pen(), actually logs into the second,  remote  SQL Server,  and
  34.          performs a remote procedure call.
  35.          dbrpwset() allows the application to specify the password to be
  36.          used when the first SQL Server attempts to call the stored pro-
  37.          cedure on the remote SQL Server.   Multiple  passwords  may  be
  38.          specified,  one  for  each SQL Server that the first SQL Server
  39.          might need to log into.
  40.  
  41.        o If the application has not specified a remote  password  for  a
  42.          particular  SQL Server,  the  password  defaults to the one set
  43.          with DBSETLPWD() (or a null value, if DBSETLPWD() has not  been
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                 dbrpwset
  47.   ______________________________________________________________________
  48.          called).  This behavior may be fine if the  application's  user
  49.          has the same password on multiple SQL Servers.
  50.  
  51.        o dbrpwclr() clears all remote passwords from the LOGINREC.
  52.  
  53.   PARAMETERS:
  54.        loginrec -  A pointer to a LOGINREC structure.  This pointer will
  55.            serve as an argument to dbopen().  You can get one by calling
  56.            dblogin().
  57.        srvname -  The name of a server.  A server's name  is  stored  in
  58.            the  srvname column of its sysservers system table.  When the
  59.            first server calls a stored procedure located on  the  server
  60.            designated  by srvname, it will use the specified password to
  61.            log in.  If srvname is NULL, the specified password  will  be
  62.            considered a "universal" password, to be used with any server
  63.            that does not have a password explicitly specified for it.
  64.        password -  The password which the first SQL Server will  use  to
  65.            log into the specified SQL Server.
  66.  
  67.  
  68.   dbrpwset                Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.        pwlen -  The length of the password in bytes.
  71.  
  72.   RETURNS:
  73.        SUCCEED or FAIL.  This routine may fail if the  addition  of  the
  74.        specified  password would overflow the LOGINREC's remote password
  75.        buffer.  (The remote password buffer is  255  bytes  long.   Each
  76.        password's  entry  in the buffer consists of the password itself,
  77.        the associated server name, and two extra bytes.)
  78.  
  79.   SEE ALSO:
  80.        dblogin,  dbopen,  dbrpwclr,  DBSETLAPP,  DBSETLHOST,  DBSETLPWD,
  81.        DBSETLUSER
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.