--- loncom/enrollment/localenroll.pm	2015/05/30 18:01:12	1.52
+++ loncom/enrollment/localenroll.pm	2015/08/05 18:47:17	1.53
@@ -1,6 +1,6 @@
 # functions to glue school database system into Lon-CAPA for 
 # automated enrollment
-# $Id: localenroll.pm,v 1.52 2015/05/30 18:01:12 raeburn Exp $
+# $Id: localenroll.pm,v 1.53 2015/08/05 18:47:17 raeburn Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -935,6 +935,47 @@ sub get_userinfo {
     return $outcome;
 }
 
+=pod
+
+=item get_multusersinfo
+
+ (a) $dom - domain
+ (b) $type - username or id
+ (c) $unamenames - reference to hash containing usernames of users
+ (d) $instusers - reference to hash which will contain info for user
+                 as key = value; keys will be one or all of:
+                 lastname,firstname,middlename,generation,id,inststatus -
+                 institutional status (e.g., faculty,staff,student)
+                 Values are all scalars except inststatus,
+                 which is an array.
+ (e) $instids - reference to hash which will contain ID numbers -
+                 keys will be unique IDs (student or faculty/staff ID)
+                 values will be either: scalar (username) or an array
+                 if a single ID matches multiple usernames.
+
+ returns 1 parameter - 'ok' if no processing error, or other value
+                       if an error occurred.
+
+ side effects - populates the $instusers and $instids refs to hashes.
+                with information for specified username, or specified
+                id, if fifth argument provided, from all available, or
+                specified (e.g., faculty only) institutional datafeeds,
+                if sixth argument provided.
+
+ WARNING: You need to set $outcome to 'ok' once you have customized
+          this routine to communicate with an instititional
+          directory data source, otherwise retrieval of institutional
+          user information will always be reported as being unavailable
+          in domain $dom.
+
+=cut
+
+sub get_multusersinfo {
+    my ($dom,$type,$usernames,$instusers,$instids) = @_;
+    my $outcome = 'unavailable'; 
+    return $outcome;
+}
+
 =pod
 
 =item inst_usertypes()