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

NOTA BENE

6       The PQ2 tools are deprecated and will be removed in ROOT v6.16/00.
7
8       Please  contact  the  ROOT  team at http://root.cern.ch in the unlikely
9       event this change is disruptive for your workflow.
10

NAME

12       pq2-verify - Extract the content one or more datasets  from  a  dataset
13       meta-repository based on ROOT files
14

SYNOPSIS

16       pq2-verify [options] dataset
17

DESCRIPTION

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

ARGUMENTS

30       dataset
31              Datasets to be analysed; the '*' wild card in the items (in such
32              a case the full string, as shown by  pq2-ls,  should  be  given,
33              e.g. '/default/ganis/h1-set5*'.
34

OPTIONS

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

RETURN

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

EXAMPLES

96       1. Update the 'is-staged' bit for all the files in a dataset
97
98                 $ pq2-verify -o "AN" /default/pippo/mydset
99
100       2. Issue a locate request for all the files in a dataset
101
102                 $ pq2-verify -o "AL" /default/pippo/mydset
103
104

ENVIRONMENT VARIABLES

106       See setup-pq2(1).
107

SEE ALSO

109       pq2(1),   setup-pq2(1),   pq2-ls(1),   pq2-ls-files(1),   pq2-ls-files-
110       server(1),  pq2-info-server(1), pq2-ana-dist(1), pq2-put(1), pq2-rm(1),
111       pq2-cache(1)
112
113       For  more  information  on   the   ROOT   system,   please   refer   to
114       http://root.cern.ch
115

ORIGINAL AUTHORS

117       Gerardo Ganis for the ROOT team.
118

COPYRIGHT

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

AUTHOR

136       This  manual  page  was  originally  written  by  Gerardo  Ganis  <ger‐
137       ardo.ganis@cern.ch>, for ROOT version 5.
138
139
140
141ROOT                               Version 5                     PQ2-VERIFY(1)