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
|