$Session List: 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> = $Session_List(listid, sesid, owner)
<p class="syntax"><span class="term">%rc</span> = <span class="literal">$Session_List</span>(<span class="term">listid, sesid, owner)
</p>
</p>



Revision as of 19:56, 12 April 2013

Get list of sessions

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

$Session_Create 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 is set to the number of added items.

The first argument is the $list identifier to receive the output from $Session_List. This is a required argument.

The second argument is the session id 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 "*" meaning all session ids are to be listed.

The third argument is the session owner 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 a "*" will list all private and public sessions but a ""*" 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*D matches "CUSTID", "COD" or "CLOD". S??T matches "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)


Products authorizing $Session_List