DBSETLUSER

Description

Set the user name in the LOGINREC structure.

Syntax

RETCODE DBSETLUSER(loginrec, username)
 
LOGINREC     *loginrec;
char                *username;

Parameters

loginrec

A pointer to a LOGINREC structure, which will be passed as an argument to dbopen. You can allocate a LOGINREC structure by calling dblogin.

username

The user name that will be sent to the server. It must be a null-terminated character string. The maximum length of the string, not including the null terminator, is 30 characters. The server will use username to determine who is attempting the connection. The server usernames are defined in the syslogins table in the master database.

Returns

SUCCEED or FAIL.

Usage

NoteOn UNIX: the user name defaults to the UNIX login name.

On MPE/XL: The user name defaults to the value of the system environment variable HPUSER.

See also

dblogin, dbopen, DBSETLHOST, DBSETLPWD, DBSETLAPP