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.
%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 |
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.
The format of the data in the output $list is:
|Col 1-10||Owner of the session; |
|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.|
- 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.
C*Dmatches "CUSTID", "COD", or "CLOD".
S??Tmatches "SALT", "SLOT", or "SORT".
"*matches "*" (that is, public sessions, in the case of the owner).
The following example displays information about all sessions owned by the current user:
%list = $ListNew %rc = $Session_List(%list) %rc = $List_Print(%list)