TAA Tools
CVTDTAARA       CONVERT DATA AREA                      TAAARAO

The Convert  Data Area  command converts  the attributes  and the  data
from one  or more data areas to the  outfile DTAARAV (data area value).
Both  *DEC and *CHAR  data areas are  supported.  The  outfile may then
be queried for consistency or searching for specific values.

The model file  is TAAARAOP  with a format  name of  DTAARAS.  You  can
display the model file with DSPFMT TAAARAOP.

A typical command would be:

             CVTDTAARA    DTAARA(xxx) OUTLIB(QTEMP)

The named Data  Area objects would be converted to  the DTAARAV file in
QTEMP.  There would be one record for each Data Area object.

Decimal fields in the output field DSDATA
-----------------------------------------

CRTDTAARA  supports  a  maximum  decimal  field  of  24  digits with  9
decimal positions.   The decimal  value is converted  to character  and
right aligned  in the  DSDATA field from  1 - 24.   Leading  zeros will
exist.  No decimal notation will exist.

CVTDTAARA escape messages you can monitor for
---------------------------------------------

      TAA9891    No *DTAARA object types in the library.

Escape messages from based on functions will be re-sent.

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

   DTAARA        The  qualified  name of  the  Data Area  object  to be
                 converted.  *ALL is the  default.  A specific name  or
                 a generic name may also be entered.

                 The  library  value  defaults  to  *USRLIBL.    *LIBL,
                 *CURLIB, *ALLUSR, or *ALL may also be used.

                 You  must  have *ALLOBJ  special  authority  to use  a
                 library value of *ALLUSR.

   OUTLIB        The   library  in  which  the  DTAARAV  file  will  be
                 placed.  The  default is *LIBL.   If the DTAARAV  file
                 does not  already exist, a library  must be specified.

   OUTMBR        The  member of the  DTAARAV file to  be used.   If the
                 member does not  exist, it is added.   The default  is
                 DTAARAV.

   REPLACE       A  *YES/*NO value  for whether  the  member should  be
                 cleared before  writing records into it.   The default
                 is *YES.

                 *NO may  be  specified  to  add  records  to  existing
                 data.

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

                 You  must have  *ALLOBJ  special  authority to  use  a
                 library value of *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVDTAARAD      Retrieve Data Area description
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTDTAARAA    *CMD                   TAAARAO       QATTCMD
   TAAARAOC      *PGM       CLP         TAAARAOC      QATTCL
   TAAARAOR      *PGM       RPG         TAAARAOR      QATTRPG
   TAAARAOP      *FILE      PF          TAAARAOP      QATTDDS
					

Added to TAA Productivity tools January 15, 2004


Home Page Up to Top