The QDELETE.EXE command deletes a queue, canceling any jobs in the queue. If the queue contains any executing jobs, the QDELETE.EXE command will not delete the queue unless the /ABORT_JOBS qualifier is used.

Syntax

QDELETE.EXE	QueueName

		/ABORT_JOBS

		/SERVER=ServerName

Qualifiers

/ABORT_JOBS
This instructs the Argent Queue Engine to abort any executing jobs in the queue in order to delete the queue. If you do not use this qualifier, and the queue contains one or more executing jobs, then the Argent Queue Engine does not delete the queue.

/SERVER
This specifies the name of an Argent Queue Engine server. If this qualifier is absent, then the command uses the value of the XS_SERVER environment variable, if defined. If this environment variable is also absent, then the command assumes the local server.

Example A

QDELETE.EXE QUEUE1

This example deletes queue QUEUE1. If the queue contains any executing jobs, then an error message is displayed and the queue is not deleted.

Example B

QDELETE.EXE QUEUE1/ABORT_JOBS

This example deletes queue QUEUE1, aborting any executing jobs in the queue.

See Also:

Command Reference

Network Usage