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

NAME

6       arcresub - ARC Resubmission
7
8

DESCRIPTION

10       The arcresub command is used for resubmitting jobs to grid enabled com‐
11       puting resources.
12
13

SYNOPSIS

15       arcresub [options] [jobid ...]
16
17

OPTIONS

19       -a, --all
20              all jobs
21
22       -j, --joblist=filename
23              the  file  storing  information  about  active   jobs   (default
24              ~/.arc/jobs.xml)
25
26       -i, --jobids-from-file=filename
27              a file containing a list of job IDs
28
29       -o, --jobids-to-file=filename
30              the IDs of the submitted jobs will be appended to this file
31
32       -c, --cluster=name
33              select  one or more computing elements: name can be an alias for
34              a single CE, a group of CEs or a URL
35
36       -q, --qluster=name
37              select one or more computing elements for the new jobs: name can
38              be an alias for a single CE, a group of CEs or a URL
39
40       -g, --index=name
41              select one or more registries: name can be an alias for a single
42              registry, a group of registries or a URL
43
44       -r, --rejectmanagement=URL
45              skip jobs which are on a computing element with a given URL
46
47       -R, --rejectdiscovery=URL
48              skip the service with the given URL during service discovery
49
50       -S, --submissioninterface=InterfaceName
51              only  use  this  interface   for   submitting   (e.g.   org.nor‐
52              dugrid.gridftpjob,          org.ogf.glue.emies.activitycreation,
53              org.ogf.bes)
54
55       -I, --infointerface=InterfaceName
56              the computing element specified  by  URL  at  the  command  line
57              should be queried using this information interface (possible op‐
58              tions: org.nordugrid.ldapng,  org.nordugrid.ldapglue2,  org.nor‐
59              dugrid.wsrfglue2, org.ogf.glue.emies.resourceinfo)
60
61       -k, --keep
62              keep the files on the server (do not clean)
63
64       -m, --same
65              resubmit to the same cluster
66
67       -M, --not-same
68              do not resubmit to the same cluster
69
70       -s, --status=statusstr
71              only select jobs whose status is statusstr
72
73       -P, --listplugins
74              list the available plugins
75
76       -t, --timeout=seconds
77              timeout in seconds (default 20)
78
79       -z, --conffile=filename
80              configuration file (default ~/.arc/client.conf)
81
82       -d, --debug=debuglevel
83              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
84
85       -b, --broker=broker
86              selected broker: Random (default), FastestQueue or custom
87
88       -v, --version
89              print version information
90
91       -?, --help
92              print help
93

ARGUMENTS

95       jobid ...
96              job ID or job name of jobs to be resubmitted
97

EXTENDED DESCRIPTION

99       The arcresub command is used for resubmitting jobs on grid enabled com‐
100       puting resources.  The job can be referred to either by the job ID that
101       was  returned  by arcsub(1) at submission time or by its jobname if the
102       job description that was submitted contained a jobname attribute.
103
104       More than one job ID and/or jobname can be given. If several jobs  were
105       submitted with the same jobname all those jobs will be resubmitted.
106
107       If  the job description of a job to be resubmitted, contained any local
108       input files, checksums of these was calculated and stored  in  the  job
109       list,  and  those  will be used to check whether the files has changed.
110       If local input files has changed the job will not be resubmitted.
111
112       In case the job description is not found in the job list,  it  will  be
113       retrieved  from  the  cluster holding the job. This description however
114       might differ from the one originally used to submit the job, since both
115       the  submission  client  and the cluster can have made modifications to
116       the job description.
117
118       Upon resubmision the job will receive a new job ID, and the old job  ID
119       will be stored in the local job list file, enabling future back tracing
120       of the resubmitted job.
121
122       The name of the local job list file can used specified by the --joblist
123       option.  By  specifying the --all option, all active jobs appearing the
124       in job list file will be resubmitted.
125
126       The --cluster option can be used to select or reject jobs  at  specific
127       clusters  to be resubmitted. See arcsub(1) for a discussion of the for‐
128       mat of arguments to this option.  The --qluster option can be  used  to
129       force  the jobs to be resubmitted to a particular cluster, or to reject
130       resubmission to a particular cluster. Again see arcsub(1) for a discus‐
131       sion  of  the  format of arguments to this option.  The --status option
132       can be used to select jobs in a specific state. These  options  can  be
133       repeated several times. See arstat(1) for possible state values.  Which
134       servers to query can be specified by giving the --index option  to  the
135       command.  See  arcsub(1) for a discussion of the format of arguments to
136       this option.
137
138       The default behaviour of arcresub is to resubmit to any  cluster.  This
139       behaviour  can  be  changed  by specifying the --same or --not-same op‐
140       tions. The former will resubmit a job to the same cluster  as  the  job
141       resides,  and  thus  the --qluster and --index options is ignored.  The
142       latter will resubmit a job to any cluster except to the cluster it  re‐
143       sides.  Note  the --same and --not-same options cannot be specified to‐
144       gether.
145
146       If the old job was successfully killed the job will be removed from the
147       remote cluster unless the --keep option was specified.
148
149

FILES

151       ~/.arc/client.conf
152              Some  options  can be given default values by specifying them in
153              the ARC client configuration file. By using the  --conffile  op‐
154              tion  a  different  configuration  file can be used than the de‐
155              fault.
156
157
158       ~/.arc/jobs.xml
159              This a local list of the user's active jobs. When a job is  suc‐
160              cessfully  submitted it is added to this list and when it is re‐
161              moved from the remote cluster it is removed from this list. This
162              list is used as the list of all active jobs when the user speci‐
163              fies the
164
165

ENVIRONMENT VARIABLES

167       X509_USER_PROXY
168              The location of the user's Grid proxy file. Shouldn't be set un‐
169              less the proxy is in a non-standard location.
170
171
172       ARC_LOCATION
173              The  location  where  ARC  is installed can be specified by this
174              variable. If not specified the install location will  be  deter‐
175              mined  from  the path to the command being executed, and if this
176              fails a WARNING will be given stating the location which will be
177              used.
178
179
180       ARC_PLUGIN_PATH
181              The  location  of ARC plugins can be specified by this variable.
182              Multiple locations can be specified by separating them by  :  (;
183              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
184              Windows).
185
186
188       APACHE LICENSE Version 2.0
189
190

AUTHOR

192       ARC   software   is   developed   by   the   NorduGrid    Collaboration
193       (http://www.nordugrid.org), please consult the AUTHORS file distributed
194       with   ARC.   Please   report   bugs   and    feature    requests    to
195       http://bugzilla.nordugrid.org
196
197

SEE ALSO

199       arccat(1),  arcclean(1),  arccp(1),  arcget(1), arcinfo(1), arckill(1),
200       arcls(1),  arcmkdir(1),  arcproxy(1),  arcrenew(1),  arcresume(1),  ar‐
201       crm(1), arcstat(1), arcsub(1), arcsync(1), arctest(1)
202
203
204
205
206NorduGrid ARC 6.15.1              2022-07-03                       ARCRESUB(1)
Impressum