
	The Paragon System Diagnostic (PSD) executes tests on the individual
	node boards and the communication links in the Paragon system.  When
	a failure is detected, an error message is reported to help isolate
	the failure to the defective part.


INVOCATION

	PSD may be invoked as follows:

	psd [-l logfile] [-m macfile]

	where
	logfile is a user specified error log file name.
	The default error log file name is "psd.log".

	and 
	macfile is a user specified macro command file name.
	The default macro command file name is ".psd.mac".


OPERATION

	When PSD is invoked, the "/usr/paragon/boot/SYSCONFIG.TXT" 
	configuration file is read.  This file contains information 
	describing the system under test.  The root menu is then displayed 
	followed by the command prompt.  By entering menu item numbers, the 
	menu tree may be examined and tests may be executed.

	In addition to the error log file, PSD also generates
        "/u/paragon/diag/psd.def" (referred to as the default log file).
	This file logs the progress of the PSD session.

	The default log file is useful when the diagnostics have been
	left running for a long time and later the operator wants to 
	check how the psd session proceeded.

	Following is a list of items that are captured in the default
	log file:
	1.  It logs the trial count and the test name which is being executed.
	2.  All messages printed out by the tests programs are captured.
	3.  It captures all error log messages (which are also available
            in the error log file).
	4.  Almost all messages in this file are time stamped.  The only
	    non-time stamped messages may come from test programs which
	    can override the default time stamping.

	Similar to the error log file, the default log file is also backed
	up by psd when it is invoked.  The backup file is named
	"psd.def.bak".  The operator must rename this file if the log
	information is to be used in the future.

        NOTE:  Due to elaborated logging in the default log file, the file
	size can grow substantially.  Make sure you have enough device
	space to accommodate this file.

	The default for all numbers entered in PSD is decimal or base 10.  This
	input default may be overridden by prefixing the number with a 
	conversion control.  Conversion controls are 0b for binary (base 2),
	0 for octal (base 8), and 0x for hexadecimal(base 16).  In addition,
	the character 'k' can be suffixed on a decimal number to indicate a
	multiplier of 1024.


TEST ZERO

	At any menu, a special menu item not displayed may be executed.  This
	item, called "test zero", is executed by entering a "0" at the command
	prompt.  A zero entry will cause PSD to execute all recognized tests
	from the current menu level down.  Utilities and ignored menus and 
	tests are not executed.


SEE ALSO

	commands, tests, and utilities.

