RE: Sub procedure end specification

To: rpg400-l@xxxxxxxxxxxx
Subject: Re: Sub procedure end specification
From: BMartin@xxxxxxxxxxxx
Date: Thu, 28 May 2009 08:10:03 -0400

David,
It seems that you have allowed your coding principals to be compromised.
Sure, you forget from time to time to change the name in the ending spec
when you copy from another procedure. I do this as well. But what you
should remember is that its still better coding practice to specify the
name of the procedure you are ending than to leave it blank. This also
goes for putting the names of your parameters in your procedure interface.
They don't mean a thing, except for someone trying to maintain the code.
I put my prototypes in copybooks, so having the names of the parameters in
the PI is a big help. Don't give up on the good fight. Keep your coding
principals, guard them. Once you start to make concessions, its all
downhill.




Thanks
Bryce Martin
Programmer/Analyst I
Ext. 4777



David FOXWELL <David.FOXWELL@xxxxxxxxx>
Sent by: rpg400-l-bounces@xxxxxxxxxxxx
05/28/2009 03:13 AM
Please respond to
RPG programming on the IBM i / System i <rpg400-l@xxxxxxxxxxxx>


To
RPG programming on the IBM i / System i <rpg400-l@xxxxxxxxxxxx>
cc

Subject
Sub procedure end specification






I used to suggest to my colleagues that they systematically put the name
of a sub procedure in the end specification instead of :

D E

Our prototypes our declared in the source of the module. When searching
for the name of a sub procedure in the source, you get a hit in a comment
line before the prototype, the PR declaration, the comment before the sub
procedure, the B declaration, the PI declaration, the call to the
subprocedure and maybe other comments, but : never in the end of the
subprocedure even though the subprocedure might be pages and pages of
code.

Well, this still hasn't caught on. So I've decided, if you can't beat'em,
join'em and I no longer put the name of the subprocedure in the end spec.
It makes for quicker compiling, as I always copy another sub procedure and
forget to change the name at the end spec.

My reasoning that the end spec name isn't necessary : if I can't see the
start spec on the same page (ok 2 pages for greenscreeners), then my sub
procedure is probably too dang long!!!!


--
This is the RPG programming on the IBM i / System i (RPG400-L) mailing
list
To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.



--- This message (including any attachments) is intended only for the use of the individual or entity to which it is addressed and may contain information that is non-public, proprietary, privileged, confidential, and exempt from disclosure under applicable law. If you are not the intended recipient, you are hereby notified that any use, dissemination, distribution, or copying of this communication is strictly prohibited. If you have received this communication in error, please notify us and destroy this message immediately. ---
--
This is the RPG programming on the IBM i / System i (RPG400-L) mailing list
To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.