The  Convert Environment  Variables  command  converts job  and  system
environment  variables to  an  outfile.   The  outfile can  be  used to
verify  current  environment variable  settings,  or to  compare ENVVAR
settings overtime to ensure they remain consistent on the system.

The outfile name defaults  to ENVVARP, but the  name can be changed  to
a user  specified name in  a specific library.   A replace  option also
exists.

A typical command would be:

             CVTENVVAR  OUTLIB(*LIBL) OUTMBR(ENVVARP) REPLACE(*YES)

One  record  would  be  written for  each  environment  variable.   Job
variables would be listed first, followed by system variables.

The CCSID  for  each  variable  is  listed.   This  is  the  CCSID  the
environment variable is  stored in.  If  a CCSID was not  specified for
the environment variable, it defaults to CCSID 37.

CVTENVVAR escape messages you can monitor for
------------------------------------------

CPFA984 - Maximum number of environment variables exist.

CPF9822  -  Not  autorized  to  file  ENVVARP.    You  must  have  *USE
authority to file ENVVARP.

CPF9802 - Not  autorized to  member.   You must  have *OBJOPR,  *OBJMGT
and *DLT authority to replace the data in the member.

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


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

   OUTLIB        Library  for ENVVARP  file.   A  library  name may  be
                 specified or  the default *LIBL  may be used.   If the
                 ENVVARP  file does  not already  exist in  the library
                 list, a library must be specified.

   OUTMBR        Member to receive output.   The member of  the ENVVARP
                 file to  be used.   If the  member does not  exist, it
                 is added.  The default is ENVVARP.

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


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

A  maximum of  approximately  100 environment  variables  of each  type
(*JOB/*SYS) can be converted by the tool.

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

The following TAA Tools must be on your system:

     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVDAT          Retrieve date
     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
   ------        ----    ---------      ----------    ----------

   CVTENVVAR     *CMD                   TAAENVV       QATTCMD
   TAAENVVC      *PGM       CLLE        TAAENVVC      QATTCL
   TAAENVVR      *PGM       RPGLE       TAAENVVR      QATTRPG
   TAAENVVP      *FILE      PF          TAAENVVP      QATTDDS
   TAAENVVHC     *PNLGRP                TAAENVVHC     QATTUIM