arcget(1)

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

NAME

6       arcget - ARC Get
7
8

DESCRIPTION

10       The arcget command is used for retrieving the results from a job.
11
12

SYNOPSIS

14       arcget [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       -D, --dir=dirname
39              download  directory  (the  job directory will be created in this
40              directory)
41
42       -J, --usejobname
43              use the jobname instead of the short ID  as  the  job  directory
44              name
45
46       -k, --keep
47              keep files on the remote cluster (do not clean)
48
49       -f, --force
50              force download (overwrite existing job directory)
51
52       -P, --listplugins
53              list the available plugins
54
55       -t, --timeout=seconds
56              timeout in seconds (default 20)
57
58       -z, --conffile=filename
59              configuration file (default ~/.arc/client.conf)
60
61       -d, --debug=debuglevel
62              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
63
64       -v, --version
65              print version information
66
67       -?, --help
68              print help
69

ARGUMENTS

71       job ...
72              list of jobids and/or jobnames
73

EXTENDED DESCRIPTION

75       The  arcget  command downloads the results after a job has completed on
76       an grid enabled computing resource. Only the results of jobs that  have
77       finished  can  be  downloaded. The job can be referred to either by the
78       jobid that was returned by arcsub(1) at submission time or by its  job‐
79       name  if  the  job  description  that was submitted contained a jobname
80       attribute.
81
82       More than one jobid and/or jobname can be given. If several  jobs  were
83       submitted with the same jobname the results of all those jobs are down‐
84       loaded. If the --joblist option is used the list of jobs is read from a
85       file  with  the specified filename. By specifying the --all option, the
86       results of all active jobs are downloaded.
87
88       The --cluster option can be used to select or reject jobs  at  specific
89       clusters.  See arcsub(1) for a discussion of the format of arguments to
90       this option. The --status option can be used to select jobs in  a  spe‐
91       cific state. These options can be repeated several times. See arstat(1)
92       for possible state values.
93
94       For each job that is downloaded a subdirectory will be created  in  the
95       download directory that will contain the downloaded files.
96
97       If  the download was successful the job will be removed from the remote
98       cluster unless the --keep option was specified.
99
100

FILES

102       ~/.arc/client.conf
103              Some options can be given default values by specifying  them  in
104              the  ARC  client  configuration  file.  By  using the --conffile
105              option a different configuration  file  can  be  used  than  the
106              default.
107
108
109       ~/.arc/jobs.xml
110              This  a local list of the user's active jobs. When a job is suc‐
111              cessfully submitted it is added to this  list  and  when  it  is
112              removed  from  the  remote cluster it is removed from this list.
113              This list is used as the list of all active jobs when  the  user
114              specifies  the  --all  option  to the various NorduGrid ARC user
115              interface commands. By using the --joblist  option  a  different
116              file can be used than the default.
117
118

ENVIRONMENT VARIABLES

120       X509_USER_PROXY
121              The  location  of  the  user's Grid proxy file. Shouldn't be set
122              unless the proxy is in a non-standard location.
123
124
125       ARC_LOCATION
126              The location where ARC is installed can  be  specified  by  this
127              variable.  If  not specified the install location will be deter‐
128              mined from the path to the command being executed, and  if  this
129              fails a WARNING will be given stating the location which will be
130              used.
131
132
133       ARC_PLUGIN_PATH
134              The location of ARC plugins can be specified by  this  variable.
135              Multiple  locations  can be specified by separating them by : (;
136              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
137              Windows).
138
139

COPYRIGHT

141       APACHE LICENSE Version 2.0
142
143

AUTHOR

145       ARC    software   is   developed   by   the   NorduGrid   Collaboration
146       (http://www.nordugrid.org), please consult the AUTHORS file distributed
147       with    ARC.    Please    report   bugs   and   feature   requests   to
148       http://bugzilla.nordugrid.org
149
150