DEL
The DEL instruction deletes an occurrence or an operation from the current plan or from the long-term plan. It modifies the current plan or long-term plan, depending on the date and time specified or defaulted to. If the date and time being used is after the end of the current plan, the modification will be made to the long-term plan instead of the current plan.
Keywords used in the Del Instruction describes the keywords that can be used.
| Keyword | Requirement | Multiple Values Allowed | Description | Abbreviation | Format |
|---|---|---|---|---|---|
| APPL() | Required | No | The name of the application to be deleted. | ||
| OPNO() | Optional | Yes | The number of the operation to be deleted. If OPNO() is specified, DEL will delete the operations and not the occurrence. | OP | |
| IADATE() | Optional¹ | No | The input arrival date of the application occurrence. IADATE=() means 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 the default input arrival time that is defined in the DEFIAT parameter of the EQQYRPRM member. IATIME() 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 occurrences found in the current plan, depending on the SORT parameter specified in PARMLIB or in the INIT instruction. IA() cannot be used with IADATE() or IATIME(). | YYMMDDHHMM | |
|
Note: ¹
Mutually exclusive with another keyword. | |||||
Examples:
- DEL APPL(TEST01)
- Deletes the occurrence with the earliest or latest input arrival date and time of the application TEST01 (according to the SORT parameter or the INIT instruction)
- DEL APPL(TEST01) IAD(=) IAT(1700)
- Deletes the occurrence of application TEST01 with the input arrival date corresponding to the current date and with the input arrival time 1700
- DEL APPL(TEST01) IAD(970708)
- Deletes the occurrence TEST01 with the input arrival date 970708 and the input arrival time corresponding to the default IA time, DEF
- DEL APPL(TEST01) IA(=)
- Deletes the occurrence TEST01 with the input arrival date and time corresponding to the current date and time
- DEL APPL(TEST01) IA(9707081800)
- Deletes the occurrence TEST01 with the input arrival date 970708 and time 1800
- DEL APPL(TEST01) OP(10,30)
- Deletes operations 10 and 30 of the occurrence TEST01 with the earliest or latest input arrival date and time, depending on the SORT parameter
Note: If the occurrence is associated with an application
group, DEL will remove the group definition from the occurrence before
deleting the occurrence.
The DEL instruction returns one of the following return codes:
- RESULT = 0
- Occurrence deleted.
- 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.