Errors in variable substitution

If an error occurs in variable substitution, the operation is put on the error list with the error code OJCV.

For more information about a variable substitution error:
  • Examine the message log, EQQMLOG.
  • Look at the job for the operation that ended in error. Use the J row command from the error list.

Variable substitution error messages are inserted into the job in the lines immediately preceding the erring variable. These messages are displayed in the form of ISPF note lines:

Examples of notes lines

000001 //XCALLINN JOB (885002,J09),'BOC',MSGLEVEL=(1,1).
000002 //   NOTIFY=XCALLIN,MSGCLASS=Q,CLASS=B
000003 //STEP001  EXEC PGM=IEFBR14
000004 //DD       DD  DSN=&DS1..DATASET,DISP=SHR
NOTE=> //*>EQQJ535E 03/17 08.57.00
NOTE=> //*>         UNDEFINED VARIABLE DS2 LINE 00005 OF ORIG JCL
000005 //DD       DD  DSN=&DS2..DATASET,DISP=SHR
000006 //* More JCL

To find variable substitution error message note lines in the job, enter the primary command LOCATE SPECIAL. To save the messages in the job, convert these temporary note lines into data lines, by entering the row command MD (make data).

You can avoid the variable substitution errors by using the VARFAIL keyword. For details, see Customization and Tuning.

Note: HCL Workload Automation for Z scans the job only up to the first detected error.