Knowing the context of the current plan
To run, many Workload Automation Programming Language processes need to know the application ID, IA date and time, and operation number of the occurrence that is controlling the Workload Automation Programming Language job. When required, Workload Automation Programming Language attempts to find itself in the current plan so that it can perform these processes.
In details, Workload Automation Programming Language
needs to know the following information:
- Access to the supplied variables that reference the occurrence or operation.
- Access to the user fields related to the operation.
- Date calculations that need to know the calendar in use.
- Actions that need to update the operations in the same occurrence (for example, using the = = operator to reference the current application and input arrival).
- Actions that read variables from tables, which need to know the name of the table referred by the occurrence.
If you access any of these functions, Workload Automation Programming Language attempts to find itself in the current plan by searching for an operation in Started status with a job of the same job name and JES number. In big current plans, this can generate large CPU consumption; to prevent the search, you can provide the information in advance.
For the most efficient use of system resources, it is strongly recommended that you use one
of the following options in all your Workload Automation Programming Language jobs:
- For jobs scheduled by IBM® Z Workload Scheduler
- Set the EQQCPOP DD statement as in the following
example:
//*%OPC SCAN //RUNWAPL EXEC EQQYXJPX,SUBSYS=INDC //EQQCPOP DD * &OADID &OYMD1&OHHMM &OOPNO //SYSIN DD * SHOW OPTIONS
Alternatively, you can use theOPID OPTIONS
keyword in the ARGS symbolic parameter//*%OPC SCAN //RUNWAPL EXEC EQQYXJPX,SUBSYS=INDC, // ARGS=’OPID(&OADID &OYMD1&OHHMM &OOPNO)’ //SYSIN DD * SHOW OPTIONS
- For jobs that are not scheduled by IBM Z Workload Scheduler
- To prevent the job trying to locate itself in the current plan, set one of the
following commands:
-
//EQQCPOP DD * -
OPTIONS OPID(-)
-
//*%OPC SCAN //RUNWAPL EXEC EQQYXJPX,SUBSYS=INDC //SYSIN DD * OPTION OPID(-) SHOW OPTIONS
-
Note: Workload Automation Programming Language searches the current
plan only when the information is actually needed, and the Application and Global tables are
accessed only when searching for variables. By setting
EQQCPOP DD
or
OPTIONS OPID
appropriately, you can additionally prevent this
search process.