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 the grid manager's error log of a
12       job.
13
14

SYNOPSIS

16       arccat [options] [job ...]
17
18

OPTIONS

20       -a, --all
21              all jobs
22
23       -j, --joblist=filename
24              the   file   storing  information  about  active  jobs  (default
25              ~/.arc/jobs.xml)
26
27       -i, --jobids-from-file=filename
28              a file containing a list of jobIDs
29
30       -c, --cluster=[-]name
31              explicitly select or reject a specific cluster
32
33       -s, --status=statusstr
34              only select jobs whose status is statusstr
35
36       -o, --stdout
37              show the stdout of the job (default)
38
39       -e, --stderr
40              show the stderr of the job
41
42       -l, --joblog
43              show the grid manager's error log of the job
44
45       -P, --listplugins
46              list the available plugins
47
48       -t, --timeout=seconds
49              timeout in seconds (default 20)
50
51       -z, --conffile=filename
52              configuration file (default ~/.arc/client.conf)
53
54       -d, --debug=debuglevel
55              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
56
57       -v, --version
58              print version information
59
60       -?, --help
61              print help
62

ARGUMENTS

64       job ...
65              list of jobids and/or jobnames
66

EXTENDED DESCRIPTION

68       The arccat command displays the stdout or stderr of  running  jobs.  It
69       can  also display the grid manager's error log of a job. The job can be
70       referred to either by the jobid that was returned by arcsub(1) at  sub‐
71       mission  time or by its jobname if the job description that was submit‐
72       ted contained a jobname attribute.
73
74       More than one jobid and/or jobname can be given. If several  jobs  were
75       submitted  with  the  same  jobname  the stdout, stderr or grid manager
76       error log of all those jobs are shown. If the --joblist option is  used
77       the  list  of  jobs is read from a file with the specified filename. By
78       specifying the --all option, the stdout, stderr or grid  manager  error
79       log of all active jobs will be shown.
80
81       The  --cluster  option can be used to select or reject jobs at specific
82       clusters. See arcsub(1) for a discussion of the format of arguments  to
83       this  option.  The --status option can be used to select jobs in a spe‐
84       cific state. These options can be repeated several times.
85
86       Only jobs where the stdout or stderr argument  was  given  in  the  job
87       description can display the contents of those files.
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
130       APACHE LICENSE Version 2.0
131
132

AUTHOR

134       Bjarte Mohn <bjarte.mohn@fysast.uu.se>
135
136

SEE ALSO

138       arcclean(1), arccp(1),  arcget(1),  arcinfo(1),  arckill(1),  arcls(1),
139       arcmigrate(1),  arcproxy(1),  arcrenew(1),  arcresub(1),  arcresume(1),
140       arcrm(1), arcstat(1), arcsub(1), arcsync(1), arctest(1)
141
142
143
144
145NorduGrid ARC 1.1.0               2011-10-24                         ARCCAT(1)
Impressum