Index

DKUserMgmtDL

Purpose:

This class represents and processes datastore user management functions.

An instance of DKUserMgmtDL is created as part of a chain of instantiations when you create an instance of DKDatastoreDL. Use the userManagement() function of DKDatastoreAdminDL to get the DKUserMgmtDL instance. The following example illustrates getting the instance:

     DKDatastoreDL dsDL;
     DKDatastoreDefDL* dsDef = 0;
     DKDatastoreAdminDL* dsAdmin = 0;
     DKUserMgmtDL* userMgmt = 0;
      .... /* Connect to the datastore   */
     dsDef = (DKDatastoreDefDL*)dsDL.datastoreDef();
     dsAdmin = (DKDatastoreAdminDL*)dsDef->datastoreAdmin();
     userMgmt = (DKUserMgmtDL*)dsAdmin->userManagement();

Class summary:

class DKUserMgmtDL : public dkUserManagement
{
public:
   DKUserMgmtDL (dkDatastore* ds);
   virtual ~DKUserMgmtDL ();
 
   virtual void addUser (const char* userId,
                         const char* password);
   virtual void addUser (const char* userId,
                         const char* password,
                         dkProfile* profile);
   virtual void changePassword (const char* userId,
                                const char* oldPwd,
                                const char* newPwd);
   virtual void delUser (const char* userId);
   virtual DKString* listUsers (long& arraySize);
   virtual DKString* listUserGroups (long& arraySize);
   virtual void addUserGroup (const char* groupName);
   virtual void addUserGroup (const char* groupName,
                              dkProfile* groupProfile);
   virtual void delUserGroup (const char* userGrp);
   virtual void addToGroup (const char* group,
                            const char* userid);
   virtual void removeFromGroup (const char* group,
                                 const char* userid);
};

Members:

Constructors and destructor
   DKUserMgmtDL (dkDatastore* ds);
   virtual ~DKUserMgmtDL ();
 

Member functions

addUser
The first form creates a new user ID with default information . The second form creates a new user ID according to a given profile. The profile contains datastore specific information about the user.
   virtual void addUser (const char* userId,
                         const char* password);
   virtual void addUser (const char* userId,
                         const char* password,
                         dkProfile* profile);
 

changePassword
Changes the password of a given user ID.
   virtual void changePassword (const char* userId,
                                const char* oldPwd,
                                const char* newPwd);
 

delUser
Deletes a user ID from the system.
   virtual void delUser (const char* userId);
 

listUsers
Lists users defined in the system.
   virtual DKString* listUsers (long& arraySize);
 

listUserGroups
Lists user groups defined in the system.
   virtual DKString* listUserGroups (long& arraySize);
 

addUserGroup
The first form creates a new user group with default information. The second form creates a new user group according to a given profile The profile contains datastore specific information about the user group. It may include a privilege set or other relevant information.
   virtual void addUserGroup (const char* groupName);
   virtual void addUserGroup (const char* groupName,
                              dkProfile* groupProfile);
 

delUserGroup
Deletes a user group from the system.
   virtual void delUserGroup (const char* userGrp);
 

addToGroup
Adds a user to a user group.
   virtual void addToGroup (const char* group,
                            const char* userid);
 

removeFromGroup
Removes a user from a user group.
   virtual void removeFromGroup (const char* group,
                                 const char* userid);
 

(c) Copyright International Business Machines Corporation 1996, 2003. IBM Corp. All rights reserved.