SUBROUTINE ADI1_CCA2HC( ID, MEMBER, LOC, CMP, STATUS )
*+
*  Name:
*     ADI1_CCA2HC

*  Purpose:
*     Conditional copy of ADI data member to HDS component

*  Language:
*     Starlink Fortran

*  Invocation:
*     CALL ADI1_CCA2HC( ID, MEMBER, LOC, CMP, STATUS )

*  Description:
*     Copies an ADI data member to an HDS object if the member data is
*     defined.

*  Arguments:
*     ID = INTEGER (Given)
*        The ADI identifier containing the data member
*     MEMBER = CHARACTER*(*) (Given)
*        The name of the data member to copy
*     LOC = CHARACTER*(DAT__SZLOC) (Given)
*        The locator to the HDS structure to contain the component
*     CMP = CHARACTER*(*) (Given)
*        The name of the new HDS component
*     STATUS = INTEGER (Given and returned)
*        The global status.

*  Examples:
*     {routine_example_text}
*        {routine_example_description}

*  Pitfalls:
*     {pitfall_description}...

*  Notes:
*     {routine_notes}...

*  Prior Requirements:
*     {routine_prior_requirements}...

*  Side Effects:
*     {routine_side_effects}...

*  Algorithm:
*     {algorithm_description}...

*  Accuracy:
*     {routine_accuracy}

*  Timing:
*     {routine_timing}

*  External Routines Used:
*     {name_of_facility_or_package}:
*        {routine_used}...

*  Implementation Deficiencies:
*     {routine_deficiencies}...

*  References:
*     ADI Subroutine Guide : http://www.sr.bham.ac.uk/asterix-docs/Programmer/Guides/adi.html

*  Keywords:
*     package:adi, usage:private

*  Copyright:
*     Copyright (C) University of Birmingham, 1995

*  Authors:
*     DJA: David J. Allan (Jet-X, University of Birmingham)
*     {enter_new_authors_here}

*  History:
*     29 Mar 1995 (DJA):
*        Original version.
*     {enter_changes_here}

*  Bugs:
*     {note_any_bugs_here}

*-
      
*  Type Definitions:
      IMPLICIT NONE              ! No implicit typing

*  Global Constants:
      INCLUDE 'SAE_PAR'          ! Standard SAE constants
      INCLUDE 'ADI_PAR'
      INCLUDE 'DAT_PAR'

*  Arguments Given:
      INTEGER			ID
      CHARACTER*(*)		MEMBER,CMP
      CHARACTER*(DAT__SZLOC)	LOC	

*  Status:
      INTEGER 			STATUS             	! Global status

*  Local Constants:
      INTEGER			MAXLEN
        PARAMETER		( MAXLEN = 400 )

*  Local Variables:
      CHARACTER*(DAT__SZLOC)	CLOC			! Object to write to
      CHARACTER*(MAXLEN)	VALUE			! Intermediate value

      INTEGER			CLEN			! Length of ADI string
      INTEGER			DIMS(ADI__MXDIM)	! Data dimensions
      INTEGER			MID			! Member identifier
      INTEGER			NDIM			! Member dimensionality
      INTEGER			ULEN			! Length of output

      LOGICAL			THERE			! Object exists?
*.

*  Check inherited global status.
      IF ( STATUS .NE. SAI__OK ) RETURN

*  Does the member exist?
      IF ( MEMBER .GT. ' ' ) THEN
        CALL ADI_THERE( ID, MEMBER, THERE, STATUS )
        IF ( THERE ) THEN
          CALL ADI_FIND( ID, MEMBER, MID, STATUS )
        END IF
      ELSE
        THERE = .TRUE.
        CALL ADI_CLONE( ID, MID, STATUS )
      END IF

*  Try to copy if it exists
      IF ( THERE ) THEN

*    Get length of string
        CALL ADI_CLEN( MID, CLEN, STATUS )

*    Not zero length?
        IF ( CLEN .GT. 0 ) THEN

*      Length to use
          ULEN = MIN( MAXLEN, CLEN )
          
*      Get dimensions
          CALL ADI_SHAPE( MID, ADI__MXDIM, DIMS, NDIM, STATUS )

*      HDS value already exists? If so, delete it
          IF ( CMP .GT. ' ' ) THEN
            CALL DAT_THERE( LOC, CMP, THERE, STATUS )
            IF ( THERE ) THEN
              CALL DAT_ERASE( LOC, CMP, STATUS )
            END IF

*        Create the HDS value
            CALL DAT_NEWC( LOC, CMP, ULEN, NDIM, DIMS, STATUS )

*        Locate it
            CALL DAT_FIND( LOC, CMP, CLOC, STATUS )

          ELSE
            CALL DAT_CLONE( LOC, CLOC, STATUS )

          END IF

*      Scalar?
          IF ( NDIM .EQ. 0 ) THEN

*        Read the ADI data
            CALL ADI_GET0C( MID, VALUE(:ULEN), STATUS )

*        Write to HDS
            CALL DAT_PUT0C( CLOC, VALUE(:ULEN), STATUS )

          ELSE

*      Otherwise copy using cells

          END IF

*      Release output object
          CALL DAT_ANNUL( CLOC, STATUS )

        END IF

*    Free the member identifier
        CALL ADI_ERASE( MID, STATUS )

      END IF

*  Report any errors
      IF ( STATUS .NE. SAI__OK ) CALL AST_REXIT( 'ADI1_CCA2HC', STATUS )

      END