From a CLIST, you might want to submit a jobstream for execution. In the CLIST, you can include the required JCL statements (EXEC, DD, and so on). However, when you include the following JCL statements in a CLIST, you must use a particular CLIST function to prevent the CLIST from modifying the statements and causing subsequent JCL errors.

1. Statements following the SYSIN statement - use the &STR built-in function to preserve leading blanks and statements that have the same names as CLIST statements.
2. A statement containing a single ampersand (&) or a double ampersand (&&) - use the &SYSNSUB or &NRSTR built-in functions.
3. JCL comments - use the &STR built-in function. Because CLIST processing detects the JCL comment as a comment for the CLIST, you must set a variable equal to &STR(/*) and use this variable in place of the JCL comment.
4. JCL imbedded in a CLIST can use the SUBMIT * form of the SUBMIT command; however, all JCL is converted to uppercase. If JCL conversion to uppercase is inappropriate or undesirable, use the SUBMIT (dataset_name) form of the SUBMIT command. For a description of the SUBMIT command, see z/OS TSO/E Command Reference.

Examples of using these built-in functions with JCL are provided in Using built-in functions and in Figure 1.