To me, this message is "self-documenting"
IGD101I SMS ALLOCATED TO DDNAME (FVROUT3 )
DSN (VAT.ALL.VA520R )
STORCLAS (TESTSC) MGMTCLAS ( ) DATACLAS (DEFAULT)
VOL SER NOS= TEST07
But it is still included and described in a message manual.
I don't quite understand Tom's passion in his posts, but I agree with his
point. Many programmers want to look up messages and try to understand what
errors they have encountered - they are eager to learn new things, avoid
pitfalls, etc., but they are stunned to learn that the error messages for
the tool they use most often are not in a message manual.
And in my humble but worthless opinion, the example you created below would
not be a waste of time at all, and would save time a lot of time. I've had
programmers ask me if they needed to worry about that message (it ends in a
W, after all).
Greg Shirey
Ben E. Keith Company
-----Original Message-----
From: IBM Mainframe Discussion List [mailto:[EMAIL PROTECTED]
Behalf Of David Andrews
Sent: Thursday, June 23, 2005 9:16 AM
<snip>
It is reasonable for the compiler developers to assume some level of
competence on the user's part; COBOL isn't a 4GL after all. And it
would be IMO a waste of time to have a tech writer produce something
like:
IGYOP3091-W Code from <source code 1> to <source code 2>
can never be executed and was therefore discarded
Explanation: The compiler detected that some of the program
code could never be branched to. Rather than
produce object code that would only take up space
and never be executed, the compiler skipped the
unexecutable program source code.
In the message, <source code 1> is the first of
the source code that has been skipped, and <source
code 2> marks the end of code that was skipped.
Programmer response: Examine the program listing and determine
whether the code is intended to be executed.
Source programs are line-numbered in the program
listing, and the compiler error message includes
the source program line number near which
<source code 1> can be found.
<snip>
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [EMAIL PROTECTED] with the message: GET IBM-MAIN INFO
Search the archives at http://bama.ua.edu/archives/ibm-main.html
