1ARCCAT(1) NorduGrid Users Manual ARCCAT(1)
2
3
4
6 arccat - ARC Catenate
7
8
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
16 arccat [options] [job ...]
17
18
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
64 job ...
65 list of jobids and/or jobnames
66
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
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
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
134 Bjarte Mohn <bjarte.mohn@fysast.uu.se>
135
136
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)