Close an open session
Note: Many $functions have been deprecated in favor of Object Oriented methods. There is no direct OO equivalent for the $Session_Close function.
$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.
%rc = $Session_Close([sesid], [owner], [timeout])
|%rc||A numeric value set to 0 or to an error indicator. See Status codes, below.|
|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 |
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.
-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.
- After a $Session_Close, any session $lists, longstrings and XMLDocs will no longer be accessible.
- If a $Session_Delete had been done for the session before it was closed by the user who had the session open or someone else, the session is immediately deleted when the $Session_Close is done. A logout always does an implied $Session_Close, so $Session_Close is only necessary if another session is to be open or to minimize the time window in which the session might be requested by another thread.
The following example closes the current session, making it a public session in the process:
%rc = $Session_Close(, '*')