HP 3000 Manuals HP 3000 Manuals
CANCEL
Purges jobs awaiting transmission . Deletes returning output data sets
for jobs already transmitted to the host.
If you are connected to a VSE/POWER host system, only jobs awaiting
transmission are cancelled.
Syntax
__________________________________________________________________
| |
| { SpoolfileID } |
| { Name } |
| CA[NCEL] { UserName.AcctName } [;W[SID]=Wsid]|
| { @ } |
| { ;HJ=HostJob [,HostJob [,...]] } |
__________________________________________________________________
Parameters
SpoolfileID Cancels one of your jobs.
The SpoolfileID is assigned by the spooler after a job is submitted.
Jobs can be cancelled by SpoolfileID only before they have been
transmitted to the host.
Enter a value of the form nnnnn, where n is any digit.
Name Job name assigned by the user in the SUBMIT command. You can submit
several jobs with the same name.
Use of this parameter cancels all of your jobs with this Name.
A job name begins with a letter, and may be up to eight alphanumeric
characters long.
UserName.AcctName Cancels jobs for a specific UserName.AcctName. A period (.) must
separate UserName from AcctName.
Jobs awaiting transmission to the host under this UserName.AcctName
are purged. Data sets returning from the host for jobs submitted
under this UserName.AcctName prior to this command are purged as they
return.
If your logon UserName.AcctName is different from the jobs you want
to cancel, you must be a user configured with NM capability to use
this parameter.
@ Cancels all jobs from the current logon UserName.AcctName. Jobs
awaiting transmission to the host under the current UserName.AcctName
are purged. Data sets returning from the host for jobs submitted
under this UserName.AcctName prior to this command are purged as they
return.
HostJob Either the job name from the JCL JOB card or the job number assigned
by the host. All entries in the NRJE Job Log matching the job name
and the logon UserName.AcctName are cancelled.
Multiple job numbers or names, to a maximum of five jobs, are allowed
and must be delimited by commas. Jobs can be cancelled using the
HostJob parameter only after they have been entered in the Job Log
(that is, transmitted to the host). The Job Log is marked so that
data sets returning for the specified jobs are purged.
If you are connected to a VSE/POWER host system, this parameter is
not allowed.
Wsid Overrides the default Wsid named in the NRJE command, for this
command only.
When you specify WSID=Wsid in the CANCEL command, you cancel jobs you
have submitted at workstation Wsid.
Description
The CANCEL command enables you to remove previously submitted jobs from
the transmission queue and, for JES2 and JES3 users, to cause NRJE to
automatically purge output data sets for jobs that have already been
transmitted to the host. Use the SHOW command to get information about
jobs you want to cancel. You can specify a particular workstation
transmission queue by entering the WSID=Wsid parameter in this command.
If you omit the Wsid parameter, this command refers to the transmission
queue of the default workstation. You establish a default workstation by
using the Wsid parameter when you start an NRJE workstation with an NRJE
command .
You must confirm each interactively issued CANCEL command (see example).
Restrictions
* Jobs you want to cancel before they are transmitted must be in the
READY state. You can enter a SHOW command to determine the state of
a job.
* If you are configured with NM capability, you can cancel any job.
However, if you do not have NM capability, you can cancel only those
jobs submitted under your logon UserName.AcctName.
Example
_____________________________________________________________________________
| |
| R19>CANCEL;HJ=6461 |
| CONFIRM (Y/N)Y |
| 1 HOST JOB(S) CANCELLED. |
| |
| R19>SHOW;HJ=6461 |
| |
| --JOB#= 6461 JOBNAME= $SP#CI@L USER=USER.NRJETEST **CANCELLED** |
| 2 DATA SET(S) RECEIVED FROM HOST AS OF WED, AUG 5, 1987, 10:50 AM |
| PR= (NOT SPECIFIED) PU= (NOT SPECIFIED) FO=FORMSOUT.NRJELU.NRJETEST|
| |
| 1 JOB(S) SHOWN TRANSMITTED TO HOST. |
| |
| R19>... |
_____________________________________________________________________________
Text Reference
The NRJECancel intrinsic removes untransmitted jobs from the MPE Spooler.
The NRJEHJCancel intrinsic marks the Job Log to dispose of returning data
sets. See Chapter 5, "User Intrinsics."