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.   *CURRENT  can be  used  to
                 specify the current  user of the requesting job.   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