Hide keyboard shortcuts

Hot-keys on this page

r m x p   toggle line displays

j k   next/prev highlighted chunk

0   (zero) top of page

1   (one) first highlighted chunk

1# This file is part of ctrl_bps. 

2# 

3# Developed for the LSST Data Management System. 

4# This product includes software developed by the LSST Project 

5# (https://www.lsst.org). 

6# See the COPYRIGHT file at the top-level directory of this distribution 

7# for details of code ownership. 

8# 

9# This program is free software: you can redistribute it and/or modify 

10# it under the terms of the GNU General Public License as published by 

11# the Free Software Foundation, either version 3 of the License, or 

12# (at your option) any later version. 

13# 

14# This program is distributed in the hope that it will be useful, 

15# but WITHOUT ANY WARRANTY; without even the implied warranty of 

16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

17# GNU General Public License for more details. 

18# 

19# You should have received a copy of the GNU General Public License 

20# along with this program. If not, see <https://www.gnu.org/licenses/>. 

21 

22"""API for cancelling runs submitted to a WMS. 

23""" 

24 

25import logging 

26 

27from lsst.utils import doImport 

28 

29 

30_LOG = logging.getLogger(__name__) 

31 

32 

33def cancel(wms_service, wms_id=None, user=None, require_bps=True, pass_thru=None, is_global=False): 

34 """Cancel submitted workflows. 

35 

36 Parameters 

37 ---------- 

38 wms_service : `str` or `lsst.ctrl.bps.BaseWmsService` 

39 Name of the Workload Management System service class. 

40 wms_id : `str`, optional 

41 ID or path of job that should be canceled. 

42 user : `str`, optional 

43 User whose submitted jobs should be canceled. 

44 require_bps : `bool`, optional 

45 Whether to require given run_id/user to be a bps submitted job. 

46 pass_thru : `str`, optional 

47 Information to pass through to WMS. 

48 is_global : `bool`, optional 

49 If set, all available job queues will be checked for jobs to cancel. 

50 Defaults to False which means that only a local job queue will be 

51 checked. 

52 

53 Only applicable in the context of a WMS using distributed job queues 

54 (e.g., HTCondor). 

55 """ 

56 _LOG.debug("Cancel params: wms_id=%s, user=%s, require_bps=%s, pass_thru=%s, is_global=%s", 

57 wms_id, user, require_bps, pass_thru, is_global) 

58 

59 if isinstance(wms_service, str): 

60 wms_service_class = doImport(wms_service) 

61 service = wms_service_class({}) 

62 else: 

63 service = wms_service 

64 

65 jobs = service.list_submitted_jobs(wms_id, user, require_bps, pass_thru, is_global) 

66 if len(jobs) == 0: 

67 print("No job matches the search criteria. " 

68 "Hints: Double check id, and/or use --global to search all job queues.") 

69 else: 

70 for job_id in sorted(jobs): 

71 results = service.cancel(job_id, pass_thru) 

72 if results[0]: 

73 print(f"Successfully canceled job with id '{job_id}'") 

74 else: 

75 print(f"Couldn't cancel job with id '{job_id}' ({results[1]})")