1PQ2-VERIFY(1)               General Commands Manual              PQ2-VERIFY(1)
2
3
4

NAME

6       pq2-verify  -  Extract  the content one or more datasets from a dataset
7       meta-repository based on ROOT files
8

SYNOPSIS

10       pq2-verify [options] dataset
11

DESCRIPTION

13       This manual page documents briefly the pq2-verify program.
14
15       pq2-verify is a script invoking the pq2 ROOT application to extract the
16       content  one  or  more datasets from a dataset meta-repository based on
17       ROOT files; the repository can be accessed via the local file system or
18       a remote file server daemon or a PROOF facility.
19
20       More details about the underlying 'pq2' application can be found in the
21       man page pq2(1).
22

ARGUMENTS

24       dataset
25              Datasets to be analysed; the '*' wild card in the items (in such
26              a  case  the  full  string, as shown by pq2-ls, should be given,
27              e.g. '/default/ganis/h1-set5*'.
28

OPTIONS

30       -h, --help
31              Display help information.
32
33       -k, --keep
34              Keep the temporary  files  created  during  the  analysis  under
35              $TMPDIR
36
37       -v     Verbose mode
38
39       -d <dataset>, --dataset=<dataset>
40              Alternative way to define the datasets to be analyzed
41
42       -o <options>
43              Options  for veriying datasets. These allow to control: the sub‐
44              set selection; the pre-processing actions;  and  the  processing
45              action.
46
47                 Options controlling the file sample:
48                    A               process all files
49                    D               process only files marked as staged ('on Disk') (if 'A' is not specified the default
50                                    is to process only files marked as non-staged)
51
52                 Options controlling the pre-processing actions done on the selected sample or the complementary:
53                    O               open the files marked as staged when processing only files marked as non-staged
54                    T               open and touch the files marked as staged when processing only files marked as non-staged
55                    I               do not check the actual stage status on selected files (by default the stage status
56                                    is checked)
57
58                 Options controlling the action performed on the selected files:
59                    N               do nothing
60                    P               open the selected files and extract the meta information
61                    L               only locate the selected files
62                    S               issue a stage request for the selected files not yet staged
63
64                 Miscellanea
65                    V               notify the actions
66
67              Not  all  the  combinations of the above options are allowed; an
68              error is printed when an incosistency is found.
69
70       --redir=<redirector
71              URL to be used to relocate the files.
72
73       -u <serverurl>, --url=<serverurl>
74              URL of the PROOF master or data server  providing  the  informa‐
75              tion; for data servers, it must include the directory.  Can also
76              be  specified  via  the  environment  variables  PQ2PROOFURL  or
77              PQ2DSSRVURL (see ENVIRONMENT VARIABLES)."
78
79       -t <dir>, --tmpdir=<dir>
80              Directory for temporary files; defualt is /tmp/<username>.
81

RETURN

83       The  pq2-verify  script  returns  -1  if  any  error occurs (connection
84       failed; dataset does not exists) and >=0 in case of success.  A  return
85       code  of  1 indicates that some of the files in the dataset are not yet
86       online (staged); this can be  used  to  trigger  automatic  retries  in
87       scripts while waiting for stage-in operations.
88

EXAMPLES

90       1. Update the 'is-staged' bit for all the files in a dataset
91
92                 $ pq2-verify -o "AN" /default/pippo/mydset
93
94       2. Issue a locate request for all the files in a dataset
95
96                 $ pq2-verify -o "AL" /default/pippo/mydset
97
98

ENVIRONMENT VARIABLES

100       See setup-pq2(1).
101

SEE ALSO

103       pq2(1),   setup-pq2(1),   pq2-ls(1),   pq2-ls-files(1),   pq2-ls-files-
104       server(1), pq2-info-server(1), pq2-ana-dist(1), pq2-put(1),  pq2-rm(1),
105       pq2-cache(1)
106
107       For   more   information   on   the   ROOT   system,  please  refer  to
108       http://root.cern.ch
109

ORIGINAL AUTHORS

111       Gerardo Ganis for the ROOT team.
112

114       This library is free software; you can redistribute it and/or modify it
115       under  the  terms of the GNU Lesser General Public License as published
116       by the Free Software Foundation; either version 2.1 of the License,  or
117       (at your option) any later version.
118
119       This  library  is  distributed  in the hope that it will be useful, but
120       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
121       CHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
122       General Public License for more details.
123
124       You should have received a  copy  of  the  GNU  Lesser  General  Public
125       License  along  with  this  library; if not, write to the Free Software
126       Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,  MA   02110-1301
127       USA
128

AUTHOR

130       This  manual  page  was  originally  written  by  Gerardo  Ganis  <ger‐
131       ardo.ganis@cern.ch>, for ROOT version 5.
132
133
134
135ROOT                               Version 5                     PQ2-VERIFY(1)
Impressum