DELETE-BATCH-QUEUE-ENTRY: Difference between revisions

From NDWiki
Jump to navigation Jump to search
(created page for the DELETE-BATCH-QUEUE-ENTRY command)
 
(expanded text with info from SINTRAN III Reference manual)
Line 1: Line 1:
  @DELETE-BATCH-QUEUE-ENTRY <batch number> <input part of queue entry> <output part of queue entry>
  @DELETE-BATCH-QUEUE-ENTRY <batch number><input file>, <output file>
This command may be used to remove an entry from the [[batch queue]], that is, kill a job waiting for execution before it is started. If the job is started the @[[ABORT-BATCH]] command must be used. <batch number> identifies the [[batch process]], <input part of queue entry> is the batch input file name given in the @[[APPEND-BATCH]] command, <output part of queue entry> is the batch output file name given in the @[[APPEND-BATCH]] command.
Delete a job in the batch queue waiting to be started.
This command may be used to remove an entry from the [[batch queue]], that is, kill a job waiting for execution before it is started.  


Exact match is required between the second and third parameter of this command and the [[batch queue]] entry. The exact format of the batch queue entry to be removed may be checked by the @[[LIST-BATCH-QUEUE]] command.
Exact match is required between the second and third parameter of this command and the [[batch queue]] entry. The exact format of the batch queue entry to be removed may be checked by the @[[LIST-BATCH-QUEUE]] command.


If the batch queue contains two equivalent entries, the first one is removed.


This command may be issued by the user [[SYSTEM]] and the user owning the job to be deleted.
; <batch number> : batch processor number as returned form the @[[BATCH]] command (decimal).
; <input file> : the file to be deleted.
; <output file> : associated output file in batch queue.
Rules:
#Permitted only for user SYSTEM and the owner of the <input file>.
#Valid only if second and third parameters match with a queue entry. Both parameters must be spelled the same way as in the @[[APPEND-BATCH]] command.
#The currently active batch job is not in the queue and must be deleted by @[[ABORT-JOB]].
#If more entries match, only the first one is deleted.
#@[[LIST-BATCH-QUEUE]] may be used to find the correct spelling of the second and third parameter.
Example:
 
@DELETE-BATCH-QUEUE-ENTRY 1, JOB-1, L-P
 
The batch job file JOB-1 is deleted from the queue to batch processor 1 (if match). L-P was the output device in the corresponding @[[APPEND-BATCH]] command.
== Related commands ==
@[[ABORT-JOB]]
 
@[[LIST-BATCH-QUEUE]]
== References ==
== References ==
{{ND-doc|60.050.06}} section 3.7.4.5
{{ND-doc|60.050.06}} section 3.7.4.5


{{ND-doc|60.174.Q01}}
{{ND-doc|60.174.Q01}}
[[Category:Background Commands]]
[[Category:Background Commands]] [[Category:System Commands]]

Revision as of 22:11, 16 July 2013

@DELETE-BATCH-QUEUE-ENTRY <batch number>,  <input file>, <output file>

Delete a job in the batch queue waiting to be started. This command may be used to remove an entry from the batch queue, that is, kill a job waiting for execution before it is started.

Exact match is required between the second and third parameter of this command and the batch queue entry. The exact format of the batch queue entry to be removed may be checked by the @LIST-BATCH-QUEUE command.


<batch number>
batch processor number as returned form the @BATCH command (decimal).
<input file>
the file to be deleted.
<output file>
associated output file in batch queue.

Rules:

  1. Permitted only for user SYSTEM and the owner of the <input file>.
  2. Valid only if second and third parameters match with a queue entry. Both parameters must be spelled the same way as in the @APPEND-BATCH command.
  3. The currently active batch job is not in the queue and must be deleted by @ABORT-JOB.
  4. If more entries match, only the first one is deleted.
  5. @LIST-BATCH-QUEUE may be used to find the correct spelling of the second and third parameter.

Example:

@DELETE-BATCH-QUEUE-ENTRY 1, JOB-1, L-P

The batch job file JOB-1 is deleted from the queue to batch processor 1 (if match). L-P was the output device in the corresponding @APPEND-BATCH command.

Related commands

@ABORT-JOB

@LIST-BATCH-QUEUE

References

Norsk Data Document ND–60.050.06 SINTRAN III USERS GUIDE section 3.7.4.5

Norsk Data Document ND–60.174.Q01 SINTRAN III QUICK REFERENCE CARD