% $Id: Log_reqdoc.tex,v 1.1.6.1 2002/04/24 03:25:36 erik Exp $\documentclass[]{article}\usepackage{html}\usepackage[T1]{fontenc}\begin{document}\bodytext{BGCOLOR=white LINK=#083194 VLINK=#21004A}\begin{titlepage}\begin{latexonly}\noindent {\bf Community Climate System Model} \\\noindent National Center for Atmospheric Research, Boulder, CO \\\vspace{2in}\end{latexonly}\begin{center}{\Large\bf Log Requirements} \\\medskip{\it David Neckels }\end{center}\end{titlepage}\tableofcontents\newpage%\section{Synopsis}\input{Log_syn}\section{Requirements}\subsection{Interface}An interface for logging will be created that will be geared toward simplicity of use.  The logging API will be as similar to the existing fortran {\tt write} aspossible, and will require minimal change of existing code to use.\subsection{Logging States/Levels}Each call to the logger will contain a logginglevel.  The program itself will have a logging state, which may be set by anenvironment variable, and possibly adjusted at runtime via a signal.A matrix will be created that enumerates which logging levels are output during which state.  Calls to logging in an inactive state will return immediately.\subsection{Process Organization}The library will allow output from different MPI processes to be distinguishedor grouped.  Output from a given unit can be either output all to separate files or output all to the samefile with distinguishing tags prepended to the output.  This will allow toolslike {\tt grep} to operate on the file and isolate output from any given unit.The output will be unix friendly, i.e. each line of output will be prefacedwith information that will allow tools like grep, sort, etc.. to be used toorganize the results.\subsection{Log Flush}There will be a flush call so that output will be available in the output arenaonce this call has been made.\section{Review Status}\noindent {\bf Requirements Review} \\\begin{tabular}{r p{1.3in} p{2in}}{\bf Review Date:} & <Date> \\ \\{\bf Reviewers:}   & Cecelia Deluca     & NCAR \\                   & Brian Kauffman     & NCAR \\                   & Tony Craig         & NCAR \\                   & Erik Kluzek        & NCAR \\                   & Nancy Norton       & NCAR \\                   & Keith Lindsay      & NCAR \\                   & Steve Gombosi      & NCAR \\                   & Jim Rosinski       & NCAR\end{tabular}%\section{Glossary}%\input{Log_glos}%\section{Bibliography}\bibliography{Log} \bibliographystyle{plain}\addcontentsline{toc}{section}{Bibliography}\end{document}