NAME

       FMOPEN_ll - open a FM-file



SYNOPSIS

       USE MODI_FM_ll

       CALL  FMOPEN_ll(  HFILEM, HACTION, HFIPRI, KNPRAR, KFTYPE,
       KVERB, KNINAR, KRESP)



ARGUMENTS

       IN

              CHARACTER*    ::    HFILEM
              CHARACTER*    ::    HACTION
              CHARACTER*    ::    HFIPRI
              INTEGER       ::    KNPRAR
              INTEGER       ::    KFTYPE
              INTEGER       ::    KVERB


       OUT

              INTEGER    ::    KNINAR
              INTEGER    ::    KRESP




DESCRIPTION

       The FMOPEN_ll routine opens a FM-file  whose  basename  is
       specified  in  HFILEM.  A FM-file (FM stands for File Man­
       ager) is basically formed by two fortran files :


       1.     an ASCII namelist-formatted  file  that  holds  the
              model´s  parameters.  The suffix ´.des´ is appended
              to the HFILEM  value  to  form  the  name  of  this
              descriptive file.

       2.     a  binary  LFI  file that holds the scalar, 1D, 2D,
              ...,6D model data. The suffix ´.lfi´ is appended to
              the  HFILEM  value  to form the name of this binary
              file. The LFI abbreviation stands for ´Logiciels de
              Fichiers Indexés´. A LFI file is handled by the LFI
              library  which  provides  various  subroutines   to
              access  articles  with  their  names  and to manage
              variable size articles.


       Internally, the FMOPEN_ll statement will cause the opening
       of the ASCII part with the OPEN_ll routine in GLOBAL mode.
       It also performs a call to the  OPEN_ll  routine  in  DIS­
       TRIBUTED   mode   for  the  LFI  part.  Once  opened,  the
       descriptive part may be handled by  the  standard  Fortran
       I/O  routines  whereas  the  LFI part is handled by the FM
       routines FMREAD_ll or FMWRIT_ll.

       The HACTION argument is required to specify what  will  be
       done with the files : open for reading ( HACTION = ´READ´)
       or open for writing ( HACTION = ´WRITE´). There is no pos­
       sibility for a ´READWRITE´ opening.

       The  KNPRAR  and  KVERB input arguments are related to the
       LFI part of the FM-file.  KNPRAR is a non crucial argument
       that  gives  the  number  of predicted articles of the LFI
       files.  KVERB sets the  level  of  verbosity  of  the  LFI
       library calls.



RETURN VALUES

       Upon   successful   completion,   both   the   descriptive
       (Namelist) and binary (LFI) files are opened,  the  number
       of  articles  initially present in the LFI file is hold in
       KNINAR, and KRESP is assigned  a  zero  value.  Otherwise,
       KRESP is assigned a non zero value and an error message is
       output to the file whose name is HFIPRI.

       Note that the fortran logical units associated with  these
       two  files are not output by the FMOPEN_ll routine. A call
       to the FMLOOK_ll routine is needed to  retrieve  the  unit
       number associated to the descriptive part.



SEE ALSO

       OPEN_ll(3f),   FMCLOS_ll(3f),  FMREAD(3f),  FMREAD_LB(3f),
       FMWRIT(3f), FMWRIT_LB(3f), , FMWRITBOX(3f)






















Man(1) output converted with man2html