JBEE-127 - additional updates to the JCA 1.7 API and JavaDoc