RLSJOBSCDE (Release Job Schedule Entry)

RLSJOBSCDE Command syntax diagram

 

Purpose

The Release Job Schedule Entry (RLSJOBSCDE) command releases 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 release a job schedule entry, a job is not submitted immediately, even if the date and time at which it was scheduled to be submitted passed while the entry was held. The job is submitted on any future dates for which the entry is scheduled to be submitted.

Restriction: To release entries, have *JOBCTL special authority; otherwise you can release 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 released. 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.

ENTRYNBR

Specifies the number of the job schedule entry you want to release. 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 released and a message is sent.

*ALL: All entries with the specified job name are released.

entry-number: Specify the number of the job schedule entry you want to release.

Examples for RLSJOBSCDE

Example 1: Releasing All Job Schedule Entries

RLSJOBSCDE  JOB(*ALL)  ENTRYNBR(*ALL)

This command releases all the job schedule entries.

Example 2: Releasing an Individual Job Schedule Entry

RLSJOBSCDE  JOB(PAYROLL)  ENTRYNBR(*ONLY)

This command releases entry PAYROLL in the job schedule.

Example 3: Releasing a Generic Job Schedule Entry

RLSJOBSCDE  JOB(PAY*)  ENTRYNBR(*ALL)

This command releases all entries in the job schedule with the prefix PAY in their names.

Error messages for RLSJOBSCDE

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

CPF1648

&3 entries successfully released. &4 entries not released.

CPF1649

Entry number must be *ALL.