Difference between revisions of "Category:Service Procedures"

From MidrangeWiki
Jump to: navigation, search
(Justification)
(Justification)
Line 14: Line 14:
 
<pre>
 
<pre>
 
if %subst(%trimr(myLongString):%len(%trimr(myLongString))-4+1:4) = 'TEMP';
 
if %subst(%trimr(myLongString):%len(%trimr(myLongString))-4+1:4) = 'TEMP';
// do something
+
  // do something
 
endif;
 
endif;
 
</pre>
 
</pre>
Line 20: Line 20:
 
<pre>
 
<pre>
 
if GenUtl_SuffixString(myLongString:4) = 'TEMP';
 
if GenUtl_SuffixString(myLongString:4) = 'TEMP';
// do something
+
  // do something
 
endif;
 
endif;
 
</pre>
 
</pre>
 
It is the opinion of many that the second form is more readable and is self-documenting.  Hence, the reason for some of these very small service procedures.
 
It is the opinion of many that the second form is more readable and is self-documenting.  Hence, the reason for some of these very small service procedures.

Revision as of 21:19, 12 December 2018

Summary

Service Procedures are the smallest (and only) executable part of a service program. This category contains sample service procedures.

This article is a stub. You can help by editing it.


Justification

There are excellent reasons for having service procedures—such as shareability and standardization of business rules. However, some service procedures (minus their error checking) are so small that one might question creating a service procedure at all. They might feel that simply employing the stripped-down code directly within their program code is the best way to go (saving the necessity of calling a separate routine—with the additional overhead that such action would require).

Rule of Thumb
Sometimes, having a service procedure is simply a means of making code more self-documenting (i.e., easier for others to understand).

To wit... Which would you rather see in an RPG program—this?

if %subst(%trimr(myLongString):%len(%trimr(myLongString))-4+1:4) = 'TEMP';
  // do something
endif;

...or, this?

if GenUtl_SuffixString(myLongString:4) = 'TEMP';
  // do something
endif;

It is the opinion of many that the second form is more readable and is self-documenting. Hence, the reason for some of these very small service procedures.