7 * i"~
£00.?
              A USER'S GUIDE TO THE
                MENU-DRIVEN STORET
                                INTERFACE
                          FEBRUARY, 1989
                           HEA1
                                       Sponsored by:
                          Office of Ground Water Protection
                                       Developed by:
                    Office of Information Resources Management
                                Program Systems Division
                            I .S. Kmironmental Protection Agency
                          lcc of Information Resources Management
                                                   STORET

-------
Preface

STORI T is a national data system that accommodates environmental monitoring data relating to
the quality of water \vithin the I'nited States.  Since its inception in the early 1960s, STORI-T has
evolved into a powerful and comprehensive system,  capable of performing a broad range of ana-
Nsc-s. while  continuing to  serve in  its original  role as a data  repository'  tor EPA, other federal
agencies, state and local governments, academic institutions, Canadian agencies, and U.S.  Terri-
tories.   All 50 stales have direct access to STORIH  for both data storage and retrieval, thereby
contributing significantly to the timeliness of STORliT's data.   The system serves as an automated
utility for water pollution control agencies  '.:,.,,pting to determine the causes and effects of water
pollution, measure compliance with  water quality standards, gauge the effectiveness of waste treat-
ment plants, and identify trends in ambient water quality.

The STORET family includes several separate but related systems, which are the Water Quality
System, ihe  BIOS [;ield Survey System, and the Daily  Flow Ssstem.  The Water Quality System
IWQS) is b\ tar the largest member and most  widely known of the three, containing data for over
6SU.OUO sampling sites. Some 1I.UOij water quality  parameters are defined within the Water Quality
System.  These parameters can be grouped into the general categories of administrative, biological.
phvsicul. flow, organic, inorganic, pesticides, and temperatures.

 The STORFT  system runs  on a large-scale, third  generation  IBM  computer  system at TPA's
National Computer Center (NCC> in Research Triangle  Park, North Carolina.  It is run under the
TSO (lime-Sharing Option)  terminal  command language allowing many users to access the
STORE T system simultaneously.

This guide describes the menu-driven user interface recently developed to aid users in retrieving and
analyzing data residing in the  STOR1 1 Water Quality System.
Preface
                                                                                                  STORET

-------
Table of Contents
Description of STORE T Data  	  I
\Vho L'ses STOR1T  	  1
STOR IT L'scr Assistance 	  1

The STORKT L'scr Interface	  3
Accessing the STORET L'scr Interlace  	  4
How the STORF.T L'scr Interface \Vorks  	  4
Menus 	  6
Choice Menus  	  6
Entry Menus  	  7
Selection Menus  	  S
Command Summary  	  10
  ISPE Commands   	  ID
    Scrolling Menu Commands  	  11
    Scrolling Fntry Menu Edit (Commands  	  12
  SDSF Commands  	  12
  ISO Commands  	  !3
Accessing Helpful Information  	  14
Exiting the STORET L'scr Interface   	  15
l">ing a Personal Computer (PC) to Access S I'ORIT  	  15

STORET Retrievals  	  16
STORHT Output Formats 	  16
  INVENT  	  16
  RET 	  16
  AM.FARM  	  17
  LOG 	  17
  STA 	  17
I.'sing the User Interface   	  IT
  Step 1. Output Format Specification  	  IS
  Step 2. Station Selection  	  ! S
  Step 3. Sample Selection 	  21
  Step 4. Parameter Selection   	  22
  Step 5: Special Output Options  	  24
  Step 6. Job Submission Options  	  26

STORET Interactive Procedures  	  28
  "uBROWSE 	  2S
  "•oBI.ITX  	  2S
  "..CONTACTS 	  2S
  "oCOL'NTEM  	  28

fable of Contents                                                                   iii
USB,.
                                                                                         STORET

-------
  °;,STNDFSC  	  2S
Table of Contents
                                                                                          STORET

-------
List of Illustrations
Figure   I. Example of a Choice Menu  	  7
Figure   2. 1'xample of a Non-scrolling Fntry Menu 	  7
Figure   3. Fsample of a Scrolling Fntry Menu with Fook-up   	  S
Figure   4. ({sample of a Non-scrolling Selection Menu  	  l)
Figure   5. F"sample of a Scrolling Selection Menu  	  9
I.iM of Illustrations

                                                                                           STORE!

-------
Description of STORE! Data
 The Water Quality System contains data relating to the quality of surface water and ground water
within the United States. These data are the reMilts of field and laboratory analyses performed upon
samples gathered from streams, aquifers, lakes, and other bodies of water.

 \VQS data can he broadly categori/ed as either station or sample data.  Station data describes a
Npecific geographical location where Camples arc gathered, i.e.. a sampling site.  Station data includes
a unique station  identifier, the station's latitude  and  longitude coordinate, the state and county in
which the station exists, a reach number ide '.:!'.. Ing the station's hydrologic location, drainage basin
codes, ground water aquifer codes, a textual description ot the station's location, etc.  Sample data
describes the conditions  under which samples are gathered, e.g., date. time, depth, as well as the
results of the sample analyses.  Sample contents that  are identified during this analytical process
represent observations of various  water  quality parameters.  .*.g,. pollutants, particulars.  Over
11.000 different water quality parameters are defined within STORF.T.  Thus a typical observation
represents a measurement of a single parameter at a specific location, at a  specific point in time.
 Who  Uses  STORET

The STORFT user community consists of a wide variety of individuals and organizations.  Federal.
state,  and local water quality control  agencies utilixe the \VQS to examine  the causes and effects
of water pollution, to measure compliance with water quality standards, and to determine pollution
trends.

Many states utili/e the \VQS to help comply with the Congressional reporting requirements of PL
92-500 (National  Clean Water  Act).  The U.S.  Geological Survey, the  U.S. Forest Service, the
U.S. Army Corps of Engineers, the Bureau  of Reclamation and  the Tennessee Valley Authority
all utilize STORIZT's WQS in their  \\ater quality monitoring efforts.

The STORET user community includes agencies and organi/ations which utilize the data standards
and procedures established in the 1 PA Office of Ground  Water Protection's Data  Management
Manual.  The User Interface contain-*  a path •'pecifically designed for these users.
STORET User Assistance

The User Interface  has a variety ol built-in help information that will assist the user with immediate
problems related to  menus and  commands.  In addition, you  are  encouraged to  contact the
STORFT  User Assistance Staff tor  am  questions or problems  that  you might  encounter.
STORET User Assistance personnel m I  I1 \ Headquarters.  Washington,  D.C.  are available by
phone from 8 a.m.  to 5 p.m., F..S.T. \l> nJ.i, ihrcugh Friday, to answer any question.
Description of STORKT Data
                                                                                        I
                                                                                                 STORET

-------
The L'scr Assistance staff and their numbers are:
         Joe Sierra (Chief)
         Fee Manning        Louis Hodman      Dan Parker
         Hlaine Davis        Bill MulJrow      Olof Hansen
         Rob Palmer
         (MJO) 424-9067   or   (ITS) 3S2-7220   or  f2()2) 3S2-7220

I or help on  Telephone (Communications related problems, contact NCC Telecommunications
Support at:

(XOO) 334-0741  or  (FTS) 629-4506  or (919) 541-4506

For help on NCC mainframe operations related problems, contact NCC User Support at:

     334-2405  or  (FTS) 629-7S62  or (919) 541-7S62
SIORFT resaonal representatives have beer  >• :jneJ for each of the ten EPA regions throughout
the country. Their responsibilities include providing assistance to STORIiT users and they are the
first people to contact for help in any area dealing with STORET.
•
•
STORK I Regional Contacts
Region
1
•>
3
4
5
6
7
8
9
10
STORKT Contact
l:d \\'oo
Bill Ju5,tis
(fharles Kanetsky
Thomas Hurnett
.Stuart Ross
Carl Young
Norm Cn-^p
Dick Sotiro-.
line \\'il>on
Bill Bogue
I.iH-ution
Boston. MA
New York, NY
Philadelphia. PA


Chicago, IL
Dallas. TX
Kansas City. K.S
Denver, C J
San Francisco, CA
Seattle, \VA
Telephone
ft 17- 565-33 S4
FTS-835-33S4
212-264-4753
FTS-264-4753
2 1 5-597- 
-------
The  STORET  User Interface

STORET has always been a powerful water quality analysis tool.  However, the utility of the sys-
tem has been hindered somewhat b\ the STORET retrieval language, which although extremely
flexible and versatile, can be difficult tor the non-computer professional to master.  L'sers needed
to know the keywords and command language not only for STORET, but also  for TSO (Time
Sharing Option). QL'Et.T (output utility), and JCL (Job Control Language for batch jobs). As a
result, potential users ot' the system were often discouraged by the complexity of this environment.
This meant that STORF,T was not being used to its full capacity.  For this reason, U.S. FPA's
Office of Ground Water Protection (OG\VP) and the Office of Information  Resources Management
(OIR.M) initiated an effort to identity enhancements that would improve user access to STORET.

To determine the wants  and preferences  of STORET users regarding access  to the system. FPA
conducted an user requirements anulvsis in the fall of 1987.  Feedback was obtained from a wide
range of users at the FPA. other federal agencies, state and local governments, and acadcmia.  The
requirements analysis gathered data relating to  user characteristics, computing environment, views
of the current system, potential enhancements to the system, documentation, and training.

The  requirements analysis led  to the establishment of the following  objectives  for a new  user
interface:

     •    Facilitate ease  of use
     •    Reduce overall cost and time requirements
     •    Provide for greater convenience and accuracy
     •    Encourage wider use of the system

This user input guided the development process of a prototype design. In March of tl)SS, a national
workshop with over 80 attendees evaluated this prototype.  The recommendations of the workshop
participants resulted in the current interface design.

The  n-:w user interface has been developed following the requirement analysis and fuither input
from users.  It uses the  Interactive  System Productivity Facility (ISPF) on FPA's mainframe  to
provide a  menu-driven system having full-screen editing capabilities. The interlace will serve as a
bridge between the user and the STORFT Water Quality System.

This interface, through the use of menus, provides a simple question-and-answer selection process.
All user-selected menu entries are translated into the  existing STORET retrieval  language syntax
by the interface.  Translated retrieval requests  may  then  be submitted for execution against the
Water Quality data base.
The STORKT Lscr Interface
                                                                                                 '"**%
                                                                                                (SB)
                                                                                                STORET

-------
Accessing the S TO RET  User Interface

The STORF.T database and user interlace reside on the IBM 3090 mainframe computer maintained
by the L'.S.  EPA  at the National Computer Center in Research  Triangle Park,  North Carolina.
Accessing the interface requires that you must first establish communications with the  mainframe
computer.

Communication with EPA's IBM computer in North Carolina requires a DHC VT1UO,  IBM 3270.
or compatible  terminal, or  a personal computer (PC) that can emulate these terminals.  Commu-
nications  may be  through a  long  distance high-speed link  that  is directly  connected  to  the
mainframe or  through a modem connection which is established by dialing over the  telephone.
Users accessing the interface via a high-speed link simply select the TSO - NCC" option on the
logon menu.  Users dialing  into the IBM system must select the "IBM 3270 Emulation" option by
entering "NCC.TCP" on the dial-in logon menu.  Modems with a baud rate of 2400 or higher are
preferable, although the slower data transmission rates are acceptable. A more detailed discussion
of the dial-in  process is explained  in  Volume I  of the  STORET Handbook (available from
STORET user assistance).  Whether you arc high-speed connected or dial-in, you must possess  a
valid  user ID  and account to access the  EPA computer.   Refer to Section   'STORET User
Assistance" on page 1 for information on whom to contact for this information.  Keep in mind.
•Ahen logging on. that STORET is only available from ISO.

At this point, the TSO "READY" prompt appears indicating that you are in the TSO environment
and that  the STORET system is available.  To invoke the STORET user interface. "ISPE" must
be entered in response to the "READY" prompt.
How the STORET  User  Interface  Works

Having entered ISPF, the ISPE Primary Option Menu will be displayed on the screen.  "S" must
be entered from the Primary  Option Menu to access the  STORET interface. The other options
on this menu are ISPE functions, e.g.. BROWSE, EDIT,  SDSF.  Eor more information on ISPE
contact NCC user support.   The next menu that appears will show the STORET system herald
and list of STORET options. The user should specify option 1  to select Water Quality System
Eunctions.  The Water Quality System herald and a list of options will then be displayed on the
screen. Specifying option 1 again initiates the creation, modification, and submission of STORET
retrieval requests.

All information entered after this point is saved as part of  a retrieval request having a unique user-
assigned name.  ITiis is another aspect of the STORET interlace  that was specifically designed to
make using the system as simple and painless as possible.   \n existing request may be re-used.
modified, and saved  under a different request name. This preserves the original request, yet elimi-
nates having to re-enter the menu responses that the new request has in common with the existing
request.  When an  existing request  is  ".elected  for use, the  menu responses it contains  are re-
displayed as they were originally entered   When you wish to change any of the responses from the
original request, these values may siinpK be t>ped over.
The STORK I Lser Interface
                                                                                               STORET

-------
The STORET retrieval process is logically divided into several basic steps:

      1.  Output format specification
      2.  Sampling site selection
      3.  Sampling event selection
      4.  Parameter selection
      5.  Special output options
      6.  Job submission options

 The following five output formats are currently available:
     SIA
     INVENT
     RET
      UIPARM
     l.OC
Station ID Listing by Agency
Data Summary for Unlimited Parameters
Data Listing for up to 50 Specified Parameters
Data Listing for an I  nlimited  Number of Parameters
Station Location Map
One of two paths may be followed through the interface at this point. The general retrieval path
provides access to all data within the Water Quality System. The ground water path is >pecifically
tailored to the needs of ground water managers who are working in accordance with the data pro-
cedures and standards described in OGWP's Data Management  Manual.  Note that ground water
data not stored in accordance with the conventions established within the OG\VP Manual, which
includes a large amount of historical data, is available through  the general retrieval path.

Once u retrieval  request has been completely specified, it may be submitted for execution.  Am
number of requests may be created, modified, and submitted during a single terminal session.

 The processing of retrieval outputs is performed under SDSF (Spool Display and Support Facility).
which  is accessed via the IS PL Primary Option Menu. Outputs can be viewed on the terminal
screen, purged (deleted) from the output queue, or routed to a designated remote printer.

The commands required to progres^ through the menus arc  usually displayed on the menus them-
selves. They  may be entered on tl.f command line or through the use of function keys, e.g.. PF3
is typically defined to invoke the FND command. In general, the END command moves to the
preceding  menu, while the  ENTHR key processes the  current menu and moves you to the next
menu (assuming there are no errors on the current menu).  Scrolling menus, which are described
in detail in the next section, may require that the FN1 FR  key be pressed twice to progress to the
next menu.  Detailed help about each prompt  and each menu is available at the touch of a key
(typically  PF1 is defined to invoke the IIFI.P command).  In addition,  there arc look- ip menus
that provide listings of codes, such as FIPS county or L'SGS hydrologic unit codes from wliich the
user may  select desired  items during the retrieval process.  f.vcry selection made by the user is
checked and verified by the interface.  Complete command listings can be found in the "Command
Summary'' on page 10.

Before accessing the interface, you should attempt to identify for your workstation, the keys (or key
combinations) which perform  the following IBM 3270 functions: reset, attention, erase eof. tab
forward, tab backward, new line. PA1 and PA2 (l>.\3. if available), and PF1 through PF12 (PF13
through P24,  if available). Some keyboards Libel the L'nter key as "Newline" or "Return" and the
Attention  key  as "Break".

The STORKT l.'scr Interface                                                                5
                                                                                                 STORET

-------
Menus

I'hc three basic types of menus utili/ui in the interface are:

     •   Choice
     •   l;ntry
     •   Selection
Understanding the difference between the various types of menus will help when using the interface.
The cursor will usually be positioned at the menu location where the first entry or selection is to
be made.   This rninirm/es time spent repositioning the cursor to the appropriate section of the
menu.  In all menus, items which require input from the user will have an arrow ( = = > ) prompt
or will  have underscores (	i indicating where data may be entered.  A menu item that lacks
cither an arrow or underscores is protected and cannot be changed. To move from one input menu
item to another, use a  FAB key, or the arrow or step keys. When user errors are detected, an error
message will be displayed and will be accompanied by an audible beep.  Messages may appear in
two locations on a menu. Short messages appear at the top right corner of the screen and long
messages appear immediately below the Command = = = > prompt.

Menus whoso contents may not fit on a single screen are scrollable.  All scrollable menus have the
'ROW x OH y"and 'Scroll =  = =    CSR' labels in the upper right hand corner.  These menus
may be  scrolled up or down, since their contents may at times exceed the number of lines on the
screen.   The UP and  DOWN  commands may be entered on the command line or invoked  by
function kc\s.  e.g.. P!:7 for I,'P. PI "*> for DOWN.   These commands allow the user to move the
screen "window" up or down  to display the desired part of the  menu contents.  The "ROW x OF
y" label indicates that row "x" of a menu containing "y" rows is currently the top row displayed on
the screen. The letters 'CSR"  >pecil\ that the scrolling is based upon the current position of the
cursor.   The row on which the cursor lies when the scrolling command is issued, is moved to the
top or bottom  of the screen depending upon which scrolling command is used. If the cursor is not
in the body of the menu, or if it's already positioned at the top or bottom, the complete screen is
scrolled.   The  complete set of valid >cro!ling commands are described in the  section  "Scrolling
Menu Commands" on page 11.
Choice Menus

Choice menus display a list of option- from which a single option may be chosen by entering the
appropnate number at the Option prompt. One line descriptions of the  options are provided to
convey the purpose of each option.  I he HIT P command ( >r the equivalent PP kcyi may be en-
tered at the command line to obtain more information about the options.
rhc STORK T l.'ser Interface

                                                                                                STORE!

-------
                                  Title  Line
     Command ===>
       Option ==>

          1  Option  1 description
          2  Option  2 description
          3  Option  3 description
          4  Option  4 description
          5  Option  5 description
     Press ENTER  key after  selecting  desired option.
  Figure I.  K\ample of a Choice Menu
Entrv Menus
l-ntry menus have various locations on the screen where information may he entered by the user.
These locations arc identified by the arrow prompt (= = >) or a sequence of underscores  (	|
or both.
                                  Title  Line
     Command ===>
        This is a  question  to be answered? ==>     (Yes or  No)
        Input field ==>

        Input field ==>
Input  field ==>

Input  field ==>
     Press ENTER  key to continue.
  Figure -.  F.xamplc of a NoifKscrnlling Fntrv Menu
Scrolling entry menus have a spreadsheet format with input fields displayed in rows and columns.
There are a number of editing commands that may be specified in command column (CMD) that
precedes each row, e.g., R repeal-, the ro-A. D deletes the row.  The complete set of valid edit
commands is described in Section "('i>n:m.inJ Vnnmarv" on page 10 of the Command Summary
under Scrolling Fntry Menu Fdit CommatuN

The STORF.T l.scr Interface                                                          7
                                               (m)
                                                                                       STORE?

-------
Columns within scrolling entry- menus, whose headings contain a question mark (?) or asterisk (*),
have a powerful builtin "look-up" feature.  When a question mark is entered into a row with a
question marked column heading, a selection menu containing all possible values that may be en-
tered in the column is displayed.   Column One  below has the  question  mark look-up feature.
When part of a value immediately followed by an asterisk is entered into a row with an asterisked
column heading, a selection menu containing all possible values that may be entered in the column
lhat begin with  the characters preceding the asterisk is displayed (wild card function).  Column Two
below has the asterisk look-up feature.  Entering an asterisk BY ITSELF in a row  with an aster-
i>ked column heading is equivalent to entering a question mark in a row with a question marked
column heading, i.e., all possible values are displayed in the selection menu.

Note that  whenever the F.nter key is pressed, data validation is performed on each row of a scrolling
entry menu as a unit. This means that when you enter a value into any field of a particular row
that all  required fields within the row must  also be entered before the Enter key is pressed.  If this
is not the case, an error message will be displayed indicating that you have left a required field empty
and the cursor will be placed at the beginning of the required field.
Command =—>
Column
CMD One








Title Line Row x of y
Scroll ===> CSR
Column Two Column Three








  Figure  3.  Example of a Scrolling Entry Menu with l.ook^up
Selection Menus
Selection menus provide a set of options from which the ustv selects one or more desired options
by typing an "s" in the underscored field that precedes each option description.
The STORK I  l.'scr Interface
                                                                                                   STORET

-------
     Command  ===>
                                   Title Line
                              Option Descriptions
       	  Option 1 description
       	  Option 2 description
       	  Option 3 description
       	  Option 4 description
     Press ENTER key  to continue after  selecting desired option(s)
  1-iRurc 4.  Kvample of a Nun+scrolling Selection Menu
Selection menus may also be scrollable. See the discussion of scrolling menus in Section "Menus'
on page 6 for a complete description of their features.
                                   Title Line
     Command  ===>
                                                Row x of y
                                           Scroll  ===> CSR
     SEL
Column Heading
           Option 1 description
           Option 2 description
           Option 3 description
           Option 4 description
           Option 5 description
           Option 6 description
           Option 7 description
                     Press ENTER key twice to continue
  Figure 5.  Example of a Scrolling Selection Menu
The 'Request Selection List" menu is the only scrolling selection menu that allows just ONI: op-
tion to he selected.  The "Request Selection List" menu is displayed  when no request  name is
specified on the "Request Option and Name" menu at the start of the interface.

A small number of menus are hybrid combinations of the three basic types described above, e.a..
a choice menu entry that requires \ou ti> enter additional information when choosing the entry.
The STOKriT l.scr Interface
                                                                                         STORET

-------
Command Summary
The three different types of commands that may be invoked at any point within the interface from
the command line (Command =  = = ->) are:

     *   ISPF commands
     •   SDSF (Spool Displav and Support facility) commands.  SDSF allows the user to locate
         and process requests submitted for execution by the interface.
     •   TSO commands

Pertinent ISPF. SDSI;, and  ISO commands are described in the following sections.  A complete
dejcnption of the available ISPF. SDSF. and TSO commands is available through NCC customer
support.

Note that the function key definitions for ISPF and SDSF may van,', thus leading to different be-
havior by the -vime function  key \\hen utili/ed in the interface and SDSF. SDSF is a commercial
system utility that has it's own  set of function key definitions. For this reason, it  has it's  own
interaction conventions and feel.
ISPF Commands

An ISPF command may be entered in one of two ways:

      1.  By typing the command after the Command = = =  > prompt and pressing the FNTF.R
         key."
      2.  B\ proving a PF" key that has been defined to the desired command.

Remember that  pressing a PF function key simply simulates typing the command.  Fach PF key
is equated to a character string. When the PF"  key is pressed,  the processing is the same as if the
user actually typed the character stnns: after the Command = = = > prompt and pressed the F.N-
TF.R  key. ISPF does not differentiate between a command entered with a PF key and a command
entered by typing at the Command = = = ,» prompt.

A description of the general ISPF" a *.mands and iheir default PF function key assignments is given
below. Fisted separately are additional commands available for scrolling menus and scrolling entry
edit menus.
HI LP (PFI)

SPLIT croll downwards.
                                                      10
                                                                 sszzj
                                                                                              STORIT

-------
SWAP (PF9)

I.KFT(PFIO)
RIGHT (PF1I)
( ( RSOR(PFI2or TAB)
PFSIIOVV
KKVS

SDSF
SPf.riV
ISO
Moves the cursor to wherever it was previously positioned on
the other logical screen of a split screen pair.
Causes a scroll to the left.
Causes a scroll to the right.
Moves the cursor to the next input field.
Displays function keys and commands associated with the keys.
Causes an immediate display of a menu that allows the user to
view and change  the current  PF key definitions.
This will invoke  the Spool  Display and Support  Facility Pri-
mary Option menu at any  point in the session.   The menu
contains a list of  commands  that allow the user to  purge, fetch.
route, and view jobs in the output and input queues. The list
of commands arc given in Section ''SDSF Commands" on page
12.
Causes the screen to he split  vertically into two  logical screens.
Allows  the user  to  enter a  TSO command from any menu.
Some ct..umonly used TSO commands are given in Section
'TSO Commands" on page  13.
Permits the user  to exit the STORET  user interface and termi-
nate ISPF.  If you are  in the middle of creating or modifying a
retrieval request,  it will he automatically saved before exiting.
Scrolling Menu Commands
The commands described below may he entered after the COMMAND = = = >  prompt on ail
scrolling menus.

FIND. F

Searches or a combination of values ihat were specified in a template (pattern) resembling a menu
row.

TOP. FIRST

Moves the cursor to the first line of the scrolling menu.

BOTTOM, LAST

Moves the display to the last line of the scrolling menu.

MIDDLE, M,

Moves the display to the middle line of the scrolling menu.

LOCATE, LOC, L

Moves the display to the specified line, e •.•..  'Locale S " moves to the 8th line of the scrolling menu.

SAVE

Saves the current retrieval request.
The S1OKF.T l.'scr Interface
                                                                                      II
                                                                                                STORET

-------
Scrolling Entry Menu Edit Commands

'I'hoc commands may be entered in the underscored rows of the command column (with column
heading "C.MD") on scrolling entry menus.

A (After)

Identifies he  line after which copied, moved, or model lines are to be inserted.

It (before)

Identifies he  line before which copied, moved, or model lines are to be inserted.

C (copy)

Identifies a line  to be copied.

1) (delete)

Causes the line  to be deleted.

I (insert)

Causes a new line to be inserted after this line.

I < < nnn >  >

Inserts < < nnn ••• > empty lines after this line.

R (repeat)

Causo the line  to be repeated and the new copy to be inserted immediately after this line.

R  < < nnn > >

Causes the line  to repeated < < nnn • > times after this line.


SDSF Commands

 The SDSF commands are shown below.  These commands may be entered after entering SDSF
from the ISPF Primary Option  Menu (option 8).

n\

This command  displays information about ihe user's active jobs, i.e., jobs currently executing

I

 [his command displays information about the user's jobs that are in the input queues, i.e., awaiting
execution. Entering only the I command means that all the standard input classes are to be listed.
Two additional  parameters may be entered uith this command:  H  which  indicates that only jobs
on hold are to be listed or Ml which indu-ji^ that only jobs that are not on hold are to be listed.
The information that is listed includes t>pe >>f job (TYPE), the job number (JNLM), job execution
priority (PRTY). job class (C). position ol ;he job in input queue (POS), job output print routing

The STORKT User Interface                                                              12
  «"•«
(SB;
                                                                                               STORiT

-------
(RMT), the time and date the job was submitted (RD TIME, RD DATE), the job room number
(RNL'M) and the time execution began if the job has already executed (ST TIME).

O

This command displays information about the user's jobs that have already been executed.  When
the O command is entered, all jobs that are in the output queue will be displayed. The information
listed on each job output includes job name (JGBNAME), job number (JNUM). the output class
(C).  the output form number (I-'ORM). the total print lines for the output (TOT REQ, the job
status (STATUS =  held, canceled or blank), the output device name (DEVICE), and the output
print node (NODE). The ISPE scroHint: commands (IT. DOWN, LEFT, RIGHT) may be used
in this menu since the listing of information  displayed on a job  may be larger than  the terminal
screen.

You may display the output of any executed job whose output is  in HOLD b> typing an V tn the
NP column next to  the jobname.  You may  also change a job output's destination by modifying
it's Di ST value.  This allows you to re-direct the printed output from a held job to a specific re-
mote printer or visa-versa.  All EPA regions and most state agencies have at least one  remote
primer. The contacts listed in Section "STORET l.'ser Assistance" on page 1 should be consulted
for remote printer site numbers in their respective regions.
The user may obtain a list of the individual parts of a job output by entering a question mark ('.')
at the NP column of the desired job. The user may enter "S" in the NP column to display one part
of the job output on the screen before it is printed.

ST

 This command will display information on all of the user's jobs, i.e., input, active, and output.

PR

This command -A ill display the status of all remote and system printers on the E PA computer.

WHO

This command displays your logon procedure name, user ID. and terminal name.
TSO Commands

These are operating level commands >imilar to DOS on the personal computer.   I he command
 TSO" must be entered  first  in the command line followed  by the appropriate TSO command.
Only the commands that may be useful to STORET users a: j given below:

COPY

Copy a dataset.

DKI.KIK

Delete a dataset.

The STORKT l.'ser Interface                                                              '-*
                                                                                              STORET

-------
LIST

f ist the contents of a dataset.

USTCAT

List all datasets catalogued to your userid.

I.ISTDS

I ist the attributes of a dataset.

RENAME

Rename a dataset.

LOGOFF

I'nd your terminal session.

LOGON

Fnd your current terminal  session and begin a new terminal session.

TIME

I ist the date, lime, and other related items.
Accessing  Helpful Information
The help information available in the user interface has been separated into several levels, from the
general to the very specific, so thai the t\pc of information that the user may access is dependent
on the type of information that the user needs.

Level  I: General Help

This help is invoked by entering  the MFI.P command  (or equivalent  function key).  This will
provide  the user with  a brief description  of the menu.  If the menu is a scrolling menu, the help
will also provide the user with access to all  the commands that may be entered here.  If the menu
warrants it, more specific help ma>  be selected for each individual prompt on the menu.

Level  2: The Look-up Feature

This help is only available for scrolling menus. Two types of look-up help are provided on scrolling
menus.   Menus associated with station  selection by aquifer code,  state county PIPS  codes or
names, t.'SGS II)drologic I.nit codes. lil'A basin codes, provide a textual description for each code
specified on the menu, e.g., the Ntate name  is displayed next to the state code.  I his aids users in
confirming that the correct code vva-> entered. The second ts pe of look-up help invokes a selection
menu of valid responses,  thus blowing users to select desired entries.   Columns whose headings
contain  a question mark (?) or astemk <*i. have the "look-up" menu feature.  When a question
mark  is entered into a row with a qucMHMi marked column heading, a selection menu containing
aU possible values that can  be entered in ilu- ..okaim i* displayed. When part of a value immediately
followed by an asterisk is entered into a n>.\ \\iih an asterisked column  heading, a selection  menu
The STOKE T Ist-r Interface
                                                                                       14
                                                                                                  -r"">
                                                                                                 f **.*
                                                                                                 STORE!

-------
containing all possible values that may be entered  in the column that begin with the characters
preceding the asterisk is displayed (wild card function;.  Wintering an asterisk BY II Shi.F in a row
with an asterisked column heading is equivalent to entering u question mark in a row with a ques-
tion marked column heading, i.e., all possible values are displayed in the selection menu.

I.CM'I 3: Data Validation

This third level of help is invoked automatically. All user inputs are checked and verified by the
interface.  When an error is detected, an error message will be displayed on the >creen and is usually
accompanied by an audible beep,  The user may obtain more information about this short error
rnc>sage by entering the  ill'IE* command  on the  command line or by pressing the equivalent
function key.  By entering IK"I P again. e\en more  information may be  obtained about the error
prompt.
Exiting the STORET User  Interface

Fnter "=X" after the COMMAND = = = > prompt to exit the interface and terminate ISPF.
If >ou are in the middle of creating or mouiiung a retrieval request, it will be automatically saved
before exiting.  Thi> will get you back to the 'I SO "RFADY" prompt.

Io terminate vour terminal session, enter "I OGOFF".
Using  a  Personal Computer  (PC)  to  Access STORET

Any PC with communication software capable of emulating either a DEC VT100. or an IBM 3270
terminal, e.g.,  KFRMIT. Cross Talk, that is connected to a modem can access the F.PA mainframe
computer in North Carolina in full-screen mode and use the STORET interface.  I:PA will preside.
at no charge, copies of KFRMIT and or ARBITFR.  Crosstalk and other communication pack-
ages uith VT100 3270 emulation may be purchased through most commercial software dealers.
The STORKT t.'scr Interface
                                                                                    15
                                                                                             STORET

-------
STORET  Retrievals

("his section provides an overview of the Water Quality System (WQSj retrieval process using the
menu-driven interface.  As explained earlier, one of" two retrieved paths may be followed through
the interlace:
     •   General Retrieval I'ath
     •   OGYVP Ground \Vatcr  Path
The general retrieval path provides access to ^i! uata within the Water Quality System.  The ground
water path is specifically tailored to the needs of ground  water managers who are working in ac-
cordance with the data procedures and --tandards described in OGWP's Data Management Manual.
The ground  water path provides a  number of special menus for reqeusting STORLT data based
upon  ground water sampling and unaluical methods.  Note that  ground water data not stored in
accordance with  the conventions established  within the OG\VP  Manual, which includes a large
amount of historical data, is available through the general  retrieval path.

I or more specific information about the retrieval process refer to the '(/round Water Data Man-
agement with STORl T" and the  SIORi;T  Handbook - Volume 1". both of which are available
through STORHT L'scr Assistance.
STORET Output  Formats

The formats provided for in the initial phase of the interlace are described below.


INVENT

The INVENT format displays a Himmary listing for all or selected  parameters at the selected
stations.  Information listed for each parameter includes the number of observations, period of re-
cord, and several summary'  statistics   Remarked values for a parameter are summari/.ed o i separate
lines within the listing.  This format  provides  excellent overview for reviewing the parameter cov-
erage of specific monitoring networks or geographical areas.
 RET

 The Rlfl  format displays a tabular livings of actual sample values for up to 50 parameters at the
 selected stations.  These listings sruu\ i!v Dimpling dates, sampling times, depths, and values ot
 requested parameters.  The samples \.tliu^ Vr each parameter are  displayed in a separate column.
 Ten parameters are displayed on each p.iue. iheretiire each sample  may span hvc pages.
STORKT Retrievals
                                                                                      16
                                                                                                STORET

-------
ALLPARM

I he AM.FARM format displays a tabular listing of actual raw data values for all or selected pa-
rameters stored at the selected stations.  The sample values for each parameter are displayed in a
separate row.

This format is useful when there is need to obtain listings of raw data values of more than 50 pa-
rameters, as is often the case when working with toxics data.  Also, by specifying the parameters
of interest, any preferable order of listing can be achieved.


LOC

The I ()C format displays a map of the selected  station locations which contains a symbol to denote
the location of each  station along with the applicable state and county boundaries.  Other back-
ground options are available, e.g.. drainage basins, streams.  Included with the map is a listing of
all stations and their associated descriptive il;>tr«

Note  that a latitude longitude polygon is required when mapping station locations.   If a polygon
is not used to  select the stations, a special mapping polygon must be supplied.


STA

The STA format displays  a listing of all the primary and  secondary station codes associated with
the specified agencv code-is).  The output  is in the form of a list of station identifiers in alphabetical
order.

The STA format is used primarih  to determine which station IDs  have already been assigned by
an agency, so  that new stations within the agency's network can be assigned unique station IDs.
This report is  also handy as a reference tor determining station IDs  lor  selecting stations when en-
tering a retrieval request.
 Using the User  Interface

As previously stated, the retrieval process can be broken up into the following six steps:

      I,   Output Format Specification
      2.   Station Selection
      3.   Sample Selection
      4.   Parameter Selection
      5.   Special Output  Options
      6.   Job Submission Options
STOKKT Retrievals
                                                                                        17
                                                                                                   STORET

-------
Step  1. Output Format Specification

STA

Produces a listing of all primary and secondary station codes associated with one or more agency
codes.
INVKM

Produces a summary of the data for the all or selected parameters at the selected stations.

RET

Produces a tabular listing of actual sample values for up to 50 selected parameters at the selected
stations.

ALLPARM

Produces a tabular listing of actual sampL  \umcs for all  or selected parameters at  the selected
stations.

LOC

Produces a map displaying the locations of selected stations.

Tor more information on these output formats, refer to "STORE"!' Output Formats" on page 16.
Step 2. Station Selection

Once an output format has been chosen, the station selection herald is displayed. Selecting sample
sites is an extremely important step in the retrieval process because it narrows the scope of the re-
trieval to only those stations desired for the analysis. Effective station selection techniques can save
the user time and money by eliminating unneeded data.

The first screen in this process will be a ^election menu giving the user several basic ways of defining
which of the approximately 680.000 sites available within the WQS are of interest for that particular
retrieval. The station selection choices for the general retrieval path are:

     •    By Agency Codes and Station IDs
     •    Within States and Counties
     «    Within Aquifers
     •    Within Latitude Longitude Polygon or Circle
     •    Within LSGS Hydrologic Units
     •    Within EPA Drainage Basins
     •    By Station Type. Parameter Attributes
     •    By EPA Reaches
     •    Within EPA Ecoregjons

The last two station selectors, EPA Reaches and I PA Tcoregions, are not available on the OGWP
path.
STORF.T Retrievals
                                                                                        IX
                                                                                                  STORET

-------
Selection by Agency Codes and Station IDs

Stations may  be selected by  their agency code  and station number either  specifying individual
stations or a range of stations.  I ither primary and or secondary IDs may be used.  When a station
range is specified, the actual number of stations  whose station codes lie  within the range is dis-
played.

Selection by States and  Counties

All stations within a specified  state or states and certain counties within that state or states may be
retrieved.   Tor this specific retrieval, two types of look-up help is available.  The user may specify
a state  by  entering either its postal abbreviation, state name or Federal  Information Processing
Standards (FIPSi code.  When one of these three items are entered, the interface will first check to
see if the entry is valid.  If it is valid, all the remaining values (state name, postal abbreviation, or
I IPS code) will  be inserted by the interlace in the appropriate data fields.  Once the state has been
jntered. a list  of names  and I  IPS codes of the counties in  that state may  be obtained by entering
a question mark ("?") in either of the two County fields.  The fields where the question mark may
be entered to  obtain a  look-up menu of codes .ire identified  with a question mark ("?") in  the
[leading for the field. A specific county ma> nc selected from the look-up list by entering a  'S" next
to the correct  county.

Selection by Aquifers

All stations within selected United States Geological Survey ground water aquifers may be retrieved.
When the aquifer code  is entered, the interface will automatically provide the aquifer name, if the
code is valid.

Selection by Latitude/Longitude Polygon or Circle

All stations within  a geographical area may be selected. The user may define a  latitude longitude
window (rectangle  or irregular polygon), or search for stations within a radius of a point (circle).
 I he lat  long coordinates will be verified to see if they are in the correct format.  (In order to retrieve
a station by lat  long, the  correct lat long must have been stored.  The  latitude and  longitude are
required in order to store  a site in the data  base).

Selection by LSGS Hydrologic Units

All stations within a U.S.  Geologic Survey  Hydrologjc  Unit (HUC) drainage area may be retrieved.
The user may use either Region, Sub Region, Accounting or Cataloging Unit code.  Once the ap-
propriate numeric code  is entered, the system will verify if it is in the correct format and automat-
ically provide  the corresponding name

Selection by EPA Drainage Basins

All stations in one or more liPA basins < Major. Minor, or Sul" J may be retrieved. The basin names
will be inserted in the data field if the user enters the correct numeric codes.

Selection by Station Type/Parameter Utributcs

The user may  retrieve stations according to the type of station. Among others, the most commonly
used arc lake, stream, estuary, or wlu-'lu-r the station monitors discharge pipes, aquatic biota or
ambient water chemistry conditions.  In .ukliiion. the user may retrieve stations according to the
presence of Water Quality System pur.niut.r> being sampled at selected sites.  Priority pollutants

STORK.T Retrievals                                                                         19
                                                                                                    STORE?

-------
identified  by FPA can also be specified on this menu.  The system will validate  the station type
codes or the parameter type codes to see if they are correct.

Selection by KPA Reaches

All stations located in a  polygon window associated with FPA's  Reach File are retrieved with this
option. Stations may he on or off the reach trace.  This capability does not include hydroloac re-
trieval capabilities of the Reach Hie.

Selection by KPA Kcoregions

All stations located in an EPA Hcoreaon arc retrieved with this option.  The user may specify most
or generally typical part ot the Fcoregion.

Station Restriction

 The set of stations selected by the above criterion may be further limited by specifying one or more
station restrictors. The available station rev'-^'rrs are:

      •   restrict to specific agencies or stations (include or exclude)
      •   restrict to specific states or counties
      •   restrict to station type parameter attributes
      •   restrict to specific archive data classes

Restrict by  Agency Code und  Station IDs

Station retrieval can be  limited to only one agency and its stations,  or a specified agency can be
excluded from the retrieval.

Restrict by States and Counties

Stations selected by natural resource criteria, e.g.,  drainage basin,  may be restricted to only the
stations located  in certain political areas (states, counties, provinces).
                                   «
Restrict by Station Type/Parameter Attributes

 The same station selection capability is available to further restrict the retrieved number of sample
sites.

Restrict by  Archive Data Classes

Part of the STORET data base contains archived data.  These data can only be retrieved supphing
the archive  class value.  The groundwaler well data of I'SGf,  are all archived,   ft  is automatically
selected if the user specified the  OG\VP path through the interface.
STORKT Retrievals
20
                                                                                                     STORET

-------
Station Aggregation

I 'sers may optionally aggregate the data for retrieved stations and thus treat it is as though it came
from a  single station for purposes of analysis.  1 or example, all of the stations in a state can be
aggregated by county and the resulting  analyses will treat each county's data as a separate station.
The following station aggregation options are  available:

     •    State
     *    County
     •    tPA Major Basin
     •    P. PA Minor Basin
     •    HP A Sub-Basin
     •    i:PA Reach
     •    l.'SGS  Ihdrolouc Region
     •    I'SGS  I Ivdrologic Sub-Region
     •    l.'SGS  Ihdrologk Accounting  I nit
     •    L'SGS  Hydroloac Cataloging I i ^
     •    I."ser-Defined  Station Groups
     •    Latitude  Longitude Cell:  Height (Latitude)    = = >     (Seconds)
                                  Width  (Longitude)  = = >     (Seconds)
     •    All Stations
Step 3.  Sample Selection

Once stations have been selected, the --ample selection herald is displayed.  The menus that appear
for this step enable the user to restrict the data retrieved to only those samples identified by specific
dates, sampling depths, and sampling conditions of interest.

In the genera] path the user will be asked whether only grab samples and or composite samples
should be retrieved. If composite values are requested, the user ma> specify which composite value
types that are to be retrieved, e.g.. niin. mean, max, variance, precision, standard deviation.

Two additional menus will appear in the OGYVP path in this phase of building the retrieval request.
The  ground  water data may be qualified by adding information  pertaining to  sampler  material.
methodology, lab vs. field samples, and t\pe of sampler used.  These additional screens permit the
user to restrict the retrievals to these qualifiers.

If a sample selection option is not spvcilk'd. the retrieved data will include all sampling events for
each selected station.  By choosing a MID pie selection option, the  output  report can be limited in
a number of ways, based on the data stored with the sample.  The options arc shown below (more
than one option may be selected):

Date Ranges

Select samples that were taken on specific days or  within specific date ranges.
Time Ranes
Select samples that were taken at a
STOKKT Retrievals
                                        -unj of day or within specific time ranges.
                                                                                                     \~*<-
                                                                                                   STORET

-------
Seasonal Ranges

Select samples that were taken within specific seasons.

Depth Ranges

Select samples that were taken at a specific depth or specific depth ranges (feet or meters).

Depth Type

Select samples associated with specific depth types, e.g.. sediment, pore, core.

Aquifers

Select samples that were taken within specific aquifers.

Intensive Surveys

Select samples that were taken during spec.uc intensive surveys by entering the desired intensive
surves numbers, i.e.. state code. year, sequence number.

Locked  Status

Select samples that are locked.  STORIT samples ma> be locked by their owners to prevent un-
uuthori/.ed use. e.g.. while data validation is being performed.  Locked samples cannot be retrieved
unless the unlocking key for the contributing agency is specified.

Parameter Content

Select samples that contain one or more specific parameters.   This selection criterion may be made
more specific by  requesting that  only samples containing  specific  parameters  whose  values fall
within specific ranges be retrieved.


Step 4.  Parameter Selection

Once samples have been selected, the  parameter  selection herald is displayed.   This step and the
menus that appear for this step enable the user to select specific water quality parameters and. op-
tionally, specify special handling options for those parameters.

 There r-re over 11,000 water quality parameters within the \Vatcr Quality System.  These parameters
are grouped into the general categories  of radiological, phosphorus,  pesticides, flow,  biological,
bacteriological, solids, nitrogen. oxygen demand, organic*, inorganics, dissolved oxygen, metals, and
physical.  The interlace provides a look-up feature for partial parameter number, partial parameter
name, group, and CAS number to aid u>ers in identifying desired parameters.
STORK I Retrievals
                                                                                                    STORET

-------
As the parameter codes of interest are entered, the user has the option to specify if special handling
for the parameter is desired. The seven special handling options are:

     *    Convert Values to Logarithms (Base  10)
     *    Convert Values to Loadings
     •    Change Name  L ruts Decimal Location
     •    Specify Remark Restrictions
     •    Specify Acceptable Value Ranges
     •    Perform Math  Transformations
     •    Specify Alternate Parameters
Convert Values to Logarithms (Base 10)

This special handling option causes the logarithms of stored values for the specified parameter to
be computed before the analysis is performed.

Convert Values to Loadings

This option will cause loadings libs day.) to be calculated for the specified parameter. In order for
a loading to be computed, the sample must contain a value for one of the following flow parame-
ters: 58. 59. 60, 61. 50050. 50051. 50053. 72033, 72034, and 74020.  A flow parameter does not have
to be >pecificd as part of the retrieval  request, but it  must be present in the sample for the loading
to be computed.

Change Name/I nits/Decimal Location

This option may be used to change the parameter name,  units of measure label, and decimal lo-
cation, i.e.. print format used to print values for this parameter.  This option should  be used in
conjunction with performing math  transformations.   For example, if you desire to see values for a
particular parameter displayed in some units other than those in which it is stored, you can perform
the conversion by applying the appropriate math transformations.  In addition, the units label dis-
played with the value  should also be modified to correspond to the new units.  Also, when math
transformations are used to change  one form of a constituent to another, the parameter name must
be modified to reflect this transformation.

Specify Remark Restrictions

This special handling option allows the user to restrict the data to be retrieved to only those with
certain remark codes, to request that only remarked data be retrieved, or that only unremarked data
be retrieved. Some commonly used  remark codes that the user may enter are shown  below  (All
valid    remark   codes   are    lifted    in   the    STORLT    Help     datasct     named
STORnT.HELP.REMARKS.CODIS):

     C    Value calculated.
     J    Estimated value. Value not accurate.
     K    Actual value is known to  be less than value given.
     L    Actual value is known to  be greater than value given.
     S    I aboratorv test.

Specify Acceptable Value Ranges
STORKT Retrievals
                                                                                        2.1
                                                                                                  STORE!

-------
This special handling option allows the user to restrict the parameters retrieved to those that lie
within specific ranges of values or to specific values.  If the presence of a parameter or group of
parameters is critical for an analysis, this option should be selected.

Perform Math Transformations

This special handling option allows the user to change the values of parameters using mathematical
operations.  You may add a constant,  subtract a constant, multiply  by a constant, or divide by a
constant, in any combination.  In the resulting printed report, an asterisk (*) will be displayed next
to the parameter name indicating that some of the values in the column may have been modified
at the user s request.

Sdoet Alternate Parameters

At some Campling sites, the same constituent may have  been analyzed using  different techniques.
i.e.. for one period of time, one method may have been  used while,  for another period of time, a
different method is used.   In  STORE"!', two  unique parameter  codes are assigned to the same
constituent due to the differing sampling tccnmque.  This special  handling option allows the user
to retrieve all occurrences  of the same constituent regardless of the sampling technique. You may
also select limited special handling options for alternate parameters, as follows:

     •    Specify Remark Restrictions
     •    Specify Acceptable Value  Ranges
     •    Perform Math Transformations
Step 5: Special Output Options

This step depends on the output format chosen in step I.  Most output formats have features that
may be controlled by the user.  These output specific features are described below.

SI A

I here are no special data analysis features available with this format. The only input, in fact, is the
agency code whose primary and sccundarv station IDs are to be displayed.

IN'VENT

The inventory format provides three options that effect the printed report, as follows:

•    Gross Summary Only

     This will cause all of the output for individual stations to be suppressed for inventories and
    have only the "gross" sumrnan printed.  The gross summary  displays an single inventory  of
    all data retrieved.

•   Print Stations With Sample fi<.tia Oni;

    Only stations for which sample dat.i  ^.^ retrieved will be displayed, i.e., stations that were  se-
    lected but contained no sample data th.it met the retrieval criteria will NOT be displayed.
STORKT Retrievals
                                                                                        24
                                                                                                  STORET

-------
     Print AII Stations

     All stations, whether they contributed data to the inventor)' or not will be displayed. Only the
     Mation header data will print tor stations for which no sample data was retrieved.
     RI.T

     [here are no special data analysis features available with this format.

     AU.PARM

     The number of stations printed per page is controllable for the ALLPARM format.  One or
     multiple stations may be printed per page.  When multiple stations per page  is requested the
     output is re-formatted and compressed. This option is desirable when there is a small number
     of observations lor a small number of parameters at a large number of sampling locations.

     LOC

     Main different options  are available to control the station location map.  The user may select
     which data  should be plotted on the map from a list which includes site locations, boundaries
     (state and county) of the United States and provinces in  Canada, EPA reach trace and reach
     numbers, and various natural resource  defined areas, such as  1:PA Hcoregions.  L'SGS HLC
     basins, etc.

     A detailed  description  of the  features av;iilablc for the LOC  format  is contained in the
     STORI-T help dataset named STORFT.Hni P.PGM.LOC.

     it the stations to be mapped were selected by polygon, this polygon may optionally be enlarged
     to include areas not contributing sampling sites to the map if desired. When utili/ing the LOC
     format to generate  a map.  ihe retrieval request  must  always  contain a latitude longitude
     polygon.  If a  polygon  was not used for station selection, then  a latitude longitude polygon
     must be specified here.
                                  «
     Optionally,  the first 300 station locations may be tagged with a  identifier that is also printed
     in an  accompanying cross reference.  The  printed cross reference contains the station IDs.
     latitude longitude coordinates, and location description of the tagged stations.  l"p to five maps
     may be produced when tagging stations to avoid overprinting of any tags.

     The user may specify the desired  map scale, map  projection, plotting symbol, symbol si/,e.
     latitude longitude reference points, colors, supplementary legend text and map labelling, to be
     used in the  map. A projected border and or rectangular frame may be drawn as desired.

     A H)"o border is automatically added to all maps.   This border contains background infor-
     mation such as counts lines and increases the area being plotted 20%  in both the north south
     and east west  directions.  This overlap ensures that there is sufficient geographic reference in-
     formation displayed along with  the station locations.  However, this overlap can cause undc-
     sired  reseating of the map if the map >i/e including the overlap exceeds the paper si/.e.   This
     overlap percentage may thus be modified.
STORK I Retrievals
25
                                                                                                    STORET

-------
    Print Control Options

    Formats that produce  printed reports of sample data have several print control options, as
    follows:

     •    Print station header data and sample data only
     *    Print the station descriptive paragraph and additional station boundary points only
     *    Print the station header data,  sample  data, descriptive paragraph, and additional station
          boundary points

Also, up to  five lines of additional report  heading may be specified.   Typically,  the station header
data prints on the right side of the page.  However, it may be shifted to the left  side of the page if
desired.
    Step  6.  Job Submission  Options

    Job submission parameters are the 1st items specified to complete a retrieval request.  Once
    entered they may be modified by subsequently editing the request or as part of submitting the
    request for execution.  A completed request may be submitted for execution by selecting the
    second option, Submit a completed request for execution", on the Request Option and Name
    menu at the start of the interlace.

    The job submission parameters to be used \vhen submitting the request for execution are dis-
    played for confirmation.  1 hey may be modified for this submission and, optionally, perma-
    nently saved  in  your profile  for  use  in  creating  jobcards for future  requests.   The job
    submission parameters consist  of the following:

    PRIORITY

     This is the priority assigned to  the job.  PRIORITY' I indicates that the job is to be executed
    overnight.  PRIORITY 4 is the highest and most expensive priority.

    TIME

    This is CPU time that the user estimates the job will take to execute.

    BIN/ROOM

    This is the delivery destination for printed outputs.  Users who are not located near a remote
    printer usually have a BIN ROOM code of Miii meaning  mail the output to the address as-
    sociated with userid iii.

    NOTIFY

    This indicates whether the userid  should  receive a notification message when the job has
    completed execution.

    ROUTE

    This indicates where the job is to he printed.  HOLD is a valid entry to provide the  user with
    the option to look at the  output of a t-ompicted job on the CRT screen.
                                                                                                  (&)
STORF.T Retrievals
                                                                                       26
                                                                                                 STORET

-------
    JCL ECHO

    This indicates the degree to which the user would like the system messages to be included in
    the printed output.
     Request Disposition

     When a request has been completed, the request disposition menu is displayed.
     may be sa\ed under it's current name or a new name, cancelled, or edited again.
The request
     Two datascts are created in the user's dataset directory in the course of using the menu-driven
     STORET interface.  These partitioned datasets have the fully-qualified names:

      iiiuaaa.S TORFT.TABFFS     iiiaaaa.S I ORFT.RFQtFSTS

where iii represents your userid and aaaa your account.

 flic TABFFS dataset contains all of your requests in a special encoded format,  while the RF-
QL 1-S T dataset contains the STORFT keyword forms of your requests.  Neither of these datasets
should he modified,  since any errors introduced in doing so may prove  fatal during subsequent
processing of the request  by the interlace.

Retrieval Output Manager

Alter submitting a request for execution, the  Request Option and Name menu is displayed and the
process of creating, editing, or submitting a request may begin again.  At this point, the user may
also choose  to view the status of requests already submitted for execution  by invoking SDSF.   I'o
do this, enter the RFTLRN command for equivalent function key) to return to the ISPF  Primary
Option menu and select SDSF" (option  S).  When a request is submitted for execution it is assigned
a unique job number.  The job number should be used within SDSF to query job status, display
the job output on the screen, or route  the output to a remote printer.  A  complete description of
the SDSF commands that may be Npccified is contained in Section "'SDSF Commands" on page
 12.

As previously stated, SDSF is a system  utility that is outside of the STORET interface and. for this
reason, may behave differently than the interface. For example, the function key definitions within
SDSF are quite often different than tho->e within the interface, e.g.. pressing PI 5 within SDSF' may
produce different results than when IM 5 is pressed within the interface.
STORKT Retrievals
         27
                                                                                                   \£*NW^
                                                                                                  STORET

-------
STORET  Interactive  Procedures

The interactive procedures available in this option arc described in the following sections.


% BROWSE

This STORlvT command procedure  allows the user to interactively examine selected station lo-
cutions and parametric data in a variety of output formats. °n BROWSE can also produce plots
of parametric data versus time on ujaphics devices that are compatible  with  Tektronix graphics
terminals.


% BLITZ

This STORIT command procedure allows the user to interactively retrieve all data, both station
location and parametric data,  stored for a single S I'ORIvT station.  The procedure prompts for the
agency and station IDs. and period of record of interest, and allows for four output formats.


%CONTACTS

This STORl'T command procedure displays the name, address, and phone  for the designated
contact person for each STORLT agency code.


%COUNTEM

This STORET command procedure allows users to interactively obtain a count of all the stations
within STORET which meet a user-specified  station type, paramtcr attnbute expression. No sta-
tion data or parametric data arc retrieved by this procedure. Its purpose is only to provide a quick
indication of the number of stations that will qualify with respect to station types and or parameter
presence, and thus help the user structure a retrieval request that will best  provide the user with the
desired data.


%STNDESC

This STORI-'T command procedure interactively retrieves station description information from
STORET, optionally prints the retrieved information, or  creates a datasct containing the  header
information in fixed-field storage format for use in modifying the station header data.
STORK'!' Interactive Procedures                                                            28          *••**"

                                                                                                STORE!

-------