.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>shsql: identity</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="shsql_home.html">
<img src="img/shsql.gif" border=0><br><small>SQL database system</a> &nbsp; </td></tr>
<td>
.>>

.TH identity TDH "18-MAR-2004   TDH scg@jax.org" 

.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
.ig >>
<a href="recordlocking.html">
.>>
\0record locking.
.ig >>
</a>
.>>
Otherwise it is not required.
\fCIDENTITY\fR is also useful, but not required, for showing user identity in the
.ig >>
<a href="logs.html">
.>>
\0database transaction logs and error logs.
.ig >>
</a>
.>>
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

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="shsql_home.html">
<img src="img/shsql.gif" border=0></a><br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp;
</td></tr>
</table>
.>>

