arccat(1)

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

NAME

6       arccat - ARC Catenate
7
8

DESCRIPTION

10       The  arccat  command can be used to view the stdout or stderr of a run‐
11       ning job. It can also be used to show A-REX's error log of a job.
12
13

SYNOPSIS

15       arccat [options] [job ...]
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 jobIDs
28
29       -c, --cluster=name
30              select  one or more computing elements: name can be an alias for
31              a single CE, a group of CEs or a URL
32
33       -r, --rejectmanagement=URL
34              skip jobs which are on a computing element with a given URL
35
36       -s, --status=statusstr
37              only select jobs whose status is statusstr
38
39       -o, --stdout
40              show the stdout of the job (default)
41
42       -e, --stderr
43              show the stderr of the job
44
45       -l, --joblog
46              show A-REX's error log of the job
47
48       -P, --listplugins
49              list the available plugins
50
51       -t, --timeout=seconds
52              timeout in seconds (default 20)
53
54       -z, --conffile=filename
55              configuration file (default ~/.arc/client.conf)
56
57       -d, --debug=debuglevel
58              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
59
60       -v, --version
61              print version information
62
63       -?, --help
64              print help
65

ARGUMENTS

67       job ...
68              list of jobids and/or jobnames
69

EXTENDED DESCRIPTION

71       The arccat command displays the stdout or stderr of  running  jobs.  It
72       can also display A-REX's error log of a job. The job can be referred to
73       either by the jobid that was returned by arcsub(1) at  submission  time
74       or by its jobname if the job description that was submitted contained a
75       jobname attribute.
76
77       More than one jobid and/or jobname can be given. If several  jobs  were
78       submitted  with  the same jobname the stdout, stderr or A-REX error log
79       of all those jobs are shown. If the --joblist option is used  the  list
80       of  jobs is read from a file with the specified filename. By specifying
81       the --all option, the stdout, stderr or A-REX error log of  all  active
82       jobs will be shown.
83
84       The  --cluster  option can be used to select or reject jobs at specific
85       clusters. See arcsub(1) for a discussion of the format of arguments  to
86       this  option.  The --status option can be used to select jobs in a spe‐
87       cific state. These options can be repeated several times. See arstat(1)
88       for possible state values.
89
90       Only  jobs  where  the  stdout  or stderr argument was given in the job
91       description can display the contents of those files.
92
93

FILES

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

ENVIRONMENT VARIABLES

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

COPYRIGHT

134       APACHE LICENSE Version 2.0
135
136

AUTHOR

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