Time-dependent-operation exit (EQQUX014)
The controller calls EQQUX014 when a time dependent operation becomes ready in a z/OS® environment. It is not applicable to operations scheduled on distributed workstations in an end-to-end with fault tolerance capabilities 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. 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:
- 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:
- 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 specific order:
- All the rows with WS data type first.
- 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 section. 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 Appendix C. Sample library (SEQQSAMP).