ddlUsers() - users report

ddlUsers() - users report

Prototype:

   void ddlUsers(
      CONTROL *ctl,
      char *OptnStr,
      char *ArgList);

Permitted values in OptnStr: NA

Form of ArgList:
       Form 1: [<user-number>]
       Form 2: <DB-path-name> [<user-number>]
             <user-number> represents a specific user to be reported;
                   if <user-number> is not present, all active users are reported;
             <DB-path-name> represents the full path name of a database whose users are to be reported;

             Form1 applies to the current open data base.
             Form2 applies to an arbitrary data base.

Description:

Display a list of the current users of a database.
If ArgList is null, ddlUsers() produces a full USERS report. If ArgList contains an integer user number n, ddlUsers() produces a USERS report only for user n; in this case, Ans3Str[] contains the image of the USERS report detail line.

For each active user, or for a specified user, the Users' Report contains these fields:

usn	The user number assigned when the user opened the database. A user's usn is the value returned by ddlOpen() in Ctl.Ans1. The usn may be followed immediately by an additional flag character; the possible flag characters are: '*' - this user; '+' - attached;
node	Node type.
Time on	Date and time this user opened the database.
Last	Date and time of this users last activity.
Station	The station identification; this is the value of the environment variable COMPUTERNAME. This variable is created automatically by the Windows operating system.
Login	This users login name.