TAA Tools
DLTJOBSPLF      DELETE JOB'S SPOOLED FILES             TAASPND

The Delete Job's  Spooled Files command  deletes the spooled  files for
a  specified job.   The major intent  of the command  is to be  used in
batch  where spooled files  may be created  that are not  needed if the
job ends normally.   If a  user has multiple  interactive jobs and  one
creates excess spooled files, DLTJOBSPLF may be used to cleanup.

A typical command would be:

            DLTJOBSPLF

This  would  delete  any  spooled  files  for the  current  job.    The
completion  message will  state  the number  of spooled  files deleted.
If no spooled files exist, the command completes normally.

If a  job is  named that  the  user is  not the  owner of,  *JOBCTL  or
*SPLCTL special authority is required.

If a fully  qualified job name is  specified, no check is  made for the
status  of the  job unless no  spooled files  were found.   This allows
the CHGJOB SPLFACN attribute *DETACH  to be used along with  DLTJOBSPLF
from a different  job.  However, if  no spooled files exist,  the fully
qualified job  is checked for and  an escape message will  occur if the
job does not exist.

DLTJOBSPLF escape messages you can monitor for
----------------------------------------------

      TAA9891    No jobs exist for the specified job
      TAA9892    Duplicate job names exist
      TAA9893    Unable to delete one or more spooled files
      TAA9894    No spooled files exist and the job does not exist

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

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

   JOB           The  qualified job  name of  the job  with the spooled
                 files to  be deleted.   The default  is * meaning  the
                 current job.

                 If  multiple  jobs exist  for  the  same  job name,  a
                 fully qualified job name must be entered.

                 If  a fully qualified job name  is specified, no check
                 is made for  the status of the  job unless no  spooled
                 files  were found.   This  allows  the CHGJOB  SPLFACN
                 attribute  *DETACH to  be  used along  with DLTJOBSPLF
                 from a different  job.  However,  if no spooled  files
                 exist, the  fully qualified job  is checked for  and a
                 TAA9894 escape  message will be  sent if the  job does
                 not exist.

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

If  a specific job is named that the  user is not the owner of, *JOBCTL
special authority is required.

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

The following TAA Tools must be on your system:

     CVTWRKSPLF      Convert WRKSPLF
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBSTS       Retrieve job status
     RTVSPCAUT       Retrieve special authorities
     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
   ------        ----    ---------      ----------    ----------

   DLTJOBSPLF    *CMD                   TAASPND       QATTCMD
   TAASPNDC      *PGM       CLP         TAASPNDC      QATTCL
					

Added to TAA Productivity tools December 15, 2002


Home Page Up to Top