KILLJOB
The KILLJOB instruction stops a job that is already running. Applies only to operations running on IBM Z Workload Scheduler Agents or on distributed workstations that are directly connected to the end-to-end server (OPCMASTER).
This action can be taken only on STARTED jobs that are in the EXECUTING status, so that their operation number is known. The application number is required.
For a description of the keywords that you can use, see Keywords used in the Killjob Instruction.
| Keyword | Requirement | Multiple Values Allowed | Description | Abbreviation | Format |
|---|---|---|---|---|---|
| APPL() | Required | Yes | The name of the application to be modified. | ||
| OPNO() | Optional | Yes | The number of the operation to be modified. If OPNO() is not specified, the command will be issued to all the occurrence operations. | OP | |
| IADATE() | Optional¹ | No | The input arrival date of the application occurrence. IADATE(=) assumes the current date. IADATE() and IA() are mutually exclusive. | IAD | YYMMDD |
| IATIME | Optional¹ | No | The input arrival time of the application occurrence. If IADATE(=) is specified, IATIME() assumes that the default input arrival time is specified in the DEFIAT parameter of the EQQYRPRM member. IADATE() and IA() are mutually exclusive. | IAT | HHMM |
| IA() | Optional¹ | No | The input arrival date and time of the application occurrence. IA(=) assumes the current date and time. It defaults to the earliest or latest input arrival date and time of the application occurrence occurrences found in the current plan, depending on the SORT parameter. IA() cannot be used together with IADATE() or IATIME(). | YYMMDDHHMM | |
|
Note: ¹
Mutually exclusive with another keyword. | |||||
Example control statements:
- KILLJOB APPL(TEST01)
- Kills all operations of occurrence TEST01
- KILLJOB APPL(TEST01) OP(10,30,50)
- Kills operations 10, 30, and 50 of occurrence TEST01
- KILLJOB APPL(TEST01) IAD(=)
- Kills all operations of occurrence TEST01 for the current input arrival date and the default input arrival time
- KILLJOB APPL(TEST01) IAD(=) IAT(1800)
- Kills all operations of occurrence TEST01 for the current input arrival date and input arrival time 18.00
- KILLJOB APPL(TEST01) IAD(090709)
- Kills all operations of occurrence TEST01 for input arrival date 090709 and the default input arrival time
- KILLJOB APPL(TEST01) IA(=)
- Kills all operations of occurrence TEST01 for the current input arrival date and time
- KILLJOB APPL(TEST01) IA(0907081801)
- Kills all operations of occurrence TEST01 for input arrival date 970708 and input arrival time 18.01
The KILLJOB instruction returns one of the following return
codes:
- RESULT = 0
- Operations killed.
- RESULT = 4
- Occurrence found but operations not found in the current plan.
- RESULT = 8
- Occurrence not found in the current plan. Invalid instruction or PIF problem. Refer to the error messages.