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

Powered by AS/400Powered by AS/400 Last modified on January 12, 2010 © 1995, 2010 - Jim Sloan, Inc.