home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbsetlapp.man < prev    next >
Encoding:
Text File  |  1993-06-23  |  1.7 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                DBSETLAPP
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBSETLAPP
  6.  
  7.   FUNCTION:
  8.        Set the application name in the LOGINREC structure.
  9.  
  10.   SYNTAX:
  11.        RETCODE DBSETLAPP(loginrec, application)
  12.  
  13.        LOGINREC  *loginrec;
  14.        char      *application;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBSETLAPP               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This macro sets the application field in  the  LOGINREC  struc-
  28.          ture.  For it to have any effect, it must be called before dbo-
  29.          pen().
  30.          
  31.        o It is not necessary to call  this  routine.   By  default,  the
  32.          application  name  will be a null value.
  33.  
  34.        o SQL Server uses the application name in its sysprocesses  table
  35.          to help identify your process. If you set the application name,
  36.          you will see it if you query the sysprocesses table in the mas-
  37.          ter database.
  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.        application -   The  application  name  that  will  be  sent   to
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                DBSETLAPP
  47.   ______________________________________________________________________
  48.            SQL Server.  It must be a null-terminated  character  string.
  49.            The maximum length of the string, not including the null ter-
  50.            minator, is 30 characters.
  51.  
  52.   RETURNS:
  53.        SUCCEED or FAIL.
  54.  
  55.   SEE ALSO:
  56.        dblogin, dbopen, DBSETLHOST, DBSETLPWD, DBSETLUSER
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.