This document describes the advantages and the use of copycode.
The following topics are covered:
An object of type copycode contains a portion of source code which
can be included in another object via an INCLUDE
statement.
So, if you have a statement block which is to appear in identical form in several objects, you may use a copycode object instead of coding the statement block several times. This reduces the coding effort and also ensures that the blocks are really identical.
The copycode is included at compilation; that is, the source-code
lines from the copycode are not physically inserted into the object that
contains the INCLUDE
statement, but they will be included in the compilation process and are thus
part of the resulting cataloged object.
Consequently, when you modify the source code of copycode, you also
have to catalog all objects which use that copycode using
the CATALOG
or CATALL
system
command.
Attention:
Copycode cannot be executed on its own. It cannot be
stowed with a
STOW
system
command, but only saved using the
SAVE
system
command.
An END
statement must not be placed within a copycode.
For further information, refer to the description of the
INCLUDE
statement (in
the Statements documentation).