@INCLUDE
|
Where
- Can include these characters: uppercase and lowercase alphanumeric characters and the special characters $, @, _ (underscore), ?, and #
- Cannot begin with a number
- Must be from 1 to 8 characters long.
Function
The @INCLUDE statement retrieves the member_name from the data set specified by the SYSLIB DD statement and processes the contents of the member as if it were actually coded in the STL input data set at the point where the @INCLUDE statement is coded. The lines in the include member are processed as if they were actually "included" in the STL input data set.
An included member can itself contain @INCLUDE statements referencing other members; however, members may not be included recursively.
The statements contained in an include member must be complete STL statements. If all records of an included member have been read and continuation is expected, an error will be flagged. Other structures (such as networks, do-end groups, and procedures) can cross boundaries of included members as desired.
This statement may be coded anywhere in the STL input data set. However, when coded, it must be the last statement on the line and be followed only by STL comments.
If this statement is coded between @NETWORK and @ENDNETWORK statements, it must begin in the first position of the line, must otherwise be coded with the syntax of a normal STL statement, and must be complete on the line.
Examples
---> STL input data set
/*********************************************************/
/* PROGRAM: MYTEST */
/* DATE: 06/20/2002 */
@include header /* Include my unique comment block */
/*********************************************************/
mytest: msgtxt
⋮
endtxt
---> HEADER member from include data set. This member would
---> allow the user to include a common block of comments
---> in all of their input data sets.
/* USER: JOHN DOE */
/* TEST: REGRESSION 45 */
/* . */
/* . */
/* . */