Changes between Initial Version and Version 1 of drmsShowInfo

Timestamp:

04/30/14 13:43:06 (11 years ago)

Author:

niles

Comment:

--

drmsShowInfo

@@ +1 @@
+
+= show_info =
+
+The show_info command can be used to get information about NetDRMS data. The syntax is involved, the main point of this page is to give some examples.
+
+The command does have help, available with the -h option :
+{{{
+show_info -h
+Usage:
+show_info [-ahjklpqr] ds=<recordset query> {n=0} {key=<keylist>} {seg=<segment_list>}
+sunum=<sunum> - use instead of ds= argument when SUNUM is known.
+ summary information modes are:
+  -c: count records in query
+  -h: help - show this message then exit
+  -j: list all series, keyword, segment, and link items in jsd file format, then exit
+  -l: list all keywords with description, then exit
+  -s: stats - show some statistics for how many records, etc.
+ per-record information modes are:
+  -a: show information for all keywords
+  -A: show information for all segments
+  -b: disable prime-key logic when opening records
+  -d: Show dimensions of segment files with selected segs
+  -i: query- show the record query that matches the current record
+  -I: print session information for record creation, host, sessionid, runtime, jsoc_version, and logdir
+  -K: show information for all links
+  -o: online - tell the online state
+  -O: disable the code that sets a database query time-out of 10 minutes
+  -p: list the record's storage_unit path (retrieve if necessary)
+  -P: list the record's storage_unit path (no retrieve)
+  -r: recnum - show record number as first keyword
+  -R: retention - show the online expire date
+  -S: sunum - show sunum number as first keyword (but after recnum)
+  -T: Tapename - show archive tapename and file number
+  -v: verbose - print extra, useful information
+  -x: archive - show archive status for the record's storage unit
+  -z: size - show size of storage unit containing record's segments
+ output appearance control flags are:
+  -k: list keyword names and values, one per line
+  -t: list keyword types and print formats as 2nd and 3rd lines in table mode
+  -v: print extra, helpful information  -q: quiet - skip header of chosen keywords
+ds=<recordset query> as <series>{[record specifier]} - required
+n=0 number of records in query to show, +n from start or -n from end
+key=<comma delimited keyword list>, for all use -a flag
+seg=<comma delimited segment list>, for all use -A flag
+The -p or -P flag will show the record directory by itself or as part of the
+full path to the segment file if seg=<segmentname> is specified.
+Note that the -p flag will cause the data to be staged if offline.
+}}}
+
+To show the temporal range covered by a series :
+{{{
+show_info -s aia.lev1
+}}}
+
+
+Print 10 minutes worth of data :
+{{{
+show_info key=T_REC_INDEX,T_OBS,WAVELNTH ds="aia.lev1[2013-02-14T23:59:59Z/10m][?WAVELNTH=171?]"
+}}}
+
+or, without wavelength :
+{{{
+show_info key=T_REC_INDEX,T_OBS,WAVELNTH ds="aia.lev1[2013-02-14T23:59:59Z/10m]"
+}}}
+
+For two days rather than 10 minutes :
+{{{
+show_info key=T_REC_INDEX,T_OBS,WAVELNTH ds="aia.lev1[2013-02-14T23:59:59Z/10m]"
+}}}
+
+Having ascertained the record numbers, the information from show_info might be useful in a drms_export_cgi test script like so :
+{{{
+drms_export_cgi 'rsquery=aia.lev1[? wavelnth = 171 and T_REC_index between 1108339235 and 1108339823 ?]{image_lev1}' reqid=SDAC_SDO3_160765 ackfile=/tmp/ACKFILESDAC_SDO3_160765 expversion=0.5 method=url_cgi protocol=FITS path=jsoc 'ffmt={seriesname}.{wavelnth}A_{date__obs}.{segment}' tarfile=aia__lev1_4k_171A_1108339235-1108339823 > drms_export_cgi_tar.hfits 2> drms_export_cgi_tar.err
+}}}
+
+
+
+