Deletes one or more print or batch jobs. The jobs can be in
progress or waiting in the queue. The /ENTRY qualifier is
required.
Requires manage (M) access to the queue, or delete (D) access to
the specified jobs.
Format
DELETE/ENTRY=(entry-number[,...]) [queue-name[:]]
1 – Parameters
entry-number[,...]
Specifies the entry number (or a list of entry numbers) of jobs
to be deleted. If you specify only one entry number, you can
omit the parentheses. If you do not specify a queue name, you can
delete entries from multiple queues.
The system assigns a unique entry number to each queued print
or batch job in the system. By default, the PRINT and SUBMIT
commands display the entry number when they successfully queue
a job for processing. These commands also create or update the
local symbol $ENTRY to reflect the entry number of the most
recently queued job. To find a job's entry number, enter the
SHOW ENTRY or SHOW QUEUE command.
queue-name[:]
Specifies the name of the queue where the jobs are located. The
queue name can refer either to the queue to which the job was
submitted or to the queue where the job is executing. The queue-
name parameter is optional syntax; however, when you specify a
queue name, the operating system uses it to verify an entry in
the specific queue before deleting the entry.
2 – Qualifier
2.1 /LOG
/LOG
/NOLOG (default)
Controls whether the DELETE/ENTRY command displays the entry
number of each batch or print job that it deletes.
3 – Examples
1.$ PRINT/HOLD ALPHA.TXT
Job ALPHA (queue SYS$PRINT, entry 110) holding
.
.
.
$ DELETE/ENTRY=110 SYS$PRINT
The PRINT command in this example queues a copy of the file
ALPHA.TXT in a HOLD status, to defer its printing until a SET
ENTRY/RELEASE command is entered. The system displays the job
name, the entry number, the name of the queue in which the job
was entered, and the status. Later, the DELETE/ENTRY command
requests that the entry be deleted from the queue SYS$PRINT.
2.$ SUBMIT/AFTER=18:00 WEATHER
Job WEATHER (queue SYS$BATCH, entry 203) holding until 14-DEC-2001
18:00
$ SUBMIT/HOLD/PARAMETERS=SCANLINE DOFOR
Job DOFOR (queue SYS$BATCH, entry 210) holding
.
.
.
$ DELETE/ENTRY=(203,210)/LOG
%DELETE-W-SEARCHFAIL, error searching for 203
-JBC-E-NOSUCHENT, no such entry
%DELETE-I-DELETED, entry 210 aborting or deleted
The SUBMIT commands in this example queue the command
procedures WEATHER.COM and DOFOR.COM for processing as batch
jobs. WEATHER.COM is queued for execution after 6:00 P.M.
DOFOR.COM is queued in a HOLD status and cannot execute
until you enter a SET ENTRY/RELEASE command. Later, the
DELETE/ENTRY/LOG command requests that the system delete both
these entries from the queue and display a message indicating
that the entries have been deleted.
The job WEATHER (entry 203) has completed by the time the
DELETE/ENTRY/LOG command is entered; therefore, entry 203 no
longer exists. Note that a message indicates that there is no
entry 203 in the queue. The job DOFOR (entry 210) is in a HOLD
status when the DELETE/ENTRY/LOG command is entered. Thus, the
system deletes entry 210 from the queue and displays a message
to that effect.
3.$ PRINT CHAPTER8.MEM
Job CHAPTER8 (queue SYS$PRINT, entry 25) pending on queue SYS$PRINT
.
.
.
$ SHOW QUEUE SYS$PRINT
Printer queue SYS$PRINT, on PARROT::PARROT$LPA0, mounted form DEFAULT
Entry Jobname Username Status
----- ------- -------- ------
24 CHAPTER7 SMITH Pending
25 CHAPTER8 SMITH Pending
$ DELETE/ENTRY=25 SYS$PRINT
The PRINT command in this example submits the file CHAPTER8.MEM
to the printer queue SYS$PRINT. Later, user SMITH needs to
edit the file again before printing it. Using the SHOW QUEUE
command, SMITH verifies that the job is still pending and
that the entry number for the job is 25. SMITH then enters
the DELETE/ENTRY command to delete the job from the queue.