Node:Session Information, 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;
              )

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.