Interface to the exit

When the exit is entered, register 1 contains the address of the parameter list. Each address in this list is used to locate the parameter value. These parameters are passed to the exit:

EQQUX014 parameters

MCAUSERF  DS  A     (User field)                                     
TABPTR    DS  A     (Criteria table address)                         
NUMROW    DS  F     (Number of rows of the criteria file)            
RECSIZE   DS  F     (Criteria file record size)                      
ADID      DS  CL16  (Operation application name)                     
IATIME    DS  CL10  (Operation input arrival time, format YYMMDDHHSS)
WSNAME    DS  CL4   (Operation workstation name)                     
JOBNAME   DS  CL8   (Operation job name)                             
OPNUM     DS  F     (Operation number)                               
TOFFS     DS  F     (Offset to be added  to, or subtracted from, the 
                     operation start time)                           
RCODE     DS  F     (Return code)

MCAUSERF: User field that is also passed to the EQQUX000 exit. The scheduler for z/OS® does not use or update this field.
TABPTR: User field containing the address of the criteria table used by this exit. It is not allocated by the scheduler. The exit must return a value that is stored in controller storage and passed back to the exit at each new call. According to the provided sample, the first time the exit is called TABPTR must be set to zero, next times it contains the address of the criteria table to be used by the exit.
NUMROW: User field containing the number of rows of the input criteria file. The first time the exit is called, the exit must set and return this value, that is stored in controller storage and passed back to the exit at each new call.
RECSIZE: User field containing the record size of the input criteria file. The first time the exit is called, the exit must set and return this value, that is stored in controller storage and passed back to the exit at each new call.
ADID: The name of the application that the job becoming ready is part of.
IATIME: The input arrival time of the job becoming ready.
WSNAME: The name of the workstation defined for the job becoming ready.
JOBNAME: The name of the job becoming ready.
OPNUM: The operation number of the job becoming ready.
TOFFS: Sign and value of the offset expressed in minutes, to be added to the job start time. This parameter is used by the Workstation Analyzer task, to decide whether the operation can be started or not. The controller uses the returned offset to update the job start time only. The process leaves unchanged the latest start time.
Sample member EQQUX014 uses a criteria table to calculate this offset, however you can set it using a different method.
RCODE: The return code set by the exit. A value different from 0 indicates that the scheduler deactivated the exit.

Example

Suppose that:

CPU1 is a workstation corresponding to Rome that is the location where the controller runs.
CPU2 is a workstation corresponding to a branch location in Istanbul.
There are more workstations Z*, corresponding to different branch locations in London.

To specify the offset information and your selection criteria, define the following data in the UX14IN data set:

EDIT       TWSTST.TWSIDD1.UX014                            Columns 00001 00072 
Command ===>                                                  Scroll ===> CSR  
=COLS> ----+----1----+----2----+----3----+----4----+----5----+----6----+----7--
****** ***************************** Top of Data ******************************
000101 WS CPU2            +0060                                                
000102 WS Z*              -0060                                                
000103 /* TO EXCLUDE SPECIFIC OPERATIONS                                       
000110 AD MYAPPLID                                                             
000120 JN JOBX123                                                              
000200 JN MYJOB                                                                
****** **************************** Bottom of Data ****************************

When the operation is ready to start, the controller calls the exit and assigns the specified offsets to any operation associated to CPU2 or Z*, unless:

The operation belongs to MYAPPLID.
The operation is defined with job name JOBX123 or MYJOB.

Limitations

The controller uses the returned TOFFS value to update the job start time and leaves unchanged the latest start time. This might affect latest start time-related activities such as:

The processing of the SUPPRESS IF LATE option.
Alert conditions or critical jobs monitoring. For example, consider a job with 9:00 as start time and 9:30 as latest start time. Supposing that the exit returns +0060 as TOFFS, the job becomes late as soon as it is ready to start.