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
85       appearing 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
94              option  a  different  configuration  file  can  be used than the
95              default.
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
101              removed from the remote cluster it is removed  from  this  list.
102              This  list  is used as the list of all active jobs when the user
103              specifies the --all option to the  various  NorduGrid  ARC  user
104              interface  commands.  By  using the --joblist option a different
105              file 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
111              unless 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