The Copy  Data Area  Command copies the  contents of  one data  area to
another.

A typical command would be:

             CPYDTAARA    FROMDTAARA(xxx) TODTAARA(yyy)

The  entire contents of  the data  area are  copied from the  From data
area to the To data area.

If  a *DEC type data areas  is specified, it must  be 15 or less digits
in length.

Mapping  between data  areas  of  the  same type,  but  with  different
lengths  or decimal  positions  is possible  with MAP(*YES)  specified.
The  CHGDTAARA command is used internally  and the rules for truncation
and decimal alignment are the same as CHGVAR.

Command parameters                                    *CMD
------------------

   FROMDTAARA    The  qualified name  of  the  From  data  area.    The
                 library value  defaults to  *LIBL.   *CURLIB may  also
                 be used.

   TODTAARA      The qualified  name of the To data  area.  The library
                 value defaults to  *LIBL.  *CURLIB  may also be  used.

   CRTDTAARA     Whether to  create the TODTAARA.   *NO is  the default
                 and requires the data area to exist.

                 *YES may  be specified to  create the data  area if it
                 does not exist.

                 CRTDTAARA  is used to  create the new  data area.  The
                 only  parameters specified  are  the data  area  name,
                 library,  type, length,  decimal positions,  and text.
                 The other parameters of CRTDTAARA are defaulted.

   MAP           A  *YES/*NO value  for whether  to map  from different
                 attribute data  areas.   *NO  is the  default  meaning
                 both data  areas must  have the  identical attributes.

                 *YES  means  that it  is  valid to  map  between *CHAR
                 type data  areas of  different  lengths or  *DEC  type
                 data  areas of  different  lengths/decimal  positions.
                 It is invalid to map between *CHAR and *DEC types.

Restrictions
------------

  **   A *DEC  type data area cannot exceed 15  digits.  the data areas
       must be the same type and length.

  **   *DDM type data areas are not supported.

Prerequisites
-------------

The following TAA Tools must be on your system:

     RTVDTAARAD      Retrieve data area description
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CPYDTAARA     *CMD                   TAAARAG       QATTCMD
   TAAARAGC      *PGM       CLP         TAAARAGC      QATTCL