The  CVTWRKUSR command  creates  a  data  base file  WRKUSRP  with  one
record  per job.   The command  functions as  if there were  an OUTFILE
parameter   on  WRKUSRJOB.    This   allows  you  to  automate  several
functions involving jobs.

A typical command would be:

   CVTWRKUSR     OUTLIB(QTEMP)

The command creates a file  named WRKUSRP in QTEMP with one  record for
each job.   The model  file used is  TAAJOBIP in TAATOOL with  a format
name of UJRCD.

You can then read the file in a CL or other HLL program.

If  you request  USER(*ALL)  or a  user other  than yourself,  you must
have *JOBCTL special authority.

The information is accessed using the QUSRJOBI API.

CVTWRKUSR escape messages you can monitor for
---------------------------------------------

      TAA9891    No jobs to convert

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

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

   USER          The user's jobs  you want  output.  This  is the  same
                 parameter as on  WRKUSRJOB.  The default  is * meaning
                 the  current  job.   *ALL  may  be  specified for  all
                 users or a name of a specific user.

                 If  you  request  USER(*ALL)  or  a  user  other  than
                 yourself, you must have *JOBCTL special authority.

   STATUS        The status of the  jobs you want output.   This is the
                 same  parameter  as  on  WRKUSRJOB.   The  default  is
                 *ALL.   You may also  specify *ACTIVE, *JOBQ or *OUTQ.

   JOBTYPE       The job type to  convert.  * is the default  and means
                 all   jobs.      The   other  supported   values   are
                 A=Autostart,    B=Batch,   I=Interactive,   M=Monitor,
                 R=Spool  reader,  S=System   job,  X=Start  CPF,   and
                 W=Spool writer.

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

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

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

File format
-----------

The file name that is output is WRKUSRP.

The model file used is TAAJOBIP with a format name of UJRCD.

To see the field names used:

       DSPFMT    TAAJOBIP

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

None.

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

The following TAA Tools must be on your system:

      CRTUSRSPC     Create user space
      EDTVAR        Edit variable
      RTVUSRSPCI    Retrieve user space initialization
      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
   ------        -----      ---------      ----------     -----------

   CVTWRKUSR     *CMD                      TAAJOBI        QATTCMD
   TAAJOBIP      *FILE         PF          TAAJOBIP       QATTDDS
   TAAJOBIC      *PGM          CLP         TAAJOBIC       QATTCL
   TAAJOBIR      *PGM          RPG         TAAJOBIR       QATTRPG