To get an explanation of a message thrown by your program after the fact, you can run the splain program.

To get your program to emit more useful messages in the first place, simply insert use diagnostics; at the top.

You can always read the message explanations on line, in perldiag.