Differences between ViewUserSearch not ViewUserQuery in a Module in the Portal

Products

• CA Identity Manager

Issue/Introduction

When are trying to get a list of all users with a specific value in Identity Portal.
We have several user accounts in IDM that have the same email address and when attempting to search for all users with a specific email address it stops and only displays one user. 

Environment

Identity Portal: 14.4, 14.5

Cause

This is due to using the incorrect soap method.  When calling the IDM task ViewUserQuery only a single user is returned. 

Resolution

Change to utilize ViewUserSearch instead, this will return a full list of users with the specified, for example, a search for 'joe' will return 
Login ID = joe
Login ID = joe2
Login ID = sue (who has an email address of '[email protected]' )