
Purpose:

	The purpose of this program is to allow users to view, print and/or save official 
	AWIPS text products, which are archived in AWIPS according to WSOM Issuance 
	97-2. Since those products are stored in various different locations, this 
	program facilitates the retrieval of needed products.

	WSOM Issuance 97-2 requires all NWS offices, which issue products, to retain 
	those products, for a period of 30 days.  In accordance with the Service Records 
	Retention System (SRRS), AWIPS stores the products for 31 days, after which 
	time, the products are purged from the system.  Each office is also required to 
	have retention and hard copy reproduction capabilities for the above stated 
	period of time.

Background:

	All locally generated text products are stored in the AWIPS system in several
	different locations.

	Products which use the handleOUP.pl script are stored in the following location:
    $FXA_DATA/archive/obs/archive
	
	Products which use the LDAD sua processor are stored in the following location:
    $FXA_DATA/archive/obs/archive
	
	All products which are sent out from a text workstation are archvied in the 
	following directories:
    $FXA_DATA/textWSwork/xt#-<sid>:0/archived
	
	where # is a workstation number, and <sid> is the site ID.  There will be several 
	different directories for every location.

Usage:

	To start the Archive Viewer program, type archview.tcl at the command line. While
	loading, the program searches the system for the above listed directories.  The
	list of valid directories are placed under the Location menu. 
	
	To load the contents of a directory into the program, select a directory from the
	Location menu.
	
Screen Components:

	File Listbox - The filelist box to the left contains the list of files in the
	currently selected location.  Clicking a filename will display the Product ID and
	Time and Date (product issuance time, if available) below the File Listbox.
	Double-clicking a file will load the file into the File Contents Display text box
	on the right side of the program window.
	
	Filter - A filter may applied to the list of files which are listed in the File
	Listbox.  The filter text box is not case sensitive.  Do not use wildcards within
	the Filter text box...they are applied automatically.
	
	File Contents Display - The File Contents Display text box displays the currently
	selected file.  This text box cannot be edited.
	
	Searching - To search the File Contents Display text box, enter the desired text
	in the search text box near the top of the screen.  By default, the search box
	will only allow uppercase letters to be typed.  To search for lowercase, as well
	as uppercase, select the Literal Search check box.
	
	Clear - The Clear button clears the contents of the File Contents Display text
	box.
	
	Save - The Save button enables the user to Save the currently displayed file to
	a new location.  By default the file is saved with a .txt extension, in the 
	home directory of awipsusr.
	
	Print - Prints the currently displayed file to the default printer.
	
	
