TAA Tools
ENDSBS3        END SUBSYSTEM 3                    TAAJODX

The End Subsystem 3 command will quiesce a system, but not take the
system completely to restricted state. All subsystems will be ended,
except:  QCMN, QHTTPSVR, QSERVER, QSPL, QSYSWRK, QUSRWRK, TAAUPSMON,
the controlling subsystem, and those specified in the OMIT parameter.

Users can always explicitly end any of these subsystems on their own.

An omit list and options on how jobs are ended may be specified. No
new jobs or routing steps are started in the subsystems after this
command is run.

Distinction between ENDSBS(*ALL) and ENDSBS3
--------------------------------------------

There is an important distinction between ENDSBS(*ALL) and ENDSBS3.

  ENDSBS(*ALL) will end all system jobs, including those in the
  current SBS, putting the system into a restricted state.

  ENDSBS3 will end all subsystems with user type work.  Hence, all
  subsystems will be ended, except:  QCMN, QHTTPSVR, QSERVER, QSPL,
  QUSRWRK, the controlling subsystem, and those specified in the OMIT
  parameter. System type jobs will be left running.

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

Omit List  (OMIT)
  The list of subsystems to avoid ending.
  The default is *NONE.  Up to 15 subsystems may be specified.

How To End (OPTION)
  Specifies whether the jobs in the subsystem end in a controlled
  manner (ending jobs in a controlled manner lets the application
  programs perform end-of-job processing) or immediately.
  The default is *CNTRLD.

  Values:
    *CNTRLD means the jobs are ended in a controlled manner.  This
    allows the programs that are running to perform cleanup (end of job
     processing). See ENDSBS documentation for further explanation.

    *IMMED means that the jobs are ended immediately.
    The programs are not allowed to perform any cleanup.  See ENDSBS
    command documentation for further explanation.
    Note:  The *IMMED value might cause undesirable results if data has
    been partially updated.  This value should be used only after a
    controlled end has been attempted unsuccessfully.

Delay Time  (DELAY)
  Specifies the amount of time (in seconds) that is allowed to complete
  the controlled subsystem end operation.  If this amount of time is
  exceeded and the end operation is not complete, any jobs still being
  processed in the subsystem are ended immediately.

  Values:
    *NOLIMIT indicates the amount of time in which to complete a
    controlled end is not limited.

    0-99999 Specifies the number of seconds in which the end operation
    is allowed to complete.

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

  *JOBCTL special authority is required.

  Will end up to 100 SBS, or whatever the reciever variable of the
  QWDRSBSD API can retrieve for consideration.

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

  The following TAA Tools must be on your system:

     RTVSYSVAL       Retrieve System Value
     SNDESCINF       Send escape information

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

  None, the tool is ready to use.

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

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------
   ENDSBS3       *CMD                   TAAJODX       QATTCMD
   TAAJODXC      *PGM       CLP         TAAJODXC      QATTCL
   TAAJODXR      *PGM       RPGLE       TAAJODXR      QATTRPG
					

Added to TAA Productivity tools October 15, 2017


Home Page Up to Top