.\"
.\" What:         @(#)extract.1 $Date: 09JAN03 09:30:00 $
.\" File:         extract.1
.\" Author:       Performance Technology Center, Roseville
.\" Package:       Performance Collection Component
.TH EXTRACT 1
.ad b
.SH NAME
.I extract
- (export functionality) reads the contents of Performance
Collection Component datastore. 
The results are exported into class specific data files in
ASCII Format. 

.SH SYNOPSIS

.TP
To create exported files:
.TP 15
extract  -xp 
[-gapdzcnituxyGADZNTIUXY]
[-f <outputfilename>] [-r <filename>]
[-b <date> <time>] [-e <date> <time>]

.SH
.TP 9
To display more details about the extract program parameters:
man extract
.nf
or
.nf
extract ?

.SH DESCRIPTION

The
.I extract
program reads performance measurement data from Performance Collection Component datastore and extracts data according to 
specifications set by the user.  The file to be extracted is /var/opt/OV/databases/oa/oa.db

.SH Options
.TP 18
.B -b <date> <time>
Sets starting date and time

.TP 18
.B -B <date> <time>
Sets starting date and time in UNIX format

.TP 18
.B -e <date> <time>
Sets ending date and time

.TP 18
.B -E <date> <time>
Sets ending date and time in UNIX format

.TP 18
.B -r <reportfile>
Specifies export template file for export formats. If the path of the template file contains spaces, it should be enclosed
within double quotes.

.TP 18
.B -f <file>
Sends extracted data to a specific output file. 

.TP 18
.B -gapdzcnituyGADZINTUY 
Selects types of data to extract/export
.nf
g = global detail
.nf
a = application detail
.nf
p = process detail
.nf
d = disk device detail
.nf
z = logical volume detail
.nf
c = configuration detail
.nf
n = netif detail
.nf
t = transaction detail    
.nf
u = CPU detail
.nf
x = Core detail
.nf
y = filesystem detail
.nf
i = logical system detail
.nf
G = global summary         (Export only)
.nf
A = application summary    (Export only)
.nf
D = disk device summary    (Export only)
.nf
Z = logical volume summary (Export only)
.nf
N = netif summary          (Export only)
.nf
I = logical system summary (Export only)
.nf
T = transaction summary    (Export only)
.nf
U = CPU summary            (Export only)
.nf
X = Core summary           (Export only)
.nf
Y = filesystem summary     (Export only)

.TP 18
.B -xp <xopt>
Exports data


.TP 18
.B ?
Displays command line syntax

.SH where:
.TP 13
.B <date>
Specifies a date in native language syntax.
(The default format is MM/DD/YY, as in 12/31/03.)

Or specifies one of the special keywords ,
"first", or "last",
the first date in the data store, or the last date in
the data store, respectively.

.TP 13
.B <time>
Specifies a time in native language syntax.
(The default format is hh:mm::ss)


.TP 13
.B <reportfile>
Names an ASCII template file that defines output data
fields and format for the EXPORT command.  The default
template file is /var/opt/perf/reptfile.

.TP 13
.B <file>
Specifies an output file name for EXPORT.
(See the OUTPUT command for default values.)

.SH 


.SH DEPENDENCIES

DataStore must be named oa.db and must be stored under 
/var/opt/OV/databases/oa directory for extract to identify 
it correctly. oacore process must be running to use extract

.SH AUTHOR

Developed by Hewlett-Packard.

.SH FILES

.TP
.TP
.B oa.db
 - datastore 
.TP
.B extract.help
 - help catalog
.TP
.B reptfile, reptall
 - export template files

.SH SEE ALSO
utility(1),
midaemon(1).