NAME

       MPIOSA - Given the area identifier of one of the areas defined by whatever database was last read by one
       of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the area identifier of
       the smallest area, at a specified level, that contains it.

SYNOPSIS

       IOSA=MPIOSA(IAIN,ILVL)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       int c_mpiosa (int iaid, int ilvl)

DESCRIPTION

       IAIN        is  an  input expression of type INTEGER, specifying the area identifier of a particular area
                   of interest.

       ILVL        is an input expression of type INTEGER, specifying the level of the  containing  area  to  be
                   found.

C-BINDING DESCRIPTION

       The C-binding argument description is the same as the FORTRAN argument description.

USAGE

       The statement "IOSA=MPIOSA(IAIN,ILVL)" retrieves in IOSA the area identifier of that area, at level ILVL,
       that  contains  the  area  with area identifier IAIN.  For example, if IMAD is the area identifier of the
       little island in Lake Superior called "Lake Madeline", then MPIOSA(IMAD,3) is the area identifier of  the
       area called "Conterminous US".

EXAMPLES

       Use the ncargex command to see the following relevant examples: mpex11, mpex12.

ACCESS

       To  use MPIOSA or c_mpiosa, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
       that order.

SEE ALSO

       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw,  mapeod,  mapfst,  mapgci,  mapgrd,  mapgrm,
       mapgtc,  mapgti,  mapgtl,  mapgtr,  mapint, mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm,
       maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,  mapsti,  mapstl,  mapstr,
       maptra,  maptri,  maptrn, mapusr, mapvec, mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty,
       mpifnb, mpilnb, mpiola, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,  mpname,  mprset,
       mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               April 1998                                     MPIOSA(3NCARG)