Data Management

Detailed Information About the JGOFS Distributed Database Management System (DDMS)

User Interfaces

Command Line Interface

Listing an Object

listvar "object"

Lists the variables in the object, with indenting indicating the hierarchical structure.

list "object"

Lists the data

In addition, there are options for other kinds of listings:

list [-n] [-s] [-t] [-f] [-b] [-c] [-z] object [outfile]

Typing the application name without any arguments returns usage instructions.

For example:

% list
Usage: list [-n] [-s|-t] [-z] [-m [new_missing]] [-c] [-l] [-f|-b|-r|-rs|-rt]
           [-errout errfile[+]] [-noerrecho] [-nopipeerr] [-finishinp]
           [-forceheader]
           object [outfile[+]]
Options:
    -n   nonstop
    -s   space-separated   |  -t   tab-separated
    -z   delete extra spaces
    -m   missing value converted to new_missing (default -9999.0)
    -c   no comments
    -l   no limit on output line length
    -f   flat file output   |  -b   brief flat file (no header info)
    -r   reps-on-one-line output
    -rs   -r w/reps space-separated   |  -rt   -r w/reps tab-separated
    -h   prints this message
    ?    prints this message
    -v   prints version information

-errout       send err messages to errfile instead of /dev/stdout after command line parsing
-noerrecho    do not echo err messages to outfile if errfile is different
-nopipeerr    do not produce err message if output ends w/ "broken pipe"
-finishinp    read input until end-of-data even if output errors
-forceheader  produce variable list even if there is no data from object
             (unless listing is in -b format)

list version 1.6 28 Dec 2003

# to return a list of the 'test' object data 
# 
% list -c -f -n -z /test
leg,year,month,station,lat,lon,press,temp,sal,o2,sigth
1,81,6,3,38.28,-73.53,5.000,18.334,33.570,5.970,24.096
1,81,6,3,38.28,-73.53,25.000,12.848,34.159,6.990,25.773
1,81,6,3,38.28,-73.53,49.000,11.070,34.523,6.060,26.394
1,81,6,3,38.28,-73.53,99.000,11.093,35.090,5.340,26.831
1,81,6,3,38.28,-73.53,149.000,11.906,35.487,5.020,26.990
. . .

% listvar
Usage: /usr/local/dmo/JGddms/bin/listvar [-a][-l] object
Options:
 -a   follow variable names with attributes
 -l   precede variable names with level at which it occurs as X, variable

listvar version 1.3  28 Jul 1998

# to return a list of the variables and their respective levels from 'test' object data 
# 
% listvar -l /test
0, leg
0, year
0, month
1, station
1, lat
1, lon
2, press
2, temp
2, sal
2, o2
2, sigth 

Browser Interface