.TH DCM 8 "30 Nov 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
-dcm \- build config files from SMS database and update servers
-.br
-startdcm \- start a dcm running, capturing log files
+dcm, startdcm \- build config files from Moira database and update servers
.SH SYNOPSIS
.B dcm
[-d level]
.SH DESCRIPTION
The
.B dcm
-must be run periodically on the SMS server. It is usually run every
+must be run periodically on the Moira server. It is usually run every
15 minutes by the
.I cron
daemon. Rather than invoke
.I /etc/nodcm
or by setting the value of
.I dcm_enable
-to zero in the SMS database. Debug mode may be enabled in the dcm by
+to zero in the Moira database. Debug mode may be enabled in the dcm by
specifying an integer on the command line or by setting the
environment variable
.B DEBUG.
If critical errors are detected, they are logged to
.B /u1/sms/critical.log
and in a zephyrgram to class
-.B SMS
+.B Moira
instance
.B DCM
in addition to standard output.
+For the
+.B dcm
+to function properly,
+.I root
+must both be authorized to access each of the tables by RTI Ingres,
+and on the query acls for each of the queries the
+.B dcm
+will execute.
+.PP
For the actual generation of config files, the
.B dcm
-will for off generator programs of the form
+will fork off generator programs of the form
.B /u1/sms/bin/\fIservice\fB.gen.
Each generator takes as an argument the name of the output file to
produce. Many of them also require working directories in
.B /u1/sms/dcm/\fIservice\fB.
A generator exits with a status code defined in
-.I <sms_et.h>.
+.I <mr_et.h>.
In particular,
-.B SMS_NO_CHANGE
+.B MR_NO_CHANGE
is a common exit status if the database hasn't changed since the last
time this generator was run.
.PP
/etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms"
(null instance).
.SH "SEE ALSO"
-The Project Athena Technical Plan section on SMS.
+The Project Athena Technical Plan section on Moira.