NAME

       FMREAD_LB - read a LB field from FM-file



SYNOPSIS

       USE MODI_FMREAD_ll


       CALL  FMREAD_LB(  HFILEM,  HRECFM,  HFIPRI,  HLBTYPE, PLB,
       KRIM, KL3D, KGRID, KLENCH, HCOMMENT, KRESP)



ARGUMENTS

       IN

              CHARACTER*    ::    HFILEM
              CHARACTER*    ::    HRECFM
              CHARACTER*    ::    HFIPRI
              CHARACTER*    ::    HLBTYPE
              INTEGER       ::    KRIM
              INTEGER       ::    KL3D


       OUT

              REAL, DIMENSION(:,:,:)    ::    PLB
              INTEGER                   ::    KGRID
              INTEGER                   ::    KLENCH
              CHARACTER*                ::    HCOMMENT
              INTEGER                   ::    KRESP




DESCRIPTION

       The FMREAD_LB routine reads a LB (Lateral Boundary)  field
       with  HRECFM  name  from  the binary LFI part of a FM-File
       whose basename is HFILEM.  Each process  of  the  parallel
       MsoNH  application  must  call this routine that delivers
       the corresponding local LB field in PLB.  Three  arguments
       define the LB field to retrieve :

       *      HLBTYPE   that   may   take   the   string   values
              LBX,LBY,LBXU and  LBYV.  LBX  and  LBXU
              stand  for LB areas that spread along the x axe for
              mass and  U  grid  point  respectively.  LBY  and
              LBYV  stand  for LB areas that spread along the y
              axe for mass and V grid point respectively.

       *      KL3D is the size of the LB  array  in  the  FM-file
              (size along the y axe for a LBX or LBXU area or
              size along the x axe for a LBY or LBYV area)  .

       *      KRIM is the thickness of the LB area to retrieve.


RETURN VALUES

       Upon  successful  completion,  the  FMREAD_LB  returns the
       expected data in PLB together with the C-grid indicator in
       KGRID  and  the  string comment in HCOMMENT with KLENCH as
       the comment length.  The return code KRESP is then set  to
       0. Otherwise KRESP is set to a non zero value and an error
       message is printed in the HFIPRI file.



SEE ALSO

       FMREAD(3f)












































Man(1) output converted with man2html