#include <cat/cat.h>
int catear_dbmap(catpac_ear *ep, const char *givenuser, const char *givenpsw, const char *givendbid, char **newuser, char **newpsw, char **newdbid);
If a service is not expecting one of the parameters shown above in the UAR
data and so does not want user mapping, the
newuser, newpsw, and newdbid parameter(s)
can all be NULL.
The function returns zero if successful, which means that all non NULL return parameters have been assigned a value. The caller is responsible for freeing the new* parameters.