Preparing jobs without unresolved promptable variables

Type the N row command beside the job to edit it and start the setup operation. The scheduler automatically resolves any non-promptable job variables that are defined to be resolved at setup time and then invokes the ISPF editor.

You can edit the job as required in the EDITING JCL FOR AN OPERATION panel (EQQRJCLE - Editing JCL for an operation).

Figure 1. EQQRJCLE - Editing JCL for an operation
EQQRJCLE --------------- EDITING JCL FOR AN OPERATION ----- SUBSTITUTION ERROR
Command ===>                                                  Scroll ===> PAGE

Edit JCL below and press END to complete,  CANCEL to reject and reset,
or  TSAVE to save changes and interrupt the operation.

Application           : APP2              application 2
Operation             : CPU1 050          job 2
Jobname               : JOB2              JCL last updated by: XRAYNER

****** ***************************** TOP OF DATA *****************************
000001 //*%OPC SCAN
000002 //JOB2     JOB  (&ACCT.,NOBO),'SAMPLE',
000003 //      MSGCLASS=&MSGC.,NOTIFY=XRAYNER,CLASS=A
000004 //OUTPUT1  OUTPUT DEST=&DEST.,DEFAULT=YES
000005 //*
000006 //*       PAYMORE PAYROLL SAMPLE
000007 //*       THIS JOB RUNS PAY04 AND PAY06
000008 //*%OPC RECOVER ERRSTEP=PAY04,TIME=&RTIME.,RESTART=YES  1
000009 //*%OPC RECOVER ERRSTEP=PAY06,RESTART=N
000010 //PAY04    EXEC PGM=PAY04
000011 //STEPLIB  DD DSN=&DPT..OPC.LOADLIB,DISP=SHR
000012 //PAYIN    DD DSN=&DPT..CICS.PAYDB,DISP=SHR
000013 //PAYOUT   DD DSN=&DPT..DAY.TRANS,DISP=SHR
000014 //SYSIN    DD *
=NOTE= //*>EQQJ569E 03/13 13.11.31
=NOTE= //*>         INVALID REFERENCE TO DYNAMIC FORMAT VARIABLE AT LINE 00015
=NOTE= //*>         OF ORIG JCL          2
000015 ?01ODAY. ?02CDATE.                3
000016 /*
The job in EQQRJCLE - Editing JCL for an operation has several errors:
  1. The error message 2 refers to the line following (3). CDATE is a dynamic-format variable whose format must be specified in a SETFORM directive before being used.
  2. When variables are not found, other variables, such as those on the job card, are not substituted either, even though HCL Workload Automation for Z has found them. You do not see any substituted variables unless HCL Workload Automation for Z has found them all.
  3. The variable on 1 is wrong. You cannot have variables in HCL Workload Automation for Z RECOVER directive. The scheduler has not pointed out this error because it does not scan recovery statements unless the job fails.
When you have finished editing the job, exit by entering one of the following commands:
  • END, which causes HCL Workload Automation for Z to save the modified or not modified job in the JCL repository, set the status of the setup operation to C (complete), and start the successor operation (the job itself) unless there are other dependencies.
  • CANCEL, which causes HCL Workload Automation for Z to exit without saving the job in the JCL repository. The status of the setup operation is still R (ready).
  • TSAVE, which saves your edited job in the JCL repository for later editing and changes the setup operation to status I (interrupted). Use this command if you want to keep your changes and continue editing later.