SYMLIST parameter

Parameter type: Keyword on EXPORT statement, required

Purpose: Use the SYMLIST parameter to list the JCL symbolic parameters to be exported, and made available to the job step program. Exported symbol values can also be passed in to in-stream (sysin) data; see Using symbols in JES in-stream data for details.

JCL symbol values that are used by a job step program are not resolved until the job step execution phase. In this section, JCL symbol values that are made available to the job step program are referred to as exported symbol values.

Exported symbol values can be set in the JCL with the SET statement or through PROC symbolic parameter processing. Exported symbol values must be set at a point in time in the job stream after the EXPORT SYMLIST statement, and prior to or within the same job step as the program where they are to be used.

Exported symbol values are resolved to the last value set before or within the job step that executes the program that uses them. Exported symbol values persist across job steps, and once an exported symbol value is set, subsequent job step programs receive the same exported symbol value until the symbol is set to a new value. See Examples for more information on how exported symbol values are resolved.

JCL Converter processing generates EXPORT EXPSET statements to manage how exported symbol values are resolved. These statements appear in the job log. Reviewing the placement of EXPORT EXPSET statements in the job log can be helpful in understanding exported symbol value resolution for a given job.

Using exported symbol values in procedures: Exported symbol values can be set in the JCL with the SET statement or through PROC symbolic parameter processing. SET statements that are placed immediately following an EXEC PROC statement apply to the exported symbol values that are used in the final step of the procedure.