#set TITLE = "identity"
#include top

.SH IDENTITY
\fCIDENTITY\fR is a \fBshsql\fR SQL command extension that allows a user identity 
to be supplied.
Since \fBshsql\fR doesn't use logins or passwords, this command provides a way of 
associating a process with a unique user or session.  
Only one \fCIDENTITY\fR should be supplied for any given process.
Typically \fCIDENTITY\fR is set by the middleware.
.LP
Identity can be represented by any character string.
A login name, REMOTE_HOST, or other unique session identifier work well.
.LP
\fCIDENTITY\fR \fBmust\fR be used if a process will access a table that uses
#set FILE = "recordlocking.html"
#set TAG = "record locking."
#include link
Otherwise it is not required.
\fCIDENTITY\fR is also useful, but not required, for showing user identity in the
#set FILE = "logs.html"
#set TAG = "database transaction logs and error logs."
#include link
If it is used, the \fCIDENTITY\fR command should be issued before any SQL 
commands that update the database.
Identity is in effect during the current process only.
.LP
Usage: \fCIDENTITY  \fItag\fR
.LP
Example: \fCidentity  "steve"\fR

#include bottom

