Change System Job (CHGSYSJOB)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change System Job (CHGSYSJOB) command allows the user to change the run priority of a system job.
Restrictions:
- To use this command, you must have job control (*JOBCTL) and all object (*ALLOBJ) special authorities.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Qualified job name | Required, Key, Positional 1 |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| RUNPTY | Run priority | 0-99, *SAME, *IPL | Optional |
| Top |
Job name (JOB)
Specifies the name of the system job whose attributes are being changed. The list of valid job names are displayed when F4 is pressed while prompting for this parameter.
This is a required parameter.
Qualifier 1: Job name
- name
- Specify the name of the system job.
If more than one system job has the name specified, and no values are specified for the user name and job number elements of this parameter, and the CHGSYSJOB command is being run in an interactive job, a selection panel is shown where you can select the system job to change. If the specified job name is not unique and the CHGSYSJOB command is being run in a batch job, escape message CPF1069 is sent.
Qualifier 2: User
- name
- Specify the user name that identifies the user profile under which the job is started.
Qualifier 3: Number
- 000000-999999
- Specify the system-assigned job number.
| Top |
Run priority (RUNPTY)
Specifies the run priority for the routing step. Machine run priority is a value, ranging from 0 (highest priority) through 99 (lowest priority), that represents the importance of the routing step when it competes with other routing steps for machine resources. This value represents the relative (not the absolute) importance of the routing step. For example, a routing step with a run priority of 25 is not twice as important as one with a run priority of 50.
- *SAME
- The value does not change.
- *IPL
- Use the run priority at which the system job was started.
- 0-99
- Specify the run priority that the routing step uses.
| Top |
Examples
CHGSYSJOB JOB(QDBSRVXR2) RUNPTY(20)
This command changes the run priority of the system job QDBSRVXR2 to 20.
| Top |
Error messages
*ESCAPE Messages
- CPF1069
- End of duplicate names.
- CPF1070
- Job &3/&2/&1 not found.
- CPF137A
- Not authorized to change system job.
- CPF1379
- Job &3/&2/&1 cannot be changed.
| Top |