The Display Subsystem Jobs command provides a display that is similar
to that provided by the system WRKSBSJOB command except that only a
single subsystem may be displayed and the user cannot perform actions
against the jobs. An option exists to allow a display of any spooled
files associated with the job. DSPSBSJOB may be helpful if you have
a menu oriented system and want to prevent users from changing,
holding, or ending active jobs.
The intent of the command is that it would be used in place of
WRKSBSJOB as an option on a user menu. It allows a user to see what
other jobs exist in the subsystem. No command line exists. However,
if the spooled file option is specified, a command line does exist on
the system spooled file display.
A typical command would be:
DSPSBSJOB SBS(QBATCH)
This displays the jobs that are active in the QBATCH subsystem. The
display that appears is similar to that provided by WRKSBSJOB, but
would only allow the option to display more details about the job or
to work with the spooled files of the job. The subsystem monitor job
is not shown.
If multiple jobs exist at the same device, a plus symbol is shown to
the left of the job name similar to WRKACTJOB. F14 may be used to
expand the display to show these jobs as well as system jobs.
The SPLF parameter allows control of whether the user will be allowed
to see any spooled files of a job, just display the spooled files, or
have the full capability of WRKJOB OPTION(*SPLF).
Access to spooled files requires the user to be the owner of the
spooled file or have *JOBCTL special authority. DSPSBSJOB does not
adopt a profile during the processing of spooled files.
The APIs used include:
- QUSCRTUS
- QUSLJOB
- QUSRTVUS
- QUSRJOBI
Security considerations
-----------------------
In order to retrieve the information about jobs that are not the
users own, the TAAJOEC2 program is used. This adopts the QSECOFR
profile while job information is being retrieved to allow for *JOBCTL
special authority. This provides the user with more authority than
he would receive from WRKSBSJOB in terms of displaying information
about a job. If you feel this is too much information, make the
DSPSBSJOB command private.
If the SPLF option is *DSP or *WRK, the user can only display or work
with his own spooled files.
Command parameters *CMD
------------------
SBS The subsystem to be displayed. The subsystem
description must be entered. The default is QBATCH.
A qualified name may be used. The library defaults
to *LIBL. *CURLIB may be used.
SPLF Whether to allow the user to display or work with
the spooled files of the jobs.
To operate on a spooled file requires the user to be
the owner of the spooled file or have *JOBCTL
special authority. DSPSBSJOB does not adopt a
profile during the processing of spooled files.
The default is *WRK which causes the function of
WRKJOB JOB(xxx) OPTION(*SPLF) to be used. The user
would have full control to display, change, or
delete the spooled files in addition to being able
to respond to spool messages.
*DSP may be specified to cause the function of
DSPJOB JOB(xxx) OPTION(*SPLF) to be used. The user
can only display the spooled files associated with
the job.
*NONE may be specified to prevent the user from any
access to the spooled files of the job.
Restrictions
------------
A maximum of 3000 jobs can be displayed. If the limit is exceeded, a
message appears on the first display informing the user that not all
jobs are shown.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTDTS Convert date/time in *DTS format
FILEFDBCK File feedback
HLRMVMSG HLL Remove message
RTVSBSD Retrieve subsystem description
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPSBSJOB *CMD TAAJOCE QATTCMD
TAAJOCEC *PGM CLP TAAJOCEC QATTRPG
TAAJOCEC2 *PGM CLP TAAJOCEC2 QATTRPG
TAAJOCER *PGM RPG TAAJOCER QATTRPG
TAAJOCED *FILE DSPF TAAJOCED QATTDDS
|
