MOOC Download Devices --- SLMCLS
			   Dennis Nicklaus
			     May 15, 2001



A standard MOOC class, SLMCLS, allows you to trigger database
downloads to a front-end, and to monitor the status of the download.
Clone the following device, and enter the device name into the
acnet_node_info table using page D98 ("Download Device").  Specifying
the Download Device on page D98 supports download triggering from page
D31.  Mooc automatically creates an instance of SLMCLS on the
front-end, for you to access through a database device.

Additionally, the SLMCLS supports more than just the reset control
(which triggers the download).

Besides the reset/download control, you can also enable/disable global
*reporting* of alarms from your front end with this SLMCLS.  The ON
control (must be value 2) turns on alarms reporting (the default), the
OFF control (must be value 3) turns off alarms reporting.  Even with
alarms reporting disabled, the front end is still doing the alarm scan
and reading the devices. It just isn't reporting (to AEOLUS) any
alarms it finds.  Frig nodes are the only ones I know of who use this
facility, but it has always been there.

There is also a basic status channel for SLMCLS.  It is most useful
when used with the direct-database-access (freeTDS) method of
alarms downloading (which you all ought to be using now, right!!??)
But even with the old MISCBOOT kinds of downloads, it returns
a few basic things.

There is also a reading channel. It can return up to 6bytes (3 two
byte integers). This is ONLY useful with the direct-database-access
(freeTDS) method of alarms downloading.  It'll always be 0 if you
use the MISCBOOT/AERBOOT/FRIGBOOT method.

-----------------------------------------------------------------------

MOD Z:NFALEN ( "NEW FRONT-END ALARM     ", FRIGNF,         , 07FFFFFE )
SSDNHX BCNTRL (09CD/0003/0000/030?)
!              /\/\              ^ See note 1. below!!
!               | node
!               trunk

PRO BCNTRL ( 2, 2, 60)
PDB BCNTRL ( 07, 00000000, 00000002, 00000003, 00000000, 00000000)
! Value of 0 (reset) re-downloads alarms, 2 enables alarm reporting, 3 disables.
SSDNHX BASTAT (09CD/0003/0000/0300)
PRO BASTAT ( 2, 2, 60)
PDB BASTAT ( 01, 00, 00000001, 00000000, 00000000, 00000000, 2,
             00000000, 00000000, 00000000, 00000000)
PRO EXTEXT ( 1, 10, 4, "NO     ", 2, "YES    ", "DOWNLOAD EVER REQUESTED?",
             1, 9, 2, "NO     ", 4, "YES    ", "RELOAD IN PROGRESS      ",
             1, 8, 2, "OK     ", 4, "FAILED ", "SLAM ACNET INIT ERRORS  ",
             1, 7, 2, "OK/NONE", 4, "ERRORS ", "ERROR PROCESSING VMDIS  ",
             1, 6, 2, "OK/NONE", 4, "ERRORS ", "ERROR PROCESSING ALARMS ",
             1, 5, 2, "OK/NONE", 4, "ERRORS ", "ERROR PROCESSING SETTING",
             1, 4, 2, "OK     ", 4, "FAILED ", "DOWNLOAD VMDI STATUS    ",
             1, 3, 2, "OK     ", 4, "FAILED ", "DOWNLOAD ALARMS STATUS  ",
             1, 2, 2, "OK     ", 4, "FAILED ", "DOWNLOAD SETTINGS STATUS",
             1, 1, 4, "NO     ", 2, "YES    ", "ALARM SCAN ENABLED      ",
             1, 0, 4, "NO     ", 2, "YES    ", "ALARM SENDING ENABLED   ")
SSDNHX READNG (09CD/0003/0000/0300)
PRO READNG ( 2, 6, 60)
! The Reading returns up to three 2-byte integers.
! These integers are the number of errors encountered during
! download of the settings, alarms, and VMDIs, in that order,
! corresponding to the ERROR PROCESSING [Setting, alarms, VMDIs]
! bits of the basic status. The basic status just gives you a 0/1 indicating
! if there were any errors. If there were any, then you can use the reading
! channel to find out how many.

!1.  The last digit of the SSDN for basic control will not matter in the
!    latest version (versino 3.1 or later) of Mooc.
!    In older versions, the last digit has to be
!    1 for the reset/download control to work,
!    and a 0 for the alarm reporting On/Off control to work.
!    If you want to use the download facility with an older Mooc
!    then make the last digit=1.
!    Be aware your alarm reporting enable/disable control won't work until
!    you move to version 3.1 of Mooc (or higher).
 -----------------------------------------------------------------------