Remove Job Schedule Entry (RMVJOBSCDE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove Job Schedule Entry (RMVJOBSCDE) command allows you to remove an entry, entries, or generic entries in the job schedule. Each job schedule entry corresponds to one batch job, and contains the information needed to automatically run the job once or at regularly scheduled intervals. A message is sent to you and the message queue specified in the job schedule entry when an entry is successfully removed.
Restrictions:
- To remove entries, you must be running under a user profile which has job control (*JOBCTL) special authority; otherwise you can remove only those entries that you added.
- To use this command, you must have:
- Use (*USE) authority to object QDFTJOBSCD, type *JOBSCD, in library QUSRSYS and execute (*EXECUTE) authority to library QUSRSYS.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JOB | Job name | Generic name, name | Required, Positional 1 |
| ENTRYNBR | Entry number | 000001-999999, *ONLY, *ALL | Optional |
| Top |
Job name (JOB)
Specifies the name of the job schedule entry.
This is a required parameter.
- generic-name
- Specify the generic name of the job schedule entry. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all entries with names that begin with the generic name, and for which the user has authority, are removed. If a generic name is specified, ENTRYNBR(*ALL) must also be specified. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete job name.
- name
- Specify the name of the job schedule entry that you want to remove.
| Top |
Entry number (ENTRYNBR)
Specifies the number of the job schedule entry you want to remove. The message sent when an entry is successfully added contains the entry number. You can also determine the entry number by using the Work with Job Schedule Entries (WRKJOBSCDE) command. Press F11 from the WRKJOBSCDE display to show the entry numbers of the selected entries.
- *ONLY
- Only one entry in the job schedule has the job name specified for the JOB parameter. If *ONLY is specified and more than one entry has the specified job name, no entries are removed and an error message is sent.
- *ALL
- All entries with the specified job name are removed.
- 000001-999999
- Specify the number of the job schedule entry you want to remove.
| Top |
Examples
Example 1: Removing Job Schedule Entries
RMVJOBSCDE JOB(SAMPLE*) ENTRYNBR(*ALL)
This command removes all the job schedule entries whose job names start with SAMPLE.
Example 2: Removing an Individual Job Schedule Entry
RMVJOBSCDE JOB(PAYROLL) ENTRYNBR(*ONLY)
This command removes the job PAYROLL in the job schedule.
Example 3: Removing a Generic Job Schedule Entry
RMVJOBSCDE JOB(PAY*) ENTRYNBR(*ALL)
This command removes all entries in the job schedule that have the prefix PAY in their names.
| Top |
Error messages
*ESCAPE Messages
- CPF1628
- Job schedule entry &3 number &4 not found.
- CPF1629
- Not authorized to job schedule &1.
- CPF1630
- Not authorized to job schedule entry &3 number &4.
- CPF1631
- &3 entries successfully removed, &4 entries not removed.
- CPF1636
- More than one entry with specified entry job name found.
- CPF1637
- Job schedule &1 in library &2 in use.
- CPF1638
- Job schedule entry &3 number &4 in use.
- CPF1640
- Job schedule &1 in library &2 does not exist.
- CPF1641
- Job schedule &1 in library &2 damaged.
- CPF1645
- No job schedule entries found for specified name.
- CPF1646
- Entry number must be *ALL when generic name specified.
| Top |