Difference between revisions of "Slash COPY"

From MidrangeWiki
Jump to: navigation, search
Line 21: Line 21:
 
...code here...
 
...code here...
 
/ENDIF
 
/ENDIF
 +
...anything here is included regardless...
 
</pre>
 
</pre>
  

Revision as of 22:29, 6 December 2018

/copy members are a way to include other source members in a RPG program.

They are quite often used to pull in external descriptions, such as Procedures or Data Structures.

The syntax for a /copy is:

/COPY [[<library>/]<source file>,]<member>

If the library isn't specified, then the library list will be searched.

If the source file isn't specified, then the source file the program is being compiled from will be used.

Often /IF, /DEFINE, and /ENDIF are used in the copied source member to conditionally define source so that source lines are not duplicated.

For example (in the copy member):

/IF NOT DEFINED <somenamevalue>
/DEFINE <samenamevalue>
...code here...
/ENDIF
...anything here is included regardless...

Thus, if the member is copied in more than once, the code that is in the member will only be actually included once.

To exclude the entire member when referenced a second time, you can use /EOF as follows (in the copy member).

/if defined <somenamevalue>
/eof
/endif
/define <samenamevalue>
...code here...