The Work Submitted Jobs 2 command is a subset of the system WRKSBMJOB
command. WRKSBMJOB2 is designed to be run from a user menu where the
end user should be given some, but not all of the options offered by
WRKSBMJOB. Command parameters allow selection of the valid end user
options.
The following choices exist:
** Whether the '4 = End' option should appear. If so, should the
user be able to end an Active job or only a job on the job
queue.
** Whether the '3 = Hold' and '6 = Release' options should
appear. If so, should the user be able to hold and release an
Active job or only a job on the job queue.
** Whether the '8 = Spooled file' option should appear. If so,
should the user be able to 'Work with Spooled files' (allowing
change and deletion), 'Display spooled files' (display only),
or use the TAA Tool DSPALLSPLF. If DSPALLSPLF is selected,
other options may be made for this command such as whether the
user can select PRTPAGRNG.
** Whether the '2 = Change to Job Queue' option should appear.
This is the only CHGJOB option supported. It allows the user
to move a job from one job queue to the job queue specified on
WRKSBMJOB2. This technique can be used to allow the end user
to schedule jobs to be run.
The user is always provided with the '5 = Display' option. This
provides a 'basic' screen of job status information. F6 is available
for access to the DSPJOB menu.
A typical command would be:
WRKSBMJOB2
Since the defaults are taken, the user would see the following
options:
5 = Display
8 = WRKSPLF option
A command parameter allows an option to send an escape message if no
submitted jobs exist to be displayed. This is intended to allow a
menu user to see a message on the menu rather than seeing an empty
subfile with a message.
WRKSBMJOB2 escape messages you can monitor for
----------------------------------------------
TAA9895 No submitted jobs exist (Option based on ESCAPE parm)
Escape messages from based on functions will be re-sent.
What occurs if no spooled files exist?
--------------------------------------
If the job is still on the job queue, a message will appear on the
WRKSBMJOB2 display informing the user that no spooled files can
exist.
If the job has completed and has no spooled files, it would not
appear on the WRKSBMJOB2 display. It is possible that the job will
complete while the user is viewing the display and then selects the
option to display the spooled files. A message will appear
If the job is completed and has a status of OUTQ, by spooled files
exist and will be displayed based on the SPLCMD parameter.
If the job is active, but has no spooled files, the following will
occur based on the SPLCMD parameter:
** If WRKSPLF or DSPSPLF is specified, the user will see the
system display with an appropriate message.
** If DSPALLSPLF is specified, the user will see an appropriate
message on the WRKSBMJOB2 display.
Command parameters *CMD
------------------
SBMFROM The default is *USER meaning any jobs submitted by
the current user.
*JOB may be specified to mean any jobs submitted by
the current job.
JOBSTS The type of job status to display. The default is
*ALL for jobs in any status.
*ACTIVE may be specified to display just the active
jobs.
*JOBQ may be specified to display just the jobs on
job queues.
*OUTQ may be specified to display just the jobs on
output queues.
CHGJOBQ Whether to allow the '2 = Change to a Job Queue'
option. The default is *NONE which means the Option
will not exist.
A specific Job Queue name may be entered to allow
the user to move a job to that queue. If a library
qualifier is not used, it defaults to *LIBL. The
intent is that the user would be in control over
when jobs were transferred to a 'Hot Job Queue'.
Note that there is only a single job queue name
which can be entered. Therefore, once a job is
moved to the named job queue, it cannot be moved
back to the original job queue. The job queue name
used on the command appears at the bottom of the
display.
ALWHLDJOB Whether to allow the '3 = Hold' and '6 = Release'
options for jobs. The default is *NONE, meaning the
option will not exist.
*ALL may be entered to allow the user to Hold or
Release a job that is either active or on a job
queue.
*JOBQ may be entered so it is only valid for the
user to hold a job that is on a job queue.
ALWENDJOB Whether to allow the '4 = End job' option. The
default is *NONE, meaning the option will not exist.
*ALL may be entered to allow the user to End a job
that is either active or on a job queue.
*JOBQ may be entered so it is only valid for the
user to end a job that is on a job queue.
SPLCMD Whether to allow the user to use 8 option to access
spooled files. The default is WRKSPLF meaning the
WRKSPLF display would be displayed for the spooled
files of the job. This allows users to change or
delete the spooled files for a job.
DSPSPLF may be entered to allow the user to only
display the spooled files for the job.
DSPALLSPLF may be entered to cause the TAA Tool
DSPALLSPLF to be used. Several other WRKSBMJOB2
command parameters are only meaningful if DSPALLSPLF
is specified. See the DSPALLSPLF command for a
complete description of the options.
*NONE may be be entered meaning the option will not
exist.
ALWJOBLOG Whether to allow job logs to be displayed if
SPLCMD(DSPALLSPLF) is specified. *YES is the
default allowing files named QPJOBLOG, QSRVDMP, and
QPPGMDMP to be displayed.
*NO may be specified to prevent the display of these
spooled files.
If *NO is specified and a job has only a job log,
the job appears on the WRKSBMJOB2 display with an
indication of *OUTQ, but when Option 8 is used, no
spooled files will display.
ALWSNDSPLF Whether to allow the '1 = Send net spooled file'
option. This parameter is ignored unless
SPLCMD(DSPALLSPLF) is used. *YES is the default
which causes the option for SNDNETSPLF to appear on
the subfile display.
*NO may be specified to eliminate the option being
displayed or entered.
CHGOUTQ Whether to allow the '2 = Change to OUTQ' option.
This parameter is ignored unless SPLCMD(DSPALLSPLF)
is used. The default is *NONE in which case Option
2 will not exist on the DSPALLSPLF display.
A qualified name of the output queue may be entered.
If the library name is left blank, *LIBL is assumed.
ALWHLDSPLF Whether to allow an option for HLD/RLS of spooled
files. This parameter is ignored unless
SPLCMD(DSPALLSPLF) is used. *YES is the default
which causes options for HLDSPLF and RLSSPLF to
appear on the subfile display.
*NO may be specified to eliminate the options being
displayed or entered.
ALWPRTSPC Whether to allow an option for the TAA Tool
DSPPRTSPC. This parameter is ignored unless
SPLCMD(DSPALLSPLF) is used. *YES is the default
which causes the option to appear on the DSPALLSPLF
display.
DSPPRTSPC displays the spooled file data with blank
lines included as well as skipping information.
*NO may be specified in which case the option will
not exist on the DSPALLSPLF display.
ALWPAGRNG Whether to allow an option for the TAA Tool
PRTPAGRNG. This parameter is ignored unless
SPLCMD(DSPALLSPLF) is used. *YES is the default
which allows the option to appear on the subfile
display so the user can prompt for PRTPAGRNG.
PRTPAGRNG allows the re-printing of a spooled file
with a range of pages.
*NO may be specified in which the option will not
exist on the DSPALLSPLF display.
ESCAPE Whether to send an escape message if no submitted
jobs exist for the current user. The default is *NO
which means the user will see a message on the
WRKSBMJOB2 display describing the condition.
*YES may be specified to cause the escape message
TAA9895 to be sent. This is intended to allow a
menu user to see a message on the menu rather than
seeing an empty subfile with a message.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CHKOBJ3 Check object 3
CVTDTS Convert date/time stamp
DSPALLSPLF Display all spooled files
FILEFDBCK File feedback
HLRMVMSG HLL Remove message
RPGSTSDS RPG status data structure
RTVJOBSTS Retrieve job status
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
WRKSBMJOB2 *CMD TAAJOCT QATTCMD
TAAJOCTC *PGM CLP TAAJOCTC QATTCL
TAAJOCTC2 *PGM CLP TAAJOCTC2 QATTCL
TAAJOCTR *PGM RPG TAAJOCTR QATTRPG
TAAJOCTD *FILE DSPF TAAJOCTD QATTDDS
|
