$G C

Function

To terminate the scheduling or execution of a job at another node and provide a storage dump if requested.

Syntax


>>-$G--C--+---------+--,'jobname'--+-,J--|--JOB--n-+------------>
          +-N--nnnn-+              +-,S--|--STC--n-+   
          +-name----+              '-,T--|--TSU--n-'   
          '-destid--'                                  

>--,O=--+-LOCAL--|--ANYLOCAL---+--+-,D--ump--+-----------------><
        +-N--nnnn--|--nodename-+  '-,P--urge-'   
        '-destid---------------'

Parameters

Dump

JES2 provides a storage dump.

J|JOBn or S|STCn or T|TSUn

The job ID (batch job (Jn), started task (Sn), or time-sharing user (Tn)) assigned to the job by its originating node. This operand is necessary only if more than one job exists with the specified job name.

‘jobname'

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 the job did not originate at the sending node (or have default print and/or punch output for the sending node), the destination node must have the sending node flagged as having network authority.

Note: Started tasks and time-sharing users can be cancelled only after they completed execution.

Nnnnn|name|destid

The destination node to which JES2 sends this command. You can specify this location by an alias for the name of a node. The destination node must have the sending node flagged as having job authority.

O=

The node on which the job originated. You must specify this parameter if the originating node is not the node at which this $G C command is entered. If you fail to identify the originating node, JES2 issues the $HASP693 message which indicates the job was not found. The valid specifications:

LOCAL|ANYLOCAL: Indicates that jobs are to be run at the local node.
Nnnnn|nodename: Indicates that jobs are to be run at the specified node(s). You can specify a node using a decimal node identifier from 1 to 32767 or an EBCDIC nodename.
destid: Indicates that jobs are to be run at the specified node(s). You can specify this location by an alias for the name of a node.

Note: This parameter requires that the destination node has the sending node flagged as having network authority.

Purge

JES2 cancels the job output. You must specify this operand to cancel a job that is already in the output phase.

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.

For the authority required at the destination node, see Displaying and controlling jobs at other nodes.

Processing Considerations

If you do not know the job ID of the job with this jobname, use the $G D command to display the job IDs of all jobs with this jobname at a specific node.
The $T NODE,Auth= command sets the command authority of a specified node.

Scope

Network-wide. This command only needs to be issued from a single member; the command has an effect across the entire MAS.

Messages

The $HASP000 message indicates the command has been accepted.

The $HASP890 message, displaying the current status of the indicated job, is sent from node 2 to node 1.

Examples

 1   $g c n2,'myjob'

           $HASP000 OK
  JOB00018 $HASP540 MYJOB   ON L15.SR1     285 RECORDS
 JOB00017 N2   M2  $HASP890 MYJOB   EXECUTING A PRIO  9 CANCEL IBM2

JES2 sends a global cancel command record through the network to node 2. Node 2 terminates the job named MYJOB (if found and owned by the sending node) and then sends the $HASP890 to the sending node.

The following messages are displayed on the console at node 2:

 2   JOB00017 $H ASP395 MYJOB   ENDED
           $HASP309    INIT 3 INACTIVE ******** C=ABC
  JOB00017 $HASP530 MYJOB   ON L15.ST1          285 RECORDS
           $HASP534 L15.ST1 INACTIVE
  JOB00017 $HASP250 MYJOB   IS PURGED