Set the user name in the LOGINREC structure.
RETCODE DBSETLUSER(loginrec, username) LOGINREC *loginrec; char *username;
A pointer to a LOGINREC structure, which will be passed as an argument to dbopen. You can allocate a LOGINREC structure by calling dblogin.
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.
SUCCEED or FAIL.
This macro sets the user name in the LOGINREC structure. For it to have any effect, it must be called before dbopen.
In most environments, this macro is optional. If it is not called, DB-Library will generally set the default value for the user name.
On 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.