$Session List: Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
No edit summary |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
<span class="pageSubtitle">Get list of sessions</span> | <span class="pageSubtitle">Get list of sessions</span> | ||
<p class="warn"><b>Note: </b> | <p class="warn"><b>Note:</b> Many $functions have been deprecated in favor of Object Oriented methods. But there is no OO equivalent for the $Session_List function.</p> | ||
<var>$Session_List</var> returns information about [[Sessions|sessions]] to a $list, accepts three arguments and returns a the number of items added to the output $list. All errors result in request cancellation. | <var>$Session_List</var> returns information about [[Sessions|sessions]] to a $list, accepts three arguments and returns a the number of items added to the output $list. All errors result in request cancellation. | ||
| Line 18: | Line 18: | ||
<tr><th>sesid</th> | <tr><th>sesid</th> | ||
<td>The identifier of the session for which information is to be returned. This argument can contain wildcards & | <td>The identifier of the session for which information is to be returned. This argument can contain wildcards — for example <code>PEQ*</code> indicates that information is to be returned for all sessions beginning with the letters "PEQ". | ||
<p> | <p> | ||
This is an optional argument and defaults to asterisk (<tt>*</tt>), which means all session IDs are to be listed. </p> | This is an optional argument and defaults to asterisk (<tt>*</tt>), which means all session IDs are to be listed. </p> | ||
| Line 30: | Line 30: | ||
===Output format=== | ===Output format=== | ||
The format of the data in the output $list is | The format of the data in the output $list is: | ||
<table class=" | <table class="thJustBold"> | ||
<tr><th>Col 1-10</th> | <tr><th>Col 1-10</th> | ||
<td>Owner of the session; * for public sessions.</td></tr> | <td>Owner of the session; <code>*</code> for public sessions.</td></tr> | ||
<tr><th>Col 11-16</th> | <tr><th>Col 11-16</th> | ||
| Line 49: | Line 48: | ||
<tr><th>Col 51-</th> | <tr><th>Col 51-</th> | ||
<td>The session | <td>The session ID.</td></tr> | ||
</table> | </table> | ||
| Line 55: | Line 54: | ||
<ul> | <ul> | ||
<li>The session ID and owner specified in the second and third arguments can be explicit names or can contain the following wildcard characters: | <li>The session ID and owner specified in the second and third arguments can be explicit names or can contain the following wildcard characters: | ||
<table class=" | <table class="thJustBold"> | ||
<tr><th>*</th> | <tr><th>*</th> | ||
<td>Matches any number of characters including none</td></tr> | <td>Matches any number of characters including none</td></tr> | ||
<tr><th>?</th> | <tr><th>?</th> | ||
<td>Matches any single character</td></tr> | <td>Matches any single character</td></tr> | ||
<tr><th>"</th> | <tr><th>"</th> | ||
<td>Indicates that the next character must be treated literally even if it is a wildcard character. | <td>Indicates that the next character must be treated literally even if it is a wildcard character. | ||
</td></tr></table> | </td></tr> | ||
For example | </table> | ||
For example: | |||
<ul> | |||
<li><code>C*D</code> matches "CUSTID", "COD", or "CLOD". </li> | |||
<li><code>S??T</code> matches "SALT", "SLOT", or "SORT". </li> | |||
<li><code>"*</code> matches "*" (that is, public sessions, in the case of the owner).</li> | |||
</ul></li> | |||
</ul> | </ul> | ||
| Line 77: | Line 86: | ||
<li>[[List of $functions|Sirius functions]]</li> | <li>[[List of $functions|Sirius functions]]</li> | ||
<li>[[Fast/Unload User Language Interface]]</li> | <li>[[Fast/Unload User Language Interface]]</li> | ||
<li>[[Media:JoclrNew.pdf|Janus Open Client]</li> | <li>[[Media:JoclrNew.pdf|Janus Open Client]]</li> | ||
<li>[ | <li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li> | ||
<li>[[Janus Sockets]]</li> | <li>[[Janus Sockets]]</li> | ||
<li>[[Janus Web Server]]</li> | <li>[[Janus Web Server]]</li> | ||
<li>Japanese functions</li> | <li>Japanese functions</li> | ||
<li>[ | <li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li> | ||
</ul> | </ul> | ||
[[Category:$Functions|$Session_List]] | [[Category:$Functions|$Session_List]] | ||
Latest revision as of 21:56, 7 December 2021
Get list of sessions
Note: Many $functions have been deprecated in favor of Object Oriented methods. But there is no OO equivalent for the $Session_List function.
$Session_List returns information about sessions to a $list, accepts three arguments and returns a the number of items added to the output $list. All errors result in request cancellation.
Syntax
%rc = $Session_List(listid, [sesid], [owner])
| %rc | A numeric variable that is set to the number of added items. |
|---|---|
| listid | The identifier of the $list to receive the output from $Session_List. This is a required argument. |
| sesid | The identifier of the session for which information is to be returned. This argument can contain wildcards — for example PEQ* indicates that information is to be returned for all sessions beginning with the letters "PEQ".
This is an optional argument and defaults to asterisk (*), which means all session IDs are to be listed. |
| owner | The userid that owns the session for which information is to be returned. This argument can contain wildcards, though for a non-system manager user, only sessions owned by the requesting user and public sessions will be listed. Note that an asterisk (*) value will list all private and public sessions, but a double-quote asterisk ("*) will list public sessions only.
This is an optional argument and defaults to the userid of the invoking user. |
Output format
The format of the data in the output $list is:
| Col 1-10 | Owner of the session; * for public sessions. |
|---|---|
| Col 11-16 | Session timeout value. |
| Col 17-30 | Session creation time in YYYYMMDDHHMISS format. |
| Col 31-44 | Last session access time in YYYYMMDDHHMISS format. If the session is currently open this value is the time of the $Session_List invocation and will have the same value for all sessions open at the time of the $Session_List call. |
| Col 45-50 | User number with session open. If the session is not currently open by any users these columns contain all blanks. |
| Col 51- | The session ID. |
Usage notes
- The session ID and owner specified in the second and third arguments can be explicit names or can contain the following wildcard characters:
* Matches any number of characters including none ? Matches any single character " Indicates that the next character must be treated literally even if it is a wildcard character. For example:
C*Dmatches "CUSTID", "COD", or "CLOD".S??Tmatches "SALT", "SLOT", or "SORT"."*matches "*" (that is, public sessions, in the case of the owner).
Example
The following example displays information about all sessions owned by the current user:
%list = $ListNew %rc = $Session_List(%list) %rc = $List_Print(%list)