WL#3051: Improve handling of connections in mysqltest

Extend 'mysqltest' to make testing of multiple connections and connection
authorization easier. This includes adding support for detecting (and recovering
from) connect failures and adding connection information to the .result file.
This was originally part of WL#1165.