Hold Job Schedule Entry (HLDJOBSCDE)

Hold Job Schedule Entry (HLDJOBSCDE)

Where allowed to run: All environments (*ALL)

Threadsafe: No

The Hold Job Schedule Entry (HLDJOBSCDE) command allows you to hold an entry, all entries, a set of entries, or 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:

To hold the job schedule, you must have job control (*JOBCTL) special authority.
To hold entries, you must have job control (*JOBCTL) special authority; otherwise you can hold 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.

Parameters

Keyword	Description	Choices	Notes
JOB	Job name	Generic name, name , ALL, JOBSCD	Required, Positional 1
ENTRYNBR	Entry number	000001-999999, ONLY , ALL	Optional

Job name (JOB)

Specifies the name of the job schedule entry.

This is a required parameter.

*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.
*JOBSCD: The job schedule is held. If JOB(*JOBSCD) is specified, ENTRYNBR(*ALL) must also be specified.
generic-name: Specify the generic name used to find job schedule entries. 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 held. 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 held.

Entry number (ENTRYNBR)

Specifies the number of the job schedule entry you want held. 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 held and an error message is sent.
*ALL: All entries with the specified job name are held. If *JOBSCD was specified for the name, the job schedule is held.
000001-999999: Specify the number of the job schedule entry you want held.

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.

Example 5: Holding the Job Schedule


HLDJOBSCDE   JOB(*JOBSCD)  ENTRYNBR(*ALL)

This command holds the job schedule.

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.
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.