$Session Close: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
Line 7: Line 7:


==Syntax==
==Syntax==
<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Session_Close</span>(<span class="term">sesid, owner, timeout)
<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Session_Close</span>(<span class="term">sesid</span>, <span class="term">owner</span>, timeout)
</p>
</p>



Revision as of 20:54, 12 April 2013

Close an open session

Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $Session_Close function is to be entered.

$Session_Close closes an open session, accepts three arguments and returns a zero, indicating success, or a number indicating the cause of error, if there is one.

Syntax

%rc = $Session_Close(sesid, owner, timeout)

Syntax terms


%rc A numeric value set to 0 or to an error indicator. See "Status codes".
sesid A new ID to be given to the session being closed. This is an optional argument which if not specified leaves the session's ID unchanged.
owner The userid that is to be set as the new owner of the session being closed. An owner value of * means that the session is public, that is available to all users. Only a system administrator can create a non-public session for a user other than itself.

This is an optional argument which if not specified leaves the session's owner unchanged.

timeout The new value to be used as the session timeout value, that is the time after which the session is considered timed-out, that is eligible for deletion. A value of -1 means to use the SRSDEFTO parameter value.

This is an optional argument; if it is not specified, there is no change to the session's timeout value.

Status codes

-1 — Session not open  0 — No errors  1 — Session id already exists for user  2 — Online session limit exceeded  3 — User session limit exceeded

The status codes greater than 0 can only happen when one or more of the session attributes (sesid, owner, timeout) is being changed.

Usage notes