subroutine dchapp (xsm,ysm,zsm,discha,ier)
c*
c***********************************************************************
c*
c*          "Copyright [c] CNES 98 - tous droits reserves"
c*          **********************************************
c*
c*PRO MAGLIB
c*
c*VER 99.03.31 - V 1.0
c*VER 01.06.05 - V 2.0
c*VER 03.01.06 - V 2.1
c*
c*AUT spec. CNES - JC KOSIK - juin 1995    
c*AUT port. CISI 
c*
c*ROL Theme : Frontieres et regions
c*ROL         Calcul de la distance d'un satellite a la plasmapause.
c*
c*PAR xsm    (I) : coordonnee en x dans le repere solaire magnetique
c*               : (rayons terrestres)
c*PAR ysm    (I) : coordonnee en y dans le repere solaire magnetique
c*               : (rayons terrestres)
c*PAR zsm    (I) : coordonnee en z dans le repere solaire magnetique
c*               : (rayons terrestres)
c*
c*PAR discha (O) : distance du satellite par rapport a la 
c*PAR            : plasmasphere (rayons terrestres)
c*
c*PAR ier    (O) : code de retour
c*
c*NOT ier        : sans objet
c*
c*INF utilise    : carsp, tgml2, chapp2, distdip
c*
c*HST version 1.0 - 99.03.31 - creation de la maglib au CDPP
c*HST version 2.0 - 01.06.05 - correction de commentaires de code
c*HST version 2.1 - 03.01.06 - corrections en compilation avec g77
c*
c***********************************************************************
c*
      implicit none
c
c     ---------------------------------
c*FON Declaration identificateur rcs_id
c     ---------------------------------
c
      character rcs_id*100
c
c     --------------------------
c*FON Declaration des parametres
c     --------------------------
c
      double precision xsm, ysm, zsm
      double precision discha
      integer ier 
c
c     ---------------------------------
c*FON Declaration des variables locales
c     ---------------------------------
c
      double precision r,thetr,phir
c*LOC r,thetr,phir : coordonnees spheriques
c
      double precision tgl
c*LOC tgl : temps geomagnetique local
c
      double precision xlchap
c*LOC xlchap : apex de la ligne de champ dans le plan equatorial
c
      SAVE
c
c     ---------------------------------
c*FON Affectation identificateur rcs_id
c     ---------------------------------
c
      data rcs_id /"
     >$Id$"/
c
c     ******************
c     Debut de programme
c     ******************
c
      ier = 0
c
c     ---------------------------------
c*FON Calcul des coordonnees spheriques
c     ---------------------------------
c
      call carsp(xsm,ysm,zsm,r,thetr,phir,ier)
c
c     -----------------------------------
c*FON Calcul du temps geomagnetique local
c     -----------------------------------
c
      call tgml2(xsm,ysm,tgl,ier)
c
c     -------------------------------------------------------------
c*FON Calcul de l'apex de la ligne de champ dans le plan equatorial
c     -------------------------------------------------------------
c
      call chapp2(tgl,xlchap,ier)
c
c     ----------------------------------------------------------------
c*FON Calcul de la distance du satellite par rapport a la plasmasphere
c     ----------------------------------------------------------------
c
      call distdip(r,thetr,xlchap,discha,ier)
c
c     ****************
c     Fin de programme
c     ****************
c
      return
      end