pq2-verify man page

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


pq2-verify [options] dataset


This manual page documents briefly the pq2-verify program.

pq2-verify is a script invoking the pq2 ROOT application to extract the content one or more datasets from a dataset meta-repository based on ROOT files; the repository can be accessed via the local file system or a remote file server daemon or a PROOF facility.

More details about the underlying 'pq2' application can be found in the man page pq2(1).


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


-h, --help
Display help information.
-k, --keep
Keep the temporary files created during the analysis under $TMPDIR
Verbose mode
-d <dataset>, --dataset=<dataset>
Alternative way to define the datasets to be analyzed
-o <options>

Options for veriying datasets. These allow to control: the subset selection; the pre-processing actions; and the processing action.

Options controlling the file sample:
   A               process all files
   D               process only files marked as staged ('on Disk') (if 'A' is not specified the default
                   is to process only files marked as non-staged)

Options controlling the pre-processing actions done on the selected sample or the complementary:
   O               open the files marked as staged when processing only files marked as non-staged
   T               open and touch the files marked as staged when processing only files marked as non-staged
   I               do not check the actual stage status on selected files (by default the stage status
                   is checked)

Options controlling the action performed on the selected files:
   N               do nothing
   P               open the selected files and extract the meta information
   L               only locate the selected files
   S               issue a stage request for the selected files not yet staged

   V               notify the actions

Not all the combinations of the above options are allowed; an error is printed when an incosistency is found.

URL to be used to relocate the files.
-u <serverurl>, --url=<serverurl>
URL of the PROOF master or data server providing the information; for data servers, it must include the directory. Can also be specified via the environment variables PQ2PROOFURL or PQ2DSSRVURL (see Environment Variables)."
-t <dir>, --tmpdir=<dir>
Directory for temporary files; defualt is /tmp/<username>.


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


1. Update the 'is-staged' bit for all the files in a dataset
$ pq2-verify -o "AN" /default/pippo/mydset
2. Issue a locate request for all the files in a dataset
$ pq2-verify -o "AL" /default/pippo/mydset

Environment Variables

See setup-pq2(1).

See Also

pq2(1), setup-pq2(1), pq2-ls(1), pq2-ls-files(1), pq2-ls-files-server(1), pq2-info-server(1), pq2-ana-dist(1), pq2-put(1), pq2-rm(1), pq2-cache(1)

For more information on the ROOT system, please refer to http://root.cern.ch

Original Authors

Gerardo Ganis for the ROOT team.


This manual page was originally written by Gerardo Ganis <gerardo.ganis@cern.ch>, for ROOT version 5.

Referenced By

pq2(1), pq2-ana-dist(1), pq2-cache(1), pq2-info-server(1), pq2-ls(1), pq2-ls-files(1), pq2-ls-files-server(1), pq2-put(1), pq2-redistribute(1), pq2-rm(1).

Explore man page connections for pq2-verify(1).

ROOT Version 5