TAA Tools
CVTJOBSPLF      CONVERT JOB SPOOLED FILES              TAASPNV

The Convert Job  Spooled Files command converts existing  spooled files
for  a specified job  to an outfile.   The  WRKSPLFP data base  file is
written  with  one record  for each  spooled file.    This is  the same
format as  used  by  CVTWRKSPLF.   CVTJOBSPLF  provides  a  performance
advantage over  CVTWRKSPLF when  the spooled files  for a  specific job
are needed.

The model file is TAASPLHP with a format name of SFREC.

You  must have *JOBCTL  special authority  to use CVTJOBSPLF  for a job
other than your own.

Any spooled files in a FIN (finished) status are never output.

The job's SPLFACN parameter value must be *KEEP.

A specific file name such as QPJOBLOG may be specified.

A typical command would be:

             CVTJOBSPLF JOB(*) OUTLIB(QTEMP)

All  spooled  files  for  the  current  job  that  are  not  in  a  FIN
(finished) state would be output.

A specific  job name  may be  entered without  either the  user or  job
number or both such as:

             CVTJOBSPLF JOB(ABC) OUTLIB(QTEMP)

If either  the user or job  number are entered as  blanks, *ALL will be
used and the  job will  attempt to be  identified.   If duplicate  jobs
exist, an escape message will be sent.

If the job does not exist, an escape message will be sent.

If the job exists, but  no spooled files exist (or match  the file name
specified),  the  WRKSPLFP file  will  contain 0  records.   No  escape
message occurs.

CVTJOBSPLF escape messages you can monitor for
----------------------------------------------

      TAA9891    Duplicate jobs exist for the specified job
      TAA9892    No jobs exist for the specified job.

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

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

   JOB           The  qualified  name  of  the  job  to  output spooled
                 files for.  The default is * for the current job.

                 If * (current  job) is not  specified, at least a  job
                 name  must be  entered.   If  either the  user or  job
                 number  portion of  the parameter  are blank,  *ALL is
                 assumed when attempting to identify the job.

   FILE          The file name  to be converted.   The default is  *ALL
                 for all spooled  file names.  A  specific spooled file
                 name such as QPJOBLOG may be entered.

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

   OUTMBR        The member  of  the WRKSPLFP  file to  be  used.   The
                 default  is WRKSPLFP.   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
------------

You  must have *JOBCTL  special authority  to use CVTJOBSPLF  for a job
other than your own.

The job's SPLFACN parameter value must be *KEEP.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RTVJOBSTS       Retrieve job status
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CVTJOBSPLF    *CMD                   TAASPNV       QATTCMD
   TAASPNVC      *PGM       CLP         TAASPNVC      QATTCL
   TAASPNVR      *PGM       RPG         TAASPNVR      QATTRPG

Note that the outfile WRKSPLFP is part of the CVTWRKSPLF tool.
					

Added to TAA Productivity tools April 15, 2005


Home Page Up to Top