The  Convert   Controller  Description   Virtual  Workstation   command
converts   one,  generic,   or  all   virtual   workstation  controller
descriptions  to  an  outfile.    This  provides  a  simple  method  of
processing the information.  The  outfile name is always CTLVWSP.   The
model file is TAACFGZP with a format name of CTLVWSR.

A typical command would be:

            CVTCTLVWS      CTLD(*ALL) OUTLIB(QTEMP)

Only the  virtual workstation controller descriptions  (type VWS) would
be converted to the CTLVWSP outfile in QTEMP.

CVTCTLVWS escape messages you can monitor for
---------------------------------------------

      TAA9893    No virtual workstation controllers exist

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

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

   CTLD          The  controller   description  to  be  converted.    A
                 single description, a  generic name,  or *ALL for  all
                 virtual  workstation  controller descriptions  may  be
                 entered.   Only  controller  descriptions of  type VWS
                 will be converted.

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

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

   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 any existing
                 data.

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

None.

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

The following TAA Tools must be on your system:

     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVCTLVWS       Retrieve controller local workstation description
     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
   ------        ----    ---------      ----------    ----------

   CVTCTLVWS     *CMD                   TAACFGZ       QATTCMD
   TAACFGZC      *PGM       CLP         TAACFGZC      QATTCL
   TAACFGZR      *PGM       RPG         TAACFGZR      QATTRPG
   TAACFGZP      *FILE      PF          TAACFGZP      QATTDDS