'\"macro stdmacro
.if n .pH g8.dgmon @(#)dgmon	40.4 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} dgmon 8 "" "\&"
.if \nX=1 .ds x} dgmon 8 ""
.if \nX=2 .ds x} dgmon 8 "" "\&"
.if \nX=3 .ds x} dgmon "" "" "\&"
.TH \*(x}
'\" t
.SH NAME
\f4dgmon\f1 \- run diagnostic phases in firmware
.SH SYNOPSIS
\f4dgn\f1
[ \f4unit\f1 [ \f4=\f2number\f1 ]]
.br
\f4dgn\f1
[ \f4unit\f1[ \f4=\f1\f2number\f1 ]] [ \f4ph=\f1\f2a\f1[\f4-\f2b\f1] ]
[ \f4rep=\f2n\f1 ] [ \f4ucl\f1 ] [ \f4soak\f1 ]
.br
\f4l(ist)\f1
\f4unit\f1
.br
\f4h(elp)\f1
.br
\f4s(how)\f1
.SH DESCRIPTION
The Diagnostic Monitor Utility, \f4dgmon\fP, allows diagnostics to be
run on the 3B2 Computer in the firmware mode via the system console.
The particular diagnostic phases are specified via the \f4dgn\f1 command.
The interface and the entry into the diagnostic mode is
discussed in detail in the 
.I System Administrator's Guide.
Diagnostics can be invoked for the entire computer, types of devices
(e.g., all ports boards), a specific device (e.g., the system board), or a particular phase or range of phases for the
device or device type.  Each diagnostic phase and phase description can be
found by listing the diagnostic phases 
for each computer device (such as \f4l sbd\fP).
The Monitor \f4s(how)\fP command lists the physical devices.
.P
Types of diagnostic phases:
.RS 6
.TP 12
Normal
diagnostics that run every time the computer is powered up
.TP
Demand
diagnostics that run during soak or must be specifically requested
.TP
Interactive
diagnostics that must be specifically requested and may cause loss of
stored data or require operator intervention
.RE
.PP
The Diagnostic Monitor denies requests for diagnostics on unequipped
devices and non-existent phases.
.PP
Option definitions:
.RS 6
.TP 8
\f4ucl\f1
unconditional execution\(emrun all specified phases and display all failing results
.TP 8
\f4rep=\f2n\f1
repeat phase(s) \f2n\f1 times
.TP 8
\f4ph=\f2a\f1
run phase
.I a
only
.TP 8
\f4ph=\f2a\f4-\f2b\f1
run phases
.I a
through
.I b
only
.TP 8
\f4soak\f1
silently and continuously run normal and demand diagnostics
for specified range (default:  all of phase table) and for specified
repetitions (default:  continuous, stopped with keyboard entry)
.RE
.bp
.SH EXAMPLES
.TS
lf4 l.
.vs +2
dgn	(full system)
dgn ports	(all ports devices)
dgn sbd 0 ucl	(unconditional execution)
dgn ports 0	(ports 0 diagnostic)
dgn ports 1 ucl
dgn sbd ph=3	(run phase 3 only)
dgn sbd ph=1-5	(run phases 1 through 5 only)
dgn sbd soak	(diagnostic system board soak)
.vs -2
.TE
.P
Whenever specific phases are requested, the device to be tested must be
designated.
.SH DIAGNOSTICS
Improper syntax generates a message or reports the invalid input.
The ``\f4h\fP'' command generates a listing of the correct syntax
for the system board firmware.
.Ee
