Daily-planning-scheduling environment exit EQQDPX01

The daily-planning-scheduling environment exit (EQQDPX01) is called by the HCL Workload Automation for Z daily-planning batch jobs and is used to set or modify the scheduling environment names associated with the operations in the plan.

The exit is optional: the daily plan batch attempts to load it, and when it finds it, it puts it to use. The exit should be used with care as it could affect system performance.

EQQDPX01 parameters
 FUNC      DS   CL6       (Function type)
 ADID      DS   CL 16     (Name of current application)
 OPNUM     DS   F         (Operation number)
 JOBNAME   DS   CL8       (Job name)
 WSNAME    DS   CL4       (Operation workstation name)
 SPECNR    DS   H         (Number of special resources)
 SPECBUF   DS   A         (Special resource buffer)
 WSCHENV   DS   CL 16     (Scheduling Environment Name)
 MCAUSERF  DS   A         (User field)
FUNC
Function type:
  • 'INIT ' first call
  • 'TERM ' last call
  • 'CHECK ' check SCHENV call

The exit is called at DP batch start with function type INIT and at DP batch end with function type TERM. This is so that the open and the close only at the beginning and at the end of DP batch (to minimize impact on performance). The exit is called with function type CHECK each time an operation must be checked.

FUNC
Is present only for compatibility reasons.
ADID
Is the name of the application that the job belongs to.
OPNUM
Is the operation number of the operation representing this job.
JOBNAME
Is the name of the job associated to the operation.
WSNAME
Is the name of the workstation where the operation is to run.
SPECNR
Is the number of special resource names in SPECBUF.
SPECBUF
Is an address to a buffer that contains a number of 64-byte fields. The number of 64-byte fields in the buffer is indicated by SPECNR. The first 44 bytes of each field contain the name of the special resource. The last 20 bytes of each field are reserved for future use.
WSCHENV
Is the scheduling environment name currently stored in the CP operation record. This value can be modified by the exit.
MCAUSERF
This field is reserved for users. HCL Workload Automation for Z does not use or update it.