$Session Delete: Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
m (misc cleanup) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 2: | Line 2: | ||
<span class="pageSubtitle">Delete a session</span> | <span class="pageSubtitle">Delete a session</span> | ||
<p class="warn"><b>Note: </b> | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The O-O equivalent of $Session_Delete is the <var>[[Global_and_session_objects#Using_system_class_methods_to_access_global_and_session_objects|DiscardSession]]</var> shared method.</p> | ||
<var>$Session_Delete</var> deletes a [[Sessions|session]]. | <var>$Session_Delete</var> deletes a [[Sessions|session]]. | ||
| Line 11: | Line 11: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table | <table> | ||
<tr><th>%rc</th> | <tr><th>%rc</th> | ||
<td>A numeric variable that is set to 0, indicating success, or to a numeric error indicator: | <td>A numeric variable that is set to 0, indicating success, or to a numeric error indicator: | ||
| Line 35: | Line 35: | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li>A return code of 2 indicates that while the session | <li>A return code of 2 indicates that while the session has not been deleted, it will be as soon as it is closed. In fact, this would be the normal return code when deleting the current session — the session actually being deleted when it is closed or the user logs off. | ||
</ul> | </ul> | ||
| Line 54: | Line 54: | ||
<li>[[Janus Web Server]]</li> | <li>[[Janus Web Server]]</li> | ||
<li>Japanese functions</li> | <li>Japanese functions</li> | ||
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]</li> | <li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
[[Category:$Functions|$Session_Delete]] | [[Category:$Functions|$Session_Delete]] | ||
Latest revision as of 22:24, 6 October 2015
Delete a session
Note: Many $functions have been deprecated in favor of Object Oriented methods. The O-O equivalent of $Session_Delete is the DiscardSession shared method.
$Session_Delete deletes a session.
Syntax
%rc = $Session_Delete(sesid, [owner], [timeout])
Syntax terms
| %rc | A numeric variable that is set to 0, indicating success, or to a numeric error indicator:
0 - No errors 1 - Session not found 2 - Session in use |
|---|---|
| sesid | The ID of the session to be deleted. This is a required argument. |
| owner | The userid that owns the session to be deleted. An owner value of asterisk (*) means that the session is public, that is available to all users.
This optional argument defaults to the creating user's userid. |
| timeout | The time to wait for an in-use session to be closed to perform a synchronous delete. If timeout is 0, or the session being deleted is the session currently opened by the invoking user, or the session is not closed within the indicated timeout time, the session is deleted asynchronously when the session is closed.
This argument defaults to 0, which means that if the session is in-use, it is deleted asynchronously. |
Usage notes
- A return code of 2 indicates that while the session has not been deleted, it will be as soon as it is closed. In fact, this would be the normal return code when deleting the current session — the session actually being deleted when it is closed or the user logs off.
Example
The following example deletes the current session no matter what its ID:
%sesid = $Session_Id %rc = $Session_Delete(%sesid) %rc = $Session_Close