TAA Tools
ENDSBSJOB       END SUBSYSTEM JOB                      TAAJOEK

The End  Subsystem Job command ends  one or more  jobs from one  or all
subsystems based  on a number of minutes active.   For example, you can
end  all jobs in  a subsystem that  have been active  for more than 640
minutes (8 hours).

You must have *JOBCTL special authority to use ENDSBSJOB.

The current job is never ended.

A typical command would be:

             ENDSBSJOB  SBS(xxx) MINACTIVE(640)

By default,  all  interactive jobs  in the  named  subsystem that  have
been active  for more than 8 hours  (640 minutes) would be  ended.  The
default  OPTION and DLYTIM  are the same  as on ENDJOB  (*CNTRLD and 30
seconds).

ENDSBSJOB escape messages you can monitor for
---------------------------------------------

      TAA9892    No jobs exist for the selection criteria
      TAA9893    ENDJOB failed for one or more jobs

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

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

   SBS           The name of the subsystem to end jobs for.

                 *ALL may be specified for all subsystems.

   JOB           The name of the job  or generic job name to be  ended.

                 *ALL is the default for all jobs.

   JOBTYPE       The type  of job  to be  ended.   *ALL is the  default
                 for all types of jobs.

                 Other entries that may be made are:

                       *BCH     Batch jobs
                       *INT     Interactive jobs
                       *MON     Subsystem monitor jobs
                       *RDR     Reader jobs
                       *SYS     System jobs
                       *WTR     Writer jobs

   USER          The name  of the user of the  job or generic user name
                 of the job to be ended.  The default is *ALL.

   MINACTIVE     The number of  minutes that  the jobs  must be  active
                 before they  are ended.   The  default is 600  minutes
                 (10 hours).

                 For  example,  if  a   job  started  at  8:00  AM  and
                 ENDSBSJOB  was run at  7:00 PM with  the default of 10
                 hours, the  job would  be  ended (the  job was  active
                 for 11  hours).  Any  jobs that started after  9:00 AM
                 would not be ended.

                 System  request jobs are considered  as separate jobs.

                 Group jobs  which are  not active  are not  considered
                 (only the active group job is considered).

                 The current job is never ended.

   OPTION        How to  end the  job.   This value  is passed thru  to
                 the ENDJOB  command.  *CNTRLD is  the default.  *IMMED
                 may be specified.

   DLYTIM        The delay time  if *CNTRLD is  specified.  This  value
                 is passed thru to  the ENDJOB command.  30  seconds is
                 the default.

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

None.

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

The following TAA Tools must be on your system:

     ADDTIM          Add time
     CHKJOBCTL       Check *JOBCTL special authority
     CVTWRKACT       Convert work active
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBSTRA      Retrieve job start attributes
     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
   ------        ----    ---------      ----------    ----------

   ENDSBSJOB     *CMD                   TAAJOEK       QATTCMD
   TAAJOEKC      *PGM       CLP         TAAJOEKC      QATTCL
					

Added to TAA Productivity tools March 26, 2007


Home Page Up to Top