- jobname
- The name of the batch job, started task, or APPC/MVS transaction
program to be canceled.
The job name for a given
started task can be assigned based on a variety of inputs. These inputs
are examined in the following order, so that if item #1 is not specified,
item #2 is used. If neither #1 nor #2 is specified, then #3 is used,
and so on.
- The jobname specified in the JOBNAME= parameter of the START command
or
The
identifier specified on the START command.
- The jobname specified on the JOB JCL statement within the member.
- The device number specified on the START command, or the device
number associated with the device type specified on the START command
or
The
device number associated with the device type specified on the START
command.
- The device number associated with the IEFRDER DD statement within
the member.
- The member name.
- U=userid
- The user ID of the time-sharing user you want to cancel.
If
the user is just logging on and does not yet have a unique name, you
must find out the address space identifier for the user (see the explanation
under A=
asid) and use the following version of the command:
- [jobname.]identifier
- The identifier for the unit of work that you want to cancel,
optionally preceded by the job name.
The following types of identifiers
can be used:
- The identifier that was specified on the START command.
- [/]devnum, the device number specified when
the START or MOUNT command was entered. The device number is 3 or
4 hexadecimal digits, optionally preceded by a slash (/). You can
precede the device number with a slash to prevent ambiguity between
the device number and a device type or identifier.
- devicetype, the type of device specified when the START
or MOUNT command was issued.
If no identifier was specified on the START command,
the system assigns temporary identifier “STARTING” to the
unit of work, until the system can assign an identifier according
to the following order of precedence:
- If an identifier was not specified on the START command, the identifier
is the device type (for example, 3410) or device number (for example,
X‘0000’) specified on the START or MOUNT command.
- If an identifier, a device type, or a device number was not specified
on the START or MOUNT command, the identifier is the device type specified
on an IEFRDER DD statement (invoking a cataloged procedure) in the
JCL.
- If none of the above was specified, the identifier defaults to
the job name.
When you specify
jobname.identifier, then
identifier can be represented
by any of the following:
- An asterisk
- One or more characters from the beginning of the identifier, followed
by an asterisk
- The entire identifier
When you specify an asterisk, the system responds with
message IEE422I.
Attention: When
you use the asterisk format, the command affects all started
tasks that begin with the specified characters. Device numbers are
assumed to be four-digit numbers; for example, /13* would
match on 1301, 1302, and
so on, but would not match on 13C, because 13C is interpreted as 013C.
Specifying
both the job name and the entire identifier causes the command to
take effect if one and only one work unit with
that combination of job name and identifier is running. For the case
where more than one work units with the same combination of job name
and identifier are running, see “A=asid”
below.
- DUMP
- A dump is to be taken. The type of dump (SYSABEND, SYSUDUMP,
or SYSMDUMP) depends on the JCL for the job. A dump request is only
valid when made while the job is running. Dumps are not taken during
job allocation or deallocation.
Note: You
can use DUMP with any of the other CANCEL parameters.
- A=asid
- The hexadecimal address space identifier of the work unit you
want to cancel.
If more than one work unit is running with the
same job name, identifier, combination of job name and identifier,
or user ID that you specified on the CANCEL command, the system rejects
the command because it does not know which work unit to cancel. To
avoid this, you must add the parameter A=asid to your original
CANCEL command in order to specify the address space identifier of
the work unit.
Note: If the asterisk format is used,
you will not be prompted for A=asid. Rather, all work units
meeting the specified criteria will be canceled.
You
can use the CANCEL operator command to cancel z/OS UNIX address
spaces. Each address space is equivalent to a z/OS UNIX process.
To
find out the address space identifier for a unit of work, you can
use the DISPLAY command as follows:
- DISPLAY JOBS,ALL
- Lists the address space identifiers for all batch jobs and started
tasks.
- DISPLAY ASCH,ALL
- Lists the address space identifiers for all APPC/MVS transaction
programs.
- DISPLAY TS,ALL
- Lists the address space identifiers for all logged-on time-sharing
users.
- DISPLAY OMVS,ASID=ALL or DISPLAY
OMVS,A=ALL
- Lists the address space identifiers for all z/OS UNIX processes.
Note: A=asid can be used with any of the
other CANCEL parameters except if you specify jobname.identifier with
an asterisk (for example, CANCEL aor2.tl*).
- ARMRESTART
- Indicates that the batch job or started task should be automatically
restarted after the cancel completes, if it is registered as an element
of the automatic restart manager. If the job or task is not registered
or if you do not specify this parameter, MVS™ will
not automatically restart the job or task.
Example 1:
Cancel the job named EXAMPLE and take a dump.
c example,dump
Example 2:
Cancel the job named EXAMPLE. Whether you get a dump or not depends
on the system routine in control when you enter the command.
c example
Example 3:
Of all jobs named EXAMPLE in the system, cancel only the one whose
address space identifier is 7F.
c example,a=7F
Example 4:
Log off the system the user just logging on who has an address
space identifier of 3D but does not yet have a unique user identifier.
c u=*logon*,a=3d
Example 5:
Log user A237 off the system.
c u=a237
Example 6:
Log user A237 off the system and take a dump.
c u=a237,dump
Example 7:
Cancel the MOUNT command that requests a volume to be mounted on
device number 232, enter:
c 232
Example 8:
Cancel the MOUNT command that requests a volume to be mounted on
a 3330 device type.
c 3330
Example 9:
End the device allocation for a writer with device number 00E.
c 00e
Example 10:
End the output processing being done for device number 00E and
cause another output data set to be processed.
c 00e
Example 11:
End the output processing being done for device number 3480 and
cause another output data set to be processed.
c /3480
Example 12:
Of all the transaction programs running with the job name MAIL,
end only the one whose address space identifier is 2C, which is the
APPC/MVS scheduler (ASCH) initiator ASID.
C mail,a=2c
Example 13:
End the device allocation for a writer on device number F00E.
c /f00e
Example 14:
There are several tasks running with jobname AOR2. End all of those
tasks.
c aor2.*
Example 15:
There are several tasks running with jobname AOR2. Some of those
tasks have
identifiers beginning T1. End only those specific
tasks.
c aor2.t1*
Example 16:
The following example shows an operator session that cancels a
process that is running the shell command
sleep 6000 for
the TSO/E user CHAD.
DISPLAY OMVS,U=CHAD
BPXO001I 17.12.23 DISPLAY OMVS 700 C
OMVS ACTIVE BPXPRMHF
USER JOBNAME ASID PID PPID STATE START CT_SECS
CHAD CHAD 001D 262147 1 RI 17.00.10 1.203
CHAD CHAD 001B 131076 5 SI 17.00.10 .111
LATCHWAITPID= 0 CMD=sleep 6000
CHAD CHAD 0041 5 262147 IW 17.00.10 .596
LATCHWAITPID= 0 CMD=-sh
CHAD CHAD3 001B 131076 5 SI 17.00.10 .111
LATCHWAITPID= 0 CMD=sleep 6000
If you want to cancel only the process that is running the shell
command
sleep 6000, enter:
CANCEL CHAD3
If you want to cancel the TSO/E user CHAD altogether, enter:
CANCEL U=CHAD