This dataset is called 'STORET.HELP.INFO.LIB(CFUNCTN)'
It is a copy of 'STORET.HELP.RETRIEVE.PARGROUP'


  The STORET language has been modified to accept what will
be called the "C" function.  The "C" function enables the
user to designate, in a single expression, an entire group
of parameters as "P=nnnn," or "ONLYATTR=Pnnnn," depending on
how you use it.

  It is intended for users who wish to retrieve by C.A.S. number
or group designation, an entire group of STORET parameters.
It works similarly to the INCLUDE keyword documented in
'STORET.HELP.INCLUDE', which you should also list.  Helpful
hints there concerning the use of keywords ECHO and NOECHO
also apply here.

  When you specify a "C" function in a retrieval request,
STORET will substitute all the "P" keywords needed to expand
it fully.
  For example,

     PGM=INVENT,PURP=307/STA,STC=51,CO=059,
     P=C(METALS),

will inventory (for State 51, County 59) all the STORET
parameters designated in the Group named "METALS" (there are
over 300).

Similarly,

     PGM=RET,PURP=106/STA,STC=51,CO=059,
     P=C(7440666),

will produce tabular raw data listings (for the same State/County)
of all parameters designated with C.A.S. Number 7440666
metallic Zinc (there are 23).

  One may also use the "C" function to aid in station selection,
by combining it with the ONLYATTR keyword.
  For example,

     PGM=INVENT,PURP=208/FED,STC=51,CO=059,
     ONLYATTR=C(7440666),

will produce an inventory only for those stations actually
monitoring zinc (C.A.S. 7440666).

  The "C" function can include more than one C.A.S. Number or
Group Designation, related by logical operators (AND,OR) if
the needs of the retrieval require it.
  For example,

     PGM=RET,PURP=305B/FED,
     ATTR=C(7440666 OR 7439976),
     P=10,P=300,P=400,

will produce tabular listings of Temperature(P=10), Dissolved
Oxygen(P=300) and ph(P=400) for all STORET sites in the
country monitoring either for C.A.S. Number 7440666(zinc) or
for C.A.S. Number 7439976(mercury). In this retrieval, what
makes it nationwide in scope is the "ATTR" instruction which
is a station selector verses the "ONLYATTR" keyword which is
a station restrictor.

  The "C" function may also be combined (in an ONLYATTR
keyword) with any other valid ONLYATTR criteria.
For example,

   PGM=INVENT,PURP=404E/EPA,STC=51,
   ONLYATTR=(AMBNT AND STREAM) AND P31616 AND C(METALS AND WATER),

will produce an inventory of all STORET stations in State 51
monitoring ambient stream water for parameter 31616(coliform
bacteria) and also monitoring for metals in the water column.

  Sub group
  --- -----
  In some cases, it will not be possible to make use of the
"C" function because it will supply too many parameters after
expansion for the STORET option at hand.  For example, the
following is NOT valid.

     PGM=RET,PURP=303E/STA,STC=51,CO=059,
     P=C(METALS),

since it exceeds by several hundred the limit of fifty
parameters in the RET program.
  One can still approach this problem, however, by dividing
the large group into subgroups, and making several separate
retrieval requests, in separate runs.
  For example,

     PGM=RET,PURP=303E/STA,STC=51,CO=059,
     P=C(METALS:1:50),

will get the first 50 parameters from the metals group.
  Then, in your second retrieval, code

     PGM=RET,PURP=303E/STA,STC=51,CO-059,
     P=C(METALS:51:50),

to get the next 50, and so on.

  To make full use of this capability, you must use the
"official" group names for parameters designated by
groups or C.A.S. numbers.  Refer to 'STORET.HELP.PARGROUP'
for a run stream to list STORET parameters by group,
with C.A.S. numbers.  Official names of the groups are
given below:

   Group name                            Official name
 ------------------------------         -----------------

 Administrative                          ADMIN
 Bacteriological                         BACT
 Biological                              BIO
 Dissolved Oxygen                        DO
 Flow                                    FLOW
 All Priority Pollutants available       ALLPPL
 Inorganics                              INOGAN
 Inorganics (Priority Pollutants)        PRIPOLIN
 Organics                                OGAN
 Organics (Priority Pollutants)          PRIPOLOR
 Metals                                  METALS
 Metals (Priority Pollutants)            PRIPOLME
 Nitrogen                                NITR
 Oxygen Demand                           OXYDE
 Pesticides                              PEST
 Pesticides (Priority Pollutants)        PRIPOLPE
 Phosphorous                             PHOS
 Physical                                PHYS
 Radiological                            RAD
 Solids/Particulates                     SOLIDS
 Temperature                             TEMP
 Miscellaneous Other                     MISC

            Media Related
 Water column                            WATER
 Air                                     AIR
 Tissue                                  TISSUE
 Effluent                                EFFLUENT
 Land                                    LAND
 Bottom sediment                         SEDIMENT
 Food                                    FOOD
 Meteorological                          METEO
 Other (non-specific)                    OTHER

            Type of Sample/Measurement
 Total of material                       TOTAL
 Dissolved material only                 DISS
 Suspended material only                 SUSP
 Material in wet sediment only           WET
 Material in dry sediment only           DRY
 Material in fat (tissue)                FAT
 Other (non-specific)                    AOTHER

  Most STORET parameters fall into several groups/C.A.S.
designations, and specifications can be combined in
many useful ways to limit retrievals to stations and/or
parameters specifically desired.
  Consider STORET parameter code 71900 (Mercury, Total
ug/L as Hg). It is a member of the following groups:

          C.A.S. 7439976
          METALS
          WATER
          TOTAL

  And as a result, will be retrieved if one requests
parameters as follows.

     PGM=RET,PURP=209/FED,STC=51,CO=059,
     P=C(TOTAL AND METALS AND WATER AND 7439976),

along with any other parameters which fall into all four
of the categories.

  STORET command PRTPAR (no arguments) will produce counts
and listings of parameters by "C" function.  It is available
whenever you are signed on STORET/TSO.
