jskill command

Purpose

You can use the jskill command to stop job steps that are running or pending.

Syntax

jskill [OPTION] <list of job steps | all | shutdown>

Description

If you have job steps from the IBM® Job Step Manager (JSM) that are in a running state or a pending state, you can use the jskill command to terminate or signal the job steps.

Options

• all
  
• Terminates all processes that are in a running state and removes all job steps from the JSM queue. Note that this does not terminate reservations (See jsrun --allocate_only) which must be explicitly killed using the identifier they were assigned.
• shutdown
  Stops all processes that are in a running state, removes all job steps from the JSM queue, and shutdown the JSM.
• -c , --csm #
  If you run the jskill command outside of an allocation, you must use this option to identify the CSM allocation ID.
• -s , --signal #
  Sends the specified signal to JSM and all ranks in that job step.
• -i , --include_children
  Terminates the job step and all associated children job steps.
• -r, --ranks rank_list
  Delivers a signal to only the specified ranks. The rank list displays a list of comma-separated ranks that can include ranges and strides. For example, a rank list that contains 1,3-5,10-153 only signals the ranks 1, 3, 4, 5, 10, and 13.
• -g, --grace seconds rank_list
  Specifies that the job step(s) should be signaled with SIGTERM and then killed with SIGKILL if they have not terminated within the number of seconds specified. The option -s is ignored when this option is used.
• -? , --help
  Display help text for the command.
• -V , --version
  Displays the version of JSM.

Examples

1. To terminate all job steps that are in a running state and removes all queued job steps from JSM, run the jskill all command.

2. When you run the jslist command, output displays the following

        parent         cpus     exit
   ID     ID    nrs   per RS   status   status
   =============================================
   1      0      1       3       0      Running
   2      1      1       3       0      Running
   3      1      2       3       0      Running
   4      0      1       3       0      Running
   

In this example to terminate job step 1 and the corresponding children job steps 2 and 3, run the jskill -i 1 command. To terminate only job step 1, run the jskill 1 command.

See also

jsrun(1), jslist(1), jswait(1)

Parent topic: Job Step Manager commands