EPA
United States
Environmental Protection
Agency
Office of Information
Resources Management
Washington DC 20460
OIRM 87.02
10,87
EPA SYSTEM DESIGN &
DEVELOPMENT GUIDANCE:
-------
United States Office of Information OIRM 87.Q2A
TT1 ¥3 A Environmental Protection Resources Management 10/87
Fv j f\ Agency Washington DC 20460
EPA SYSTEM DESIGN &
DEVELOPMENT GUIDANCE:
VOLUME A:
MISSION
NEEDS ANALYSIS
-------
Volume A
Executive Summary
This document constructs a framework around which Agency pro-
gram managers and contracting officers can document a problem and
justify the need for an information processing solution. The ob-
jective of this document is to provide guidance towards satisfying
requirements specified in EPA's IRM Policy Manual for the acquisi-
tion and management of information technology.
The guidelines within this document are designed to provide
program managers and their staff with a suggested methodology for
assessing and evaluating the need for information processing. Ap-
plying the methodology in this volume will result in two outputs:
1) a preliminary specification of a management requii .merit for in-
formation or information processing; and the outputs and benefits
tied to the user's organization mission and operation, and 2) an
"Initial System Concept" which provides an initial depiction of
the inputs, outputs, and processes.
Completion of the steps outlined in this document will pro-
vide management with the information required to make a decision
whether or not to proceed to the Preliminary Design and Options
Analysis task defined in Volume B. The following exhibit de-
scribes the complete software life cycle. Each process in the
software life cycle is represented by a circle with its corre-'
spending title on the inside of the circle. Inputs to the Mission
Needs Analysis or factors that influence the process are shown
surrounding the circle. As indicated, influencing factors are:
new legislation, changes to regulations, program growth and the
preceding process Software Obsolescence.
-------
Complete Software
Life Cycle
Volume A
New
Legislation
\
Volume B
Mission
Needs
Analysis
Software
Obsolescence
Preliminary
Design &
Options
Analysis
\
Program
Growth
Changes
to
Regulations
Software
Improvement
Increment
System
Design
System
Development
Software
Improvement
Increment
System
Implementation
System
Improvement
Plan
Volume C
-------
EPA System Design & Development
Guidance: Volume A
TABLE OF CONTENTS
Tltlft Page
1. Introduction 1-1
1.1 Background 1-1
1.2 Objectives of the System Design and
Development Guidance 1-1
1.3 Authority 1-5
1.4 Applicability of the Guidance 1-5
1.5 Documentation Requirements 1-5
1.6 Assistance and Support Available 1-9
2. Conducting the Mission Needs Analysis and
Developing the Initial System Concept 2-1
2.1 Step 1 - Review of System Need Background
and the Mission and Organizational
Needs 2-3
2.2 Step 2 - Identification and Preliminary
Specification of System Inputs,
Processes, and Outputs and Development
of the "Initial System Concept" 2-4
2.3 Step 3 - Evaluation and Testing, of the
Initial System Concept Through User
Review 2-8
2.4 Step 4 - Final Specification and
Documentation of Results in the
Mission Needs Statement 2-9
2.5 Step 5 - Initiation of the Project
Management Plan 2-9
3. Summary 3-1
3~"! 1 'Mission Needs Analysis Outputs 3-1
3.2 Next Steps 3-1
Appendix A Essential Elements of Information A-l
LIST OF EXHIBITS
1-1 EPA System Development Life Cycle
and Decision Process 1-3
1-2 EPA System Development Life Cycle
Documentation 1-6
1-3 System Category/EEI Matrix 1-10
2-1 Process Flow of Site Information 2-6
2-2 Initial System Concept - Site
Management System 2-7
111
-------
EPA System Design & Development
Guidance: Volume A
1. INTRODUCTION
Pursuant to the Environmental Protection Agency's IRM Policy
Manual, this volume is the first of three volumes which provide
guidance for Agency system design and development efforts. This
volume provides guidance for the first phase of the EPA system
development process The Mission Needs Analysis.
Volume A is intended for use by Agency Program and Management
Officials and responsible staff when making a determination
regarding an information or information processing need and
whether to commit resources to identify, develop, and implement an
appropriate solution to satisfy that need.
1.1 BACKGROUND
The Environmental Protection Agency expends millions of
dollars each year on the design, development, implementation and
maintenance of major environmental and administrative systems
vital to EPA's programs and administrative functioning.
Management of these system resources is becoming increasingly
complex, since the rapid development of information technology in
the 1980's has dramatically increased computer capacity and user
accessibility. The result has been two-fold:
. An increasing number of system development efforts by
managers and staff at all organizational levels who,
because of access to their own equipment, develop their own
systems independently of Agency systems staff
. A wide range of hardware/software options for
implementation of any specific system concept or design.
Therefore, there has been a proliferation of system development
efforts by a broad range of users with varying levels of
sophistication in making system development decisions and
conducting system development efforts.
1.2 OBJECTIVES OF THE SYSTEM DESIGN AND DEVELOPMENT GUIDANCE
Within EPA's Office of Administration and Resources
Management (OARM), the Office of Information Resources Management
(OIRM) is responsible for ensuring the effective and efficient use
of EPA's information resources including automated system design,
development and maintenance. OIRM's objective in this endeavor is
to provide guidance, assistance, and only when necessary,
controls, to assure that the Agency's considerable information
resources are utilized cost-effectively for the overall benefit of
the Agency. To this end, OIRM has developed umbrella policies
guiding information system development and acquisition (see
Information Resources Management Policy Manual) and has also
1-1
-------
EPA System Design & Development
Guidance: Volume A
developed this three-volume set of guidelines and standards to
assist with EPA's system development efforts. These three volumes
provide sequential guidance for:
. Defining the system requirement (or need) and related
operating concept
. Developing feasible system options and selecting the most
cost-effective option
. Designing, developing and implementing the selected system
option.
Exhibit 1-1, following this page, graphically depicts the three
major phases of the system development life cycle and the
decisions and results expected of each phase. However, EPA's
system development life cycle discussed in these volumes
represents little more than fifty-five percent of the total life
cycle of a software application. Typical cost allocations for
each major component of the total system life cycle are
represented in the graph below.
Life Cycle Costs 1
Mission Needs Analysis /
Preliminary Design &
Options Analysis 5.0%
Detailed Design
15.0%
Software Operations & / I^^SffflTfll S°nw*re
MainJLr™ A* no/. ^mT \\ Development 5.0%
Maintenance 45.0%
'o
Software Testing,
Integration, Verification, &
Validation 30.0%
1 These figures are based on a graphic illustration in Controlling
Software Products by Tom DeMarco, 1982, which purports to
represent industry averages.
1-2
-------
EPA System Design & Development
Guidance: Volume A
EXHIBIT 1-1
EPA SYSTEM DEVELOPMENT LIFE CYCLE
& DECISION PROCESS
DEVELOPMENT STAGE
DECISION/RESULT
REAL WORLD
MISSION NEED
VOLUME A
-»
I
MISSION NEEDS
ANALYSIS
SYSTEM REQUIREMENT
AND OPERATIONAL
CONCEPT DEFINITION
VOLUME B
PRELIMINARY DESIGN
& OPTIONS ANALYSIS
SYSTEM OPTION DESIGN,
BENEFIT/COST ANALYSIS,
AND OPTION SELECTION
SYSTEM DESIGN,
DEVELOPMENT
A IMPLEMENTATION
FULLY IUPLEUENTED
SYSTEM
1-3
-------
EPA System Design & Development
Guidance: Volume A
This document is the first of the three-volume set. The
volumes cover the following:
• Volume A - Mission Needs Analysis — is designed to provide
program managers and staff with a suggested methodology for
assessing and evaluating the need (requirement) for an
information system. Applying the methodology in this
volume will result in two outputs: 1) a preliminary
specification of the management requirement for information
or information processing and the outputs and benefits tied
to the user organization's mission and operations, and 2)
an "Initial System Concept" which provides an initial
depiction of the system's input, processes and outputs.
These results: 1) confirm that a need (retirement) exists
and 2) provide a preliminary operational specification of
the retirement.
. Volume B - Preliminary Design and Options Analysis — is
directed towards program managers and staff. It provides
guidance and a methodology for structuring design options
for meeting the retirement defined in Volume A and
provides guidance for selecting the most cost-effective
option. The steps described in this volume result in the
selection of the most mission/cost-effective option (manual
or automated) based upon life cycle concepts.
. Volume C. - System Design. Development: And Implementation --
is intended for use primarily by system developers and
provides specific guidance and standards which must be
adhered to when undertaking automated system design and
development efforts.
Together these three volumes provide comprehensive guidance and
standards for the orderly and cost-effective development of
automated systems.
It should be noted that the EPA has established a
comprehensive information security program through Chapter 8 of
the IRM Policy Manual. Because retrofitting security measures
into software under development is complex, expensive and risky,
security considerations need to be an integral part of the system
development life cycle. Consequently, security issues and factors
are identified at appropriate points throughout these volumes. A
detailed discussion of security design and development
considerations is beyond the scope of this guidance. Additional
security guidance will be provided in the forthcoming EPA
Information Security Manual.
1-4
-------
EPA System Design & Development
Guidance: Volume A
1.3 AUTHORITY
The EPA System Design and Development Guidance derives its
authority from Chapter 4 of the IRM Policy Manual, entitled
"Software Management," which establishes the Agency Software
Management Program. The guidance serves as the primary guidance
for Agency system design and development efforts.
1.4 APPLICABILITY OF THE CJIITnANrP".
Senior Agency managers and responsible staff should read the
guidance and become familiar with the decision-making process
involved with system design and development efforts. They are
responsible for ensuring adequate analysis and documentation to
support the critical decisions/results illustrated in Exhibit 1-1.
The full documentation requirements for automated system
development efforts, which must be followed to conform to OARM
policy, are fully discussed in Volume C.
In general, Volumes A and B are intended to assist program
offices and/or users in conducting their own initial studies of
system requirements, needs, option feasibility and cost-
effectiveness. In this context, the term "system" in Volumes A
and B refers to a systematic set of processes and/or procedures
which can be used to meet the information needs of a user. It
does not imply that the "system'1 will be an automated system.
Volume C, however, presumes that an automated or partially
automated solution has been selected as a result of the Volume B
options analysis. Volume C provides guidance and standards for
automated system development efforts. If the automated system is
a relatively small application on a microcomputer targeted for use
within a single office (a "user owned information system"), Volume
C provides simplified requirements for system design, development
and implementation. If the proposed system is a larger
application (mainframe or minicomputer), which is mission-critical
or invcflvee multiple offices and organizations, Volume C provides
the full set of guidance and standards which must be followed by
system developers. This will assure uniform, cost-effective
system development in accordance with EPA policies, guidelines and
standards.
1.5 DOCUMENTATION REQUIREMENTS
In general, the intent of the three-volume System Design and
Development Guidance is to provide a consistent focus for system
development efforts which will allow both EPA program managers and
OARM managers to cost-effectively develop and maintain the
Agency's systems. To achieve this goal, certain documentation
requirements (termed "Essential Elements of Information" (EEI)
documents) must be met. Exhibit 1-2, following this page,
summarizes the EEI documentation requirements. As shown,
1-5
-------
EPA System Design & Development
Guidance: Volume A
EXHIBIT 1-2
EPA SYSTEM DEVELOPMENT LIFE CYCLE
DOCUMENTATION
DEVELOPMENT PHASE
DOCUMENTATION
REAL WORLD
MISSION NEED
VOLUME A
MISSION NEEDS
ANALYSIS
££/-;. MISSION
STATEMENT /INCLUDING
INITIAL SYSTEM CONCEPT}
VOLUME B
PRELIMINARY
DESIGN & OPTIONS
ANALYSIS
££1-2. PaELIMINAPY DESIGN
AND OPTIONS ANALYSIS
EEI-3. PROJECT
MANAGEMENT PLAN
VOLUME C
SYSTEM DESIGN,
DEVELOPMENT
IMPLEMENTATION
\
EEI-S 4-13. DETAILED
SYSTEMS DOCUMENTATION
[LISTED
DETAIL
1-6
-------
EPA System Design & Development
Guidance: Volume A
documentation required for the first two phases of the process —
Mission Needs Analysis and the Preliminary Design and Options
Analysis -- are limited to one and two documents, respectively.
All system development efforts are subject to the documentation
requirements of these first two phases as set out in Volumes A and
B.
If a full information system development effort is
anticipated after the first two phases, then a traditional series
of system design and development documents must be developed and
submitted as shown in Exhibit 1-2.
For certain system development efforts OIRM and office Senior
Information Resources Management Officials (SIRMOs) must be
involved in a review capacity to fulfill EPA's IRM Policy Manual
requirements. Systems falling into one or more of the following
categories must have OIRM/SIRMO review involvement:
. EPA mission critical
States, local governments or other Federal agencies
involved
. Interorganizational involvement (e.g., between Assistant
Administratorships or including Regional Office
involvement)
. Costs for system development/enhancement are projected to
exceed 3250K (excluding costs associated with long-term
system operation and maintenance)
. Information security issues involving the three general
security areas: applications security, installation
security and personnel security. In total, information
security involves the precautions taken to protect the
confidentiality, integrity and availability of information
•
j
. Privacy Act or confidential business information involved.
For system development efforts falling into any one of these
categories, OIRM and office SIRMOs must be involved beginning with
a review of EEI-1, generated at the conclusion of the Mission
Needs Analysis, as described in this volume of the EPA System
Design and Development Guidance. OIRM/SIRMO review involvement
will continue through the development life cycle of these systems
and will include all EEI documentation requirements for such
systems.
For systems not falling into one of the above categories,
EEIs may be forwarded to OIRM/SIRMOs for information and review as
they are developed.
1-7
-------
EPA System Design & Development
Guidance: Volume A
Automated systems involving information security will be
subject to one additional documentation requirement — completion
of a certification form (certification of sensitive systems is an
OMB requirement). The form, which is under development and will
be issued as part of the forthcoming EPA Information Security
Manual, will capture basic information on system sensitivity,
security requirements, security design, reviews, test scenarios,
results and safeguards. Information needed to complete the form
will be readily available in the EEI documentation. Prior to the
system being placed into use or production, the cognizant SIRMO
(or other senior official in the AA/RA's office) will need to
certify that the automated system is adequately safeguarded based
on the information in the form.
It is not OIRM's intent to burden EPA managers with a host of
documentation requirements for each system development effort.
The EEIs simply stress typical documentation requirements and
their outlines highlight major topics that need to be considered
for any system development effort. Managers may use their
professional judgment in substituting, combining, or down-scaling
the content of the EEIs to meet the unique requirements of their
project. Additionally, the EEIs set out in this volume are not
meant to conflict with or add more burden to documentation
requirements set out in other manuals (e.g., EPA/NCC ADABAS
Application Development Procedures Manual). Documentation
produced according to such other procedures will invariably
satisfy, either partially or fully, some EEI requirements.
Criteria for determining the minimum EEI documentation for a
specific system during the design, development and implementation
phase is based on the nature and scope of the information system
and its importance to EPA's mission. Four types of systems with
differing levels of EEI documentation requirements are identified
as follows:
Major Agency Information System: An information system
'" thfet requires special attention because of its importance
to an Agency mission; its high development, operating, or
maintenance costs or its significant impact on
administration of Agency programs.
Widely Accessed Information System: An information system
that is not a Major Agency Information System (although it
significantly supports accepted program goals and missions)
but is widely accessed by a combination of EPA
Headquarters, Regional Offices and/or state and local users
and other Federal agencies.
Localized Information System: An information system that
is not a Major Agency Information System but significantly
supports accepted program goals and missions and is
1-8
-------
EPA System Design & Development
Guidance: Volume A
accessed primarily by users in one major area, e.g., EPA
Headquarters, a single Agency program, or a Region.
• User Owned Information System; Unique, stand-alone system
developed to improve the efficiency or effectiveness of
operations for a single user or a small group of users.
Documentation requirements for each of these system
categories are projected in Exhibit 1-3 on the next page and in
Chapter 4 of Volume C. Policies and procedures covering the
submission, review and approval of EEIs by OIRM will be issued
under separate guidance.
1 . 6 ASSISTANCE AND SUPPORT AVAILABLE
Agency Program Management officials' embarking on a system
development effort should be aware that there are at least-two
sources available to them for assistance and support during the
system development life cycle:
. Within each AA/RA's office SIRMOs are available for
assistance, support and guidance relative to the EPA
Systems Design and Development Guidance and other OIRM
guidance and standards (e.g., Core Systems, Structured
Programming, etc.)
. OIRM, with its general IRM management oversight role and
requirements to exercise procurement approval authority,
has a staff organized to support EPA's administrative,
program and research communities.
It is appropriate to involve these support sources as early as is
feasible in the system development life cycle for most system
development efforts.
The primary reasons for early involvement of SIRMOs and OIRM
staff fre:,
. Fulfilling EPA's IRM policy for system development review
requirements
. Providing a value-added service role involving
consultation, assistance, technical standards, guidance and
interpretation of requirements
. Expediting procurement for system development efforts which
proceed to the system design, development and
implementation phase
. Providing assistance in determining user needs as early as
possible in the life cycle.
1-9
-------
EPA System Design & Development
Guidance: Volume A
EXHIBIT 1-3
EEI-13
System Integration
Test Report
EEI-12
Software User's
Reference Guide
EEI-11
Software Operations
Document
EEI-10
Software Maintenance
Document
EEI-9
Software Detailed
Design Document
EH-8
Software Preliminary
Design Document
EH-7
Software Test
and Acceptance Plan
EO-6
Software
Management Plan
EH-5
System Detailed
Requirements Document
EEU
System
Implementation Plan
EEI-3
Project Management
Plan
EQ-2
Preliminary Design
and Options Analysis
EH-1
Mission Needs
Analysis
i /
1 /
^ ^" / r^
U°/ l§
•
•
•
•
•
•
•
•
•
•
•
•
•
Systems That
Require OIRM
Involvement l
•
•
•
•
•
•
•
•
•
0
•
•
•
Major Agency
Information
Systems
•
«
•
•
•
•
•
•
•
•
•
•
•
Widely Accessed
Information
Systems
0
0
O
•
O
•
•
9
•
•
Localized
Information
Systems
©
9
9
9
9
9
User Owned
Information
Systems
X
DC
LU
LU
>
oc
O
O
LU
O
III
0
As detailed on page 1-7
1-10
-------
EPA System Design & Development
Guidance: Volume A
Achieving these objectives will strengthen EPA's system
development efforts and avoid major pitfalls that have beset
system development efforts in other government agencies (e.g.,
project stalls due to outyear funding shortages stemming from
under-projected planning or project disruptions due to failure to
get hardware/software acquisitions into the procurement cycle
expeditiously and when required).
The remainder of Volume A provides requirements for
conducting the first phase of the system development process --
the Missions Needs Analysis, including development of the Initial
System Concept.
1-11
-------
EPA System Design & Development
Guidance: Volume A
2. CONDUCTING THE MISSION NEEDS ANALYSIS
AND DEVELOPING THE INITIAL SYSTEM CONCEPT
This chapter provides guidance for the first and most
critical stage in initiating any system development effort --
the Mission Needs Analysis.
The decision to initiate system development efforts should be
based on a perceived or existing mission-based information or
information processing need. This need may be prompted by any
number of factors such as new legislation, changes in regulations,
or program growth which may create needs for additional data,
changes in practices or additional demands on existing functions
and resources.
As a result of the Mission Needs Analysis, the manager should
have a complete understanding of the problem and be able to
demonstrate that the problem and solution are within the manager's
organizational mission. This will provide the manager with the
necessary information to justify.the need for the project which is
then used to obtain procurement authority for the required
resources. The manager should be aware of the fact that once the
definition of the needs has started, adequate in-house or
contractor resources must be available to complete it.
Successful development and implementation of any system
requires careful review, understanding, and documentation of the
need for information and the functioning of the information
processes in the context of the user organization's mission and
operational framework. It is, therefore, critical that the
"mission-based need" be reviewed as the first step towards
establishing and defining the requirements for the system.
Project managers should be aware of the types of activities
involved in software development efforts and allow for slippage in
schedules due to uncertainties and unknowns. Planning for these
activities and making estimates is a difficult task for any
manager that does not do this full time. Cost and time factors
associated with implementing and managing a software development
effort are dependent on such factors as size of the project,
levels of complexity and the skill level, experience and length of
time the project team has been together.
However, it is vital that managers begin making and recording
their estimates early in the project life cycle so they can
compare them with actual recorded program costs and hours. It is
this iterative effort of comparing planned versus actual
performance that allows the manager to develop more accurate
estimation skills for future planning efforts.
2-1
-------
EPA System Design & Development
Guidance: Volume A
Information collected during the Mission Needs Analysis:
. Specifies the nature of the program mission, problem,
functions, processes and information flows
. Validates the need for information or information
processing in the context of the organizational mission
. Provides the basis for developing and evaluating an
"Initial System Concept" which will meet the need.
The five steps retired to conduct a complete Mission Needs
Analysis and develop an Initial System Concept are as follows:
. Step 1 - Background review of the evolution of the system
need, a concise statement of the problem and a review of
the user's mission, organizational structure and
operational processes. The analysis focuses on the
positions and functions of those individuals who will be
the users of the completed system. The result of this
review should be a preliminary list of potential users of
the system.
Step 2 - Identification and specification of the
information flow',, transactions and outputs the system must
or potentially could produce. The result of this step is
the development of a concise (perhaps one page) Initial
System Concept.
Step 3 - Testing and/or evaluation of the system concept bv
reviewing the concept and preliminary output "designs" wich
potential users to test their usefulness and identify
actual or potential constraints.
•* . jStep 4 - Final specification and documentation of the
results of the previous steps through development of a
Mission Needs Statement.
Step 5 - Initiation of the Project Management Plan as a
preliminary document to facilitate the planning and
scheduling of resources for the activities that follow the
Mission Needs Analysis.
The actual approach to conducting the Mission Needs Analysis
involves conducting the first four steps, and requires continual
review, revision and recycling of steps as the analysis proceeds.
The suggested approaches for conducting each of these steps are
oresented below.
2-2
-------
EPA System Design & Development
Guidance: Volume A
2-1 STEP 1 - REVIEW OF SYSTEM NEED BACKGROUND AND THE MISSION AN";
ORGANIZATIONAL NEEDS
The Mission Needs Analysis should begin with a careful review
of the organizational and operational context from which the need
evolved and the specific users which the system or systematic
solution is intended to assist. The first task is to determine
the genesis of the initially identified and/or defined need. Some
possibilities include:
. A new program or set of mission functions have been
mandated by the President, Congress or senior officials,
requiring the performance of new tasks, processes and/or
systems
. A manager has decided to perform a new function or an
existing function using different procedures in support of
the Agency's mission, goals and objectives
. An existing process or system has been evaluated and is
suspected of being inefficient, ineffective or obsolete.
In each of these cases it is important to review the
evolution of the system need to determine which of these possible
causes was principally responsible for the system development
effort. Clearly identifying which of these causes is the basis
for the system requirement is important to future development
efforts since knowing the reason for the need helps:
. Define the problem in concise terms including any
quantifiable facts or conditions related to the problem.
For example, "The program office is unable to respond to
Freedom of Information Act (FOIA) requests for data due
partly to a fifty percent increase in FOIA requests and a
five percent effective reduction in force."
•" . £>efine the specific set of users and uses
. Establish the likely priority accorded the effort by senior
Agency officials and responsible staff
. Determine whether the problem is really one requiring a
system solution or has some other underlying cause.
In conducting this background review, two primary data
collection methods may be used:
Interviews with key officials, managers and staff involved
or potentially involved in the processes to be systematized
and those who will be the end users of the system results.
These user interviews should focus on what specific outputs
2-3
-------
EPA System Design & Development
Guidance: Volume A
are required of the system and what benefits users
anticipate.
Collection and review of key documents such as relevant
legislation, agency policies or operational plans,
organizational mission/function statements or previous
studies of the function or process.
The results of the data collection efforts should be reviewed to
provide those conducting the Mission Needs Analysis with a clear
picture of the operational context within which the system will
operate.
Perhaps the critical output of this initial review is a
preliminary identification of users and potential benefits of
system outputs. A summary format for displaying this information
in a matrix format is provided below:
Potential System User/ Position/ System User
Organization Function Output Benefit
It is important that to the extent practical, this type of
matrix be completed for all major users to ensure adequate
consideration of user needs and system benefits.
2.2 STEP 2 - IDENTIFICATION AND PRELIMINARY SPECIFICATION OF
SYSTEM INPUTS, PROCESSES AND OUTPUTS AND DEVELOPMENT OF THE
"INITIAL SYSTEM CONCEPT"
Conducting Step 1 will result in the identification of the
potential system users, uses, outputs and benefits. During this
second task, the "flow" of information and work processes of the
potential system application are developed and documented. The
purpose of this step is to develop an overall understanding and
preliminary design for the flow of information and information
procfbcte. At the conclusion of this step, a brief (perhaps one
page) Initial System Concept is developed. In addition, the
documentation of the information flow ultimately provides the
basis for:
. Determining the manual processes and procedures which will
become a part of the ultimate "system solution" for the
need or problem (any and all automated systems have a set
of manual processes and procedures which support the
automated portion of the "system" and distribute its
output)
Identifying and specifying the procedures and functions
which may be automated and therefore may become the
"automated system" which will be designed.
2-4
-------
EPA System Design & Development
Guidance: Volume A
The flow of information or work processes that are candidates
to be systematized can be examined through overall flow charting
processes that depict, on a macro level, the:
. Organizations and key individuals involved in the
information flow and information products
. The input processes and documents which feed and support
the system
. The specific output products.
Exhibit 2-1 illustrates a format for a sample flow chart
which can usefully depict such information. As shown, the flow
chart contains these important elements:
. A stub (vertical axis), containing the major organizations
and/or individuals involved in the process including those
involved in:
- Input processes
- Information process flow
- System operation
- System output and use.
. The flow and interrelationships of information among the
various involved organizations
. Specifically identified outputs of the system.
The creation of a flow chart similar to, and at the
approximate level of detail as, that shown is highly recommended.
It is a systematic methodology for identifying the specific
inputs, information flow and system outputs. This flow chart can
usually be constructed from a combination of existing
documentation and limited interviews with affected organizations
and staff.
Based upon the flow chart, a higher level (ideally one page)
Initial System Concept document should be developed as in Exhibit
2-2. The concept should illustrate:
. Major system input documents/sources on the left side
. A very brief description of key "processes" and/or data
files in the center
. Graphic depictions of system "outputs" on the right sice.
In most cases it should be possible to construct the "Initial
System Concept" on one page.
2-5
-------
PROCESS FLOW OF SITE INFORMATION
ORGANIZATION
H
E
A
0
O
u
A
R
T
E
n
I
CT>
EPA
R
E
G
I
O
N
S
PROGRAM
MANAGEMENT
PROGRAM
STAFF
PROGRAM
MANAGEMENT
PROGRAM
STAFF
STATE
CONTRACTOR
PROCESS FLOW
o tn
c >v
H- >
a
ft> CO
D ^
O (/>
(0 rt
•• n>
<3
o o
f— 0)
a>
a
(D
<
0)
0)
D
rt
-------
INITIAL SYSTEM CONCEPT -
SITE MANAGEMENT SYSTEM
INPUT
PROCESS
SFTE PLAN
ACTIVITY
SCHEDULE
_
___
—
$
. M ^
' ~
. —
• .
-
.-
——— —•— IV- Z^^^
1
1
INITIATION
FORMS
_
MONTHLY UPDATE
ACTIVITY
CHOGHLSS
men
COST
HEV
SCM
MAJOR CHANGES
1
1
MAINTENANCE FORMS
CURRENT
DATA
NEW
DAIA
Site tiles (1,000)
- Project files
(1,000)
- Activity Rles
(30,000)
- Task Rles
(200,000)
OUTPUT
UPDATED SITE PLAN
SITE SUMMARY REPORT
ACTIVITY PROGRESS
REGIONAL/NATIONAL
SUMMARY
$ BY ACTIVITY
PI
X
00
M
H
MANAGEMENT ASSISTANCE
REPORTS
START LAG
ACTIVITY COMPLETION
TASK START
O PI
C TO
H->
JD in
3 •<
O w
n> rt
.. a)
O O
I— 0)
§(/)
(-••
(D i£l
O
(D
0)
(D
D
rr
-------
EPA System Design & Development
Guidance: Volume A
2.3 STEP 3 - EVALUATION AND TESTING OF THE INITIAL SYSTEM CONCEPT
THROUGH USER REVIEW
Documentation of processes and functions as outlined in Steps
1 and 2 will result in a high level Initial System Concept
depicting system inputs, processes and outputs. During this step,
the system concept is evaluated in terms of output usefulness,
input feasibility and possible constraints. A methodology which
should be employed for evaluating system usefulness is to review
the system concept as well as "mock-ups" of system outputs (hard
copy or screens) with users or potential users. The "mock-ups"
allow potential users to visualize the output of the system with
three results:
. The user is able to "relate" to the output and indicate the
benefit (or lack of benefit) of the output
. The discussion surrounding the reports can often identify
other types of needs or report designs which can be
incorporated into the Initial System Concept
. A preliminary estimate of the benefit to the user or
potential user can be made by the user.
During the review of the system concept and outputs with
users, an exploration of possible constraints to the system design
should also be conducted. Constraints and/or implementation
problems may include:
. Resistance by managers or staff to changes in operations
. Organizational impediments
. Input data compilation/collection problems
. . ^Lack of hardware accessible to the organizational units
Lack of staff and/or funds to develop and/or operate a
system
Information security needs and considerations based on the
sensitivity of the system
Limited development time.
Also, during the system concept review, the proposed output
reports can be expected to be partially redesigned in response to
suggestions and reactions to individual reports by the users.
Finally, it is at this point that system options or process
designs for achieving similar outputs can be explored with the
user. Although the options analysis is not fully conducted until
2-8
-------
EPA System Design & Development
Guidance: Volume A
a later phase of the system development life cycle (described in
Volume B), it is useful to begin identifying alternatives with the
user during this phase.
Two results should emerge from this step of the Mission Needs
Analysis:
. A refined Initial System Concept incorporating the results
of user evaluations of both the concept and proposed
outputs
. An initial assessment of the system feasibility, priorities
and constraints.
These and the results from the previous step provide the basis for
documenting each section in the Mission Needs Statement (EEI-1).
2.4 STEP 4 - FINAL SPECIFICATION AND DOCUMENTATION OF RESULTS IN
THE MISSION NEEDS STATEMENT
The next step in conducting the Mission Needs Analysis is the
formal documentation of the work performed in Steps 1 through 3 in
a Mission Needs Statement. This document need not be long. An
outline for this document is attached in Appendix A. As shown,
primary chapters in the statement include:
. A background section, with a concise statement of the
problem. It should also relate the problem and its
solution to the agency organizational unit's missions and
functions.
. An Information Flow/Initial System Concept section which
contains the Initial System Concept and also identifies:
Input data sources
- Macro information flow and functions
* - System outputs including "mock up" format
. A discussion of potential system development constraints.
The actual length of the Mission Needs Analysis document is
dependent on various factors such as: complexity of the problem or
the organizational functions and mission, the size or scope of the
Initial System Concept, the impact of any known elements of risk,
and the number and effect of potential constraints to development
and implementation.
2.5 STEP 5 - INITIATION OF THE PROJECT MANAGEMENT PLAN
The final step in conducting the Mission Needs Analysis is to
initiate a preliminary Project Management Plan. The format of the
Project Management Plan is contained in Volume B, Preliminary
2-9
-------
EPA System Design & Development
Guidance: Volume A
Design and Options Analysis. It is important to start this
planning effort as early as possible in order to plan and schedule
the resources required for the activities that follow. This
preliminary document should include the following:
. Steps and tasks associated.with Preliminary Design and
Options Analysis
. Assignment of roles and responsibilities for the purpose of
accountability
Resource allocations to accomplish the Preliminary Design
and Options Analysis
. Project costs and time frames associated with Preliminary
Design and Options Analysis.
At this stage of the system development process, there should
also be little, if any, thought given to the specific hardware or
software that is to be used to support the system. Options in
these areas will be considered as part of the options analysis
which is discussed in Volume B.
2-10
-------
EPA System Design & Development
Guidance: Volume A
3 . SUMMARY
3.1 MISSION NEEDS ANALYSTS
The outputs, documents and results of the Mission Needs
Analysis are as follows:
. EEI-1, Mission Needs Analysis, is a concise document that
describes the problem and the need to perform the process
or function in support of the organization's mission.
. An "Initial System Concept" indicating the flow of
information required to support the function, as well as
the preliminary input documents and output reports.
. An initial Project Management Plan that outlines the tasks,
resources and deliverables of the next phase of the project
effort .
3 . 2 NEXT STEPS
Once the Mission Needs Statement is complete, it should be
understood that it will continue to evolve and change as the
"Initial System Concept" proceeds through the development life
cycle. The next major step is to prepare the Preliminary Design
and Option Analysis as described in detail in Volume B. Both of
these tasks are based on information collected during the Mission
Needs Analysis and embodied in the "Initial System Concept."
3-1
-------
EPA System Design & Development
Guidance: Volume A
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
-------
EPA System Design & Development
Guidance: Volume A
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
A. ESSENTIAL ELEMENTS OF INFORMATION
This appendix provides a representative outline of the
document that will be developed during the Mission Needs Analysis
phase.
A.I INTRODUCTION
The documentation requirements contained in this appendix
apply to all software development projects, regardless of size,
complexity or origin. At a minimum, these standards apply to all
new software development projects. Maintenance and/or
enhancements to existing information systems must comply with the
requirements set out in Chapter 1, section 1.5 of Volume A,
Mission Needs Analysis.
Compliance with the standards and conventions provided in
this appendix will ensure that adequate documentation is produced
for all system development projects.
The document defined in this appendix is:
EEI-1 • • Mission Needs Statement
The following milestone chart illustrates the relative
initiation and completion of each document with respect to the
software development life cycle, its major phases, and the span
and scope of Volumes A, B, and C.
A-l
-------
DOCUMENTATION VERSUS LIFE CYCLE
Mission Needs Analysis
EEI-1
Preliminary Design/
Options Analysis
EEI-2
EEI-3
System Detailed
Requirements Analysis
EEI-4
EEI-5
EEI-6
Preliminary Design
EEI-7
EEI-8
Detailed Design
EEI-9
System Production
and Programming
EEI-10
EEI-11
EEI-12
System Integration
Testing & Evaluation
EEI-13
System Installation
System Operations &
sintenance
Volume A
Volume B
Volume C
Review
Preliminary Critical
Design Design
Review Review
Review
OT&E
Review
O M
C *0
H->
o.
CD CO
D»<
o w
0) ft
O D
M rt>
C co
3 H-
n> in
D
(D
0)
-------
EPA System Design & Development
Guidance: Volume A
EEI-1. MISSION NEEDS
1. BACKGROUND
Agency and organizational mission requiring system support
- Mission/function statement (s)
- Organizational chart with key functions/users
identified
- Operational environment
- Current system description, including manual
procedures
Evolution of system need
- New program or functions, or
- Current performance mode and limitations/problems
2 . INFORMATION FT.OW AND TNITTAL SYSTEM
. Description/documentation of information flow including:
- Organizational process flow charts
- Key input processes/documents
- Primary data integration/data base functions and
processes
- Key output report types and distribution
. "Mock-ups" of key output reports and discussion of their
benefits to users
. Initial System Concept (ideally one page) and related
description
(*
3 . DEVELOPMENT/OPERATIONAL CONSTRAINTS
. User commitment, priority, discipline and budgetary
limitations
. Policy or organizational constraints
Information security needs based on system sensitivity
Timing of need
Interface needs
Stability/flexibility of need
A-3
-------
United States
Office of Information OffiM 87-0'
-m-m » on
T? P A ? nvironn«nul Protection Resources Management
Hi I A Ag«ncy
Washington DC 20460
EPA SYSTEM DESIGN &
DEVELOPMENT GUIDANCE:
VOLUME B:
PRELIMINARY
DESIGN AND
OPTIONS ANALYSIS
-------
Volume B
Executive Summary
This document establishes the criteria that 'Agency program
managers and their staff should follow to develop a preliminary
design and analysis of all the alternative options that satisfy
the "Initial System Concept" developed during the Mission Needs
Analysis. The objective of this document is to provide guidance
towards satisfying requirements specified in EPA's IRM Policy Man-
ual for the acquisition and management of information technology.
The guidelines within this document are designed to provide
program managers and their staff with guidance and a methodology
for developing design options that satisfy the "Initial System
Concept" developed as a result of the processes in Volume A. This
document also provides guidance for selecting the most cost-effec-
tive solution for the defined problem. The steps described in
this volume will result in the selection of the most cost-effec-
tive mission based option (manual or automated) based on life
cycle concepts and an initial project management plan that out-
lines how the selected option will be defined, developed and im-
plemented.
Completion of the steps and subsequent analysis outlined in
this document will result in a list of two or more feasible solu-
tions for the problem and related documentation concerning their
descriptions, life cycle benefits and costs, a formal life cycle
benefit-cost analysis, and a summary of the risks and contingen-
cies associated with each option. After selecting an alternative,
the project management plan will be updated to reflect how the
system development effort will be accomplished. The revised pro-
ject management plan will focus on resources, scheduling and ac-
countability as well as other pertinent factors. The following
exhibit describes the complete software life cycle. Each phase in
the software life cycle is represented by a circle with its
corresponding title on the inside of the circle. Inputs to the
Preliminary Design and Options Analysis or factors that influence
the phase are shown surrounding the circle. As indicated, in-
fluencing factors are: agency budget constraints, GSA and OMB re-
quirements, available resources, and the preceding phase, the
Mission Needs Analysis.
-------
Complete Software
Life Cycle
Volume A
Volume B
Agency Budget
Contraints
\
Mission
Needs
Analysis
Software
Obsolescence
Preliminary
Design &
Options
Analysis
Available
Resources
GSA&
OMB Requirements
Software
Improvement
Increment
System.
= Design =
System
Development
Software
Improvement
Increment
System
Implementation
System
Fmproyejnent
Plan
Volume C
-------
EPA System Design and Development
Guidance: Volume B
TABLE OF CONTENTS
TiUe Page
1. Introduction 1-1
1.1 Background 1-1
1.2 Objectives of the System Design
And Development Guidance 1-1
1.3 Authority 1-5
1.4 Applicability of the Guidance 1-5
1.5 Documentation Requirements 1-5
1.6 Assistance And Support Available 1-9
2. Preliminary Options Design 2-1
2.1 Translating Management and Functional
Requirements Into Operational
Specifications 2-1
2.1.1 System Inputs 2-2
2.1.2 System Functions/Processes 2-2
2.1.3 System Outputs 2-2
2.1.4 General System Requirements 2-2
2.2 Developing Feasible System Options 2-3
2.2.1 Determining the Flexibility and Relative
Priority of Each of the Operational
Specifications 2-4
2.2.2 Reviewing the Range of Hardware and
Software Potentially Available to
Satisfy the Initial System Concept
(Management and Functional Requirements)
and Operational Specifications 2-4
2.2.3 Developing Options by Structuring
and Adjusting the Operational
Specifications and Varying Manual/
Automated Functions 2-9
3. Options Analysis 3-1
3.1 Operational and Technical Feasibility
Analysis 3-1
3.2 Life Cycle Benefit-Cost Analysis 3-1
3.2.1 Determining and Valuing Benefits 3-3
3.2.1.1 Non-recurring Cost-Reduction Benefits 3-4
3.2.1.2 Recurring Cost-Reduction Benefits 3-4
3.2.1.3 Qualitative Benefits 3-5
3.2.1.4 Determining Total Benefits 3-5
3.2.2 Determining and Valuing Costs 3-5
3.2.2.1 Non-recurring Costs 3-7
3.2.2.2 Recurring Costs 3-8
111
-------
EPA System Design and Development
Guidance: Volume B
3.2.2.3 Qualitative Costs 3-8
3.2.2.4 Determining Total Costs 3-9
3.2.3 Benefit-Cost Comparison 3-9
3.2.3.1 Benefit-Cost Ratio 3-12
3.2.3.2 Payback Period 3-12
3.2.4 OMB Benefit-Cost Approval Criteria 3-12
4. Option Selection and Documentation 4-1
4.1 Option Selection Criteria 4-1
4.2 Documentation Requirements 4-2
5. Summary 5-1
5.1 Preliminary Design and Options Analysis
Outputs 5-1
5.2 Next Steps • 5-1
Appendix A Essential Elements of Information A-l
LIST OF EXHIBITS
1-1 EPA System Development Life Cycle and
Decision Process 1-3
1-2 EPA System Development Life Cycle
Documentation 1-6
1-3 System Category/EEI Matrix 1-10
2-1 Typical Functional Requirements Analysis
Worksheet, Input/Output Flexibility of
Grants Payment Process 2-5
2-2 EPA - Agency Standard
Hardware/Software 2-6
2-3 Software Support Tool Selection Matrix
Small Systems 2-10
2-4 Software Support Tool Selection Matrix
Medium Systems 2-11
2-5 Software Support Tool Selection Matrix
Large Systems 2-12
3-1 Operational and Technical Feasibility
Analysis 3-2
3-2 Sample Summary of Time-Phased Costs and
Benefits for Option A 3-10
3-3 Sample Summary of Option
Benefits and Costs 3-11
IV
-------
EPA System Design & Development
Guidance: Volume B
1. INTRODUCTION
Pursuant to the Environmental Protection Agency's IRM Policy
Manual, this volume is the second of three volumes which provide
guidance for Agency system design and development efforts. This
volume provides guidance for the second phase of the EPA system
development process — Preliminary Design and Options Analysis.
Volume B is to be used by Agency Program and Management
Officials and responsible staff to identify alternative manual and
system solutions to problems identified in the Mission Needs
Analysis, and to select the best solution based upon life cycle
benefit-cost analysis principals.
1.1 BACKGROUND
The Environmental Procection Agency expends millions of
dollars each year on the design, development, implementation and
maintenance of major environmental and administrative systems
vital to EPA's programs and administrative functioning.
Management of these system resources is becoming increasingly
complex, since the rapid development of information technology in
the 1980's has dramatically increased computer capacity and user
accessibility. The result has been two-fold:
. An increasing number of system development efforts by
managers and staff at all organizational levels who,
because of access to their own equipment, develop their own
systems independently of Agency systems staff
. A wide range of hardware/software options for
implementation of any specific system concept or design.
Therefore, there has been a proliferation of system development
efforts by a broad range of users with varying levels of
sophistication in making system development decisions and
conducting system development efforts/
1.2 OBJECTIVES OF THE SYSTEM DESIGN AND DEVELOPMENT GUIDANCE
Within EPA's Office of Administration and Resources
Management (OARM), the Office of Information Resources Management
(OIRM) is responsible for ensuring the effective and efficient use
of EPA's information resources including automated system design,
development and maintenance. OIRM's objective in this endeavor is
to provide guidance, assistance, and only when necessary,
controls, to assure that the Agency's considerable information
resources are utilized cost-effectively for the overall benefit of
the Agency. To this end, OIRM has developed umbrella policies
guiding information system development and acquisition (see
Information Resources Management Policy Manual) and has also
1-1
-------
EPA System Design & Development
Guidance: Volume B
developed a three-volume set of guidelines and standards to assist
with EPA's system development efforts. These three volumes
provide sequential guidance for:
. Defining the system requirement (or need) and related
operating concept
. Developing feasible system options and selecting the most
cost-effective option
. Designing, developing and implementing the selected system
option.
Exhibit 1-1, following this page, graphically depicts the three
major phases of the system development life cycle and the
decisions and results expected of each phase. However, EPA's
system development life cycle discussed in these volumes
represents little more than fifty-five percent of the total life
cycle of a software application. Typical cost allocations for
each major component of the total system life cycle are
represented in the graph below.
Life Cycle Costs 1
Software Operations &
Maintenance 45.0%
Mission Needs Analysis /
Preliminary Design &
Options Analysis 5.0%
Detailed Design
15.0%
Software
Development 5.0%
Software Testing,
Integration, Verification, &
Validation 30.0%
1 These figures are based on a graphic illustration in Controlling
Software Products by Tom DeMarco, 1982, which purports to
represent industry averages.
1-2
-------
EPA System Design & Development
Guidance: Volume B
EXHIBIT 1-1
EPA SYSTEM DEVELOPMENT LIFE CYCLE
& DECISION PROCESS
DEVELOPMENT STAGE
DECISION/RESULT
I
REAL WORLD
MISSION NEED
J
'VOLUME A
MISSION NEEDS
ANALYSIS
SYSTEM REQUIREMENT
AND OPERATIONAL
CONCEPT DEFINITION
VOLUME B
PRELIMINARY DESIGN
& OPTIONS ANALYSIS
SYSTEM OPTION DESIGN.
BENEFIT/COST ANALYSIS,
AND OPTION SELECTION
VOLUME C
SYSTEM DESIGN,
DEVELOPMENT
& IMPLEMENTATION
FULLY IMPLEMENTED
SYSTEM
1-3
-------
EPA System Design & Development
Guidance: Volume B
This document is the second of the three-volume set. The
three volumes cover the following:
• Volume A - Mission Needs Analysis — is designed to provide
program managers and staff with a suggested methodology for
assessing and evaluating the need (requirement) for an
information system. Applying the methodology in this
volume will result in two outputs: 1) a preliminary
specification of the management requirement-, for information
or information processing and the outputs and benefits tied
to the user organization's mission and operations, and 2)
an "Initial System Concept" which provides an initial
depiction of the system's input, processes and outputs.
These results: 1) confirm that a need (requirement) exists
and 2) provide a preliminary operational specification of
the requirement.
. Volume B - Preliminary Design and Potions Analysis — is
directed towards program managers and staff. It provides
guidance and a methodology for structuring design options
for meeting the requirement defined in Volume A and
provides guidance for selecting the most cost-effective
option. The steps described in this volume result in the
selection of the most mission/cost-effective option (manual
or automated) based upon life cycle concepts.
• Volume C - System Design. Development And Implementation —
is intended for use primarily by system developers and
provides specific guidance and standards which must be
adhered to when undertaking automated system design and
development efforts.
Together these three volumes provide comprehensive guidance and
standards for the orderly and cost-effective development of
automated systems.
It should be noted that the EPA has established a
comprehensive information security program through Chapter 8 of
the IRM Policy Manual. Because retrofitting security measures
into software under development is complex, expensive and risky,
security considerations need to be an integral part of the system
development life cycle. Consequently, security issues and factors
are identified at appropriate points throughout these volumes. A
detailed discussion of security design and development
considerations is beyond the scope of this guidance. Additional
security guidance will be provided in the forthcoming EPA
Information Security Manual.
1-4
-------
EPA System Design & Development
Guidance: Volume B
1.3 AUTHORITY
The EPA System Design and Development Guidance derives its
authority from Chapter 4 of the IRM Policy Manual, entitled
"Software Management," which establishes the Agency Software
Management Program. The guidance serves as the primary guidance
for Agency system design and development efforts.
1.4 APPLICABILITY OF THE GUIDANCE
Senior Agency managers and responsible staff should read the
guidance and become familiar with the decision-making process
involved with system design and development efforts. They are
responsible for ensuring adequate analysis and documentation to
support the critical decisions/results illustrated in Exhibit 1-1.
The full documentation requirements for automated system
development efforts, which must be followed to conform to OARM
policy, are fully discussed in Volume C.
In general, Volumes A and B are intended to assist program
offices and/or users in conducting their own initial studies of
management requirements, needs, option feasibility and cost-
effectiveness. In this context, the term "system" in Volumes A
and B refers to a systematic set of processes and/or procedures
which can be used to meet the information needs of a user. It
does not imply that the "system" will be an automated system.
Volume C, however, presumes that an automated or partially
automated solution has been selected as a result of the Volume B
options analysis. Volume C provides both guidance and standards
for automated system development efforts. If the automated system
is a relatively small application on a microcomputer targeted for
use within a single office (a "user owned information system"),
Volume C provides simplified requirements for system design,
development, and implementation. If the proposed system is a
larger application (mainframe or minicomputer), which is mission-
critical or involves multiple offices and organizations, Volume C
provides the full set of guidance and standards which must be
followed by system developers. This will assure uniform, cost-
effective system development in accordance with EPA policies,
guidelines and standards.
1 .5 DOCUMENTATION REQUIREMENTS
In general, the intent of the three vo.lume System Design and
Development Guidance is to provide a consistent focus for system
development efforts which will allow both EPA program managers and
OARM managers to cost-effectively develop and maintain the
Agency's systems. To achieve this goal, certain documentation
requirements must be met. Exhibit 1-2, following this page,
summarizes the EEI (termed "Essential Elements of Information"
(EEI) documents) documentation requirements. As shown,
1-5
-------
EPA System Design & Development
Guidance: Volume B
EXHIBIT 1-2
EPA SYSTEM DEVELOPMENT LIFE CYCLE
DOCUMENTATION
DEVELOPMENT PHASE
DOCUMENTATION
C
REAL WORLD
MISSION NEED
'VOLUME A
MISSION NEEDS
ANALYSIS
EEI-1. MISSION NEEDS
STATEMENT (INCLUDING
INITIAL SYSTEM
U CONCEPp I
VOLUME B
PRELIMINARY
DESIGN & OPTIONS
ANALYSIS
EEI-!. PRELIMINARY DESIGN
AND OPTIONS ANALYSIS
EEI-3. PROJECT
MANAGEMENT PLAN
VOLUME C
SYSTEM DESIGN,
DEVELOPMENT
IMPLEMENTATION
EEfS 4-13. DETAILED
SYSTEMS DOCUMENTATION
(LISTED IN DETAIL
IN VOLUME C)
1-6
-------
EPA System Design & Development
Guidance: Volume B
documentation required for the first two phases of the process —
Mission Needs Analysis and the Preliminary Design and Options
Analysis — are limited to one and two documents, respectively.
All system development efforts are subject to the documentation
requirements of these first two phases as set out in Volumes A and
B.
If a full information system development effort is
anticipated after the first two phases, then a traditional series
of system design and development documents must be developed and
submitted as shown in Exhibit 1-2.
For certain system development efforts OIRM and office Senior
Information Resources Management Officials (SIRMOs) must be
involved in a review capacity to fulfill EPA's IRM Policy Manual
requirements. Systems falling into one or more of the following
categories must have OIRM/SIRMO review involvement:
. EPA mission critical
. States, local governments or other Federal agencies
involved
Interorganizational involvement (e.g., between Assistant
Administratorships or including Regional Office
involvement)
. Costs for system development/enhancement are projected to
exceed S250K (excluding costs associated with long-term
system operation and maintenance)
Information security issues involving the three general
security areas: applications security, installation
security and personnel security. In total, information
security involves the precautions taken to protect the
confidentiality, integrity and availability of information
. Privacy Act or confidential business information involved.
For system development efforts falling into any one of these
categories, OIRM and office SIRMOs must be involved beginning with
a review of EEI-1, generated at the conclusion of the Mission
Needs Analysis, as described in Volume A of the EPA System Design
and Development Guidance. OIRM/SIRMO review involvement will
continue through the development life cycle of these systems and
will include all EEI documentation requirements for such systems.
For systems not falling into one of the above categories,
EEIs may be forwarded to OIRM/SIRMOs for information and review as
they are developed.
1-7
-------
EPA System Design & Development
Guidance: Volume B
Automated systems involving information security will be
subject to one additional documentation requirement -- completion
of a certification form (certification of sensitive systems is an
OMB requirement). The form, which is under development and will
be issued as part of the forthcoming EPA Information Security
Manual, will capture basic information on system sensitivity,
security requirements, security design, reviews, test scenarios,
results and safeguards. Information needed to complete the form
will be readily available in the EEI documentation. Prior to the
system being placed into use or production, the cognizant SIRMO
(or other senior official in the AA/RA's office) will need to
certify that the automated system is adequately safeguarded based
on the information in the form.
It is not OIRM's intent to burden EPA managers with a host of
documentation requirements for each system development effort.
The EEIs simply stress typical documentation requirements and
their outlines highlight major topics that need to be considered
for any system development effort. Managers may use their
professional judgment in substituting, combining, or down-scaling
the content of the EEIs to meet the unique requirements of their
project. Additionally, the EEIs set out in this volume are not
meant to conflict with or add more burden to documentation
requirements set out in other manuals (e.g., EPA/NCC ADABAS
Application Development Procedures Manual). Documentation
produced according to such other procedures will invariably
satisfy, either partially or fully, some EEI requirements.
Criteria for determining the minimum EEI documentation for a
specific system during the design, development and implementation
phase is based on the nature and scope of the information system
and its importance to EPA's mission. Four types of systems with
differing levels of EEI documentation requirements are identified
as follows:
Major Agency Information System; An information system
that requires special continuing management attention
because of its importance to an Agency mission; its high
development, operating, or maintenance costs or its
significant impact on administration of Agency programs.
Widely Accessed Information System: An information system
that is not a Major Agency Information System (although it
significantly supports accepted program goals and missions)
but is widely accessed by a combination of EPA
Headquarters, Regional Offices and/or State and local users
and other Federal agencies.
. Localized Information System: An information system that
is not a Major Agency Information System but significantly
supports accepted program goals and missions and is
1-8
-------
EPA System Design & Development
Guidance: Volume B
accessed primarily by users in one major area, e.g., EPA
Headquarters, a single Agency program, or a Region.
• User Owned Information Svstem: Unique, stand-alone system
developed to improve the efficiency or effectiveness of
operations for a single user or a small group of users.
Documentation requirements for each of these system categories are
projected in Exhibit 1-3 on the next page and in Chapter 4 of
Volume C. Policies and procedures covering the submission, review
and approval of EEIs by OIRM will be issued under separate
guidance.
1.6 ASSISTANCE AND SUPPORT AVAILABLE
Agency Program and Management officials embarking on a system
development effort should be aware that there are at least two
sources available to them for assistance and support during the
system development life cycle:
. Within each AA/RA's office SIRMOs are available for
assistance, support and guidance relative to the EPA
Systems Design and Development Guidance and other OIRM
guidance and standards (e.g., Core Systems, Structured
Programming, etc.)
. OIRM, with its general IRM management oversight role and
requirement to exercise procurement approval authority, has
a staff organized to support EPA's administrative, program
and research communities.
It is appropriate to involve these support sources as early as is
feasible in the system development life cycle for most system
development efforts.
The primary reasons for early involvement 'of SIRMOs and OIRM
staff are:
. Fulfilling EPA's IRM policy for system development review
requirements
. Providing a value-added service role involving
consultation, assistance, technical standards, guidance and
interpretation of requirements
. Expediting procurement for system development efforts which
proceed to the system design, development and
implementation phase
. Providing assistance in determining user needs as early as
possible in the life cycle.
1-9
-------
EPA System Design & Development
Guidance: Volume B
DC
LU
LJJ
CC
o
o
LU
O
LU
EXHIBIT 1-3
EEI-13
System Integration
Test Report
EEI-12
Software User's
Reference Guide
EEI-11
Software Operations
Document
EEI-10
Software Maintenance
Document
EEI-9
Software Detailed
Design Document
EEI-8
Software Preliminary
Design Document
EEI-7
Software Test
and Acceptance Plan
EEI-6
Software
Management Plan
EEI-5
System Detailed
Requirements Document
EEI-4
System
Implementation Plan
EH-3
Project Management
Plan
EO-2
Preliminary Design
and Options Analysis
EEI-1
Mission Needs
Analysis
1 /
'B /
S S" / .
CU IX / c ^
/ 1 §>
©
o
©
©
©
o
0
©
•
©
©
•
©
Systems That
Require OIRM
Involvement l
®
©
0
0
©
©
©
©
©
0
0
©
Major Agency
Information
Systems
0
©
0
©
©
©
Q
O
©
0
©
©
Widely Accessed
Information
Systems
©
©
©
©
•
©
0
©
©
Localized
Information
Systems
©
®
©
©
®
User Owned
Information
Systems
1 As detailed on page 1-7
1-10
-------
EPA System Design & Development
Guidance: Volume B
Achieving these objectives will strengthen EPA's system
development efforts and avoid major pitfalls that have beset
system development efforts in other government agencies (e.g.,
project stalls due to outyear funding shortages stemming from
under-projected planning or project disruptions due to failure to
get hardware/software acquisitions into the procurement cycle
expeditiously and when required).
The remainder of Volume B provides guidance for conducting
the second phase of the system development process — the
Preliminary Design and Options Analysis phase.
1-11
-------
EPA System Design and Development
Guidance: Volume B
2. PRELIMINARY OPTIONS DESIGN
Completion of the Mission Needs Analysis phase of the system
development process will have resulted in development of an
Initial System Concept (operational concept) meeting the
identified management and functional requirements of the
organization. The purpose of Volume B is to translate these
requirements into operational specifications, to identify and
develop feasible options meeting the requirements and to analyze
the overall feasibility and cost-effectiveness of the various
options. This chapter presents the methodologies for:
Translation of the management and functional requirements
identified during the Mis.sion Needs Analysis into
operational specifications
. Identifying and developing procedural and system options
satisfying the defined management and functional
requirements and operational specifications.
It should be noted that requirements refinement and system
option definition is an iterative process in that management and
functional requirements are first translated into operational
specifications. System options are then developed to satisfy
(insofar as possible) the management requirements and then the
operational specifications are refined. The result of this
iterative analytic process is a set of two to four feasible design
options, which to varying degrees may meet the basic defined
management and functional requirements identified in the Mission
Needs Analysis.
2.1 TRANSLATING MANAGEMENT AND FUNCTIONAL REQUIREMENTS INTO
OPERATIONAL SPECIFICATIONS
The Mission Needs Analysis of Volume A broadly defines the
system management and functional requirements and results in
development of the macro-level Initial System Concept. The
purpose of this stage is to further examine and define the current
system environment and user needs, then to translate these needs
into a specific set of operational specifications. The result of
this step is a set of operational specifications which provide a
basis for structuring combined automated/manual options meeting
the management and functional requirements defined in Volume A.
The objective is to develop the operational specifications only in
sufficient detail to allow defining of options for a proposed
system, but not to complete a detailed system requirements
analysis. The operational specifications form the baseline for
what a proposed system must do. The detailed system requirement
analysis is conducted in Phase III (only if an automated system
solution is selected) and is discussed in Volume C.
2-1
-------
EPA System Design and Development
Guidance: Volume B
The operational specification process focuses first on
defining and providing details about specific operational
parameters which are retired to meet the management requirement.
These include:
2.1.1 System Inputs
. Origin/type of input (indirect data entry from forms,
interface with other automated systems, etc.)
. Frequency/rate of input (hourly, daily, weekly, monthly,
etc.)
. Volume of data/text
2.1.2 System Functions/Processes
. Process and flow of each input into the "system"
. Data processing/manipulation/tabulation functions
. Types and sizes of major data files
. Update/purging requirements
. Statistical or scientific analysis requirements
Special functions such as project management/critical path,
etc.
2.1.3 System Outputs
. Hard copy report formats
. Screen display
Special presentations/graphics
. Frequency (daily, weekly, monthly, on demand) and ongoing
output rate
. Other system interfaces
. View locally and/or transmit to remote locations
2.1.4 General System Requirements
. Required system/user interface
Information security requirements, including:
- Accuracy and validity requirements
- Criticality of key outputs
- Failure contingency
- Access controls
- Response time
- Flexibility
2-2
-------
EPA System Design and Development
Guidance: Volume B
- Failure contingency
In general, these specific operational specifications involve
an elaboration and quantification of the Initial System Concept
developed during the Mission Needs Analysis. All operational
specifications should be designed to meet the management and
functional requirements identified in the Mission Needs Analysis.
Concentration at this point of the study should be on creating a
detailed picture of the way in which inputs/processes/outputs are
generated and used. Detailed formats and information field
structuring will be established in the System Design stage
described in Volume C.
2.2 DEVELOPING FEASIBLE SYSTEM OPTIONS
The operational specifications defined above provide the
foundation for structuring two to four feasible system options
which largely (but probably not exactly) meet the management and
functional requirements. In general, there are almost always a
number of potential options for meeting the management and
functional requirements varying from manual processes through
sophisticated automated system designs. It is generally true
that, if only one way to solve a problem is apparent, the
management problem has not been adequately defined and analyzed.
Options should include feasible approaches to solving the
management problem and should not be limited to alternatives
involving automation (see FIRMR 201-30.009, "Analysis of
Alternatives for Satisfying a Requirement.")
Structuring and developing possible options to satisfy the
mission need (management requirement) and operational
specifications is a process which involves several activities
performed simultaneously and iteratively. They include:
. Determining the flexibility and relative priority of each
of the operational specifications
. Reviewing the range of available hardware and software
options available to meet the specifications
. Constructing alternatives by structuring/adjusting the
operational specifications and related procedures to meet
available hardware and software options
. Option refinement through balancing'overall management
requirements with development costs and timing
considerations.
These four steps are pursued iteratively to first structure
and then specify in some detail the system options.
2-3
-------
EPA System Design and Development
Guidance: Volume B
2.2.1 Determining the Flexibility and Relative Priority of Each
of the Operational Specifications
At this stage, the operational specifications identified
earlier are treated as somewhat flexible and not a rigid set of
specifications that every systematic solution must meet. Instead,
the management and functional requirements should be considered as
the overall goal but determinations must be made regarding the
relative priority of various requirements and specifications. To
assist the system developer with this process, a flexibility/
priority analysis of each of the requirements and specifications
should be performed in order to define the ranges of associated
parameters. This analysis represents just another step in the
iterative process of structuring system options. The
flexibility/priority analysis is conducted based upon the overall
management and functional requirements and the operational
specifications defined in Section 2.1. Exhibit 2-1 provides an
example of an analysis of the flexibility of inputs/outputs for a
grants payment process. The analysis provides a "flexibility
assessment" on key components of the requirements and operational
specifications developed earlier. Conducting this analysis
provides the system developers with a sense of the way in which
the requirements and specifications must be satisfied including
which things are mandatory, and which are desirable. The results
of this "feel" of relative priorities is used both for the
development of options and for the options selection process.
2.2.2 Reviewing the Range of Hardware and Software Potentially
Available to Satisfy f.he Initial System Concept
And Functional Requirements) and Operational Specifications
During this step of the system development process, a
preliminary review of the hardware and software potentially
available for the application should be conducted. The past
several years have seen a major expansion in the range of hardware
and software available to potential users. Thus, this step of the
system development process has become more critical as the range
of options has increased. In conducting this review it is
strongly urged that EPA's Office of Information Resources
Management and/or the Senior Information Resource Management
Officer (SIRMO) for the program area be contacted for assistance.
The range of hardware and software currently available in EPA
is briefly summarized in Exhibit 2-2. This, list provides an
initial basis for determining available options within the
Agency environment. In addition, however, the system developer,
in conjunction with OIRM or SIRMO staff, might want to review and
consider other kinds of specialized hardware/software for
particular systems.
2-4
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-1
TYPICAL FUNCTIONAL REQUIREMENTS ANALYSIS WORKSHEET,
INPUT/OUTPUT FLEXIBILITY OF GRANTS PAYMENT PROCESS
COMPONENT
COMMENTS ON FLEXIBILITY
INPUT
4
5
Grant authorization form 1.
Invoice
Form must have entries in all
blocks conforming to pre-
defined ranges with 100% edit
check.
Must have date, amount,
grantee name, address, and
grant authorization number and
must be 100% edited and
verified.
PROCESS/FUNCTION
Ledger
Check Printing
Must be accurate, be backed
up, and all incoming
transactions must have been
100% edited and verified
Must be accurate, be backed
up, provide for safeguards and
anti-counterfeit procedures,
and allow 100% edit and
verification.
OUTPUT
Funding check for each 1.
program operation
Updated ledger 2.
Management Report A 3.
Management Report B 4.
Queries via on-line 5.
access
Checks issued must be 100%
accurate and delivered to
grantees by 15th of each month
Must be 100% accurate and be
completed by 13th of month so
that checks can be run by 15th
User would like by 15th but
indicates not a big problem if
slips as late as 25th of month
Nice to have but not essential
Nice to have but on-line not
essential
2-5
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-2
EPA - Agency Standard Hardware/Software
TOOLS
3rd Generation:
COBOL
FORTRAN
PL/1
PASCAL
4th Generation:
INFO
FOCUS
NATURAL
SAS
dBASE III Plus
Easytrieve Plus
Data Base Management
ADABAS
Graphics Facilities
TELL-A-GRAPH/ Cuechart
VERSAGRAPH
SASGRAPH
Spreadsheet
LOTUS 1-2-3
20/20
MEGACALC
SAS/FSP
Geo-graphlcs
ARC/INFO (Pilot)
UNIRAS (Pilot)
TARGET HARDWARE ENVIRONMENT
IBM 3090
IBM 43XX DEC/VAX
PRIME IBM/PC
• »
0
O ft
0 «
ft
:
• • • :
• • • •
• :
• • • •
I • <
• i i i
'
o i ; i
9
•
•
0
0 9
0
0
0
0
* ~ ~ -
• i • {
« i
2-6
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-2 (Continued)
EPA- Agency Standard Hardware/Software
TOOLS
Word and Text Software
LEXJTRON WP DEVICE
LEXrTYPE
WORDSTAR
MULTI-MATE
WORD PERFECT
WORDMARC
Displaywrile 4
BASIS
TEXTWP
INFO-TEXT
Project Management
Tell-A-Plan
Microsoft Project
Telecom Capabilities
SNA
ASYNCH ASCII
HASP
X25
PRIMENET
DECNET
CROSSTALK
KERMfT
GNETII
PRIMELINK
NATURAL/CONNECTION
SAS/RBnk Rterm
3270 PC File Transfer
Electronic Mall
DIALCOM SERVICE
Local Capability
Programmmer Productivity
Aids/Facilities
ISPF
LIBRARIAN
EMACS
COBOL DEBUGGER
Fortran/ DEBUGGER
EVE/TPU
TARGET HARDWARE ENVIRONMENT 1
IBM 3090
IBM 43XX DEC/VAX PRIME IBM/PC |
«
• :;
• ;
• i
. * 1
"""•" i
9 ! i i
i \ i •
•
«
•
«
•
«
•
• • • j.
• • i
• • •;
•
}
• • i
• I
• •" • i
• 1
• • 1
• ^
• ;s
• • 1 • I
j
i ' ^
• i • |
1
• ; • |
• i
1
« 3
• ; •
2-7
-------
EPA System Design and Development
Guidance: Volume B
In reviewing the available hardware/software, the system
developer should consider such factors as the following:
. What specific hardware is available or can be made
available in physical proximity to the user(s)? What is its
accessibility?
. What similar software or data bases already exist, either
within EPA or elsewhere, which perform similar functions or
contain similar data? For example, EPA's personnel and
payroll systems already contain much personnel data, and
the Agency's Financial Management System (FMS) contains
comprehensive (and accessible) financial files.
. Is the application/system concept one for which software
has already been developed and is available either within
EPA or through service bureaus? For example, LEXIS/NEXIS,
a commercially available software package, provides a means
for storage and retrieval of abstracted data bases.
. Has EPA already developed "Core System" applications which
can be readily modified? (Consult OIRM/SIRMOs for
currently available Core Systems and Standards.)
. How complex are the basic functions which must or could be
performed by the automated system, and what software exists
to perform these functions (e.g., numerous project
management software packages exist which include critical
path analysis, as do statistical packages to perform
regression analysis etc.)?
. What is the desirable form of the output (hard copy tables,
text, graphs and charts, screen display, color graphics
etc.), and what hardware/software is available or can be
procured to produce this output?
. How long will the hardware/software be available within EPA
and when will it be replaced?
. What security arrangements are available for given hardware
or software, and are they adequate for the application?
The review of available hardware/software needs to include
examination of all of these areas.
Beyond the availability of specific hardware and software
applications, option designers should examine the potential
hardware and software based upon defined size and flexibility
requirements identified in the management and functional
requirements and operational specifications analyses.
2-8
-------
EPA System Design and Development
Guidance: Volume B
Exhibits 2-3, 2-4 and 2-5, following this page, present guidelines
for the type of software required for an application of a given
size and complexity.
Based upon the above reviews, the option designer should have
a relatively good feel for the potentially feasible hardware and
software options available to meet some or all of the management,
functional and operational specifications.
2.2.3 Developing Options by Structuring and Adjusting the
Operational Specifications and Varying Manual/Automated
Functions
In this step the analyses conducted to date are used to
construct manual/automated system options.
In constructing system options, a number of factors must be
considered simultaneously. Some of these factors include the
following:
Specific functions which are candidates for automation.
All automated systems have a manual component, and the only
question is what portion of the process or function will be
automated and what will be left as manual processing.
Often the feasible alternatives differ in the proportions
of the processes and functions that are to be automated.
The amount of effort (and hence cost) of automating certain
functions. For example, full text automation involving
voluminous files is usually not a desirable option because
of the almost prohibitive effort and cost associated with
inputting large amounts of data or text.
. User sophistication and discipline. Automated systems, but
particularly sophisticated systems, require considerable
effort and discipline to maintain accurate data. If these
are not present in the user organization, then a manual or
simple system is more highly preferred to a more
sophisticated design, and thus the options analysis should
include at least one "unsophisticated" option.
. Timing of the management requirement. If a system must be
in place quickly, a manual or less sophisticated design
will probably be required.
. Availability of the appropriate hardware/software at the
time of implementation. Procurement of new hardware or
software may take prohibitively long, and/or existing
hardware or software may be replaced while the system is
being designed.
2-9
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-3
SOFTWARE SUPPORT TOOL SELECTION MATRIX
SMALL SYSTEMS
SMALL SYSTEMS - # RECORDS < 10K OR TOTAL SIZE < 10 MEGABYTES
Number of Simultaneous Users
Complex Random Retrievals?
Location
of Related
Data
None
Main-
Frame
Mini-
Computer
PC
1
YES
2,3,6.7
2.3
6
7.8,9
NO
2,3,4.6,7
2.3,4
S
7,8,9
1 X'
>15
YES
'
2
2
2
MJMfX-&*'f&»-M*
NO
2,3,4
2.3.4
2,3.4
2,3,4 [
v^MM-XKMMOW-Xw^
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
3GL/DBMS (COBOL, PM. FORTRAN)
4GL/OBMS (Natural/ADABAS)
4GL (FOCUS)
4GL (Natural/VSAM)
5 - Minicomputer 3GL
6 - Minicomputer 4GL
(COBOL. FORTRAN. Pascal)
(FOCUS, INFO)
7 - Microcomputer 4GL (INFO, FOCUS. dBASE III)
8 - Microcomputer 4GL/08MS (dBASE III)
9 - Microcomputer 3GL (FORTRAN. Pascal)
2-10
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-4
SOFTWARE SUPPORT TOOL SELECTION MATRIX
MEDIUM SYSTEMS
MEDIUM SYSTEMS -1 OK < t RECORDS < 100K OR 10 MEGABYTES « TOTAL SIZE < 100 MEGABYTES j
Volatility
Number of
Simultaneous Users
Complex Random
Retrievals?
Location
of Related
Data
None
Mini-
Computer
Main-
Frame
Moderate Amount
of Change per Day
...
YES NO
2.3.6 2.3.
4.6
6 6
2.3 2,3,4
<*^.-t^^*^^~^r<.m,~^.<.,m^.^,,^<.^x«<^»a,.
...
YES NO
2 2.4
2 2.4
2 2.4
Volatile
S15 >15
YES NO YES NO
Highly '•.
Volatile
S15 >15
YES
2.6 2.3. 2,3 2.4 I 1.2.
4,6 I 5.6
i
5.6 5.6 2,3 2.4 5.6
2 2.3.4 2.3 2.4 1.2
NO YES NO !
1.2, 1.2, 1,2
5,6 5,6 :
5,6 1.2 1,2
1.2 1,2 1.2 !
wo^-^vs*i<^^«^«<^y;^v«.xi~a™o^^^
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
5 - Minicomputer
6 - Minicomputer
3GL/DBMS (COBOL PL/I. FORTRAN)
4GL/DBMS (Natural/ADABAS)
4GL (FOCUS)
4GL (Natural/VSAM)
3GL (COBOL FORTRAN, Pascal)
4GL (FOCUS, INFO)
2-11
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 2-5
SOFTWARE SUPPORT TOOL SELECTION MATRIX
LARGE SYSTEMS
LARGE SYSTEMS - » RECORDS
Volatility
Number of
Simultaneous Users
Complex Random
Retrievals?
File
Pass
Frequency
n- 1
per day
1 40
per day
> 100K OR TOTAL SIZE
Almost Static
(Update Weekly or Less)
•
YES
2.3
2
Hybrid
1.2
5
NO
2.3,4
2.4
4
>'
YES
2
2
Hybrid
1.2
5
NO
2.4
2.4
4
> 100 MEGABYTES
Moderate Amount of
Change or Volatile
$15
YES
2
2
Hybrid
1.2
.»
NO
2,4
2.4
4
Highly
Volatile
...
YES
1,2
1,2
Hybrid
1.2
„•
NO
1.2
1.2
Hybrid
1.2
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
3GL/08MS (COBOL, PL/1. FORTRAN)
4GL/OBMS (Natural/ADABAS)
4GL (FOCUS)
4GL (Natural/VSAM)
2-12
-------
EPA System Design and Development
Guidance: Volume B
Based upon these and other considerations, a set of system
options for performing the defined functions should be structured.
In general, these options should range from manual processes or
procedures, through the most highly automated alternative which is
potentially feasible.
In displaying the options, it is highly desirable — in fact
virtually mandatory — that all the manual and automated functions
associated with the option be defined and displayed. In fact
these manual/automated differences along with the
hardware/software differences are the primary factors which
differentiate the options and which will form the basis for the
benefit-cost analysis and subsequent option selection.
A recommended analytical technique for defining and
specifying the manual/automated alternatives and differences by
alternative, is to rely upon the flow charts and the Initial
System Concept developed during the Mission Needs Analysis.
Beginning with these flow charts (see Exhibits 2-1 and 2-2 of
Volume A), updated system concepts can be constructed for each
alternative identifying:
The specific manual functions which must be performed
. The specifi-c system functions which must be performed
Changes from the current mode of operation.
This clear specification of which functions are to-be performed
manually and which are to be automated is critical to the
development of benefit and cost estimates for each option.
As a final step of this analysis, the defined options should
be reviewed with the users to determine their acceptability. This
review should include a discussion of the advantages/disadvantages
as well as the operational implications (additional staff, new
procedures, information security factors, etc.) of each option.
The result of this last review with the users is a potential set
of options which appear to satisfy to an acceptable degree the
management requirements and mission need.
2-13
-------
EPA System Design and Development
Guidance: Volume B
3. OPTIONS ANALYSTS
Selecting an appropriate solution to satisfy the mission need
and operational specifications involves evaluating identified
options against the identified requirements to determine which
alternative most cost-effectively satisfies the requirements.
Thus, two analyses must be conducted:
. Operational and technical feasibility analysis
. Life cycle benefit-cost analysis.
Guidance for performing these analyses is provided below.
3.1 OPERATIONAL AND TECHNICAL FEASIBILITY ANALYSIS
For an option to be viable it should be technically,
operationally, and economically feasible. The purpose of the
operational and technical feasibility analysis is not only to
evaluate how well each option meets the requirements identified to
date but also to determine how operationally and technically
feasible each option is. The primary result of this task is a
ranking of the various options in accordance with their capacity
to meet the requirements.
Exhibit 3-1, following this page, presents an example of the
parameters and a matrix format for conducting an operational and
technical feasibility analysis.
Completion of a matrix such as the one shown in Exhibit 3-1
should indicate the extent to which each option is operationally
and technically feasible. The matrix can be used, if desired, as
a means of ranking options by desirability. This can be done
either informally through a joint review of the information by
management, users and the system developers, or formally through
the development of specific weights to be applied to each criteria
and the "scoring" of each option. The total score then becomes
the relative desirability of the option.
The results of this analysis will indicate the relative
desirability and effectiveness of each option. Before a final
determination of an option can be made, however, a life cycle
benefit-cost analysis must be conducted.
3.2 LIFE CYCLE BENEFIT-COST ANALYSIS
To ensure that the most cost-effective option is selected,
the benefits and costs of each option over the anticipated life of
the system must be carefully reviewed. The benefit-cost analysis
3-1
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 3-1
OPERATIONAL AND TECHNICAL
FEASIBILITY ANALYSIS
OPERATIONAL/TECHNICAL AREA
1 . CAPABILITY OF PRODUCING KEY
PRODUCTS (MEET MANAGEMENT
REQUIREMENT)
• 'A'
. -C-
2. DEVELOPMENTAL TIME COMPARED
TO NEED
3. FLEXIBILITY/EXPANDABILITY
4. ACCEPTABILITY TO MANAGEMENT
AND USERS
5. EXTENSIVENESS OF MANAGEMENT/
OPERATIONAL CHANGES REQUIRED (IF ANY)
6. RESOURCE AVAILABILITY
(STAFF AND DOLLARS)
7. MANAGEMENT COMMITMENT
8. RISKS OF DEVELOPMENT/
IMPLEMENTATION (Security, etc.)
• Management Risks
• System Hardware/Software Risks
• Security Risks
9. AVAILABILITY/ACCESSIBILITY OF
HARDWARE AND SOFTWARE
10. AUTOMATED SYSTEM CHARACTERISTICS
Capability to Interface with
Other Systems
• User-friendly Interface
• Failure and Backup Provisions
Hardware/Software Obsolescence
Site/Physical Plant Requirements
SCORE
DEGREE EACH OPTION MEETS
REQUIREMENT
OPTION 1
OPTION B
OPTION UI
3-2
-------
EPA System Design and Development
Guidance: Volume B
is a methodology for conducting this analysis. The objective of
the analysis is to identify and compare the benefits and costs of
feasible options to provide a sound basis for selecting the
preferred alternative.
The benefit-cost methodology consists of three tasks:
. Determining and valuing benefits
. Determining and valuing costs
. Comparing total benefits and costs.
The result of the benefit-cost-analysis is the determination of
the most cost-effective option. Detailed guidelines for
completing the benefit-cost analysis are presented below.
3.2.1 Determining and Valuing Benefits
The purpose of this task is to identify and value the
potential benefits of each system option. Benefits usually are
expressed in terms of the mission, goals or operating program
accomplishments over the expected system operational life-span.
These benefits must be identified for each year of system
operation. In general, benefits- are those accruing when compared
to the current situation including a projection of the "base"
situation to the future.
Generally, there are three types of potential benefits from
automated systems:
Cost reduction benefits which are a direct result of an
automated process being more efficient than a manual
process. In general these benefits accrue only when a
system is an operational system producing a product, such
as payment checks, mailing lists, etc. The methodology for
valuing these benefits is a relatively straightforward
efficiency analysis.
Additional capability benefits such as conducting
statistical (regression) analyses which cannot be dene
manually because of the immense number of calculations
required. It is often difficult to quantify these
benefits.
Management effectiveness benefits which result from
improved management due to improved information from
management information systems. In general, it is
impossible to directly measure these benefits
quantitatively since they stem from the presumed actions of
managers who will make better and more informed decisions.
The approximate magnitude of these benefits may, however,
be inferred by estimating the total cost of the
3-3
-------
EPA System Design and Development
Guidance: Volume B
organization being managed and presuming a small increase
(2%-10%) in organizational effectiveness or efficiency.
For example, if a 1,000 person organization is expending
$50 million/year, then a 2% increase in management
effectiveness translates into an inferred benefit of $1
million (.02 x $50 million).
Every reasonable effort should be made to identify and
quantify benefits in units and dollars with supporting rationale.
When benefits cannot be quantified in dollars, they should be
expressed in measurable units. Non-quantifiable benefits may be
identified if pertinent to the decision. The discussion below
presents categories of benefits which may result from a system
project.
3.2.1.1 Non-recurring Cost-Reduction Benefits
These are one-time benefits that have a dollar value. The
benefits may occur at any point in the life cycle, but they are
not continuing benefits.
1) Cost reduction - The value of eliminating owned
equipment, excess equipment and inventory, or any other
one-time source of quantifiable benefit.
2) Value enhancement - The value of additional tangible
procurements (depreciable, not consumable) and
improvements to owned facilities and equipment.
3.2.1.2 Recurring Cost-Reduction Benefits
This includes benefits accrued throughout, or during most of,
the system life cycle. These cost-reduction benefits should be
quantifiable and may include such categories as:
1) Maintenance and Lease of ADP Equipment - The savings for
ongoing lease and/or maintenance contracts for ADP
equipment.
2) Communications - The savings on rental, lease or
maintenance of data communication equipment, services,
and facilities.
3) Software Maintenance - The projected savings on the
maintenance of application software.
4) Personnel - The salaries and fringe benefits saved (net
savings) for operations, data entry, and other personnel.
5) Training and Travel - Savings due to reduced training and
travel.
3-4
-------
EPA System Design and Development
Guidance: Volume B
6) Space Occupancy - Savings on equipment space, personnel
and support facilities, and administrative offices.
7) Supplies and utilities - Reduction of both technical and
administrative supplies.
8) Security - Savings on security guards, devices, etc.
3.2.1.3 Qualitative Benefits
Many important benefits can result from a system without
being able to easily quantify them. Examples include:
. Faster processing and/or lower error rate
. Enhanced organizational image
Improved morale
. Standardization
It may not be possible to precisely quantify these benefits in
dollar terms, but they nevertheless should be examined and
retained as part of the analysis.
3.2.1.4 Determining Total Benefits
Total benefits are determined by summing annual tangible
benefits over the life of the system and adding non-recurring
benefits. To determine present value benefits, adjust the
benefits over the system life cycle to their present value. The
net present value is calculated by subtracting the adjusted cost
from the total present value of benefits. FIPS PUB 64 and OMB
Circular A-94 provide guidance for calculating the present value
of benefits.
3.2.2 Determining and Valuing Costs
The purpose of this task is to determine for each system
option all costs and required resources, e.g., personnel,
equipment, etc. Costs must be analyzed for each alternative over
its life cycle.
The system life cycle includes both the research and
developmental, and operational and maintenance phases of the
system's life. For example, the costs for conducting the system
development process discussed in Volume C must be included in the
system life cycle costs. The end of the system life cycle is the
projected final year in the useful life of the system, or the last
year in which either costs or benefits are incurred.
3-5
-------
EPA System Design and Development
Guidance: Volume B
Only relevant costs must be addressed in the economic
analysis. A cost is relevant if the implementation of an
alternative would cause currently occurring costs to change. For
example, site costs are relevant if the current facilities must be
modified or expanded to accommodate the system. Costs which are
not impacted by any alternative are the same for all alternatives
and, therefore, they are irrelevant to the economic analysis.
Sunk costs are not relevant to the economic analysis. Sunk
costs are costs which have already been incurred or are
irrevocable due to a prior commitment. Sunk costs are irrelevant
to the economic analysis because they will be incurred at the same
level regardless of the outcome of the analysis.
Relevant non-informational system costs must be included in
the analysis. For example, if workload increases would require
future increases to non-information system staff to perform a
program mission, goal or operating function, the additional costs
must be shown as increased costs of the present system.
Cost estimates must be supported by a reasonably accurate
projection of workload and capacity requirements. Specific
workload data and associated capacity requirements for each year
in the system life must be provided.
The effects of inflation, or anticipated changes in the
general price level, are not required in the analysis of costs.
If inflation is used in the analysis, the resulting costs must be
presented in both present (constant) and future (discounted)
dollars.
Although inflation, or an unanticipated increase in the
general price level, is not required for the analysis, a known or
expected price increase in a specific cost item should be included
when the magnitude of the price change may affect the decision
(for example: an increase in personnel costs projected due to a
planned general Federal pay raise). Note that costs for all years
of the system life must be presented in both present and future
dollars.
Developmental (non-recurring) and operational (recurring)
costs must be separately identified. Developmental costs are one-
time costs to acquire hardware, software, telecommunications,
facilities, capitalized equipment, training and travel.
Operational costs may be incurred over the life of the system and
include maintenance, facilities, non-capitalized equipment,
supplies, training and travel. Specific types of costs which
should be considered in the analysis are identified below.
3-6
-------
EPA System Design and Development
Guidance: Volume B
3.2.2.1 Non-recurrina Costs
Non-recurring costs are costs associated with the acquisition
of equipment, real property, non-recurring services, non-recurring
operations and maintenance (start-up) costs, and other one-time
costs. Non-recurring costs need not all occur in a single year.
They include costs for:
1) Site Modifications - The cost of erecting or modifying a
site and surrounding facilities to meet the needs of the
proposed system, e.g., costs to enlarge a computer room
and additional space required for personnel involved in
this process, etc.
2} ADP Equipment - The cost for hardware, e.g., CPUs, disk
drives, security devices, etc.
3) Data Communications - The cost for data communications
hardware, communication lines and dedicated data
communications software.
4) Software purchase - The cost for system software packages
procured for the direct support of the proposed system.
5) Database development - The cost of implementing database
system software and database applications software.
6) Software development - The cost of implementing
application programs.
7) Studies - The cost of studies associated with the
requirements, design development, or implementation of
the proposed system.
8) Data Conversion - The cost of converting present data and
program logic.
9) Prorurornoni- - The cost of procuring hardware, software
and data communications such as RF? preparation, vendor
evaluation, and contract preparation.
10) Training - The cost of training, including user,
operations, and management training.
11) System Test - The cost of evaluating the system, «
including tests of information security safeguards.
12) Management Overhead - The cost of management interface in
the development process defined in terms of hours
required for meetings, reviews and administrative
3-7
-------
EPA System Design and Development
Guidance: Volume B
functions associated with continued system operation,
etc.
3.2.2.2 Recurring Costs
Recurring (operations) costs are costs of operating the
system on an annual basis that continue throughout the system
life. They include costs for:
1) Personnel - The salaries and fringe benefits for
operations, data entry, and other personnel assigned to
the system. Part-time activities should be prorated
accordingly.
2) Maintenance and Lease of ADP Equipment - The cost for
lease and/or maintenance contracts for ADP equipment.
3) Space Occupancy - The cost of equipment space, personnel
and administrative offices.
4) Supplies and Utilities - The cost of both technical and
administrative supplies.
5) Timesharing - The cost of buying computer time from a
commercial source.
6) Communications - The cost for the rental, lease or
maintenance of data communications equipment, services
and facilities.
7) Software Maintenance - The cost of maintaining
application software.
8) Training - The cost of training and travel for new
employees and upgrades.
9) Security - The cost of security guards, security devices,
etc.
3.2.2.3 Qualitative Costs
Costs may or may not be measured in quantitative terms.
Although the primary emphasis of the benefit-cost analysis is to
evaluate measurable impacts, the overall objective is to clarify
all of the important effects of any decision. Since this is the
case, the identification and consideration of qualitative or
intangible effects which usually defy accurate calculation
nevertheless play a part in the analysis. Some qualitative costs
include, but are not limited to:
3-8
-------
EPA System Design and Development
Guidance: Volume B
. Operational disruptions
. Reduced employee morale
. Degraded organizational image
3.2.2.4 Determining Total Costs
To calculate total costs, the total non-recurring and
recurring cost subtotals for each year of the system life are
added together. The total annual cost can be converted to present
value cost for each year of the system life. The present value
will give a more equitable base when alternatives have a wide
dispersion in the funding years. A percentage rate must be
applied to each year's cost to calculate the present value and
aggregate the total system cost. FIPS PUB 64 and OMB Circular A-
94 (revised March 27, 1982) provide more detailed guidance for
calculating present value costs. The total cost over the system
life is derived by summing the total costs for all years of the
system life.
3.2.3 Benefit-Cost Comparison
The final step of the benefit-cost analysis is the summation
of all benefits and costs, selection of the benefit-cost measure,
and arrangement of the benefit-cost display.
The summation of benefits and costs is a straightforward
addition which permits total benefits to be compared to costs. If
all benefits and costs are measured in dollar terms, then one
number will be obtained for each. However, qualitative benefits
or costs frequently will be included and in these cases no single
number can be obtained and a number of measures may have to be
included in the final summation. However, just because a cost or
benefit cannot be measured in dollar terms does not mean it can be
dropped from the final summation or downrated. If it is a major
effect, it must be considered.
The actual quantitative benefit-cost comparison involves
three primary calculations:
1) Determination of the benefit-cost ratio
2) Determination of payback period
3) Determination of rate-of-return on investment
Exhibit 3-2 provides a sample format for summarizing both benefits
and costs of an option (e.g., Option "A") over the system life
cycle period. Exhibit 3-3 provides a sample format for displaying
quantitative benefits for all options evaluated in order to allow
easier comparison.
3-9
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 3-2
SAMPLE SUMMARY OF TIME-PHASED COSTS
AND BENEFITS FOR OPTION A
CATEGORY
SYSTEM DESIGN 8, DEVELOPMENT
COSTS
ACQUIRE/MAINTAIN HARDWARE
ACQUIRE/MAINTAIN SOFTWARE
IMPACT COSTS
TRAINING
DATA ENTRY
TOTAL COSTS
CUMULATIVE COSTS
OPTION A
RSCAL YEAR
1987
1988
1989
1990
1991
1992
1993
1994
TOTAL BENEFITS
CUMULATIVE BENEFITS
NET BENEFITS
CUMULATIVE BENEFITS
3-10
-------
EPA System Design and Development
Guidance: Volume B
EXHIBIT 3-3
SAMPLE SUMMARY OF OPTION
BENEFITS AND COSTS
CATEGORY
SYSTEM DESIGN & DEVELOPMENT
ACQUIRE/MAINTAIN HARDWARE
ACQUIRE/MAINTAIN SOFTWARE
IMPACT COSTS
TRAINING
DATA ENTRY
TOTAL COSTS
TIME SAVINGS TO USERS
NET BENEFITS (BENEFITS - COSTS)
PAYBACK
(ONE-TIME COSTS/NETBENEFITS)
OPTION A
ONE-T1ME
ANNUAL
OPTION B
ONE-TIME
ANNUAL
OPTION C
ONE-TIME
ANNUAL
3-11
-------
EPA System Design and Development
Guidance: Volume B
3.2.3.1 Benefit-Cost Ratio
There are several benefit-cost measures which can be used for
comparison purposes. The benefit-cost ratio (B/C) is one measure
which gives an approximate multiple of return on the investment
costs of a project. Obviously, for a project to be economically
viable, benefits should outweigh costs so that the B/C ratio
should be greater than 1. Another measure is the
ratio of net benefits (benefits minus costs) to costs. This gives
an approximate rate of return on investment. A third measure, net
benefits (B-C) may be used if the size of benefits is important.
3.2.3.2 Payback Period
The payback period is calculated by determining the year and
month in which the sum (in current dollars) of benefits first
exceeds the sum of the costs.
3.2.4 OMB Benefit-Cost Approval Criteria
Benefit-cost submissions to OMB for external review and
approval must show at least a 10% return on investment or provide
substantial additional justification for funding based on
satisfying non-financial criteria. OMB has also indicated that
particular attention will be paid to narrative amplification of
system benefits and costs, including assumptions made, options
considered, and the use of sensitivity analysis as a hedge against
uncertainty.
3-12
-------
EPA System Design and Development
Guidance: Volume B
4.0 OPTION SELECTION AND DOCUMENTATION
When the procedural steps outlined above have been performed,
the options analysis and the life cycle benefit-cost analysis are
complete. The results of these analyses provide decision makers
with a range of valued alternatives. However, the results must be
carefully examined to ensure the accuracy of the analysis, and
other factors that may be relevant to option selection must be
considered.
4.1 OPTION SELECTION CRITERIA
The results of the operational and technical feasibility
analysis and the benefit-cost analysis support decision makers by
providing them with required information to make an informed
selection. These analyses do not make automatic the decision of
which option to select. The selection process, while guided by
these analyses, still involves a moderate amount of subjectivity.
One factor which may play an important role in any decision
is risk. With any project there is a certain element of risk
involved, risk that costs may exceed expectations, that benefits
will not materialize as expected, etc. A benefit-cost analysis
and the operational and technical feasibility analysis helps
minimize risk since they require explicit definition of expected
benefits, costs and risks. However, some risk always remains. If
there is a high possibility that benefits may not materialize from
a project, the project's benefits should be much greater than its
costs if a decision to continue is to be made. Similarly, if
costs and benefits are almost assuredly known, the project may be
viable even at a lower benefit-cost ratio or lower rate-of-return.
The risk factor should be evaluated in any decision concerning a
project.
Another element of the option selection process which must be
taken into account, especially for larger systems, is OMB's
requirements governing major system development. As previously
noted, OMB requires a 10% return on investment or substantial
additional justification if it is to approve such development
efforts. In addition, OMB requires (OMB Circular A-ll) that
budget estimates must be prepared for all "major information
system initiatives" which are defined as:
System design or development costs exceeding $1 million
System operation and maintenance costs exceeding
$500,000/year.
4-1
-------
EPA System Design and Development
Guidance: Volume B
This approval requirement can affect the timing of a system
development project and potentially even help decide which option
is selected.
Of particular importance in the final decision is the value
judgment placed upon qualitative considerations, either those
identified in the analysis or others. Frequently, the
desirability of the project will hinge on these factors. It is
the job of the decision maker to evaluate intangibles in light of
his/her knowledge of the project, the people affected by it, and
the conditions surrounding it. A final decision must be based
upon these factors as well as the results of the benefit-cost
analysis.
4.2 DOCUMENTATION REQUIREMENTS
Completion of the-analyses described in this volume should be
documented in a report outlining the analyses conducted and the
results obtained. Appendix A, EEI-2, presents a suggested outline
for this report. The report -- EEI-2, Preliminary Design and
Options Analysis — or an equivalent report, must be completed for
all system development efforts as described in Chapter 1, section
1.5. If the selected option is a manual solution, it is not
strictly necessary to complete the report shown, since
justification for a manual system is not required. Nevertheless,
it is recommended that basic elements of the documentation be
retained for future reference.
It should be remembered that the benefits-cost analysis is an
evolving document and that benefits/costs will change as the
project progresses and becomes better defined. Therefore, for
those system efforts which proceed to the design, development and
implementation phase the benefit-cost analysis will require
updating.
Additionally, at the conclusion of this phase, if the system
development effort appears to be viable and proceeding to design,
development and implementation there are certain management
actions which must be taken, including:
. Appointment of a project manager and team
. Consideration of establishment of configuration
management and quality assurance/control mechanisms
. Development of a Project Management Plan (EEI-3) .
The Project Management Plan is an extremely important
document and will set out how the system development effort will
be accomplished, especially focusing on resources and scheduling
4-2
-------
EPA System Design and Development
Guidance: Volume B
as well as other factors. Appendix A, EEI-3, provides a
representative outline for a Project Management Plan.
4-3
-------
EPA System Design & Development
Guidance: Volume B
5. SUMMARY
5.1 PRELIMINARY DESTGM AMD OPTIONS ANALYSTS
The outputs, documents and results of the Preliminary
Design and Options Analysis are:
. EEI-2, Preliminary Design and Options Analysis
. EEI-3, Updated Project Management Plan
. Detailed supporting documentation and work papers
. Summaries of available options, benefits and costs
. Operational and technical feasibility analysis
. Functional requirements analysis worksheets
5.2 NEXT STEPS
If the option analysis and subsequent Project Management Plan
indicate that an automated system should be developed, either
wholly or in part, then the next steps would be System Design,
System Development, and System Implementation as outlined in
Volume C. Otherwise, the program manager should develop the
written guidelines and procedures that outline the recommended
approach for conducting the process using non-automated methods.
5-1
-------
EPA System Design & Development
Guidance: Volume B
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
-------
EPA System Design and Development
Guidance: . Volume B
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
A. ESSENTIAL ELEMENTS OF INFORMATION
This appendix provides a representative outline of documents
that will be developed during the Preliminary Design and Options
Analysis phase.
A.I INTRODUCTION
The documentation requirements contained in this appendix
apply to all software development projects, regardless of size,
complexity or origin. At a minimum, these standards apply to all
new software development projects. Maintenance and/or
enhancements to existing information systems must comply with the
requirements set out in Chapter 1, section 1.5 of Volume B,
Preliminary Design and Options Analysis.
Compliance with the standards and conventions provided in
this appendix will ensure that adequate documentation is produced
for all system development projects.
The documents defined in this aooendix are:
EEI-2 • • Preliminary Design And Options Analysis
EEI-3 • • Project Management Plan
When an asterisk appears within a section number in the
outlines, it represents a repetition of the element as many times
as necessary to define multiple iterations of the element.
The following milestone chart illustrates the relative
initiation and completion of each document with respect to the
software development life cycle, its major phases, and the span
and scope of Volumes A, B, and C.
A-l
-------
DOCUMENTATION VERSUS LIFE CYCLE
Mission Needs Analysis
EEI-1
Preliminary Design/
Options Analysis
EEI-2
EEI-3
System Detailed
Requirements Analysis
EEI-4
EEI-5
EEI-6
Preliminary Design
EEI-7
EEI-8
Detailed Design
EEI-9
System Production
and Programming
EEI-10
EEI-11
EEI-12
System Integration
Testing & Evaluation
EEI-13
System Installation
tem Operations &
intenance
Volume A
Volume B
Volume C
System Preliminary Critical
Requirement Design ; Design DT&E OT&E
Review TV-Review--::v^i:s:.RevlewVt:S 'Review Review
U
;eptapca
O W
C *0
H->
C" C/l
3 ^<
O to
fl> ft
.. fD
3
< a
o n>
M W
C H-
3lQ
0) D
tt) fiJ
o
0)
fD
h-1
O
13
fD
-------
EPA System Design and Development
Guidance: Volume B
EEI-2 PRELIMINARY DESIGN AND OPTIONS
EXECUTIVE SUMMARY
. Background
. System Concept
. Option Summary
. Results of Options Analysis
1. INTRODUCTION
1.1 Background
1.2 Current System Description
1.3 Results of Mission Needs Analysis
1.4 Scope and Purpose
2. OPTION DESIGNS
2.1 System Concept, Management Requirements and Functional
Requirements Summary
2.2 Operational Requirements Summary (General system
requirements like security, etc.)
2.3 Option Descriptions
2.3.1 Option 1 •
2.3.2 Option 2
2.3.* Option 3 etc.
3. OPTIONS ANALYSIS
3.1 Summary of Option Life Cycle Benefits
3.2 Summary of Option Life Cycle Costs
3.3 Life Cycle Benefit-Cost Analysis
3.4 Summary of Risks and Contingencies by Option
4. OPTION RECOMMENDATION (WITH RATIONALE)
A-3
-------
EPA System Design and Development
Guidance: Volume's
EEI-3 PROJECT MANAGEMENT PLAN
EXECUTIVE SUMMARY
. Background
System Description
. Funding/scheduling
. Accomplishment Plan (including Procurement)
. Risk
1. INTRODUCTION
1.1 Background
1.2 Current System Overview
2. System Description
3. Project Team and Support
3.1 Roles and Responsibilities
3.2 Configuration Management
3.3 Quality Assurance/Control
3.4 Procurement Plan
4. Project Schedule and Task Description
5. Project Budget and Funding
6. Facilities
7. Test Plan Requirements/Constraints
8. Risk Summary/Project Constraints
8.1 Policy Events
8.2 Forms and Clearances
A-4
-------
United States
Environmental Protection
Agency
Office of Information
Resources Management
Washington DC 20460
OIRM 87-02C
10/87
EPA SYSTEM DESIGN &
DEVELOPMENT GUIDANCE:
VOLUME C:
SYSTEM DESIGN,
DEVELOPMENT
AND
IMPLEMENTATION
-------
Volume C
Executive Summary
This document defines the process and documentation that
system developers prepare during the System Design and Develop-
ment phase of the system life cycle. The objective of this doc-
ument is to provide guidance towards satisfying requirements
specified in EPA's IRM Policy Manual for the acquisition and
management of information technology.
The guidance within this document is intended to provide
system developers with specifics concerning software program
management, design and related documentation. The objective of
the Software Management Plan, outlined in this document, is to
ensure the quality of EPA software design, development, imple-
mentation and maintenance efforts. The EPA Software Management
Program is based on six software engineering elements that in-
clude policies, standard software tools, procedures/ methods,
guidelines, planning, and oversight and compliance.
Completion of the steps and documentation outlined in this
document will result in an automated system that solves a spe-
cific problem as outlined in EEI-1, the Mission Needs Statement.
Accompanying the automated system will be a sufficient quantity
of documentation that detail inputs, outputs and processes
within the system. The rationale behind all the documentation
requirements is to assure program managers and OIRM staff that
the delivered system fulfills its user's requirements, utilizes
EPA accepted standards and procedures, and is within the guid-
ance, limitations and constraints imposed on the Agency by OM3,
GSA and the Congress of the United States.
The following exhibit describes the complete software life
cycle. Each phase in the software life cycle is represented by
a bubble with its corresponding title on the inside of the cir-
cle. Factors that influence each phase are shown surrounding
each circle. The scope of this document covers three separate
phases, System Design, System Development and System Implementa-
tion. As indicated, factors that influence the System Desigr.
phase are programming language constraints, detailed user re-
quirements, data requirements, and the physical environment ar.d
the preceding bubble, the Preliminary Design and Options
Analysis. The next phase discussed in this volume, System De-
velopment, is influenced by the output from the System Design
phase and the external influences of development resources, pro-
gramming standards and development tools. The final phase de-
tailed in this document is System Implementation. As indicated,
factors that influence this phase are the outputs from the
System Development Process, and external factors such as OMB
certification, operations constraints and user acceptance of the
delivered product.
-------
Complete Software
Life Cycle
Volume A
Lack of
Maintenances^
Resources
Improved
Tools —
Radical
Changes in
/ Requirements
Volume B
Physical
/ Environment
Mission
Needs
Analysis
Software
Obsolescence
Preliminary
Desin
Options
Analysis
Hardware
Environment
\
Improved
Hardware
High Quality
Government
Owned or
Commercial
Alternative
Software?
Iroprovcmcni
Increment
System
Design
Programming
Language —
Conuaints
Detailed
User
Requirements
Enchancement
/
Development
Resources
User
Acceptance
Operations
Contrainis —f
System
Implementation
System
Development
Software
Improvement
Incremeni
Programming
Standards \
Programming
Slandards
\
System
Improvement
Plan
Requirements
Software
Design/
Implementation
Constraints
I
Software
Bugs
Volume C
Software
Engineering
Technology
OMB /
Certification
-------
EPA System Design & Development
Guidance: Volume C
TABLE OF CONTENTS
Title Pace
1. Introduction 1-1
1.1 Background 1-1
1.2 Objectives of the System Design and
Development Guidance 1-1
1.3 Authority 1-5
1.4 Applicability of the Guidance 1-5
1.5 Documentation Requirements 1-5
1.6 Assistance And Support Available 1-9
2. Software Management Program 2-1
2.1 Applicability to Small and Large
Projects 2-1
2.2 Quality Software 2-1
2.3 Software Management Program Overview 2-2
3. System Design, Development and Implementation
Overview 3-1
3.1 System Design Stage 3-1
3.1.1 System Detailed Requirements Analysis 3-1
3.1.1.1 Activities 3-3
3.1.1.2 Documentation 3-4
3.1.1.3 System Requirements Review 3-4
3.1.1.4 Functional Baseline 3-4
3.1.2 Preliminary Design 3-4
3.1.2.1 Activities 3-4
3.1.2.2 Documentation 3-6
3.1.2.3 Preliminary Design Review 3-6
3.1.2.4 Preliminary Design Baseline 3-7
3.1.3 Detailed Design 3-7
3.1.3.1 Activities 3-7
3.1.3.2 Documentation 3-8
3.1.3.3 Critical Design Review 3-9
3.1.3.4 Design Baseline 3-9
3.2 System Development Stage 3-9
3.2.1 System Production and Programming 3-9
3.2.1.1 Activities ' - 3-10
3.2.1.2 Documentation 3-11
3.2.1.3 System Production and Programming
Reviews 3-11
3.2.1.4 Development Test and Evaluation Review 3-11
3.2.1.5 Product Baseline 3-11
3.2.2 System Integration, Test and Evaluation 3-12
-------
EPA System Design & Development
Guidance: Volume C
3.2.2.1 Activities 3-12
3.2.2.2 Documentation 3-12
3.2.2.3 System Integration, Test and Evaluation
Reviews 3-13
3.2.2.4 Operational Test and Evaluation Review 3-13
3.2.2.5 Operational Baseline 3-13
3.3 System Implementation Stage 3-14
3.3.1 System Installation 3-14
3.3.1.1 Activities 3-14
3.3.1.2 Major Products 3-14
3.3.2 System Operation, Maintenance and
Evaluation 3-14
3.3.2.1 Activities 3-15
3.3.2.2 Documentation 3-15
4. Software Engineering Components . 4-1
4.1 Software Engineering Components 4-1
4.1.1 Standards 4-1
4.1.2 Procedures/Methodologies 4-1
4.1.3 Software Development Support Tools 4-2
4.1.4 Quality Assurance 4-2
4.2 Software Engineering Principles 4-2
4.2.1 Determining Documentation Retirements 4-4
4.2.2 Software Life Cycle Reviews 4-6
5. Software Development Standards 5-1
5.1 Standard Programming Languages 5-1
5.1.1 Programming Language Selection
Guidelines 5-1
5.1.2 Source Program Design and Coding
Conventions 5-4
5.2 Core System Standards 5-8
5.3 EPA Standard Specialized Software Tools 5-9
5.4 EPA - Agency Standard Hardware/Software 5-9
6. Summary 6-1
6.1 System Design, Development and
Implementation Outputs 6-1
6.2 Next Steps 6-1
Appendix A Essential Elements of Information A-l
LIST OF EXHIBITS
1-1 EPA System Development Life Cycle
and Decision Process 1-3
1-2 EPA System Development Life Cycle
Documentation 1-7
IV
-------
EPA System Design & Development
Guidance: Volume C
1-3 System Category/EEI Matrix 1-10
3-1 System Design, Development and
Implementation Life Cycle Phase 3-2
3-2 Software Maintenance Life Cycle 3-16
4-1 EEI Requirements for Major Agency and
Widely Accessed Information Systems 4-5
4-2 EEI Requirements for Localized
Information Systems 4-7
4-3 EEI Requirements for User Owned
Information Systems " 4-8
5-1 EPA Standard Application Programming
Languages 5-2
5-2 Software Support Tool Selection Matrix
Small Systems 5-5
5-3 Software Support Tool Selection Matrix
Medium Systems 5-6
5-4 Software Support Tool Selection Matrix
Large Systems 5-7
5-5 EPA Standard Specialized Software Tools 5-10
5-6 EPA Hardware/Software Environmental
Standards 5-11
-------
EPA System Design & Development
Guidance: Volume C
1. INTRODUCTION
Pursuant to the Environmental Protection Agency's IRM Policy
Manual, this volume is the third of three volumes which provide
guidance for Agency system design and development efforts. This
volume provides detailed guidance for the final phase of the EPA
system development life cycle process — the Design, Development
and Implementation phase.
Volume C is intended for use by system developers,' including
Agency staff and contractors, who are actually responsible for
system development. It therefore provides detailed guidance for
conducting automated system development activities to help insure
compatibility and uniformity EPA-wide.
1.1 BACKGROUND
The Environmental Protection Agency expends millions of
dollars each year on the design, development, implementation and
maintenance of major environmental and administrative systems
vital to EPA's programs and administrative functioning.
Management of these system resources is becoming increasingly
complex, since the rapid development of information technology in
the 1980's has dramatically increased computer capacity and user
accessibility. The result has been two-fold:
. An increasing number of system development efforts by
managers and staff at all organizational levels who,
because of access to their own equipment, develop their own
systems independently of Agency systems staff
. A wide range of hardware/software options for
implementation of any specific system concept or design.
Therefore, there has been a proliferation of system development
efforts by a broad range of users with varying levels of
sophistication in making system development decisions and
conducting system development efforts.
1.2 OBJECTIVES OF THE SYSTEM DESIGN AND DEVKT.OPMF.NT GUIDANCE
Within EPA's Office of Administration and Resources
Management (OARM), the Office of Information Resources Management
(OIRM) is responsible for ensuring the effective and efficient use
of EPA's information resources including automated system design,
development and maintenance. OIRM's objective in this endeavor is
to provide guidance, assistance, and only when necessary,
controls, to assure that the Agency's considerable information
resources are utilized cost-effectively for the overall benefit of
the Agency. To this end, OIRM has developed umbrella policies
1-1
-------
EPA System Design & Development
Guidance: Volume C
guiding information system development and acquisition (see
Information Resources Management Policy Manual) and has also
developed this three-volume set of guidelines and standards to
assist with EPA's system development efforts. These three volumes
provide sequential guidance for:
. Defining the system requirement (or need) and related
operating concept
. Developing feasible system options and selecting the most
cost-effective option
. Designing, developing and implementing the selected system
option.
Exhibit 1-1, following this page, graphically depicts the three
major phases of the system development life cycle and the
decisions and results expected of each phase. However, EPA's
system development life cycle discussed in these volumes
represents little more than fifty-five percent of the total life
cycle of a software application. Typical cost allocations for
each major component of the total system life cycle are
represented in the graph below.
Life Cvcle Costs 1
Mission Needs Analysis /
Preliminary Design &
Options Analysis 5.0%
Detailed Design
15.0%
Software Testing,
Integration, Verification, &
Validation 30.0%
1 These figures are based on a graphic illustration in Coni-mi i
Software Products by Tom DeMarco, 1982, which purports to
represent industry averages .
1-2
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 1-1
EPA SYSTEM DEVELOPMENT LIFE CYCLE
& DECISION PROCESS
PEVELOPMENT STAGE
DECISION/RESULT
REAL WORLD
MISSION NEED
VOLUME A
MISSION NEEDS
ANALYSIS
SYSTEM REQUIREMENT
AND OPERATIONAL
CONCEPT DEFINITION
VQLUMg •
PRELIMINARY DESIGN
OPTIONS ANALYSIS
SYSTEM OPTION DESIGN.
BENEFIT/COST ANALYSIS,
AND OPTION SELECTION
VOLUME C
SYSTEM DESIGN,
DEVELOPMENT
A IMPLEMENTATION
FULLY IMPLEMENTED
SYSTEM
1-3
-------
EPA System Design & Development
Guidance: Volume C
This document is the third of the three-volume set. The
volumes cover the following:
• Volume A - Mission Needs Analysis — is designed to provide
program managers and staff with a suggested methodology for
assessing and evaluating the need (requirement) for an
information system. Applying the methodology in this
volume will result in two outputs: 1) a preliminary
specification of the management requirement for information
or information processing and the outputs and benefits tied
to the user organization's mission and operationsr and 2)
an "Initial System Concept-" which provides an initial
depiction of the system's input, processes and output-*.
These results: 1) confirm that a need (requirement) exists
and 2) provide a preliminary operational specification of
the requirement.
• Volume B - Preliminary 'Design and Options Analysis ~ is
directed towards program managers and staff. It provides
guidance and a methodology for structuring- design options
for meeting the requirement defined in Volume A and
provides guidance for selecting the most cost-effective
opt inn. The steps described in this volume result in the
selection of the most mission/cost-effective option (manual
or automated) based upon life cycle concepts.
• Volume C - System Design. Development And Implementation —
is intended for use primarily by system developers and
provides specific guidance and standards which must be
adhered to when undertaking automated system design and
development efforts.
Together these three volumes provide comprehensive guidance and
standards for the orderly and cost-effective development of
automated systems.
It should be noted that the EPA has established a
comprehensive information security program through Chapter 8 of
the IRM Policy Manual. Because retrofitting security measures
into software under development is complex, expensive and risky,
security considerations need to be an integral part of the system
development life cycle. Consequently, security issues and factors
are identified at appropriate points throughout these volumes. A
detailed discussion of security design and development
considerations is beyond the scope of this guidance. Additional
security guidance will be provided in the forthcoming EPA
Information Security Manual.
1-4
-------
EPA System Design & Development
Guidance: volume C
1.3 AUTHORITY
The EPA System Design and Development Guidance derives its
authority from Chapter 4 of the IRM Policy Manual, entitled
"Software Management," which establishes the Agency Software
Management Program. The guidance serves as the primary guidance
for Agency system design and development efforts.
1.4 APPLICABILITY OF THE GUIDANCE
Senior Agency managers and responsible staff should read the
guidance and become familiar with the standard decision-making
process involved with system design and development efforts. They
are responsible for ensuring adequate analysis and documentation
to support the critical decisions/results illustrated in Exhibit
1-1.
In general, Volumes A and B are intended to assist program
offices and/or users in conducting their own initial studies of
management requirements, needs, option feasibility and cost-
effectiveness. In this context, the term "system" in Volumes A
and B refers to a systematic set of processes and/or procedures
which can be used to meet the information needs of a user. It
does not imply that the "system" will be an automated system.
The full requirements for documentation for automated system
development efforts which must be followed to conform to OARM
policy are fully discussed in Volume C. Volume C, however,
presumes that an automated or partially automated solution has
been selected as a result of the Volume B options analysis.
Volume C provides both guidance and standards for automated
system development efforts. If the automated system is a
relatively small application on a microcomputer targeted for use
within a single office (a "user owned information system"), Volume
C provides simplified requirements for system design, development
and implementation. If the proposed system is a larger
application (mainframe or minicomputer), which is mission-critical
or involves multiple offices and organizations, Volume C provides
both guidance and standards which must be followed by system
developers. This will assure uniform, cost-effective system
development in accordance with EPA policies, guidelines and
standards.
1.5 DOCUMENTATION REQUIREMENTS
In general, the intent of the three-volume System Design and
Development Guidance is to provide a consistent focus for system
development efforts which will allow both EPA program managers and
OARM managers to cost-effectively develop and maintain the
Agency's systems. To achieve this goal, certain documentation
1-5
-------
EPA System Design & Development
Guidance: Volume C
requirements (termed "Essential Elements of Information" (EEI)
documents) must be met. Exhibit 1-2, following this page,
summarizes the EEI documentation requirements. As shown,
documentation required for the first two phases of the process —
Mission Needs Analysis and the Preliminary Design and Options
Analysis — are limited to one and two documents each,
respectively. All system development efforts are subject to the
documentation requirements of these first two phases as set out in
Volumes A and B.
If a full information system development effort is
anticipated after these first two phases, then a traditional
series of system design and development documents must be
developed and submitted as shown in Exhibit 1-2. For certain
system development efforts OIRM and office Senior Information
Resources Management Officials (SIRMOs) must be involved in a
review capacity to fulfill EPA's IRM Policy Manual requirements.
Systems falling into one or more of the following categories must
have OIRM/SIRMO review involvement:
. EPA mission critical
. States, local governments or other Federal agencies
involved
. Interorganizational involvement (e.g., between Assistant
Administratorships or including Regional Office
involvement)
. Costs for system'development/enhancement are projected to
exceed 3250K (excluding costs associated with long-term
system operation and maintenance)
. Information security issues involving the three general
security areas: applications security, installation
security and personnel security. In total, information
security involves the precautions taken to protect the
confidentiality, integrity and availability of information
. Privacy Act or confidential business information involved.
For system development efforts falling into any one of these
categories, OIRM and office SIRMOs must be involved beginning with
a review of EEI-1, generated at the conclusion of the Mission
Needs Analysis, as described in Volume A of the EPA System Design
and Development Guidance. OIRM/SIRMO review involvement will
continue through the. development life cycle of these systems and
will include all EEI documentation requirements for such systems.
1-6
-------
SPA System Design & Development
Guidance: Volume C
EXHIBIT 1-2
EPA SYSTEM DEVELOPMENT LIFE
CYCLE DOCUMENTATION
DEVELOPMENT PHASE
DOCUMENTATION
REAL WORLD
MISSION NEED
YO.LMA
MISSION NEEDS
ANALYSIS
I '
J
llt-1. MISSION MHOS
STATIUINT (INCIUOINO INITIAL
1TSTIH CONCIFT)
VCUACB
PRELIMINARY DESIGN
t OPTIONS ANALYSIS
IIM. MfUMINAIIV OISION 4
OPTIONS ANALYSIS
III-*. MOJICT HANAQIUINT
PLAM
VOUACC
SYSTEM DESIGN
SYSTEM
DEVELOPMENT
SYSTEM
IMPLEMENTATION
IIM. »0»TWABI PHILIMINAflT
Oman OOCUMINT
Ill-l. SOrrWARI OITAILIO
OISION
[llt-10. lOTWABI HAINTINANCI
OOCUMINT
sorrwAHi OPIRATION*
OOCUMINT
UI-12. SOPTWAMI USIM'S
RVIRINCI OWOI
Ill-ll. STSTIM INTIORATION
HIT KIPOHT1
ID UVOAT1S AS MOUIHID
1-7
-------
EPA System Design & Development
Guidance: Volume C
For systems not falling into one of the above categories,
EEIs may be forwarded to OIRM/SIRMOs for information and review as
they are developed.
Automated systems involving information security will be
subject to one additional documentation requirement — completion
of a certification form (certification of sensitive systems is an
OMB requirement). The form, which is under development and will
be issued as part of the forthcoming EPA Information Security
Manual, will capture basic information on system sensitivity,
security requirements, security design, reviews, test scenarios,
results and safeguards. Information needed to complete the form
will be readily available in the EEI documentation. Prior to the
system being placed into use or production, the cognizant SIRMO
(or other senior official in the AA/RA's office) will need to
certify that the automated system is adequately safeguarded based
on the information in the form.
It is not OIRM's intent to burden EPA managers with a host of
documentation requirements for each system development effort.
The EEIs simply stress typical documentation requirements and
their outlines highlight major topics that need to be considered
for any system development effort. Managers may use their
professional judgment in substituting, combining, or down-scaling
the content of the EEIs to meet the unique requirements of their
project. Additionally, the EEIs set out in this volume are not
meant to conflict with or add more burden to documentation
requirements set out in other manuals (e.g., EPA/NCC ADABAS
Application Development Procedures Manual). Documentation
produced according to such other procedures will invariably
satisfy, either partially or fully, some EEI requirements.
Criteria for determining the minimum EEI documentation for a
specific system is based on the nature and scope of the
information system and its importance to EPA's mission. Four
types of systems with differing levels of EEI documentation
requirements are identified as follows:
. Major Agency Information System: An information system
that requires special continuing management attention
because of its importance to an agency mission, its high
development, operating, or maintenance costs or its
significant impact on administration of Agency programs.
. Widely Accessed Information System; An information system
that is not a Major Agency Information System (although it
significantly supports accepted program goals and missions)
but is widely accessed by a combination of EPA
Headquarters, Regional Offices and/or State and local users
and other Federal agencies.
1-8
-------
EPA System Design & Development
Guidance: Volume C
. Localized Information System; An information system that
is not a Major Agency Information System but significantly
supports accepted program goals and missions and is
accessed primarily by users in one major area, e.g., EPA
Headquarters, a single Agency program, or a Region.
. User Owned Information System; Unique, stand-alone system
developed to improve the efficiency or effectiveness of
operations for a single user or a small group of users.
Documentation requirements for each of these system
categories are projected in Exhibit 1-3 on the next page and in
Chapter 4 of Volume C. Policies and procedures covering the
submission, review and approval of EEIs by OIRM will be issued
under separate guidance.
1 . 6 ASSISTANCE AND SUPPORT AVAILABLE
Agency Program and Management officials embarking on a system
development effort should be aware that there are at least two
sources available to them for assistance and support during the
system development life cycle:
. Within each AA/RA's office SIRMOs are available for
assistance, support and guidance relative to the EPA System
Design and Development Guidance and other OIRM guidance and
standards (e.g., Core Systems, Structured Programming,
etc.)
. OIRM, with its general IRM management oversight role and
requirement to exercise procurement approval authority, has
a staff organized to support EPA's administrative, program
and research communities.
It is appropriate to involve these support sources as early as is
feasible in the system development life cycle for most system
development efforts.
The primary reasons for early involvement of SIRMOs and OIRM
staff are:
. Fulfilling EPA's IRM policy for system development review
requirements
1-9
-------
EPA System Design & Development
Guidance: Volume C
X
DC
LU
^
DC
O
o
LU
<
O
CO
EXHIBIT 1-3
EEI-13
System Integration
Test Report
EEI-12
Software User's
Reference Guide
EEI-11
Software Operations
Document
EEI-10
Software Maintenance
Document
EEI-9
Software Detailed
Design Document
EH-8
Software Preliminary
Design Document
EO-7
Software Test
and Acceptance Plan
EE3-6
Software
Management Plan
EEL5
System Detailed
Requirements Document
EEM
System
Implementation Plan
EEI-3
Project Management
Plan
EEI-2
Preliminary Design
and Options Analysis
EH-l
Mission Needs
Analysis
> s
c /
'3 /
S 8" /
/ !§>
•
•
•
•
•
•
•
•
•
•
•
•
•
Systems That
Require OIRM
Involvement *
•
•
•
•
•
•
•
•
•
•
•
•
•
Major Agency
Information
Systems
•
•
•
•
•
•
•
•
•
•
•
•
•
Wide3y Accessed
Information
Systems
•
•
•
•
•
•
•
•
•
•
Localized
Information
Systems
•
•
•
•
•
•
User Owned
Information
Systems
1 As detailed on page 1-6.
1-10
-------
EPA System Design & Development
Guidance: Volume C
. Providing a value-added service role involving
consultation, assistance, technical standards, guidance and
interpretation of requirements
. Expediting procurement for system development efforts which
proceed to the system design, development and
implementation phase
. Providing assistance in determining user needs as early as
possible in the life cycle.
Achieving these objectives will strengthen EPA's system
development efforts and avoid major pitfalls that have beset
system development efforts in other government agencies (e.g.,
project stalls due to outyear funding shortages stemming from
under-projected planning or project disruptions due to failure to
get hardware/software acquisitions into the procurement cycle
expeditiously and when required).
The remainder of Volume C provides guidance and standards for
conducting the third phase of the system development process —
the System Design, Development and Implementation phase.
1-11
-------
£PA System Design & Development
Guidance: Volume C
2 . SOFTWARE MANAGEMENT PROGRAM
Implementation of the EPA Software Management Program draws
on the experience of software professionals within EPA and on the
experience of the Federal Government through both the Office of
Information Resources Management, the General Services
Administration and the Institute for Computer Sciences and
Technology of the National Bureau of Standards.
The objective of the Software Management Program is to ensure
the quality with which EPA designs, develops, implements and
maintains software. The EPA Software Management Program consists
of the following Software Engineering Elements:
. Policies
. Standard Software Tools
. Procedures/Methods
. Guidelines
. Planning, and
. Oversight and Compliance.
This volume specifically addresses standard software tools,
procedures/methods, guidelines, planning and oversight and
compliance.
2 . 1 APPLICABILITY TO SMALL AND LARGE PROJECTS
The Software Management Program is designed to be applicable
to both large and small projects. Managers of specific projects
must use their professional judgment (aided by the guidelines
provided in this methodology) on how to apply the Software
Management Program. For larger projects, the Software Management
Program should be used in its entirety. For smaller software
projects, the Software Management Program should be adjusted to
meet the needs of the specific project. For example, a judgment
might be made that the documentation requirements are excessive
for a particular project, so parts of different documents could be
combined or eliminated to reduce the number of documents and level
of documentation required.
2 .2 QUALTTY SOFTWARE
The Software Management Program will produce significant
results, including:
Improved inter-organizational relationships
- Demonstrated software engineering expertise
- Improved user acceptance of final products
- Improved ability to react to changes
2-1
-------
EPA System Design & Development
Guidance: Volume C
- Increased reliability of the software
- Improved maintainability of the software
. Institutionalization of the software development process
• - Enhanced technology transfer between projects
- Better utilization of personnel resources
- Reduced dependency on specific individuals
- Improved ability to measure and control software
development for project scheduling and cost purposes
- A production line approach to software development and
maintenance
. Reduced cost of developing and maintaining software
- Increased programmer productivity
- Fewer problems (errors) with delivered products
- More easily enhanced software
. Improved software portability
- Isolation of computer architecture dependencies
- Elimination of non-standard source code
- Development of reusable source code
The Software Management Program has been developed to assist
personnel directly involved in software development projects,
including:
. Program Managers — It provides assurance that EPA will
apply uniform, cost-effective methods throughout its
software life cycle projects. New projects need not
produce their own unique software management and
development procedures, but, through the Software
Management Program, can benefit from the experience of
successful software development projects.
. Project Managers — It includes the "what, why and how"
of software life cycle management.
. Programmers and Analysts — It describes specific tools
and techniques for the software development life cycle.
2.3 SOFTWARE MANAGEMENT PROGRAM OVERVIEW
The EPA Software Management Program includes a system
development life cycle model, and for each phase of the life cycle
2-2
-------
EPA System Design & Development
Guidance: Volume C
process, the software engineering components related to
controlling and regulating that phase. The Software Management
Program has major inputs from Volumes A and B of the System Design
and Development Guidance series. These inputs are:
. Phase 1 - Mission Needs Analysis
Mission Needs Statement (including Initial System Concept)
is produced during the Mission Needs Analysis phase.
. Phase 2 - Preliminary Design and Options Analysis
Preliminary Design and Options Analysis Document and a
Project Management Plan are produced during the Preliminary
Design and Options Analysis phase.
The Software Management Program defines the following additional
phase of the system development life cycle:
. Phase 3 - System Design, Development and Implementation
Detailed discussions of this phase are contained in Chapter 3 of
this document.
2-3
-------
SPA System Design & Development
Guidance: Volume C
3. SYSTEM DESTKN. DEVELOPMENT. AND IMPLEMENTATION OVERVIEW
This chapter addresses the third phase of the system
development life cycle — the System Design, Development and
Implementation phase and provides amplifying details on the three
stages which comprise this phase:
. System Design Stage - which comprises tasks and activities
associated with System Detailed Requirements Analysis,
Preliminary Design and Detailed Design;
. System Development Stage - which comprises tasks and
activities associated with System Production and
Programming and System Integration, Test and Evaluation;
and
. System Implementation Stage - which comprises tasks and
activities associated with System Installation, and System
Operation, Maintenance and Evaluation.
For each stage it discusses the associated tasks and activities,
reviews, baselines and documentation requirements. Exhibit 3-1,
on the following page, overviews the process.
There are EEI documentation requirements during the System
Design, Development and Implementation phase. While each' is
generally discussed in this chapter, detailed representative
outlines for each EEI (numbers 4-13) are contained in Appendix A.
EEIs 1-3 were detailed previously in Volumes A and B.
3.1 SYSTEM DF.STGN STAGE
Associated tasks and activities include System Detailed
Requirements Analysis, Preliminary Design and Detailed Design.
3.1.1 System Detailed Reemiremer'.r.fi Analysis
The major inputs to this task are the:
. Mission Needs Statement document produced during the
Mission Needs Analysis phase — defined in Volume A
. Preliminary Design and Options Analysis Document and
Project Management Plan produced during the Preliminary
Design and Options Analysis phase — defined in Volume 3.
These documents are used in performing the detailed
requirements analysis for the software system. The conclusions
3-1
-------
System Design, Development and Implementation Life Cycle Phase
Uto-Cyd*
**•••
•i*e*«
Tuh« Kn4
AcllvllU*
D
•
•
u
•
n
1
•
1
1
•
a
R
•
^
w
1
i
•
•
n
1
•
(EEI9)
«•*»•
M*|M»
System Design, Development and Implementation
8y*teniDMlgn
»r»imn*+,i
Sl*tm tmflinutiitin
Pten(EEI-4)
SfUtm OMMhJ
n*<*j>*nMr« Oocumm
CEEI*)
T!fi*win MiMq«atrt
Ptan(EEM)
•yowl R»q>4renMnl>
H^4n»
• •••JIM* Function-
^^BL B«~lki»
Hiii >nnn»i
SolMw«T*«l
*n4 Aco>^unc*
PUn(E£in
0»iyi
Oocuiwi* (CEI «)
Pratntwiy
(teilgn ftmlra
Prallnikt«T
D»iQn Ibxlm
OiMMOM^i
^ SC*M« O«*ted
(EEia)
CfUnd
Dnl^iHntm
O.l«lli>
B«xUn>
System OcwIopnMnt
&BAMM Pi rik
Mi-^x^a
6(rfMW9 II^IWIMM
OocwmMI (tEHOJ
6a*ni»ClMMlJM«
OamiDmi|EE»-lt) :-
Gotau»UM(»
M*<«nc«Gi«M(CEM])
Functaml Cortgtnten
HMM>«|
Ptiyiical Conliguiuan
RMMTil
OvMtoyiMn T«M Anrf
t««lu^lnn^»tn.
T««.«n4E«alu«lMl
SMICM b^MreiloA
T«M ftaporu (EEt-13|
Funcioml C««gmtM
HMM>«
Phyilul COTligmfen
HM«v«2
C^MIanriT^Anrf
EnlutflMRMtm
6««Un, ^^U. Bwilkv
System tmplamantation
%»«-•
U**f Ac««f«MM
•irMMOp.ntfMX
ttakMMKM,
ft*im OHiH»d
(EEI^S)
Sak«M» UUHOMBWI
Phn|EEM)
&*>«raOM*fcd
Oocuawn (EEt-IO)
BQ||I»«I» OpxMJpm
ODOUMX(EEI-II)
So»MraUMO
fWw*no* Quito (EEM2)
ST«MI kwgnuan
T«ti Ripott* (EEM ft
tn
H
ui
(ii in
n *<
n u
a> rt
•• (D
3
< a
o a
I-1 W
c. t--
3 uj
n> 3
o «^
a
(D
rt>
§
a
rr
-------
EPA System Design & Development
Guidance: Volume C
of these documents are confirmed by the software development staff
that will ultimately produce the software system.
This task entails further analysis of the problem, the
definition of the functional components of the major software and
hardware elements of the system and association of functional
components to requirements. The scope of the software development
project is revised, if necessary, and further defined.
3.1.1.1 Activities
The activities associated with the System Detailed
Requirements Analysis are:
. Confirm the analysis of current systems that have been
reviewed and their adequacy/inadequacy for use in solving
the problem
. Confirm the alternative solutions that have been proposed
and ensure.that the selected alternative is the one that
should be used
. Prepare the System Implementation Plan
- Identify events, actions and milestones
- Identify resource requirements
- Review schedules and work plans
- Produce integrated project plan
. Prepare the System Detailed Requirements Document
- Define major system functions
- Define physical requirements
- Define security requirements
- Define quality requirements
- Define life cycle resource requirements
- Define testing and verification requirements
- Define project work schedule(s) and work plan(s)
. Prepare the Software Management Plan
- Identify project resources
- Define review responsibilities
- Identify organizational structure and required resources
- Establish project schedules, reviews and reporting
controls
- Implement risk management
- Implement software product assurance procedures
- Implement software development procedures for the
project
3-3
-------
EPA System Design & Development
Guidance: Volume C
While defining the System Detailed Requirements, a separate
data dictionary document should be prepared that lists and
describes each data element to be referenced by the system.
[Guidance on the content and format of the Data Dictionary
Document will be provided at a future date by OIRM.]
3.1.1.2 Documentation
Documentation associated with the System Detailed
Requirements Analysis includes:
. System Implementation Plan EEI-4 (Final)
. System Detailed Requirements
Document EEI-5 (Preliminary)
. Software Management Plan EEI-6 (Preliminary)
3.1.1.3 System Requirements Review
The System Requirements Review is performed to ensure the
adequacy of the system requirements and approve formally the
definition of the user's requirements. The System Detailed
Requirements Document is the primary subject of the review. The
Software Management Plan and the System Implementation Plan are
also input to the review process.
The System Requirements Review takes place at the end of the
System Detailed Requirements Analysis task. A successful System
Requirements Review results in the establishment of the Functional
Baseline. OIRM/SIRMO representation should be ensured at the
System Requirements Review.
3.1.1.4 Functional Baseline
The Functional Baseline is established as the original
baseline configuration and consists of the functional system
specifications contained in the System Detailed Requirements
Document (EEI-5). Once the System Detailed Requirements Document
is baselined, any changes to that document represent a change in
the scope of the project and must have management approval. The
Functional Baseline is established after a successful System
Requirements Review.
3.1.2 Preliminary Design
The Preliminary Design task represents the initial effort in
producing a design that can be used in producing an operational
software product.
3.1.2.1 Activities
The activities associated with Preliminary Design are:
3-4
-------
EPA System Design & Development
Guidance: Volume C
Confirm that candidate packages/existing software can be
used or integrated into the new system
Prepare Software Design Document
- Identify each software design requirement
- Identify the functional flow of the system, address each
design requirement and describe each requirement and
associated software design-functions (SDFs)
- Detail each SDF by defining:
Inputs
Local Data
Initiation, Timing and Sequencing
Interrupts
Processing
Outputs
Adaptation
- Define Data Base and File Structures
Data Base Management System
Logical Design of the Data Structures
Data Interrelationships
Characteristic/Requirements Traceability
Update Software Management Plan
Prepare preliminary Software Test and Acceptance Plan
- Software Unit Test Plans
Test Requirements
Test Management
Test Schedule
Tests and Results
- Integration Testing of Software Units, Modules and
Software Functions - Test Plans
Integration Test Requirements
Integration Test Management'
Integration Test Categories
Integration Test Methods
Integration Test Schedules
Integration Tests and Results
- Required Resources for Unit and Integration Testing
3-5
-------
EPA System Design & Development
Guidance: Volume C
Facilities
Hardware Environment
Interface/Support Software
Personnel
- System Test Plans
System Test Requirements
System Test Management
System Test Categories
System Test Methods
System Test Schedules
System Tests and Results
- User Acceptance Test Plans
Test Team
Pretest Procedures
Acceptance Test Procedures
Formal Acceptance
. Address:
- Initial design of user procedures
- Conversion software and appropriate procedures
- Operations procedures.
3.1.2.2 Documentation
Documentation associated with the Preliminary Design task
includes:
. Software Management Plan EEI-6 (Updated)
. Software Test and
Acceptance Plan EEI-7 (Preliminary)
Software Preliminary Design
Document EEI-8 (Final)
3.1.2.3 Preliminary Design Review
The Preliminary Design Review is performed for each system
element to ensure the adequacy of the preliminary design and the
test plans for verifying the accuracy of the software system. The
Software Preliminary Design Document and the Software Test and
Acceptance Plan are the primary subject of the review. The
updated Software Management Plan is also input to the review
process.
3-6
-------
EPA System Design & Development
Guidance: Volume C
The purpose of the Preliminary Design Review is to:
. Evaluate the progress, technical adequacy and risk
resolution (on a technical, cost and schedule basis) of the
selected design approach
. Determine the compatibility of the selected design approach
with the requirements and performance of the System
Detailed Requirements Document
. Establish the existence and compatibility of the physical
and functional interfaces among the other elements
(equipment, facilities, computer programs and personnel)
. Determine the adequacy of the test plans in accurately
verifying the software system against the design criteria.
The Preliminary Design Review takes place at the end of the
Preliminary Design task. A successful Preliminary Design Review
results in the establishment of the Preliminary Design Baseline.
OIRM/SIRMO representation should be ensured at the Preliminary
Design Review.
3.1.2.4 Preliminary Design Baseline
The Preliminary Design Baseline is established after a
successful Preliminary Design Review. It consists of the initial
design specifications — including data base specifications. The
Preliminary Design Baseline is made up of the Software Preliminary
Design Document (EEI-8) and the Software Test and Acceptance Plan
(EEI-7). Once these documents are baselined, any changes to
those documents represent a change in the scope of the project and
must have management approval.
3.1.3 Detailed Design
The Detailed Design task represents the final effort in
producing a detailed design that will be used in producing an
operational software product. The Software Detailed Design
Document is prepared using the information in the Software
Preliminary Design Document prepared during Preliminary Design.
It is refined, and additional detail is added to produce a
detailed design adequate for code production. The first draft of
the Software User's Reference Guide may be prepared. The Software
Management Plan and Software Test and Acceptance Plan are updated
as necessary. The Project Management Plan and Benefit-Cost
Analysis should be updated during this task.
3.1.3.1 Art-ivit ies
The activities associated with Detailed Design include:
3-7
-------
EPA System Design & Development
Guidance: Volume C
. Prepare Software Detailed Design Document
- Update/refine preliminary design information
- Decompose each Software Design Function
Software Unit Formal Parameters
Software Unit Inputs
Software Unit Local Data
Software Unit Processing
Software Unit Outputs
Software Unit Limitations
Use of other software elements
- Data Base Physical Design
File
Record
Field
Item
. Prepare initial draft of EEI-12, Software User's Reference
Guide with at least sections one through three completed
and a detailed outline of the remainder of the document
- Description of the system
- System access techniques
- User analysis/reporting options
- Data entry and update process
- User support and training program/sources
- Security requirements
. Update Software Management Plan
. Update Software Test and Acceptance Plan.
3.1.3.2 Documentat ion
Documentation associated with the Detailed Design includes:
. Preliminary Design and Options
Analysis EEI-2 (Updated)
. Project Management Plan EEI-3 (Updated)
. Software Management Plan EEI-6 (Updated)
. Software Test and
Acceptance Plan EEI-7 (Final)
. Software Detailed Design
Document EEI-9 (Final)
3-8
-------
EPA System Design & Development
Guidance: Volume C
Software User's
Reference Guide
EEI-12 (Preliminary)
3.1.3.3
Critical Design Review
The Critical Design Review is conducted for each system
element when the detailed design is complete. The Software
Detailed Design Document and the updated Software Test and
Acceptance Plan are the primary subject of the review. The
Software Management Plan and the Software User's Reference Guide
are also input to the review as necessary. The purpose is to
accomplish the following:
. Determine that the detailed design of the software system
element under review satisfies the performance requirements
of the System Detailed Requirements Document
. Establish compatibility among system elements in the
detailed design
. Assess the producibility and risk areas (on a technical,
cost and schedule basis) .
. Review the preliminary product specifications.
A successful Critical Design Review establishes or updates the
Design Baseline. The Design Baseline is then used as the basis
for the production and coding of the software system. OIRM/ SIRMO
representation should be ensured at the Critical Design Review.
3.1.3.4
Desion Baseline
The Design Baseline is established after a successful
Critical Design Review. It consists of the final design
specifications — including data base specifications and the test
plans associated with the software product. The Detailed Design
Baseline is made up of the Software Detailed Design Document (EEI-
9) and the final Software Test and Acceptance Plan (EEI-7). Once
these documents are baselined, any changes to the documents
represent a change in the scope of the project and must have
management approval.
3.2 SYSTEM DEVELOPMENT STAGZ
Associated tasks include System Production and Programming,
and System Integration, Test and Evaluation.
3.2.1
System Product ion ar.d Programming
The specifications developed during the System Design stage
are used to develop a system that functions correctly in a
3-9
-------
EPA System Design & Development
Guidance: Volume C
controlled environment. At the completion of the System
Production and Programming task, all programs, job streams, data
bases, security controls, user procedures and operations
procedures will have been developed and thoroughly tested by the
development team.
3.2.1.1 Activities
The activities associated with System Production and
Programming are:
. Develop Software System
- Code software units
- Review software unit code
- Unit test software unit code
- Produce unit test reports
- Perform subsystem integration testing
- Prepare subsystem integration test reports
. Prepare Software Maintenance Document
- Maintenance Procedures including:
Source Code Standards
Documentation Update Procedures
Coding and'Review Process
Change Control Process
Testing Standards and Procedures
Change Implementation Methods
- Maintenance Tools
Technical tools
Management tools
- Source code
Source listings or equivalent
. Prepare Software Operations Document
- System Initialization
- System Restart by Functional Element
- System Manager functions
- System Backup/Recovery Provisions and other Information
Security Provisions.
3-10
-------
EPA System Design & Development
Guidance: Volume C
3.2.1.2 Doeumentation
Documentation associated with the System Production and
Programming task includes:
. Software Maintenance Document EEI-10 (Preliminary)
. Software Operations Document EEI-11 (Preliminary)
. Software User's Reference
Guide EEI-12 (Updated)
. Unit Tested Source Code
. Unit Test Data.
3.2.1.3 System Production and Programming Review^
Preliminary Functional Configuration and Physical
Configuration reviews are performed as each piece of software is
delivered for inclusion into the product baseline. They confirm
that the software product or component of the software product
performs according to the requirements and design specifications
that have been prepared and baselined during System Design.
The results of the review are input to the Development Test
and Evaluation Review.
3.2.1.4 Development Test and Evaluation Review
The Development Test and Evaluation Review ensures that the
developmental testing of the software is successful and that the
system requirements are satisfied. The Software Maintenance
Document, the Software Operations Document, the updated User's
Guide, the results of the Functional Configuration Review and the
results of the Physical Configuration Review are also reviewed for
completeness and accuracy. Upon completion of a successful
review, these documents are placed in the Product Baseline.
The Development Test and Evaluation Review is performed at
the end of the System Production and Programming task. A
successful Development Test and Evaluation Review establishes or
updates the Product Baseline. OIRM/SIRMO representation should be
ensured at the Development Test and Evaluation Review.
3.2.1.5 Product: Baseline
The Product Baseline establishes a tes.ted, operable version
of the software system in its operating environment. As each
subsystem is successfully tested, the product baseline is updated.
The baseline of the completed and tested version of the software
product ensures that any changes or enhancements take place
against a stable, controlled set of functional and technical
components. The Product Baseline will include the completed
3-11
-------
EPA System Design & Development
Guidance: Volume C
product specifications, the operation/maintenance documents and
the user's guide.
The Product Baseline is established/updated after a
successful Development Test and Evaluation Review at the end of
the System Production and Programming task.
3.2.2 System Integration. Test and Evaluation
The System Integration, Test and Evaluation task includes the
testing of the fully integrated software product in its
operational environment. This task is performed by a test team
that does not include any of the software development team
members. The purpose is to provide a test and evaluation
environment that is independent of the development effort.
The Software Maintenance Document, the Software Operations
Document and the Software User's Reference Guide are updated as
necessary based on the testing process. The software product and
its related documents may have to be sent back to the development
team if rework is retired based on the results of system
integration testing.
3.2.2.1 Activities
The activities associated with the System Integration, Test
and Evaluation task are:
. Install the working system using the installation
procedures
. Execute the System Test portion of the Software Test and
Acceptance Plan
. Document any discrepancies noted during testing for
resolution with the development team and user
. Verify that discrepancies that require software
modification have been modified correctly
. Prepare System Integration Test Report
. Recommend disposition of the software and documentation.
3.2.2.2 Documentation
Documentation associated with the System Integration, Test
and Evaluation task includes:
. Software Maintenance Document EEI-10 (Updated)
. Software Operations Document EEI-11 (Updated)
3-12
-------
EPA System Design & Development
Guidance: Volume C
. Software User's Reference
Guide EEI-12 (Updated)
. System Integration Test Reports EEI-13 (Final)
. System Integration Tested Software
. System Integration Test Data
3.2.2.3 System Integration. Test and Evaluation Reviewc,
The final Functional Configuration and the Physical
Configuration reviews are performed when all the subsystems are
delivered and integrated into the Product Baseline. They confirm
that the software product or component of the software product
performs according to the requirements and design specifications
baselined in the Product Baseline.
The results of the review are input to the Operational Test
and Evaluation Review!
3.2.2.4 Operational Test and Evaluation Review
The Operational Test and Evaluation Review ensures that the
software system is viable in its intended environment. The
Operational Test and Evaluation Review is performed at the end of
the System Integration, Test and Evaluation task.
The Software Maintenance Document, Software Operations
Document and the User's Guide are the major inputs to the review.
The System Integration Test Reports drive the review in that they
contain the results of testing the software product. All errors
or incidents that were encountered during formal testing are
identified. The resolution of each incident is noted. Those
incidents that were determined to be errors are presented in two
categories — corrected and unresolved. This information is used
in determining if the software product is ready for formal use. A
successful Operational Test and Evaluation Review establishes or
updates the Operational Baseline. OIRM/SIRMO representation
should be ensured at the Operational Test and Evaluation Review.
3.2.2.5 Operational Baseline
The Operational Baseline represents the completely
implemented and tested software system. It is the basis for
future maintenance changes and enhancements. All documentation is
modified as required, validation and acceptance testing is
completed and the system is placed in production and/or turned
over to the user. The Operational Baseline is established and/or
updated after a successful Operational Test and Evaluation Review.
3-13
-------
EPA System Design & Development
Guidance: Volume C
3.3 SYSTEM IMPLEMENTATION STAGE
This stage comprises System Installation and System
Operation, Maintenance and Evaluation.
3.3.1 System Installation
The System Installation task is primarily for formal user
acceptance of the software product. The software product is
installed in a production environment, and the user exercises the
product to determine if it meets his/her needs and requirements.
3.3.1.1 Activities
The activities associated with System Installation are:
. Installation of the software product in a production
environment
. User acceptance of the software product
. User training.
3.3.1.2 Major Products
The major products associated with System Installation are:
. Operational software installed
. Training completed
. User agreement to accept the software and documentation.
In addition, the final version of the following system
documentation is delivered:
. System Detailed Requirements EEI-5
Document
. Software Management Plan EEI-6
. Software Detailed Design Document EEI-9
. Software Maintenance Document EEI-10'
. Software Operations Document EEI-11
. Software User's Reference Guide EEI-12
. System Integration Test Reports EEI-13
3.3.2 System Operation. Maintenance and Evaluation
The System Operation, Maintenance and Evaluation task begins
after the user has formally accepted the software system and its
supporting documentation at the end of System Installation. The
software product is placed in operation and made available for
use.. Formal user support and maintenance procedures are
established and implemented.
3-14
-------
EPA System Design & Development
Guidance: Volume C
While this is the last task in the system development life
cycle, it in itself represents the beginning of the software
maintenance life cycle. As the software product matures and
changes must be made to it, this process will replicate the
previous phases of the EPA system development life cycle — from
the Mission Needs Analysis through System Installation. Exhibit
3-2 presents the software maintenance life cycle concept.
3.3.2.1 Activities
The activities for this task include:
. Operate the system to the degree necessary
. Provide user support for questions, training, etc.
. Log and categorize software problems as they are identified
. Log software enhancement requests
. Perform periodic reviews of the software product and its
related documentation to ensure that the product is meeting
user/Agency needs
. Determine when identified problems/enhancement requests
• justify a new release/version of the system product.
When the nature of the problems/enhancement requests justify
a new release or new version of the software product, the
changes/modifications will be subject to the system development
life cycle. While the effort and duration of the 'maintenance1
life cycle process might not be as rigorous and lengthy as the
initial development effort — all of the steps and procedures must
be followed to ensure that:
. The EPA mission is properly supported
. The quality of the maintained software product and its
related documentation is not compromised.
The nature, complexity and cost of the modifications will
dictate the degree to which the 'maintenance' life cycle is
followed. Simple 'bug' fixes may not require the scrutiny and
analysis that a major enhancement must undergo.
3.3.2.2 Documentation
Documentation maintained or updated during the System
Operation, Maintenance and Evaluation task includes the
3-15
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 3-2
SOFTWARE MAINTENANCE LIFE CYCLE
PRODUCT
LIFECYCLE
DEVELOPMENT LIFECYCLE
3-16
-------
EPA System Design & Development
Guidance: Volume C
documentation that is delivered with the operational system
including versions of the:
. System Detailed Requirements EEI-5
Document
. Software Management Plan EEI-6
'. Software Detailed Design Document EEI-9
. Software Maintenance Document EEI-10
. Software Operations Document EEI-11
. Software User's Reference Guide • EEI-12
. System Integration Test Reports EEI-13
3-17
-------
EPA System Design & Development
Guidance: Volume C
4. SOFTWARE ENGINEERING COMPONENTS
This chapter addresses the software engineering components
necessary to successfully implement the EPA Software Management
Program during the EPA software development life cycle phases
and the quality assurance considerations for successful software
development.
4 .1 SOFTWARE ENGINEERING COMPONENTS
There are four software engineering components that direct,
control or support each of the life cycle phases and are essential
to the successful execution of each phase. These software
engineering components are:
. Standards
. Procedures/methodologies
. Software Development Support Tools
. Quality Assurance.
Each life cycle phase is supported, in different degrees, by
the four software engineering components. These components
provide the necessary technology and discipline to create a
software engineering environment.
4.1.1 Standards
Standards are grouped in two major categories: methodology
standards (uniform procedures for accomplishing a function) and
performance standards (metrics to evaluate performance).
Methodology standards allow work to be accomplished
systematically. They facilitate the turnover of work whether it
is from personnel working in one life cycle phase to those working
in another life cycle phase or among personnel working on the
project. Personnel trained in the Software Engineering Program
should be able to join a project at any time and become productive
soon thereafter.
Performance standards deal with the quantifiable aspect of a
task, for example, the amount of time it should take to perform a
task and the expected quality of the task's end product.
Performance standards depend on methodology standards being in
place and enforced so that performance can be measured accurately.
4.1.2 Procedures/Methodologies
Procedures/methodologies define the processes that are
followed in each of the particular phases of the system
development life cycle.
4-1
-------
EPA System Design & Development
Guidance: Volume C
The two classes of procedures"are manual and automated.
Manual procedures, which programmers and analysts follow when
performing a task, direct the flow of activities. For example, a
programming procedures manual provides the direction for achieving
progress using the proper programming language elements,
associated structured techniques and source code formatting.
Automated procedures, on the other hand, direct the execution of
computer programs and software development support tools.
4.1.3 Software Development Support Tools
Software Development Support Tools are computer programs used
to automate some of the labor intensive activities involved in the
management, design, coding, testing, validation and maintenance of
application programs. Software development support tools are used
in support of standards and procedures/methodologies by EPA and
its contractors in the software development and maintenance
process.
4.1.4 Quality Assurance
Quality Assurance is the formal process of measuring or
evaluating the degree to which a product meets the standards by
which it was developed and the specifications upon which it was
based. Each product (both software and documentation) produced
within each life cycle phase should be subjected to a Quality
Assurance process.
4.2 SOFTWARE ENGINEERING PRINCIPLES
Effective system development requires a thorough
understanding of the user's requirements coupled with a
development process capable of fulfilling those requirements with
a responsive system. A clear understanding must be established of
the user's requirements, their relationship to the overall system
and the functional elements constituting the system. The EPA
Software Management Program provides an approach to software
development that divides the life cycle into well defined phases.
The Software Management Program indicates the activities and
tasks that should be performed for each phase of the life cycle
and the resulting deliverables. It also identifies what has to be
done, when it should be done and how it should be done.
The Software Engineering Program defines the Essential
Elements of Information (EEIs) or documentation that should be
produced and/or updated. The baselines for each phase and reviews
necessary to approve the documentation are also defined in the
Software Engineering Program.
4-2
-------
EPA System Design & Development
Guidance: Volume C
The characteristics of an evolving system are defined and
documented in increasing detail at logical transition points, or
baselines, of the software development life cycle. Approved
documentation and/or software products constitute a baseline. At
any time in the system life cycle, all previously established
baselines, together with any approved changes to these baselines,
constitute the formal identification of the system and its
components.
The type of system being developed will dictate the level of
documentation necessary to support that system. The diligent use
of EEIs will resolve the conflicts that arise between the:
Cost of documentation
. Classical life cycle for system development
. Changes in computing capabilities and system development
techniques.
The use of Fourth Generation Languages (4GL) have, in many
instances, provided:
. Significant gains in productivity
. Shortened life cycle development time, and
. Products that better reflect user requirements.
The use of new software production techniques which include the
use of 4GLs in software development, while possibly changing the
order and timing of the production of system documentation, has
not eliminated or reduced the need for adequate system
documentation.
The use of the EEIs defined in this volume represent a
flexible approach to system documentation. All systems require
some form of documentation. However, the degree of documentation
needed is dependent on the nature of the system, constituency (who
will use it), and life cycle costs. Software systems that are
used nationwide, Agencywide and support major program initiatives
require complete documentation and thoughtful consideration of
options, life cycle costs and mission needs.
Key points to consider are:
. A mission needs analysis and a requirements analysis which
includes feasibility and benefit-cost analyses must be
conducted prior to embarking on a major agency information
system development effort.
4-3
-------
EPA System Design & Development
Guidance: Volume C
EEIs are required for both' new sysi-prr^ and existin
. The EEI outlines contained in Appendix A of this volume
represent the basic EEI requirements (see section 4.2 1 for
the minimum EEI requirements for the different sizes and
types of systems) . Information managers may want to
increase the depth and breadth of these EEIs based on the
circumstances of the project. For example:
- Elements not included in a particular EEI outline that
are considered necessary within a specific project may
be added, thus tailoring the EEI for that specific
project.
- Additional EEIs may have to be developed to meet the
specific needs of a given software system or project.
4-2.1 Determining Dnrumentaf i on RgqnrrPtnpnl-g
Criteria for determining the minimum EEI documentation for a
specific software system are based on the nature and scope of the
information system and its importance to EPA's mission. Four
types of systems are presented below along with guidance for
determining the minimum level of EEI documentation for each:
a- Ma-ior Aaencv Information Syst-.Ptn; An information system
that requires special continuing management attention
because of its importance to an agency mission, its high
development, operating, or maintenance costs or its
significant impact on administration of agency programs.
In this context, a system which requires obligations of
more than $500,000 per year to maintain or whose software
component contains more than 500,000 lines of 3GL source
code or 100,000 lines of 4GL source code is considered a
Major Agency Information System.
Exhibit 4-1 presents the EEIs required for a Major Agency
Information System.
b- Widely Accessed Information System; An information systen
that is not a Major Agency Information System, (but
significantly supports accepted program goals and
missions) . It is widely accessed by a combination of EPA
Headquarters, Regional Offices and/or State and local
users and other Federal agencies.
Exhibit 4-1 also presents the EEIs required for a Widely
Accessed Information System.
4-4
-------
M
EEI REQUIREMENTS FOR MAJOR AGENCY AND WIDELY ACCESSED
INFORMATION SYSTEMS
UI*-Cyd«
BUgco
T««k* And
Activities
D •
o
u
n
1
1
1
n
R
S
V
1
r
en
n
1
(CEI3)
AwHU
«.„...
...-,...
System Design, Development and Implementation
System OMlgn
c^nx-.
Ptan(EtM)
Stfvl4*t) DtUultd
RWBUCMIMAto OodMWft
(EEISI
Ptan(EEI«)
"^"^"•"^
Funcdanri
pm»* Hrvtra
Pntknh^)
C— P^
' Dmgn Oocutwm
(EEltt
C>Uu<
B^T
Syatom Development
_ _ ^
AndtS^nnxkv
Oacuimnl(EEMO}
0««p«,EEM,,
B-^.rc.G^WMI,
Ftfictonftl Corrfi0ureMn
Ptiytic*! C«nl«uiiKn
R*MMf I
"T^r^r
Product
TMI. And ExhMlMi
&ftum Hcgmiaa
T*« Ftapau (EEHJ)
FuntteMl Con)«>»»on
Ptiyikil Canl«u»>on
l^zil:^
O^ndenl
System ImpUnnnteUon
jrn.
U»M Atopunc*
"^i.si^r'
Syttwn OMvbd
R*cjui*mnli Oacunvrt
(EEIS)
Satva* Mamgtnwn
PUn (EEI-4)
Sottov* Ocakd
OMQO Oocuiwrt (EEI-0)
Sattmti* Ualn*n*n»
Docunwrt (EEHO)
-.._ _^ .
Oocun*n](EEI-H)
FM*»n» Qub* (E E ^ 1 2)
Syiun Mvgmiien
T.M Hiponi (EEl-ll)
tn
g
n
td
n
H
a
(U (/>
t3 K
O W
(0 rt
< O
O (D
»-• W
c: H-
3 «0
0) D
n
o
(D
<
(D
H*
O
t)
(D
-------
EPA System Design & Development
Guidance: Volume C
c. Localized Information System: An information system that
is not a Major Agency Information System, but
significantly supports accepted program goals and
missions. It is accessed primarily by users in one major
area, e.g., EPA Headquarters, a single agency program, or
a Region.
Exhibit 4-2 presents the EEIs required for a Localized
Information System.
d. User Owned Information System: Unique, stand-alone
system developed to improve the efficiency or
effectiveness of operations for a single user or a small
group of users.
Exhibit 4-3 presents the EEIs required for a User Owned
Information System.
4.2.2 Software Life Cycle Reviews
Formal reviews are carried out at key points in the life cycle to
ensure that the software development activities are progressing
.consistent with user requirements and EPA standards. The reviews
used in the EPA System Development life cycle are described in
detail in Chapter 3.
4-6
-------
EEI REQUIREMENTS FOR LOCALIZED INFORMATION SYSTEMS
"S2T
a
Tutu And
AcllvllU*
O
•
c
u
n
1
1
1
n
H
q
u
i
i
n
1
(EEIS)
Av«lt
Navtaaa
...-,...
System Design, Development and Implementation
SyttMnDMlgn
_ n^^tod
MMp*M.M.AntflHb
Pun (E EM)
RwyjfMMOli OocuOKX
(EEl S|
8,— IJUj*— .
fundland
n>ltal* •l>r"ton
0.^X1
B.sr^L.
D^O^
SotlMM D«m»rt
«^x»
EE,
Sy.tWnDMtopnMnl
•.MM Pm*rrOnn
A^fSovwnmkv
DouMMrt lEEI-iq
SS^ST
Ritoiwic* Oud* (EEMfl
Fuwttxwl Cort«u»*an
s::r*""
itiii-n' — "--' —
Pratfud
Tm. And EraluMlaa
8yM..kMV.t«>«
Fuictewl Cortigmton
ct±ST^T'
Opcndonl
SyttMn ImptomsntotJon
^TL,
O-.A.-f^nc.
Ifckttunc*,
AndE»h*Uim
(EEISI
&<*>«>• OlUted
OM«I< Oocuiwit (EEI4)
S^lw0 U^rtwncc
OocuawnKEEMO)
6a*vu* Opvabn*
OocuiMrt(EEI-ll)
GaftMicUM^
IWw*raa QUKU (EE»- 12)
Syiun M*g»uon
CD
H
I '
o tn
c »u
cu in
3K
O w
(I) rt
• • fl)
3
< O
O 0)
I— W
c: H-
3 iQ
o> D
O
O
0)
n>
(D
-------
EEI REQUIREMENTS FOR USER OWNED INFORMATION SYSTEMS
I
OQ
Uto-Cyd*
Sl.0..
Ttak. And
AcllvllU.
0
u
o
l
1
1
n
R
y
I
m
a
1
(GEI8)
...
System Design. Development and Implementation
System D*«10n
^rr^u
nM^MMntfita Oocunwrt
!££)•&)
"^^T"*
^*- ^^
oXr^L
Pratfenkwy
OvUgn ffciMtn*
0—0^
OMign OocuiMnl
(EEII)
Oklut
Bo« Acctptwic*
TS^r
S^«.0-^d
(EEIS)
SaMnra OitaiMt
Owen Oacvnwi* (EEW)
Dacumn(EEt-n)
SJ^.'^.ffEMfl
I
U)
O PI
C 13
H->
O.
(U (^
3 *<
O W
(I> rt
< O
O (D
H- W
C H-
3 «£!
01 3
O
O
(D
o
•d
3
fl>
D
rt
-------
SPA System Design & Development
Guidance: Volume C
5. SOFTWARE DEVELOPMENT STANDARDS
This chapter addresses the software development standards
that have been approved for use in the development of EPA
information systems. They include standard 3rd and 4th generation
programming languages, data base management systems, core system
standards, specialized software tools, graphics packages and
telecommunications support software.
5.1 STANDARD PROGRAMMING LANGUAGES
EPA standard programming languages have been established for
use in developing software systems for use within EPA. These
include the 3rd generation programming languages that have been
standardized by the American National Standards Institute as
national standards and by the Institute for Computer Science and
Technology of the National Bureau of Standards as Federal
Information Processing Standards.
In addition, EPA has internally standardized several 4th
generation programming languages in the interest of improving
productivity and reducing the cost of software development and
maintenance within the agency. Exhibit 5-1 presents the standard
programming languages used within EPA.
5.1.1 Programming Language Selection Guidelines
A number of factors go into deciding what computer
environment in which an application will operate. After the
computer hardware configuration has been identified, the
application programming language and associated support software
tools must be selected. While there is no "right" answer for each
information system being developed, the use of common sense and
the guidelines presented in this volume can lead to a reasonable
solution.
Software developers should consider the following questions:
. Is an off-the-shelf solution available?
. Has OIRM staff advice been solicited?
. Is the application covered by an existing Core System?
. Can the application be satisfied by'using an existing
system or" its software (e.g., software reuse, off-the-shelf
software, consulting the EPA Information System Inventory)?
5-1
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-1
EPA STANDARD APPLICATION PROGRAMMING LANGUAGES
APPLICATION SOFTWARE
PROGRAMMING LANGUAGE
3GL
4GL
COBOL
FORTRAN
PL/I
PASCAL
INFO
NATURAL
FOCUS
dBASE III
SAS
STANDARD
EPA
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
FIPS
Yes
Yes
Yes
Yes
5-2
-------
EPA System Design & Development
Guidance: Volume C
Some of the factors which should be addressed when
determining the hardware/software environment are:
. Results of the requirement and feasibility studies
. Potential life span of the application
. Resources available now and in the future to support both
the development and maintenance of the application
. Telecommunications and local communications facilities
. Location and size of the data base(s)
. Number of users / Number of simultaneous users
. Complexity of the data
. Information security needs such as access controls, backup,
and recovery.
In an attempt to reduce the complexity of this effort, EPA
has defined the computer hardware/software environments available
for use. As a guideline, a decision matrix approach to
identifying what software support tools are appropriate has been
defined.
The decision matrices can be used to help determine the
support tools appropriate to system development in the absence of
OIRM staff guidance. The matrices apply only to the general
systems which store and retrieve information and should not be
construed as taking precedence over existing EPA system plans,
strategies and policies. Also they do not encompass statistical
systems, spread sheet systems, graphics systems and other
specialized functional systems. With minor exceptions, they do
not address hybrid systems - those which are developed using two
or more support tools (e.g., Natural/VSAM for data entry and
Natural/ADABAS for data retrieval).
The Software Support Tool Selection Matrices address systems
that are small, medium, and large.
. Small Systems - are generally programmed using 4GLs with or
without data base support, and they can run in either the
mainframe, minicomputer or microcomputer environments;
. Medium Systems - are generally programmed using either 3GLs
or 4GLs with or without data base support, and they can run
in either the mainframe or minicomputer environments and;
5-3
-------
EPA System Design & Development
Guidance: Volume C
. Large Systems - are generally programmed using either 3GLs
or 4GLs with or without data base support, and they run in
the mainframe environment.
The content of each matrix cell and the criteria of small,
medium and large systems are simplified to make them useful
There are several decision criteria along the legs of the matrices
and numbers in the intersections of the rows and columns which
correspond to the software support tools. The key for the
software support tools is:
1 - Mainframe 3GL/DBMS (COBOL, PL/I, FORTRAN)
2 - Mainframe 4GL/DBMS (Natural/ADABAS)
3 - Mainframe 4GL (FOCUS)
4 - Mainframe 4GL (NATURAL/VSAM)
5 - Minicomputer 3GL (COBOL, FORTRAN, PASCAL)
6 - Minicomputer 4GL (FOCUS, INFO)
7 - Microcomputer 4GL (INFO, FOCUS, dBASE III)
8 - Microcomputer 4GL/DBMS (dBASE III)
9 - Microcomputer 3GL (FORTRAN, PASCAL)
Exhibits 5-2, 5-3, and 5-4, on the following pages, present the
Software Support Tool Selection Matrices.
5.1.2 Source Program D^icm and Coding Conventions
EPA has a general set of minimum program design and program
coding standards which can be obtained from OIRM or office SIRMOs
These standards promote productivity, source code maintainability
and software sharing and reuse. These standards are patterned
after the standards used by the Department of Defense. The
salient characteristics of these standards are:
. Use of structured programming constructs to control the
flow of execution
. Elimination or significant reduction in the use of "GO TO"
statements and complicated negative Boolean expressions
. Applicability to 3GL and 4GL programming
. Modularity in source program design and coding
. Good documentation practices such as:
- Naming conventions
- Symbolic parameters
- Paragraphing
- Blocking
5-4
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-2
SOFTWARE SUPPORT TOOL SELECTION MATRIX
SMALL SYSTEMS
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
3GL/OBMS (COBOL. PU1. FORTRAN)
4GL/OBMS (Natural/ADABAS)
4GL (FOCUS)
4GL (Natural/VSAM)
5 - Minicomputer 3GL
6 - Minicomputer 4GL
(COBOL FORTRAN. Pascal)
(FOCUS. INFO)
7 - Microcomputer 4GL (INFO. FOCUS. dBASE III)
8 - Microcomputer 4GUD8MS (dBASE III)
9 - Microcomputer 3GL (FORTRAN. Pascal)
SMALL SYSTEMS - « RECORDS < 10K OR TOTAL SIZE < 10 MEGABYTES |
Number of Simultaneous Users
Complex Random Retrievals?
Location
of Related
Data
None
Main-
Frame
Mini-
Computer
PC
1
YES
2.3,6.7
2.3
•
7,8.9
NO
2.3,4,6.7
2,3.4
6
7,8.9
1 15
YES
'
2
2
2
NO I
2.3.4 i
2.3.4 \
2.3.4 |
2.3.4 |
5-5
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-3
SOFTWARE SUPPORT TOOL SELECTION MATRIX
MEDIUM SYSTEMS
kCDUU SYSTEM - 10K <
Volatility
Number of
Simultaneous Users
Complex Random
Retrievals?
Location
of Related
Data
None
Mini-
Computer
Main-
Frame
• RECORDS «100K OR 10 ICOABYTE9 « TOTAL SOE < 100 KGOABYTES :
Moderate Amount
at Cnanot per Day
$15
YES
2.3,6
6
2,3
NO
2.3,
4,6
6
2.3.4
>
YES
2
2
2
'•
NO
2.4
"
2.4
Volatile
£15 >15
YES NO YES NO
Highly |
Volatile \
£15 >15 ;
YES
2.6 2,3, 2,3 ! 2.4 1.2.
4.6 j 5,6
5.6 5.6 2.3 j 2,4 5.6
2 2,3,4 2.3 I 2.4
| |
1.2
,;
NO YES NO :
j
1.2. 1.2. 1.2 :i
5.6 5,6 :
5.6 1.2 1.2 :
1.2 1.2 1.2 ;
::
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
5 - Minicomputer
6 - Minicomputer
3GUO8MS (COBOL PU1. FORTRAN)
4GL/08MS (Natural/AOABAS)
4GL (FOCUS)
4GL (Natural/VSAM)
3GL (COBOL FORTRAN, Pascal)
4GL (FOCUS, INFO)
5-6
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-4
SOFTWARE SUPPORT TOOL SELECTION MATRIX
LARGE SYSTEMS
LARGE SYSTEMS - • RECORDS
Volatility
Number of
Simultaneous Users
Complex Random
Retrievals?
File
Pass
Frequency .
n-1
per day
1 40
per day
> 100K OR TOTAL SIZE
Almost Staflc
(Update Weekly or Less)
S15
YES NO
2.3 2.3.4
2 2.4
Hybrid 4
1.2
,„
YES NO
2 i 2.4
2 I 2,4
Hybrid i 4
1.2 ';
> 100 MEGABYTES
Moderate Amount of
Change or Volatile
£15
YES
„»
NO
2 2.4
2
Hybrid
1.2
2.4
4
Highly i
Volatile i
S15 >15 ' 1
YES NO I
1.2 1,2 :
1.2- 1.2 I
Hybrid Hybrid i
1.2 1.2 I
NOTES:
1 - Mainframe
2 - Mainframe
3 - Mainframe
4 - Mainframe
3G I/DBMS
4GUDBMS
4GL
4GL
(COBOL. PL/1, FORTRAN)
(NaturaVADABAS)
(FOCUS)
(NaturaWSAM)
5-7
-------
EPA System Design & Development
Guidance: Volume C
- Indentation of source code
- Single statement per line
- Intelligent use of comments
- Error messages
The program design and source programming standards are
maintained and updated by OIRM and are held by office SIRMOs.
5.2 CORE SYSTEM STANDARDS
EPA's Office of Information Resources Management has
developed an important set of software engineering standards in
response to the growing concern for custom software development on
small and/or localized systems (personal computers and
minicomputers). In an effort to avoid the costly duplication of
application development, OIRM is developing a generic set of core
systems which include:
. Project Tracking
. Correspondence Control
. Bibliographic Retrieval
. Mailing List and Label Generation
. Travel Management
. Forms Generation
. Personnel Tracking.
As other core systems are developed, they will be made available
through the EPA System Design and Development Guidance.
An outgrowth of this effort was the development of core
system standards for the development of core systems for. EPA
microcomputers (IBM Personal Computers) and minicomputers (Prime
2250, 2550, and 2665 minicomputers). The objectives for a
standardized design for core systems are to:
. Provide clarity and consistency between core system
applications
. Identify functional commonalities between core system
applications
. Reduce the costs of similar one time development efforts
through the availability of common software
. Provide the basis for the modular development of a System
Builder for core systems.
The standards that have been developed and are included in the
Software Engineering Program are:
. End-User Interface
. Software Engineering
5-8
-------
SPA System Design & Development
Guidance: Volume C
. Data Interchange
. User Documentation.
These standards must be followed by developers of small systems —
e.g., those produced for use on minicomputers and microcomputers.
The'core System Standards can be obtained from OIRM or office
SIRMOs.
5.3 FPA STANDARD SPECIALIZED SOFTWARE TOOLS
The EPA has a number of specialized tools for use on its
various computer hardware configurations. The standard specialized
software packages that have been approved for use in the
development of EPA software systems are presented in Exhibit 5-5.
For detailed information on current software development standards
contact OIRM or office SIRMOs.
5.4 HARDWARE/SOFTWARE ENVIRONMENTAL STANDARDS
The EPA standard hardware/software environments available for
software development are presented in Exhibit 5-6. This exhibit
identifies the EPA standard software packages that are available
and the hardware environments in which each of the software
packages is supported. Any software development effort which uses
software packages or hardware outside the EPA Hardware/Software
Environment Standards must have approval from the Director, Office
of Information Resources Management (OIRM).
5-9
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-5
EPA STANDARD SPECIALIZED SOFTWARE TOOLS
FUNCTION
Data Base
Management
Graphics
Geographies
i
Spreadsheet
Word Processing j
i
I
Text Processing j
and Retrieval i
Programmer Tools j
Software j
Maintenance Tools i
Communications i
Software i
TOOL INTEGRATED
WITH
ADABAS NATURAL
dBASE III
SASGRAPH SAS
TELAGRAPH
VERSAGRAPH INFO
ARC/INFO INFO
UNIRAS
LOTUS 1-2-3
20/20
MEGACALC
LEXITRON
LEXITYPE
WORDSTAR
MULTI-MATE .
TEXT
WORD MARC INFO-TEXT
BASIS
INFO-TEXT INFO
ATMS
ISPF
EMACS
LIBRARIAN i
COBOL DEBUGGERS !
PUI DEBUGGERS I
SNA i
DECNET i
PRIMENET |
GNETII !
PRIMELINK i PRIME/PC Connection
CROSSTALK i
KERMIT i
1
|
:il
:'!:*
1
1
i
i
if
:
i
ji
|
]
:j
|
1
• i
:)
|
j
1
i
,-»
i
|
1
^
j
4
I
5-10
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5"-6
EPA - Agency Standard Hardware/Software
TOOLS
3rd Generation:
COBOL
FORTRAN
PL/1
PASCAL
4th Generation:
INFO
FOCUS
NATURAL
SAS
dBASE III Plu<
Easytrieve Plus
Data Base Management
AOABAS
Graphics Facilities
TELL-A-GRAPH/ Cuechart
VERSAGRAPH
SASGRAPH
Spreadsheet
LOTUS 1-2-3
20/20
MEGACALC
SAS/FSP
Geographies
ARC/INFO (Pilot)
UNIRAS (Pilot)
TARGET HARDWARE ENVIRONMENT
IBM 3090 1
£ i
BM43XX
DEC/VAX
PRIME
IBM/PC
•
9 ^ ^ i ^*
•
•
* 1
•
• •
_ A A *
•
9 ™ i ™
• i
1
i
1
•
• 1
• j
•
• ! j I 1
•
•
•
•
• •
_
•
• 1
— • i
•
]
•
1
!
i •
I
_i i :'
! i »
5-11
-------
EPA System Design & Development
Guidance: Volume C
EXHIBIT 5-6 (Continued)
EPA - Agency Standard Hardware/Software
TOOLS
Word and Taxt Software
LEXfTRON WP DEVICE
LEXfTYPE
WORDSTAR
MULTI-MATE
WORD PERFECT
WOROMARC
Displaywrit04
BASIS
TEXTWP
INFO-TEXT
Project Management
ToU-A-Plan
MtefOBOd Projwa
Talacom Capabllltlas
SNA
AS YNCH ASCII
HASP
X25
PRIMENET
OECNET
CROSSTALK
KERMfT
GNETII
PRIMELINK
NATURAL/CONNECTION
SAS/RInk Rltrm
3270 PC FH» Transfer
Electronic Mail
OIALCOM SERVICE
Local Capability
Programmmar Productivity
Alda/FacllWas
ISPF
LIBRARIAN
EMACS
COBOL DEBUGGER
Fortran/ DEBUGGER
EVE/TPU
TARGET HARDWARE ENVIRONMENT |
IBM 3090
IBM 43XX DEC/VAX PRIME IBM/PC
•
•
• ;
• s
• 1
• ;
• \
• \
I
• I
• i
• i 1 !
j I i • i
•
•
•
•
•
•
•
• • •
• • 1
m • ;
• 1
• • ;
• j
• • • i
• I
• • :
I * 1
• i
• i • " '-9 1
|
• • I
•
•
•
•
•
•
i
••'
• • i
• 5
5-12
-------
EPA System Design & Development
Guidance: Volume C
6. SUMMARY
6.1 SYSTEM DESIGN. DEVELOPMENT AND IMPLEMENTATION OUTPUTS
The outputs, documents and results of the System Design,
Development and Implementation process are as follows:
. EEI-4, System Implementation Plan*
. EEI-5, System Detailed Requirements Document
. EEI-6, Software Management Plan
. EEI-7, Software Test and Acceptance Plan*
. EEI-8, Software Preliminary Design Document*
. EEI-9, Software Detailed Design Document*
. EEI-10, Software Maintenance Document
. EEI-11, Software Operations Document
. EEI-12, Software User's Reference Guide
. EEI-13, System Integration Test Reports*
. Working, tested and user accepted automated or partially
automated solution to the problem
. Established Configuration Management or change control
procedures
* Note: These EEI requirements are the basic requirements for User
Owned Systems that DO NOT involve OIRM.
6.2 NEXT STEPS
After the user has accepted the application system it begins
the transition to the operation and maintenance phase of the
system life cycle. The application specific guidelines for
conducting this phase are outlined in the Software Maintenance
Document, EEI-10, which is required for all systems. The key
elements during the maintenance phase of the life cycle are
planning, analysis, preparation, improvement and implementation.
[Guidance concerning the Maintenance and Operation phase of
the software life cycle will be released under a separate
cover.]
6-1
-------
EPA System Design & Development
Guidance: Volume C
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
-------
EPA System Design & Development
Guidance: Volume C
APPENDIX A
ESSENTIAL ELEMENTS OF INFORMATION
A. FSSKNTTAL ELEMENTS OF INFORMATION
This appendix provides representative outlines of each of the
system-level documents that will be developed during the system
design, development and implementation phase.
A.I INTRODUCTION
The documentation requirements contained in this appendix
apply to all software .development projects, regardless of size,
complexity or origin — except as noted in subsection 4.2.1,
"Determining Documentation Requirements" in Chapter 4 of this
Volume. At a minimum, these standards apply to all new software
development projects. Maintenance and/or enhancements to existing
information systems must comply with the requirements set out in
Chapter 1, section 1.5 of Volume C, System Design, Development and
Implementation.
Compliance with the standards and conventions provided in
this appendix will ensure that adequate documentation is produced
for all system development projects.
The documents defined in this appendix are:
EEI-4 • • System Implementation Plan
EEI-5 • • System Detailed Requirements Document
EEI-6 • • Software Management Plan
EEI-7 • • Software Test and Acceptance Plan
EEI-8 • • Software Preliminary Design Document
EEI-9 • • Software Detailed Design Document
EEI-10 • • Software Maintenance Document
EEI-11 • • Software Operations Document
EEI-12 • • Software User's Reference Guide
EEI-13 • • System Integration Test Reports
When an asterisk or alphanumeric appears within a section
number in the outlines, it represents a repetition of the element
as many times as necessary to define multiple iterations of the
element.
The following milestone chart illustrates the relative
initiation and completion of each document with respect to the
software development life cycle, its major phases, and the span
and scope of Volumes A, B, and C.
A-l
-------
DOCUMENTATION VERSUS LIFE CYCLE
>
Mission Needs Analysis
EEI-1
Preliminary Design/
Options Analysis
EEI-2
EEI-3
System Detailed
Requirements Analysis
EEI-4
EEI-5
EEI-6
Preliminary Design
EEI-7
EEI-8
Detailed Design
EEI-9
System Production
and Programming
EEI-10
EEI-11
EEI-12
System Integration
Testing & Evaluation
EEI-13
System Installation
Qtitom Operations &
itenance
Volume B
Volume C
System Preliminary Critical
Requirement Design Design
Review Review Review
(U
D
DT&E
Review
OTAE
Review
A
User
Acceptance
J
O w
(D ft
O (ft
t-> w
o
<
§
-------
EPA System Design & Development
Guidance: Volume C
EEI-4 SYSTEM IMPLEMENTATION PLAN
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. IMPLEMENTATION PLAN
3.1 Plan Management
3.1.1 Policy Events and Actions
3.1.2 Program Management
3.1.3 Strategy for Acquiring Information/Data
3.1.3.1 Information- Collection
3.1.3.2 Forms
3.1.3.3 Clearance
3.1.4 Strategy for Integrating with other EPA
Information
3.1.4.1 Environmental Data
3.1.4.2 Administrative Data
3.1.5 Access Policy and Standards
3.1.6 Assessment of Existing Hardware/Software
Alternatives
3.1.6.1 EPA
3.1.6.2 Other Government Agencies
3.1.6.3 Commercial Vendors
3.1.7 Information Systems
3.1.7.1 Automated
3.1.7.2 Manual
3.1.8 Process and Procedure
A-3
-------
EPA System Design & Development
Guidance: Volume C
EEI-4 SYSTEM IMPLEMENTATION PLAN (Continued)
3.2 Work Plans and Schedules
3.3 Resource Requirements
3.3.1 Contractor
3.3.2 Personnel
3.3.3 Facilities
3.3.4 Government Furnished Property
3.4 Integrated Project Plan
4. NOTES
5. APPENDICES
6. GLOSSARY
A-4
-------
EPA System Design & Development
Guidance: Volume C
EEI-5 SYSTEM DETAILED REQUIREMENTS DOCUMENT
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. DETAILED CHARACTERISTICS AND REQUIREMENTS
3.1 System Definition Requirements
3.1.1 System Purpose
3.1.2 Concept of Operation
3.1.3 System Sizing and Timing Requirements
3.1.4 Design Standards
3.1.5 Design Constraints
3.1.6 Data Requirements
3.2 Subsystem Definition Requirements
3.2.1 Subsystem #1
3.2.1.1 Subsystem #1 Purpose/Definition
3.2.1.2 Subsystem #1 Interface Definition
3.2.1.2.1 Network
3.2.1.2.2 Software Systems
3.2.1.2.3 Data Base
3.2.1.2.4 Entity Relationships
3.2.1.3 Assumptions and Constraints
3.2.1.4 Subsystem #1 Level II Requirement 1
3.2.1.4.1 Level II Requirement 1 Description
3.2.1.4.1.1 Level III Detailed Functional Requireme:
A-5
-------
EPA System Design & Development
Guidance: Volume C
EEI-5 SYSTEM DETAILED REQUIREMENTS DOCUMENT (Continued)
3.2.1.4.1.1.1 Title and Description Of Level III
Function 1
3.2.1.4.1.1.N Title and Description Of Level III
Function N
3.2.1.4.1.n Level III Requirement n Description
3.2.1.4.m Level II Requirement m Description
3.2.M Subsystem IM
3.3 System Physical Requirements
3.3.1 HVAC and Electrical Requirements
3.3.2 Facilities Management
3.3.3 Computer Hardware Requirements
3.3.4 Computer Operating System Requirements
3.3.5 Software Utilities and Tools
3.4 System Security Requirements
3.4.1 System Backup Procedures
3.4.2 Review/Activity Log Files
3.4.3 Disaster Recovery Procedures
3.5 Quality Requirements
3.5.1 Reliability
3.5.2 Maintainability
3.5.3 Flexibility and Expansion
3.5.4 Transportability
3.6 Life Cycle Requirements
3.6.1- Software Maintenance Personnel
3.6.2 User Support and Training
3.6.3 Hardware and Supplies
4. Testing and Verification Requirements
4.1 Testing Requirements
4.1.1 Method
4.1.2 Responsibility
A-6
-------
EPA System Design & Development
Guidance: Volume C
EEI-5 SYSTEM DETAILED REQUIREMENTS DOCUMENT (Continued)
5. Project Schedules and Work Plans
5.1 Schedules
5.2 Work Plan
5.2.1 Personnel
5.2.2 Milestones
5.2.3 Budget
6. NOTES
7. APPENDICES
8. GLOSSARY
A-7
-------
EPA System Design & Development
Guidance: Volume C
EEI-6 SOFTWARE MANAGEMENT PLAN
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. PLANNING
3.1 Project Resources
3.1.1 Contractor Facilities
3.1.2 Government Furnished Equipment, Software and
Services
3.1.3 Personnel
3.1.4 Organizations Responsible for Design,
Implementation, Configuration Management,
Reliability and Quality Assurance
3.2 Review Responsibilities
3.3 Software Development
3.3.1 Organization Structure
3.3.2 Personnel
3.3.3 Resources
3.3.4 Software Development Tools, Techniques,
Methodologies and Standards
3.3.5 Manual Procedures/Forms
4. MANAGEMENT CONTROLS
4.1 Project Schedule, Reviews and Report Controls
4.1.1 Work Plan
4.1.2 Activity Network and Dependencies
4.1.3 Risk Areas
A-8
-------
EPA System Design & Development
Guidance: Volume C
LEI-6 SOFTWARE MANAGEMENT PLAN (Continued)
4.2 Risk Management
4.1.1 New Technologies
4.1.2 Backup - Recovery
4.1.3 Manual Procedures/Forms
5. SOFTWARE PRODUCT ASSURANCE
5.1 Software Configuration Management
5.2 Software Independent Verification and Validation
5.3 Software Security
5.4 Software Reliability and Quality Control
5.5 Software Interface Definition
5.6 Software Waivers to Policy and Procedures
5.6.1 Permanent Waivers
5.6.2 Temporary Waivers
5.6.3 Tools and Standards Waivers
5.7 Data Administration
5.8 Quality Assurance
5.8.1 Program Monitoring
5.8.2 Quality Reviews
5.8.3 Reporting and Control
5.8.4 Reviews
5.8.4.1 System Requirements Reviews
5.8.4.2 Preliminary Design Review
5.8.4.3 Critical Design Review
5.8.4.4 Code Reviews
5.8.4.5 Development Test and Evaluation Review
5.8.4.6 Operational Test and Evaluation Review
5.9 Testing
5.9.1 Software Test Plan
5.9.2 Software Test Description
5.9.3 Software Test Procedures
5.9.4 Conducting the Software Test
5.9.5 Software Test Reports
A-9
-------
EPA System Design & Development
Guidance: Volume C
EEI-6 SOFTWARE MANAGEMENT PLAN (Continued)
7.
8.
9.
SOFTWARE DEVELOPMENT PROCEDURES
6.1 Software Standards and Procedures
6.1.1 Software Tools
6.1.2 Commercial and Reusable Software
6.1.2.1 Data Rights and Documentation
6.1.2.2 Certification
6.1.3 Software Test Tools
6.1.4 Software Design
6.1.4.1 Software Design Methodology
6.1.4.2 Programming Language
6.1.4.2 Interface Methodology
6.1.4.4 Network Methodology
6.1.5 Software Design and Coding Standards
6.1.6 Firmware
6.2 Software Configuration Management
6.2.1 Configuration Identification
6.2.1.1 Documentation Baselines
6.2.1.2 Methods and Approach to Standards
Implementation
6.2.2 Configuration Control
6.2.2.1 Configuration Control Flow Chart
6.2.2.2 Forms
6.2.2.3 Storage and Release of Master Copies
6.2.3 Configuration Reviews
NOTES
APPENDICES
GLOSSARY
A-10
-------
EPA System Design & Development
Guidance: Volume C
EEI-7 SOFTWARE TEST AND ACCEPTANCE PLAN
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. LIMITATIONS/TRACEABILITY
3.1 Limitations
3.2 Traceability
4. TEST PLANS
4.1. Software Unit Testing (includes Manual Procedures)
4.1.1 Test Requirements
4.1.2 Test Management
4.1.2.1 Integration Test Team Organization
and Responsibility
4.1.2.2 Responsibilities of Other
Organizations
4.1.2.3 Product Control
4.1.2.4 Test Control
4.1.2.5 Evaluation and Retest Criteria
4.1.2.6 Test Reporting
4.1.2.7 Test Review
4.1.2.8 Test Identification
4.1.2.9 Test Data Environment
4.1.3 Test Schedule
4.1.4 Test Results
A-ll
-------
EPA System Design & Development
Guidance: Volume C
EEI-7 SOFTWARE TEST AND ACCEPTANCE PLAN (Continued)
4.2 Integration Testing of Software Units, Modules and
Software Functions/Risk Management
4.2.1 Integration Test Requirements
4.2.2 Integration Test Management
4.2.3 Integration Test Categories
4.2.4 Integration Test Methods
4.2.5 Integration Test Schedules
4.2.6 Integration Test Results
4.2.6.* (Insert Name) Integration Test
4.3 Required Resources
4.3.1 Facilities
4.3.2 Hardware
4.3.3 Interface/Support Software
4.3.4 Personnel
4.4 System Test
4.4.1 System Test Requirements
4.4.2 System Test Management
4.4.3 System Test Categories
4.4.4 System Test Methods
4.4.5 System Test Schedules
4.4.6 System Test Results
5. USER ACCEPTANCE
5.1 Test Team
5.2 Pretest Preparations
5.2.1 Development of Test Scenarios and Test Data
5.2.2 Development of Predicted Results
5.2.3 Development of Acceptance Procedures
5.3 Test Execution
5.3.1 Data Analysis
5.3.2 Test Evaluation
5.3.3 Problem Report and Problem Resolution Process
A-12
-------
EPA System Design & Development
Guidance: Volume C
EEI-7 SOFTWARE TEST AND ACCEPTANCE PLAN (Continued)
5.4 Formal Acceptance
5.4.1 Test Report
5.4.1.1 Detailed Test History
5.4.1.2 Detailed Test Results
5.4.1.2.* (Insert Test Name) Test
Results
6. NOTES
7. APPENDICES
8. GLOSSARY
A-13
-------
EPA System Design & Development
Guidance: Volume C
EEI-8 SOFTWARE PRELIMINARY DESIGN DOCUMENT
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. SOFTWARE DESIGN REQUIREMENTS (SDR)
3.1 Concepts
3.2 Functional Flow
3.n (Insert Name) Requirement
3.*.1 Description of Requirements and Associated
Software Design Functions (SDFs), including
Manual Procedures
4. SOFTWARE DESIGN FUNCTION (SDF)
4.* (Insert Name) Function
4.*.1 Inputs
4.*.2 Local Data
4.*.3 Initiation, Timing and Sequencing
4.*.4 Interrupts
4.*.5 Processing
4.*. 5.1 Algorithms
4.*.5.2 Error Handling
4.*.5.3 Test Structures
4.*.6 Outputs
4.*.7 Adaption
A-14
-------
ZPA System Design & Development
Guidance: Volume C
EEI-8 SOFTWARE PRELIMINARY DESIGN DOCUMENT (Continued)
5. DATA BASE DESIGN
5.1 Data Base Management System
5.2 Data Structure (Logical Design)1
5.3 Interrelationships
5.4 Design Characteristic/Requirements Traceability
5.5 Physical Design (EEI-8)1
6. NOTES
7. APPENDICES
8. GLOSSARY
For ADABAS refer to EPA/NCC ADABAS Application Development
Procedures Manual for CDBA requirements.
A-15
-------
EPA System Design & Development
Guidance: Volume C
EEI-9 SOFTWARE DETAILED DESIGN DOCUMENT
INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
SOFTWARE FUNCTION REQUIREMENTS (SFR)
3.1 SFR External Interfaces (including Manual Procedures)
3.1.* (Insert Name) Interfacer
3.1.*.* (Insert Name) Software Unit (SU)
DETAIL DESIGN
4.* (Insert Name) SFR
4.*.1 SFR Inputs
4.*. 2 SFR Local Data
4.*.3 SFR Processing
.3.1 Control
4
4
4
.3.2 .Algorithms
.3.3 Error Handling
.3.4 Data Conversion
.3.5 Test Structures
.3.6 Manual Procedures
4.*.4 SFR Outputs
4.*.5 SFR Decomposition
A-16
-------
EPA System Design & Development
Guidance: Volume C
EEI-9 SOFTWARE DETAILED DESIGN DOCUMENT (Continued)
4.*.5.* (Insert Name) Software Unit (SU)
4.*.5.*.1 SU Formal Parameters
4.*.5.*.2 SU Inputs
4.*.5.*.3 SU Local Data
4.*.5.*.4 SU Processing
4.*.5.*.5 SU Outputs
4.*.5.*.6 SU Limitations
4.*.5.*.7 Use of Other Elements
4.*.5.*.8 Manual Procedures
5. DATA BASE DESIGN (If Applicable)
5.1 Data Base Management System
5.2 Data Structure (Logical Design)1
5.3 Interrelationships
5.4 Design Characteristic/Retirements Traceability
5.5 Physical Design1
5.5.* File (Insert Name)
5.5.*.* Record (Insert Name)
5.5.*.*.* Field (Insert Name)
5.5.*.*.*.* Item (Insert Name)
6. NOTES
7. APPENDICES
8. GLOSSARY
For ADABAS refer to EPA/NCC ADABAS Application Development
Procedures Manual for CDBA retirements.
A-17
-------
EPA System Design & Development
Guidance: Volume C
EEI-10 SOFTWARE MAINTENANCE DOCUMENT
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. MAINTENANCE PROCEDURES
3.1 Source Code Standards
3.2 Documentation Update (including non-software elements)
3.3 Coding and Review Process
3.3.1 Top Down Approach
3.3.2 Peer Review
3.3.3 Walkthrough
3.3.4 Team Leader Review
3.4 Change Control Process
3.4.1 Change Request
3.4.2 Code Review
3.4.3 Review and Approval
3.4.3.1 Maintainer
3.4.3.2 User
3.5 Testing Standards and Procedures
3.5.1 Test Plans
3.5.2 Test Data
3.5.3 Test Scenarios
3.5.4 Test Results
3.6 Change Implementation Methods
3.6.1 Test to Production Method
A-18
-------
EPA System Design & Development
Guidance: Volume C
EEI-10 SOFTWARE MAINTENANCE DOCUMENT (Continued)
4. MAINTENANCE TOOLS
4.1 Technical Tools
4.1.1 Processing Tools
4.1.1.1 Compilers
4.1.1.2 Cross Reference
4.1.1.3 File Comparator
4.1.1.4 Traces/Dumps
4.1.1.5 Test Data Generator
4.1.1.6 Test Coverage Analyzer
4.1.1.7 Preprocessor
4.1.1.8 Verification/Validation
4.1.2 Clerical Tools
4.1.2.1 On-line Editor
4.1.2.2 Documentation Library
4.1.2.3 Archival Processor
4.1.2.4 Source Code Reformatter
4.1.2.5 Data Dictionary
4.2 Management Tools
4.2.1 Problem Reporting
4.2.2 Status Reporting
4.2.3 Scheduling
4.2.4 Configuration Management
5. SOURCE CODE
5.* (Insert Software Unit Name) Source Listing
6. NOTES
7. APPENDICES
8. GLOSSARY
A-19
-------
EPA System Design & Development
Guidance: Volume C
EEI-11 SOFTWARE OPERATIONS DOCUMENT
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. OPERATIONS
3.1 System Initialization
3.2 System Restart
3.2.* (Insert Name) Function
3.2.*.l Execution
3.2.*. 2 Inputs
3.2.*.2.1 User Inputs
3.2.*.2.2 System Inputs
3.2.*.3 Outputs
3.2.*. 4 Termination
3.2.*.5 Error Messages
3.3 System Manager
3.3.1 Manager's Functions/Menu
3.3.1.* (Insert Name ) Function
3.4 System Backup/Recovery Provisions
3.5 System Security
4. NOTES
5. APPENDICES
6. GLOSSARY
A-20
-------
EPA System Design & Development
Guidance: Volume C
EEI-12 SOFTWARE USER'S REFERENCE GUIDE
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. DESCRIPTION OF THE SYSTEM
3.1 System Overview and Mission Based Activities
3.2 System Flow and Data Descriptions
3.3 System and Program Manager
3.4 Data Dictionary
4. SYSTEM ACCESS TECHNIQUE(S)
4.1 Hardware/Software Interface(s)
4.2 Menus and Other Methods of Access
4.3 Manual Procedures
5. USER ANALYSIS / REPORTING OPTIONS
5.1 Standard Reports
5.2 Ad-hoc Capabilities
5.3 Specialized Capabilities
5.3.1 Models, Algorithms, Etc.
5.3.2 Graphics
5.3.3 Expert Systems
5.3.4 Laser and Other Output Media
6. DATA ENTRY AND UPDATE PROCESSES
6.1 Methods and Descr': .ions of Processes
6.2 Data Responsibilities
A-21
-------
EPA System Design & Development
Guidance: Volume C
EEI-12 SOFTWARE USER'S REFERENCE GUIDE (Continued)
7. USER SUPPORT AND TRAINING PROGRAM/SOURCES
7.1 User Support
7.2 Training Sources/Schedules
8. NOTES
9. APPENDICES
10. GLOSSARY
• A-22
-------
EPA System Design & Development
Guidance: Volume C
EEI-13 SYSTEM INTEGRATION TEST REPORT
1. INTRODUCTION
1.1 Purpose
1.2 Background
1.3 Scope
1.4 System References
1.5 Terms and Abbreviations
1.6 Assumptions and Constraints
1.7 Organization of This Document
2. REFERENCED DOCUMENTS
2.1 Government Documents
2.2 Non-government Documents
3. SUMMARY OF TESTING
3.1 Test Environment
3.2 Chronology of the Testing Process
4. TEST RESULTS
4.1 Resolved Incidents
4.2 Outstanding Incidents
4.3 Evaluation and Recommended Disposition
5. NOTES
6. APPENDICES
7. GLOSSARY
A-23
------- |