mas_put(3mas)                                          mas_put(3mas)


       NAME
             mas_put - write metrics and metric registration information
             for provider use

       SYNOPSIS
             cc [options] file -lmas
             #include <mas.h>
             int mas_put(void);

       DESCRIPTION
             The function mas_put writes metric registration information to
             the metric registration file(s).  The file name(s) and
             permissions are those that were previously passed to mas_init
             during MAS provider initialization.  The first time mas_put is
             called, it creates the metric registration file(s).  On
             subsequent invocations the metric registration files are
             rewritten with the updated registration information.

             If a provider is using an internal metric segment within the
             metric registration header file, or if dynamic registration
             was not requested by calling mas_init with file names for the
             metric registration table, metadata, and strings table, then
             mas_put should not be called more than once.

          Return Values
             On success, mas_put returns 0.

             On failure, mas_put returns -1 and sets mas_errno to identify
             the error.

          Errors
             MAS_USAGE - mas not initialized
                   mas_init was not called prior to calling mas_put.

             MAS_SYSERR - can't create mas file
                   The open system call failed.

             MAS_SYSERR - cannot malloc space for mas_buf
                   The malloc library call failed.

             MAS_SYSERR - write of mas header failed
                   The write system call failed.

             MAS_SYSERR - write of mas buf failed
                   The write system call failed.



                           Copyright 1994 Novell, Inc.               Page 1

      mas_put(3mas)                                          mas_put(3mas)


            MAS_SYSERR - write of metric reg header failed
                  The write system call failed.

            MAS_SYSERR - can't create metric registration table file
                  The open system call failed.

            MAS_SYSERR - write of met reg table failed
                  The write system call failed.

            MAS_SYSERR - can't create strings file
                  The open system call failed.

            MAS_SYSERR - write of string table failed
                  The write system call failed.

            MAS_SYSERR - can't create metadata file
                  The open system call failed.

            MAS_SYSERR - write of meta data failed
                  The write system call failed.

            MAS_SYSERR - can't create metrics file
                  The open system call failed.

            MAS_SYSERR - can't seek to start of mas file
                  The lseek system call failed.

            MAS_SYSERR - write of mas header failed
                  The write system call failed.

      REFERENCES
            mas(3mas)

      NOTICES
         Future Directions
            Currently, mas_put does not notify active consumers that a
            change in registration information has occurred.  This may be
            supported in a future release.










                          Copyright 1994 Novell, Inc.               Page 2