Time-dependent-operation exit (EQQUX014)

The controller calls EQQUX014 when a time dependent operation becomes ready in a z/OS® environment. The exit returns an offset, expressed in minutes, to be added to the operation start time. The result is used by the Workstation Analyzer task, to decide whether the operation can be started.

The sample library SEQQSAMP contains a sample of EQQUX014 exit. It describes the exit logic, based on a criteria table referenced by the UX14IN DD name in the JCL of the controller started task.

If you need to modify the criteria table while the controller is running, you must place the table in a member of a partitioned data set and identify it in the controller started task as follows:
//UX14IN    DD  DISP=SHR,DSN=TWSDEV.UX014.TABLE(UX14TAB)
Then, to dynamically refresh the criteria table, issue the following modify command: 
/F subsys,RFRUX14T

For detailed information about the RFRUX14T command, see Modifying the scheduler.

Note: If you do not need to edit the criteria table while the controller is running, you can leave it in a sequential data set.
Use the table to correlate workstation name and offset value. Optionally, you can specify filtering rules to exclude selected operations from the process that adds the offset value to the operation start time. The following layout defines column ranges to place key data in the UX14IN file:
1-2
Data type. Specify one the following values:
WS
To correlate workstation name and offset value.
AD
To exclude an operation by application name.
IA®
To exclude an operation by input arrival value.
OP
To exclude an operation by operation number.
JN
To exclude an operation by job name.
3
A blank character (filler).
4-19
One of the following values:
  • Workstation name (up to 4 characters) for WS data type. Wildcard character * is supported.
  • Application name (up to 16 characters) for AD data type. Wildcard character * is supported.
  • Input arrival (up to 10 characters) for IA® data type. Use the format YYMMDDHHMM.
  • Operation number (up to 3 characters) for OP data type.
  • Job name (up to 8 characters) for JN data type. Wildcard character * is supported.
20
Sign (+ or -) for WS data type only.
21-24
Offset value for WS data type only.
When editing the UX14IN file, specify the data types in the following order:
  • First, all the rows with WS data type.
  • Then all the rows with AD data type, if any.
  • Then all the rows with IA® data type, if any.
  • Then all the rows with OP data type, if any.
  • Then all the rows with JN data type, if any.

You can add comment text by using the /* string.

See also Example. For further details, refer to the prologue of the exit.

The sample library SEQQSAMP that was created during installation contains a sample of EQQUX014 exit. For information about this library and its samples, see Sample library (SEQQSAMP).