home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbsetlhost.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.7 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               DBSETLHOST
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBSETLHOST
  6.  
  7.   FUNCTION:
  8.        Set the host name in the LOGINREC structure.
  9.  
  10.   SYNTAX:
  11.        RETCODE DBSETLHOST(loginrec, hostname)
  12.  
  13.        LOGINREC  *loginrec;
  14.        char      *hostname;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBSETLHOST              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This macro sets the host name in the LOGINREC structure. For it
  28.          to have any effect, it must be called before dbopen().
  29.  
  30.        o The host name will show up in the  sysprocesses  table  in  the
  31.          master database.
  32.  
  33.        o It is not necessary to call this routine.  If it is not called,
  34.          DB-Library  will set the default value for the host name.  This
  35.          default value will generally be a version of the host machine's
  36.          name provided by the operating system.
  37.  
  38.  
  39.   PARAMETERS:
  40.        loginrec -  A pointer to a  LOGINREC  structure,  which  will  be
  41.            passed  as  an argument to dbopen().  You can get one by cal-
  42.            ling dblogin().
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               DBSETLHOST
  47.   ______________________________________________________________________
  48.        hostname -  The host name that will be  sent  to  SQL Server.  It
  49.            must  be  a  null-terminated  character  string.  The maximum
  50.            length of the string, not including the null  terminator,  is
  51.            30 characters.
  52.  
  53.   RETURNS:
  54.        SUCCEED or FAIL.
  55.  
  56.   SEE ALSO:
  57.        dblogin, dbopen, DBSETLAPP, DBSETLPWD, DBSETLUSER
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.