QCANCEL
The QCANCEL.EXE command cancels, aborts, or discards a job, depending on the current status of the specified job.
Syntax
QCANCEL.EXE JobNumber /ABORT /SERVER=ServerName
Qualifiers
If only a job number is provided, the pending job instance is cancelled.
/ABORT
If this qualifier is present and the specified job is executing, then the job is aborted. If this qualifier is not present, then this command returns an error if the job is executing. Terminating jobs is a potentially dangerous action, and, depending on the nature of the job that is terminated, it may cause loss or corruption of data.
/DELETE
This will delete the job instance record and job log of any non-executing job.
/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
QCANCEL.EXE 522
This example cancels Job number 522. If the job is executing at the time this command is entered, then an error message is displayed and the job is not canceled.
Example B
QCANCEL.EXE 522/ABORT
This example aborts job 522.
See Also: