Function

Parameters

Age|DAys<days | Age|DAys>days

Specifies the age of affected jobs in days. Only jobs more (with DAYS>nn) or less (with DAYS<nn) than the specified number of days in age are affected, The days are counted from the current hour.

ARMRESTART

Specify ARMRESTART to request that the automatic restart management automatically restart each specified job after it is cancelled, if that job is registered with the automatic restart management. ARMRESTART is ignored if the job is not executing or is not registered with the automatic restart management.

ARMRESTART is mutually exclusive with PURGE.

BUSY=

Specifies one of the following:

• The system name or number on which the job is busy. Note that you can specify a value of 0 to indicate the job is not busy. You can also specify values above 32 to match systems with invalid values in the BUSY value (for example, $CJOBQ,BUSY>32)
• YES or ANY, indicating that all busy jobs are to match
• NO or NONE, indicating that all non-busy jobs are to match

CARDS=cards

Specifies the number of input cards associated with the job.

CC=(ABEND|ABENDED|CANcelled|CNVT_abend|CODE| COMPleted|ENDed_by_cc|EOM_failure|JCLerror| SECurity_failure|TYPE)

Specifies the completion information associated with the job.

ABENDED

Specifies only jobs which have abnormally ended.

ABEND

Specifies the ABEND code associated with the job's termination.

CANcelled

Specifies only jobs which were cancelled by the operator.

CNVT_abend

Specifies only jobs which have abnormally ended during the conversion phase.

CODE

Specifies the last (or highest) completion code of steps in the job.

COMPleted

Specifies only jobs which completed.

ENDed_by_cc

Specifies only jobs which were ended by a step completion code.

EOM_failure

Specifies only jobs which failed in end-of-memory processing.

JCLerror

Specifies jobs which did not execute due to a JCL error.

SECurity_failure

Specifies jobs which failed security validation.

Class=class

Specifies a job class used to select a subset of jobs that have a matching job class. Wildcard characters can also be specified: see Using wildcards for details.

CMDauth=(auth1{,auth2})

Only the jobs that can be affected from the specified remote(s) or node(s) will be cancelled. The valid specifications are:

LOCAL|ANYLOCAL

Only the local devices at the local node can affect the output.

Nnnnn|nodename

Only local devices at the specified node can affect the output.

Rnnnn

Only the specified remote device can affect the output.

NnnnnRnnnn|nodename.Rnnnn

Only the specified remote device at the specified remote node can affect the output.

destid

A destid corresponding to any of the above remote devices.

Note: Specification of the CMDAUTH filter does not override the authority of the console from which the command is issued; both the authority of the console and the specified CMDAUTH filter must match for the job to be affected.

DELAY={BUSY_ON_HOLD|HOLD|LIMIT|LOCKED| No|QUEUE_ERROR|SCHENV|SECLABEL|SPOOLS_NOT_AVAILABLE|SYSAFF| MEMBER_STATUS|Yes}

Specifies reasons why a pre-execution job will not enter execution:

BUSY_ON_DEVICE

The job does not execute because it is busy on a device (such as an offload job transmitter).

HOLD

The job does not execute because it is held, its job class is held, or another job with the same jobname is executing.

LIMIT

The job does not execute because the job class execution limit has been reached (as specified by JOBCLASS XEQCOUNT=(MAX=)).

LOCKED

The job does not execute because it's being updated by JES2.

SECLABEL

The security label (SECLABEL) assigned to the job is not defined as active on any member that is active.

SYSAFF

Each of the members for which the job has affinity (SYSAFF) is inactive, or the job has specified independent state, and the JES2 member is not independent (IND=NO).

SCHENV

The job's scheduling environment is not available on any member, or is available only on systems where JES2 is inactive. Use the $DJ'jobname',LONG command to find out what scheduling environment a job requires. Then use the D WLM,SCHENV=schenv-name command to find out the current status of the scheduling environment on each system in the sysplex.

The SCHENV state masks other reasons why the job might be ineligible to run, such as the $P and $P XEQ commands having been issued. Also, note that the SCHENV delay is detected only after a job goes through conversion. If a job is delayed prior to conversion because of system affinity requirements, scheduling environments are not considered in determining delay status.

MEMBER_STATUS

A combination of system affinity, scheduling environment and SECLABEL restrictions is preventing the job from running or other member events prevent the job from running on systems where the job is otherwise eligible. These events on other members include the following:

• $P command has been issued
• $P XEQ command has been issued
• BOSS=NO (used in a poly-JES environment only)

When used as a command filter, the string MEMBER_STATUS matches jobs delayed for SYSAFF, SCHENV, SECLABEL, or MEMBER_STATUS. To get detail on why a job is delayed, display job status with the $DJ'jobname', LONG command or display member status with the $DJMEMBER(member-name) command.

Yes

Specifies only jobs which are delayed for any of the above reasons.

No

Specifies only jobs which are not delayed for any of the above reasons.

Dump|D

If the job is waiting for conversion, actively in conversion, or in execution, JES2 provides a storage dump.

HOLD=

Specifies the hold status of the job.

ALL

Specifies jobs held by the $H A command.

JOB

Specifies jobs held by the $H J command, TYPRUN=HOLD, TYPRUN=JCLHOLD, or held due to error.

DUP

Specifies jobs held for duplicate job name.

ARM

Specifies jobs which are held awaiting restart through ARM.

NONE

Specifies jobs which are not held.

Hours=hours

Specifies the age of affected jobs in hours. Only jobs more (with HOURS>nn) or less (with HOURS<nn) than the specified number of hours in age are affected.

JC|JOBCORR=job correlator

Specifies a combination of 1-64 alphanumeric, special (colon, period or underscore) and wildcard characters that can be used to select a subset of jobs that have a matching job correlator. For a description of wildcard characters, refer to Using wildcards.

JM|JOBMASK=jobmask

Specifies 1 to 8 alphanumeric, special ($, #, or @) or wild card characters (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask). For additional information, see Using wildcards.

job

Specifies 1 to 8 alphanumeric, special ($, #, or @) or wildcard characters. (or a combination of them) that can be used to select a subset of jobs whose job name matches this combination of characters (mask). For additional information, see Using wildcards.

‘job'

The name of the job that is cancelled. This name must appear as coded on the JOB statement and must be enclosed in apostrophes. If more than one job exists with this name, no action is taken.

Job

A batch job or range of batch jobs is to be cancelled.

JOBQ|JQ

Specifies all jobs, STCs, and TSUs across the MAS for processing.

OFFS=offs

Specifies offload device numbers on which the job has been archived.

PROTected

Indicates that all output groups, including output groups that have been specified ‘protected', should be purged. The 'protected' attribute is assigned to programs running in a transactional environment such as APPC or OMVS, where the transaction output is associated with the initiators like ASCHINIT or BPXAS. The ‘protected' attribute for output can also be assigned to jobs by JES2 installation exits. This parameter is only valid when used with the PURGE parameter.

Purge

JES2 purges the job output.

Note:

1. The P operand must be specified to terminate jobs that are already in the output phase.
2. $C with the P operand will not purge a job with affinity to an inactive processor until the job's affinity has been changed with the $TJ,S= command.
3. If the TSO/E user has affinity to an inactive member, the TSO/E notify message will not be issued when you specify the P operand.
4. $C with the P operand is ignored for output that is active on an FSS printer.

PURGE is mutually exclusive with ARMRESTART.

Queue={CNV|INPUT|OUT|PPU|PURGE|RCV| SETUP|SPIN|XEQ|XMT}

Only jobs on the specified job queue are to be cancelled.

CNV

Only jobs awaiting conversion are to be cancelled.

INPUT

Only jobs on the JES2 $INPUT queue are to be cancelled.

OUT

Only jobs awaiting output processing are to be cancelled.

PPU

Only jobs awaiting print/punch processing are to be cancelled.

PURGE

Only jobs awaiting purge processing are to be cancelled.

RCV

Only jobs on the JES2 $RECEIVE queue are to be cancelled.

SETUP

Only jobs on the JES2 $SETUP queue are to be cancelled.

SPIN

Only jobs awaiting spin processing are to be cancelled.

XEQ

All jobs awaiting execution and in execution are to be cancelled.

XMT

Only jobs queued for network transmission are to be cancelled.

SCHENV=schenv

Specifies the scheduling environment associated with the job.

SCHENV_AFF=member

Specifies the JES2 MAS members on which the scheduling environment for this job is available.

SECLABEL_AFF=member

Specifies the JES2 MAS members on which the SECLABEL for this job is available but only if the RACF® SECLABEL_BY_SYS is also active.

SECLABEL=seclabel

Specifies the security label associated with the job.

SPL|SPOOL={Percent|%|Tgs|Volumes}

Only jobs with specific SPOOL characteristics are to be cancelled:

Percent|%

Only jobs using more (with %>nn) or less (with %<nn) than the specified percentage of the total available spool space are to be cancelled.

Tgs

Only jobs using more (with Tgs>nn) or less (with Tgs<nn) than the specified number of track groups are to be cancelled.

Volumes=(v1,v2,...)

Only jobs which have allocated spool space on the specified spool volume(s) are to be cancelled.

SRVCLASS=srvclass

Specifies the service class of the job. The service class is available for batch jobs only. It is not available for started tasks or time-sharing users.

Note: The default workload manager (WLM) policy assigns a service class of blanks to all jobs, and WLM-managed initiators can then select such jobs for processing.

Stc

A started task or range of started tasks is to be cancelled.

Note: Started tasks can be cancelled with the $C command:

• If they are waiting for conversion
• If they are currently in conversion
• After they have completed execution.

To cancel a started task in execution, you must use the MVS™ CANCEL command.

Sysaff

Specifies jobs to process based on this system affinity. Up to 33 entries can be coded by using a combination of the following values:

memname

Specifies the identifier (1 to 4 alphanumeric characters) of a member in the JES2 multi-access spool configuration that a job has in its system affinity list.

ANY

Specifies jobs that are eligible to run on any member in the JES2 multi-access spool configuration. If you specify ANY followed by the IND parameter, they must be separated by a comma and the list must be enclosed in parentheses, for example, (ANY,IND).

IND

Specifies the job that is selected and must be executed on a processor operating in independent mode.

Tsu

A time-sharing user or range of time-sharing users is to be cancelled.

TYPE={JOB|STC|TSU}

Indicates whether only batch jobs (JOB), started tasks (STC), or time-sharing users (TSU) are to be cancelled.

USERID=userid

Specifies the userid associated with the job.

XEQNode=xeqnode

Only jobs which are destined to execute at the specified node, or which have already executed at the specified node, are to be cancelled. The node name may be specified using the decimal node number (Nnnnnn) or an EBCDIC node name.

Authority Required

This command requires job authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned.

This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

• If the job does not cancel, reenter the command.
• $C cannot cancel messages that are either being spooled for a remote or being printed by a remote.
• When canceling jobs or TSUs in execution, the $C command results in an MVS CANCEL command. This allows other subsystems to monitor the canceling of jobs and, if necessary, take appropriate action.

  The MVS CANCEL command may also be used to cancel jobs in execution but the MVS command must be entered on the system where the job is running; therefore, using the $C command gives you more flexibility.

• When canceling a TSU or STC that is waiting for conversion, or actively in conversion, the $C command must be entered on the same member where the TSU or STC is active.
• When canceling a job, TSU or STC that is waiting for, or actively in conversion, with the DUMP parameter also specified, be aware that the dump produced will be processed using Dump Analysis and Elimination (DAE).
• For additional capabilities, refer to the descriptions of MVS CANCEL and STOP in z/OS MVS System Commands, SA38-0666.

Scope

MAS-wide. This command has an effect across the entire MAS.

Messages

The $HASP890 message displays the status of the job.

The $HASP003 message indicates that you have issued the $C JOB command to cancel the specified job(s) without issuing the ,PROTECTED operand.

 2   $cj 'infn1',d

  JOB00032  $HASP890 JOB(INFN2)
  $HASP890 JOB(INFN2)     STATUS=(EXECUTING/SPLB),CLASS=A,
  $HASP890                PRIORITY=15,SYSAFF=(SPLB),HOLD=(NONE),
  $HASP890                CANCEL=YES
  JOB00032  IEA995I SYMPTOM DUMP OUTPUT
  SYSTEM COMPLETION CODE=122
  TIME=21.15.51  SEQ=00037  CPU=0000  ASID=0013
  PSW AT TIME OF ERROR  078D2000   00006EEE  ILC 2  INTC 14
    ACTIVE LOAD MODULE=GO        ADDRESS=00006EB8  OFFSET=00000036
    DATA AT PSW  00006EE8 - 80006F50  0A144110  00014120
    GPR  0-3  000001C0  00000001  00000001  009F69A4
    GPR  4-7  009F6980  009F3E88  009D3FF8  FD000000
    GPR  8-11 009FF1D0  809F3BA8  00006F08  009F3E88
    GPR 12-15 40006EBE  00006F08  40006EE8  00000000
    END OF SYMPTOM DUMP
  JOB00032  $HASP375 INFN1    ESTIMATED LINES EXCEEDED
  JOB00032  $HASP375 INFN1    ESTIMATE EXCEEDED BY    2,000  LINES       1%
  SPOOL
  JOB00032  IEF450I  INFN1 GO STEP1 - ABEND=S222 U0000 REASON=00000     000
            TIME=21.16.25
  JOB00032  $HASP395 INFN1     ENDED
            $HASP099 ALL AVAILABLE FUNCTIONS COMPLETE

 3   $CJ100-105,JM=?EBG*

  JOB00102  $HASP890 JOB(IEBGENER)
  $HASP890 JOB(IEBGENER)  STATUS=(AWAITING OUTPUT),CLASS=A,
  $HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),
  $HASP890                CANCEL=YES
  JOB00103  $HASP890 JOB(IEBGENEZ)
  $HASP890 JOB(IEBGENEZ)  STATUS=(AWAITING OUTPUT),CLASS=A,
  $HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),
  $HASP890                CANCEL=YES

JES cancels jobs that fall within the range of jobs 100-105, whose job name includes EBG as the second, third and fourth characters.

 4  $c jobq,jc=*:branchbankxyz,purge

$HASP890 JOB(D15USER2)  STATUS=(AWAITING PURGE),CLASS=A,                 
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),             
$HASP890                PURGE=YES,CANCEL=YES                             
JOB00101  $HASP890 JOB(D15USER3)                                        C
$HASP890 JOB(D15USER3)  STATUS=(AWAITING PURGE),CLASS=A,                 
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),             
$HASP890                PURGE=YES,CANCEL=YES                             
JOB00102  $HASP890 JOB(D15USER4)                                        C
$HASP890 JOB(D15USER4)  STATUS=(AWAITING PURGE),CLASS=A,                 
$HASP890                PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),             
$HASP890                PURGE=YES,CANCEL=YES                             
JOB00102  $HASP250 D15USER4 PURGED -- (JOB KEY WAS C88BCDC2)             
JOB00100  $HASP250 D15USER2 PURGED -- (JOB KEY WAS C88BCDC0)             
JOB00101  $HASP250 D15USER3 PURGED -- (JOB KEY WAS C88BCDC1)             

JES2 cancel all batch jobs, STCs, and TSUs with the job correlator user portion BRANCHBANKXYZ and then purges the job output.