 |
» |
|
|
|
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” |
