KILLREC
The KILLREC instruction stops a recovery job that is already running. Applies only to operations running on distributed workstations that are directly connected to the end-to-end server (OPCMASTER).
This action can be taken only on recovery 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 Table 1.
| 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:
- KILLREC APPL(TEST01)
- Kills all recovery jobs of occurrence TEST01
- KILLREC APPL(TEST01) OP(312)
- Kills recovery job 312 of occurrence TEST01
- KILLREC APPL(TEST01) IAD(=) IAT(1800)
- Kills all recovery jobs of occurrence TEST01 for the current input arrival date and input arrival time 18.00
- KILLREC APPL(TEST01) IAD(090708)
- Kills all recovery jobs of occurrence TEST01 for input arrival date 090708 and the default input arrival time
- KILLREC APPL(TEST01) IA(=)
- Kills all recovery jobs of occurrence TEST01 for the current input arrival date and time
The KILLREC 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.