AIPS HELP file for PRTAB in 31DEC13
As of Wed May 22 2:33:03 2013
PRTAB: Task to print any table-format extension file
INPUTS
INNAME Image name (name)
INCLASS Image name (class)
INSEQ 0.0 9999.0 Image name (seq. #)
INDISK 0.0 9.0 Disk drive #
INEXT Extension type
INVERS -5.0 46655.0 Extension file version #
BPRINT 0.0 First row number to print
EPRINT 0.0 Last row number to print
XINC 0.0 32767. Increment between rows
NDIG -10.0 10.0 > 3 => extended precision
<=0 => use F not exp format
DOCRT -3.0 132.0 If > 0, write to CRT
> 72 => CRT line width
OUTPRINT
Printer disk file to save
DOHMS -1.0 2.0 If > 0 print times with
hh:mm:ss.s format
NCOUNT 0.0 Print the first NCOUNT values
in a cell plus
BDROP 0.0 values BDROP through
EDROP 0.0 EDROP (if appropriate)
BOX List of columns to be printed
0 -> all.
DOFLAG -1.0 1.0 > 0 => list flagged rows too
RPARM Limit print to rows matching
(1) column, (2) subscript,
(3) value, (4) allowed
mismatch, (5-8) 2nd test
(9-12) 3rd test, etc.
KEYSTRNG String to match
DOINVERS -1.0 1.0 > 0 print if not match, else
print only if match
HELP SECTION
PRTAB
Type: Task
Use: PRTAB prints on the line printer or terminal the rows of any
extension file having a tables format.
Adverbs:
INNAME.....Image name (name). Standard defaults.
INCLASS....Image name (class). Standard defaults.
INSEQ......Image name (seq. #). 0 => highest.
INDISK.....Disk drive # of image. 0 => any.
INEXT......Extension file type ' ' => 'TA'
INVERS.....Extension file version # 0 => highest.
BPRINT.....First row to list. 0 => 1.
EPRINT.....Last row to list. < BPRINT => to end.
XINC.......Increment in row number between listings.
<= 0 => 1.
NDIG.......If 0 < NDIG <= 3, the formats 1PE10.3 and 1PD13.6 are
used for single and double precision floats. To see more
digits, NDIG > 3 causes 1PE13.6 and 1PD17.10 to be used.
The added digits may be significant in some tables.
If -3 <= NDIG <= 0, suitable non-exponential formats will
be used when possible. Exponential will still be used
for numbers all of which are very small. NDIG < -3 can
use additional digits if needed to reresent the smallest
non-zero values.
DOCRT......False (<= 0) use the line printer if OUTPRINT = ' '
else write named OUTPRINT file only.
When OUTPRINT is not blank, DOCRT=-2 suppresses the
page-feed character on page headers and DOCRT=-3
suppresses page headers and most other header
information.
True (> 0) use the terminal interactively. The task will
use the actual terminal width as a display limit
unless 72 < DOCRT < width. In that case, the display
limit will be DOCRT characters.
OUTPRINT...Disk file name in which to save the line printer output.
' ' => use scratch and print immediately for interactive
jobs - batch jobs use OUTPRINT = 'PRTFIL:BATCHjjj.nnn'
(jjj= job #, nnn = user #). When OUTPRINT is not blank,
multiple outputs are concatenated, and the file is not
actually printed.
DOHMS......If DOHMS is false (<=0), the times in the output will
be printed in days. If DOHMS > 0, they will be
printed in the form hh:mm:ss.s. This is done for any
column having units of DAYS and a header which starts with
TIME.
By default, PRTAB prints all elements in a cell of a table, one element
per line. The next three adverbs may be used to print elements 1-n1 and
n2-n3 only.
NCOUNT.....Elements 1 through NCOUNT are printed for each selected
cell in the table. 0 => 100000.
BDROP......Additionally, elements BDROP through EDROP are also
printed. 0 => 1.
EDROP......Additionally, elements BDROP through EDROP are also
printed. < BDROP => 100000.
BOX........To select the column numbers to be printed including their
order. Up to 40 may be selected. 0 => all columns in
basic order.
DOFLAG.....> 0 => list flagged rows (with an * in 1st col) as well
as unflagged rows
<= 0 => skip over flagged rows, listing only good ones.
You can also limit the display to those rows which match or which do
not match specified values.
RPARM......(1-4) 1st test column, subscript, value, allowed error
(5-8) 2nd test column, subscript, value, allowed error
(9-12) 3rd test column, subscript, value, allowed error
etc. up to 7 tests all of which are ANDed.
KEYSTRNG...One test may be on character-valued column which must
match this adverb - the match is checked only to the
number of characters given in KEYSTRNG. Thus, for
example, KEYSTR='RFLAG:'; DOINV 1; RPARM = 9,1 will print
only those flags not generated by RFLAG ignoring the
times shown in the RFLAG reasons when printing a flag
table.
DOINVERS...<= 0 => print only those rows match tests 1, 2, and 3
(how many of them have values)
> 0 => print only those that do not match
EXPLAIN SECTION