Fixes #3697: Prevent bleeding of cppflags in opal_check_pmi

---svn-pre-commit-ignore-below---

r27944 [[BR]]
Remove the only place where PMI was used outside a component, and relocate that code to common/pmi.


r28940 [[BR]]
Fixes #3486 - prevent opal_check_pmi from bleeding CPPFLAGS


r28941 [[BR]]
Refs #3697 - use the opal_pmi_error function instead of ompi_error as the returned error codes are from PMI


r28947 [[BR]]
Need to include module-level CPPFLAGS so it can build