ims(7)                                                        ims(7)


       NAME
             ims - Tricord Intelligent Management Subsystem

       DESCRIPTION
             The Tricord Intelligent Management Subsystem driver provides a
             generic interface for all UNIX drivers and modules wanting to
             log a message to the console and to /usr/adm/messages.  In
             most cases, the messages will originate from the device's
             (i.e. ISS, IMS, ICS, . . .) dual-port memory queues.  The IMS
             applies to the Tricord Powerframe Enterprise Server family-the
             ES3000, ES4000, and ES5000.

             The IMS driver is used primarily by the IMS message logging
             daemon, imsd, which provides the following major functions:

                   Generic, high-speed kernel message logging.

                   Remote Management Console remote shutdown.  (For systems
                   configured with an Intelligent Management Subsystem.)

             This daemon is started up when the UnixWare system enters
             multi-user state (state 2).  The imsd daemon should always be
             running when in multi-user mode.  It is invoked via the
             /etc/init.d/ims script.  If for any reason this daemon is
             killed when in multi-user mode, it can be restarted by
             entering:

                         /etc/init.d/ims start

       ioctl Calls
             It is also possible for the knowledgeable user to access the
             IMS directly by using ioctl(2) calls.  The following calls are
             provided by the driver:

             IMS_IOCTL_READ_STAT
                   Returns a structure describing the status of the IMS.

             IMS_IOCTL_READ_HDR
                   Returns the IMS header data structure that resides in
                   the IMS dual-port memory and is built by the IMS
                   firmware.  The structure containing physical addresses
                   is used by the IMS driver to interact with the IMS
                   firmware.





                           Copyright 1994 Novell, Inc.               Page 1

      ims(7)                                                        ims(7)


            IMS_IOCTL_MRP_HDR_REQ
                  Sends a user-defined Maintenance Request Packet to the
                  IMS.

            IMS_IOCTL_IS_IMS
                  Returns a 0 if there is an IMS present in the system, an
                  ENODEV if not present

            IMS_IOCTL_LOG_MSG
                  Logs a user-defined message to the console and to
                  /usr/adm/messages.

            IMS_IOCTL_DEV
                  Returns the IMS device structure that contains
                  information used in the interaction between the kernel
                  and IMS.

         Files
            /usr/include/sys/ims.h
            /usr/include/sys/ims_mrp.h

      REFERENCES
            ioctl(2)

























                          Copyright 1994 Novell, Inc.               Page 2