HLDJOBSCDE (Hold Job Schedule Entry)
HLDJOBSCDE Command syntax diagram
Purpose
The Hold Job Schedule Entry (HLDJOBSCDE) command holds an entry, entries, or generic entries in the job schedule. Each job schedule entry contains the information needed to automatically submit a batch job one time, 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.
- A job is not submitted when the entry is released, even if the date and time at which it was scheduled to be submitted passed while the entry was held.
Restriction: To hold entries, have *JOBCTL special authority; otherwise you can hold only those entries that you added.
Required Parameters
- JOB
- Specifies the name of the job schedule entry.
*ALL: All of the job schedule entries for which you have authority are held. If JOB(*ALL) is specified, ENTRYNBR(*ALL) must also be specified.
job-name: Specify the name of the job schedule entry.
generic*-job-name: Specify a generic name. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names. If a generic name is specified, ENTRYNBR(*ALL) must also be specified.
Optional Parameters
- ENTRYNBR
- Specifies the number of the job schedule entry you want to hold. 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 Work with Job Schedule Entries display to show the entry numbers of the selected entries.
*ONLY: One entry in the job schedule has the job name specified on the JOB parameter. If *ONLY is specified and more than one entry has the specified job name, no entries are held and a message is sent.
*ALL: All entries with the specified job name are held.
entry-number: Specify the number of the job schedule entry you want to hold.
Examples for HLDJOBSCDE
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.
Error messages for HLDJOBSCDE
*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.
- CPF1632
- Job schedule entry &3 number &4 damaged.
- 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.
- CPF1647
- &3 entries successfully held, &4 entries not held.
- CPF1649
- Entry number must be *ALL.