ADDRES
The ADDRES instruction adds a special resource to an operation in the current plan.
Table 1 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 modified. | ||
| OPNO() | Optional | No | The number of the operation to be modified. It defaults to the default operation number specified in the DEFOPNO parameter of the EQQYRPRM member. | 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 the EQQYRPRM member in the INIT instruction. IA() cannot be used with IADATE() or IATIME(). | YYMMDDHHMM | |
| ONERROR | Optional | No | Keep on error: YES, NO, or blank | OE | |
| ONCOMPL | Optional | No | On complete action. Change resource availability: YES, NO, RESET, or blank | ONC | |
| RESNAME() | Required | No | The special resource to be added. | RN | |
| RESUSAGE() | Required | No | The special
resource usage:
|
RU | |
| ONERROR() | Required | No | The ONERROR option: YES to keep the special resource, NO ot free it, in case of operation ended in error. | ||
|
Note: ¹
Mutually exclusive with another keyword. | |||||
Examples:
- ADDRES APPL(TEST01) RN(prova.sr1) RU(X) OE (N)
- Adds the special resource PROVA.SR1 with exclusive use to the default operation number, DEFOPNO, of the occurrence TEST01 and KEEP-ON-ERROR set to no.
- ADDRES APPL(TEST02) IAD(&OYMD1) RN(prova.sr2) RU(X) OP(10), OE(Y)
- Adds the special resource PROVA.SR2, with exclusive use and keep-on-error set to YES, to operation 10 of the occurrence TEST01 with the default input arrival time, DEFIAT
The ADDRES instruction returns one of the following return codes:
- RESULT = 0
- Special resource added.
- RESULT = 4
- Occurrence or operation not found in the current plan.
- RESULT = 8
- Invalid instruction or PIF problem. Refer to the error messages.