Using JCLNeat › Manual Control of JCLNeat › Symbolic Replacement

Symbolic Replacement

When processing a PROCLIB member or an inline procedure (PROC/PEND) at your request (RSYM=Y), JCLNeat replaces the symbolics within the procedure with the values specified on the PROC statement unless:

• The symbolic is specifically excluded by an entry in the KEYWORDS DD data set in the following format:

  Column Number 1    6
                PROC Symbolic1
                PROC Symbolic2
                PROC Symbolicn
  

• The symbolic has a null value (SYMBOL=,) on the PROC statement.

Once replacement has been effected, all symbolics except those specifically excluded or those with a null value are then removed from the PROC statement in the reformatted JCL. You can use this feature to restructure procedure libraries by eliminating unused symbolics. Symbolics still required by the installation would be excluded in a PROC entry in the KEYWORDS DD data set.

Note: Global editing is performed before symbolic replacement is affected. Therefore, if you specify a CHANGES DD data set entry that modifies the data portion of a symbolic parameter, it is changed prior to being replaced in the procedure.

For example, a CHANGES DD data set entry of /3380/SYSDA/ and a PROC of:

//NAME1 PROC U=3380
//STEP1 EXEC PGM=A
//DD1   DD   DSN=CDE,DISP=OLD,UNIT=&U,VOL=SER=XYZ

results in the following reformatted JCL:

//NAME1 PROC
//STEP1 EXEC PGM=A
//DD1   DD   DISP=OLD,
//           DSN=CDE,
//           UNIT=SYSDA,
//           VOL=SER=XYZ

If a procedure that has had its symbolics replaced is subsequently executed and still contains qualified symbolic overrides, a JCL error results.