CL Command Reference - HLDJOBSCDE
CL Command List > HLDJOBSCDE Reference
Description:
The Hold Job Schedule Entry (HLDJOBSCDE) command allows you to hold an entry, all entries, or a set of entries in the job schedule. Each job schedule entry contains the information needed to automatically submit a job to be run once or at regularly scheduled intervals.
If you hold a job schedule entry:
. The entry is held until it is released using the Release Job Schedule Entry (RLSJOBSCDE) or Work with Job Schedule Entries (WRKJOBSCDE) command.
. The job is not submitted when it is released, even if a date and time at which it was scheduled to be submitted passed while the entry was held.
Restrictions:
1. To hold entries, you must have job control (*JOBCTL) special authority; otherwise you can hold only those entries that you added.
2. 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.
Examples:
Example 1: Holding a Job Schedule Entry
HLDJOBSCDE JOB(CLEANUP)
This command holds the job schedule entry with the job name CLEANUP.
Example 2: Holding All Job Schedule Entries
HLDJOBSCDE JOB(*ALL) ENTRYNBR(*ALL)
This command holds all entries in the job schedule.
Example 3: Holding an Individual Job Schedule Entry
HLDJOBSCDE JOB(PAYROLL) ENTRYNBR(*ONLY)
This command holds the entry PAYROLL in the job schedule.
Example 4: Holding a Generic Job Schedule Entry
HLDJOBSCDE JOB(PAY*) ENTRYNBR(*ALL)
This command holds all entries in the job schedule that have the prefix PAY in their names.