The End Interactive  Jobs command ends  all interactive jobs.   Various
selection criteria  can be made as  well as a list of  omit devices and
users  (see the  Omit list  discussion).   The command  may be  used in
conjunction with  the SNDINTMSG command  which can  inform users a  few
minutes before ending their jobs.

You must have *JOBCTL special authority to use ENDINTJOB.

The command has no parameters and would be entered as:

             ENDINTJOB

All  interactive jobs would  be ended  except the  current job  and any
jobs  found on the  omit lists of  devices and users.   The current job
may be  a batch  job (the  function is  not  restricted to  interactive
use).  The ENDJOB command is specified as OPTION(*IMMED).

The job  running ENDINTJOB  is not  included in  any of the  completion
message counts.

By  default, the jobs  that will  be ended are  checked to see  if they
hold or are waiting  for record locks.   You may  also print a  listing
of the record locks they hold.

Considerations
--------------

If multiple jobs  exist at the same  device, an ENDJOB command  is used
for each job  that should be ended.  If group  jobs or a system request
job  (for the  same user)  exist, all  jobs will  be ended  or retained
depending on the  omit list.   If the user has  two jobs active  at the
same  device  with different  user  profiles,  each  job is  considered
separately.

Certain  devices allow a  'jump' key  to jump to  a different  job.  If
the device causes  a separate job  name to be  established, it will  be
considered to be a separate device.

Omit list
---------

Two data  areas exist in  TAASECURE that can  contain up to  45 entries
each  of devices and  users that should  be omitted from  the jobs that
will be ended.   These are  the same data  areas that  are used by  the
SNDINTMSG command.

The data areas can only  be maintained by an *ALLOBJ user  and exist in
TAASECURE.

            INTJOBDEV    - List of omitted device names
            INTJOBUSR    - List of omitted user names

An *ALLOBJ user would maintain the device list by entering:

            EDTCONARR    DTAARA(TAASECURE/INTJOBDEV)

Enter  names of  devices  (workstations) that  should not  be  ended by
ENDINTJOB.

Note  that  client access  device  names are  dynamically  assigned and
cannot be effectively omitted.

ENDINTJOB escape messages you can monitor for
---------------------------------------------

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

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

   SBS           The subsystem to  end jobs in.   The default is  *ALL.
                 If a  specific subsystem is  named, only jobs  in that
                 subsystem will be considered.

   DEV           The  device name (Job  name) for the  jobs that should
                 be ended.    The  default  is *ALL.    A  specific  or
                 generic name may also be entered.

   USER          The  user name  for  the jobs  that  should be  ended.
                 The default  is *ALL.  A specific  or generic name may
                 also be entered.

   TEST          Whether this is a  test of the function.   *NO is  the
                 default meaning that  jobs may be ended by  the ENDJOB
                 command.

                 *YES  may  be  specified  when testing  the  function.
                 Messages  will be sent to the  job log for each device
                 that would have been ended.

   CHKRCDLCK     Whether to check for  record locks held or  waiting in
                 a job to  be ended.  *YES is  the default which causes
                 a  check and an indication by  job if any record locks
                 are held.    If a  job  is  holding record  locks,  it
                 either indicates  a poor  programming practice  or the
                 user is actively processing.

                 *PRT  may be  specified to  use the  DSPRCDLCK2 *PRINT
                 function to print a listing  if any jobs are found  to
                 hold or be waiting on a record lock.

                 *NO may  be specified to  not check for  record locks.

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

See the previous comments.

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

The following TAA Tools must be on your system:

     CHKJOBCTL       Check *JOBCTL special authority
     CVTWRKACT       Convert work active
     DSPRCDLCK2      Display record locks 2
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBSTS       Retrieve job status
     RTVRCDLCK2      Retrieve record locks 2
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDINTMSG       Send interactive jobs a message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   ENDINTJOB     *CMD                   TAAJODA       QATTCMD
   TAAJODAC      *PGM       CLP         TAAJODAC      QATTCL