arckill(1)

1ARCKILL(1)                  NorduGrid Users Manual                  ARCKILL(1)
2
3
4

NAME

6       arckill - ARC Kill
7
8

DESCRIPTION

10       The arckill command is used to kill running jobs.
11
12

SYNOPSIS

14       arckill [options] [job ...]
15
16

OPTIONS

18       -a, --all
19              all jobs
20
21       -j, --joblist=filename
22              the   file   storing  information  about  active  jobs  (default
23              ~/.arc/jobs.xml)
24
25       -i, --jobids-from-file=filename
26              a file containing a list of jobIDs
27
28       -c, --cluster=name
29              select one or more computing elements: name can be an alias  for
30              a single CE, a group of CEs or a URL
31
32       -r, --rejectmanagement=URL
33              skip jobs which are on a computing element with a given URL
34
35       -s, --status=statusstr
36              only select jobs whose status is statusstr
37
38       -k, --keep
39              keep files on the remote cluster (do not clean)
40
41       -P, --listplugins
42              list the available plugins
43
44       -t, --timeout=seconds
45              timeout in seconds (default 20)
46
47       -z, --conffile=filename
48              configuration file (default ~/.arc/client.conf)
49
50       -d, --debug=debuglevel
51              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
52
53       -v, --version
54              print version information
55
56       -?, --help
57              print help
58

ARGUMENTS

60       job ...
61              list of jobids and/or jobnames
62

EXTENDED DESCRIPTION

64       The arckill command kills a running job on an ARC enabled resource. The
65       job can be referred to either by the jobid that was  returned  by  arc‐
66       sub(1) at submission time or by its jobname if the job description that
67       was submitted contained a jobname attribute.
68
69       More than one jobid and/or jobname can be given. If several  jobs  were
70       submitted  with  the  same  jobname  all  those jobs are killed. If the
71       --joblist option is used the list of jobs is read from a file with  the
72       specified  filename.  By  specifying  the --all option, all jobs can be
73       killed.
74
75       The --cluster option can be used to select or reject jobs  at  specific
76       clusters.  See arcsub(1) for a discussion of the format of arguments to
77       this option. The --status option can be used to select jobs in  a  spe‐
78       cific state. These options can be repeated several times. See arstat(1)
79       for possible state values.
80
81       If the job was successfully killed the attepmt to remove the  job  from
82       the remote cluster will be made unless the --keep option was specified.
83       Depending on functionality of service job killing  procedure  may  take
84       time  and  it may be impossible to clean job immediately.  In that case
85       arckill will report number of cleaned jobs smaller than processed ones.
86       Cleaning of leftover jobs may be performed by running arcclean later.
87
88

FILES

90       ~/.arc/client.conf
91              Some  options  can be given default values by specifying them in
92              the ARC client  configuration  file.  By  using  the  --conffile
93              option  a  different  configuration  file  can  be used than the
94              default.
95
96
97       ~/.arc/jobs.xml
98              This a local list of the user's active jobs. When a job is  suc‐
99              cessfully  submitted  it  is  added  to this list and when it is
100              removed from the remote cluster it is removed  from  this  list.
101              This  list  is used as the list of all active jobs when the user
102              specifies the --all option to the  various  NorduGrid  ARC  user
103              interface  commands.  By  using the --joblist option a different
104              file can be used than the default.
105
106

ENVIRONMENT VARIABLES

108       X509_USER_PROXY
109              The location of the user's Grid proxy  file.  Shouldn't  be  set
110              unless the proxy is in a non-standard location.
111
112
113       ARC_LOCATION
114              The  location  where  ARC  is installed can be specified by this
115              variable. If not specified the install location will  be  deter‐
116              mined  from  the path to the command being executed, and if this
117              fails a WARNING will be given stating the location which will be
118              used.
119
120
121       ARC_PLUGIN_PATH
122              The  location  of ARC plugins can be specified by this variable.
123              Multiple locations can be specified by separating them by  :  (;
124              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
125              Windows).
126
127

COPYRIGHT

129       APACHE LICENSE Version 2.0
130
131

AUTHOR

133       ARC   software   is   developed   by   the   NorduGrid    Collaboration
134       (http://www.nordugrid.org), please consult the AUTHORS file distributed
135       with   ARC.   Please   report   bugs   and    feature    requests    to
136       http://bugzilla.nordugrid.org
137
138