arcclean(1)

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

NAME

6       arcclean - ARC Clean
7
8

DESCRIPTION

10       The arcclean command removes a job from the remote cluster.
11
12

SYNOPSIS

14       arcclean [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       -f, --force
39              removes  the  job from the local list of jobs even if the job is
40              not found in the cluster's information system
41
42       -P, --listplugins
43              list the available plugins
44
45       -t, --timeout=seconds
46              timeout in seconds (default 20)
47
48       -z, --conffile=filename
49              configuration file (default ~/.arc/client.conf)
50
51       -d, --debug=debuglevel
52              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
53
54       -v, --version
55              print version information
56
57       -?, --help
58              print help
59

ARGUMENTS

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

EXTENDED DESCRIPTION

65       The arcclean command removes a job from the remote cluster.  Only  jobs
66       that have finished can be removed. The job can be referred to either by
67       the jobid that was returned by arcsub(1) at submission time or  by  its
68       jobname  if  the job description that was submitted contained a jobname
69       attribute.
70
71       More than one jobid and/or jobname can be given. If several  jobs  were
72       submitted  with  the  same  jobname  all those jobs are removed. If the
73       --joblist option is used the list of jobs is read from a file with  the
74       specified filename. By specifying the --all option, all active jobs can
75       be removed.
76
77       The --cluster option can be used to select or reject jobs  at  specific
78       clusters.  See arcsub(1) for a discussion of the format of arguments to
79       this option. The --status option can be used to select jobs in  a  spe‐
80       cific state. These options can be repeated several times. See arstat(1)
81       for possible state values.
82
83       The --force option removes the job from your local list of jobs even if
84       the job can not be found in the remote information system. Jobs not ap‐
85       pearing in the remote information system can also be removed  from  the
86       local list by specifying the --status option with value Undefined.
87
88
89

FILES

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

ENVIRONMENT VARIABLES

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

COPYRIGHT

130       APACHE LICENSE Version 2.0
131
132

AUTHOR

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