Node:Session Information, Next:, Previous:Who Information, Up:LysKOM Data Types



Session Information


        Session-Info ::=
              ( person                  :       Pers-No;
                working-conference      :       Conf-No;
                session                 :       Session-No;
                what-am-i-doing         :       HOLLERITH;
                username                :       HOLLERITH;
                idle-time               :       INT32;
                connection-time         :       Time;
              )

        Session-Info-Ident ::=
              ( person                  :       Pers-No;
                working-conference      :       Conf-No;
                session                 :       Session-No;
                what-am-i-doing         :       HOLLERITH;
                username                :       HOLLERITH;
                hostname                :       HOLLERITH;
                ident-user              :       HOLLERITH;
                idle-time               :       INT32;
                connection-time         :       Time;
              )


        Static-Session-Info ::=
              (
                username                : HOLLERITH;
                hostname                : HOLLERITH;
                ident-user              : HOLLERITH;
                connection-time         : Time;
              )


        Session-Flags ::= BITSTRING
              ( invisible;
                user-active-used;
                user-absent;
                reserved3;
                reserved4;
                reserved5;
                reserved6;
                reserved7;
              )


        Dynamic-Session-Info ::=
              ( session                 :       Session-No;
                person                  :       Pers-No;
                working-conference      :       Conf-No;
                idle-time               :       INT32;
                flags                   :       Session-Flags;
                what-am-i-doing         :       HOLLERITH;
              )


        Scheduling-Info ::=
              ( priority                : INT16;
                weight                  : INT16;
              )

These data types give information about a particular LysKOM session. The types Session-Info and Session-Info-Ident have been superseded by Static-Session-Info and Dynamic-Session-Info. The static session info represents information about a session that does not change during the lifetime of the session. Therefore static session infos can be aggressively cached by the client.

The fields of Session-Info are

person
The person using this session.
working-conference
The conference the session is currently in.
session
The number of this session.
what-am-i-doing
A client-supplied string saying what the person is currently doing.
username
The name of the "real" user (see Who-Info above.)
idle-time
The number of seconds since user-active was used by this session, or since the session was created if user-active has not been used yet. See also user-active-used below.
connection-time
The time when the connection was initiated. This is not the same as the amount of time the person has been on.

The fields of Session-Info-Ident are

person
The person using this session.
working-conference
The conference the session is currently in.
session
The number of this session.
what-am-i-doing
A client-supplied string saying what the person is currently doing.
username
The name of the "real" user (see Who-Info-Ident above.)
hostname
The host the connection originated at.
ident-user
The user name according to the Ident dæmon at the user's machine or "unknown" if Ident was not used.
idle-time
The number of seconds since user-active was used by this session, or since the session was created if user-active has not been used yet. See also user-active-used below.
connection-time
The time when the connection was initiated. This is not the same as the amount of time the person has been on.

The fields of Static-Session-Info are

username
The name of the "real" user (see Who-Info-Ident above.)
hostname
The host the connection originated at.
ident-user
The user name according to the Ident dæmon at the user's machine or "unknown" if Ident was not used.
connection-time
The time when the connection was initiated. This is not the same as the amount of time the person has been on.

The bits in Session-Flags are:

invisible
When true, the user requested an invisible session (see login). Sessions where no-one is logged in also have the invisible flag set.
user-active-used
When true, the user-active call has been issued by the session, which in turn means that idle-time fields of Dynamic-Session-Info, Session-Info and Session-Info-Ident are valid. When false, the idle-time fields contains the number of seconds since the session was created.
user-absent
This flag is currently not used.

The fields of a Dynamic-Session-Info are

session
The session number of the session.
person
The person currently logged on, or zero if the session has not yet logged on.
working-conference
The conference the session is currently in.
idle-time
The number of seconds since user-active was used by this session, or since the session was created if user-active has not been used yet. See also user-active-used above.
flags
The dynamic session flags (see above.)
what-am-i-doing
What the client is doing. This string is set by the client.

The Scheduling-Info type determines how the resources are shared between different sessions1. See get-scheduling and set-scheduling for more information. It contains these fields:

priority
Clients with a numerically lower priority value will have priority over other clients. A client with priority set to 0 can totally starve clients with priority set to 1, 2 or anything higher.
weight
Within a priority class, the resources are shared in proportion to the weight value. If one client has a weight of 200 and another of 50, the first client will get roughly four times as much work done (assuming that the server is the limiting factor).

Footnotes

  1. RFC 2782 (DNS SRV) provided inspiration when the Scheduling-Info structure was defined.