DERBY-5630; intermittent test failure in store/lockTableVTI.sql fixing up javadoc, some comments, adjusting some exception class thrown