[FLINK-1209] & [FLINK-1250] Fixes for error messages and config keys

[FLINK-1209] Improve error messages when forgetting to close an iteration
[FLINK-1250] Correct and document config keys for heartbeat intervals and timeouts