CHGEXTNAME
The CHGEXTNAME instruction defines or modifies the
extended job information associated to the operations of an application
occurrence. You can delete the extended name by specifying EXTNAME() and EXTSE().
For a description of the keywords that can be used, see Keywords used in the Chgextname Instructions.
| Keyword | Requirement | Multiple Values Allowed | Description | Abbreviation | Format |
|---|---|---|---|---|---|
| APPL() | Required | No | The name of the application to be modified. | ||
| OPNO() | Required | No | The number of the operation to be modified. | 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 occurrences found in the current plan, depending on the SORT parameter. IA() cannot be used together with IADATE() or IATIME(). | YYMMDDHHMM | |
| EXTNAME() | Required if EXTSE not specified | No | A free-format name for the operation. It can include blanks and special characters. Do not include parentheses in the extended name value. | ||
| EXTSE() | Required if EXTNAME not specified | No | Scheduling Environment name. | ||
|
Note: ¹
Mutually exclusive with another keyword. | |||||
Examples:
- CHGEXTNAME APPL(TEST01) EXTNAME('DAILY PAYROLL JOB')
- This example sets the extended name DAILY PAYROLL JOB for the operations of TEST01 application.
- CHGEXTNAME APPL(TEST01) EXTNAME()
- This example deletes the extended name DAILY PAYROLL JOB for the operations of TEST01 application.
Do not use CHGEXTNAME to add the extended name to an operation that is to be included in the Symphony file, when the value of TWSJOBNAME is either EXTNAME or EXTNOCC. Use the ADDOP instruction with the EXTNAME keyword instead.
The CHGEXTNAME instruction returns one of the following return
codes:
- RESULT = 0
- Occurrence modified.
- RESULT = 4
- Occurrence or operations not found in the current plan.
- RESULT = 8
- Invalid instruction or PIF problem. Refer to the error messages.