mas_get_met_id(3mas)                            mas_get_met_id(3mas)


       NAME
             mas_get_met_id - get the metric ID for a particular entry in
             the metric registration table for consumer use

       SYNOPSIS
             cc [options] file -lmas
             #include <mas.h>
             metid_t *mas_get_met_id(int md, uint32 mrt_slot);

       DESCRIPTION
             The function mas_get_met_id returns the address of the metric
             ID number of the metric located in position mrt_slot of the
             metric registration table.

             The md argument is a metric descriptor returned from mas_open.
             The second argument, mrt_slot, is array index to access within
             the metric registration table.  mrt_slot must be a non-
             negative number less than the number of entries in the metric
             registration table.  The number of entries in the metric
             registration table can be determined by calling mas_get_nmrt.
             Hence, mas_get_met_id can be used to determine the set of
             metrics that have been registered in a metric registration
             file.

          Return Values
             On success, mas_get_met_id returns an address at which the
             metric ID number resides in the caller's address space.

             On failure, mas_get_met_id returns NULL and sets mas_errno to
             identify the error.

          Errors
             MAS_INVALID_ARG - invalid metric descriptor
                   The metric descriptor, md does not correspond to a
                   metric registration file previously opened by mas_open.

             MAS_INVALIDARG - invalid slot number
                   The location referred to by mrt_slot within the metric
                   registration table does not exist. mrt_slot is probably
                   greater than or equal to the number of entries in the
                   metric registration table.

       bounds


             MAS_SANITY - corrupted metric registration file -


                           Copyright 1994 Novell, Inc.               Page 1

      mas_get_met_id(3mas)                            mas_get_met_id(3mas)


                   id address out of
                  The metric registration file is corrupted such that the
                  address of the metric ID falls outside the bounds of the
                  metadata area.

      REFERENCES
            mas(3mas)









































                          Copyright 1994 Novell, Inc.               Page 2