The Work Job 2 command is a more powerful version of the system
WRKJOB command. Both commands display the 'Work with Job' menu if
only a single job exists. Both commands display a subfile if
multiple jobs exist. WRKJOB2 supports options for WRKJOB and DSPJOB
OUTPUT(*PRINT) and all of the detail options available on the WRKJOB
menu. When the option completes, the subfile is re-displayed.
WRKJOB2 also allows options for all jobs, all users, job status, and
job type.
To request a job other than the for the current user, the user must
have *JOBCTL authority.
A typical command would be:
WRKJOB2 JOB(xxx)
If only a single job exists for the qualified job name, the 'Work
with Job' menu appears.
If multiple jobs exist for the same qualified job name, a subfile
display appears and options exist to use WRKJOB or DSPJOB
OUTPUT(*PRINT) or directly access the detail options of the WRKJOB
display. When the option is complete, the subfile is displayed
again.
Command selection options exist for:
** Job name (or generic name) or *CURRENT or all jobs.
** User name (or generic name) or *CURRENT or all users.
** Job type (such as *INTER) may be specified to display only the
interactive jobs.
** Job status (such as *JOBQ) may be specified to display only
those jobs on the job queue.
An option exists to determine what should occur if no jobs exist to
meet the criteria specified. The default is to send an escape
message. You may specify that the user should see the subfile
display with an appropriate message stating that no jobs exist.
Differences with DSPJOB2
------------------------
WRKJOB2 differs from the DSPJOB2 command in that options exist to
cause changes such as changing spooled files or ending jobs that have
locks.
WRKJOB2 escape messages you can monitor for
--------------------------------------------
TAA9895 No jobs exist (Optional based on ESCAPE parm)
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
JOB The qualified job name of the job to be worked with.
The default is for all jobs for the current user.
This differs from the WRKJOB default of a display of
the current job.
The default for the JOB name portion is *ALL. A
specific job name, a generic name, or *CURRENT may
be specified.
The default for the USER portion is *CURRENT. A
specific user name, a generic name, or *ALL may be
specified.
The default for the job number portion is *ALL. A
specific number may be entered.
STATUS The status of the job to be displayed. The default
is *ALL for jobs in any status.
*ACTIVE, *JOBQ, or *OUTQ may be specified to select
only those jobs that have the same status.
TYPE The type of the job to be displayed. The default is
*ALL for any type of job to be displayed.
*AUTO, *BATCH, *INTER, *SBS, *SPLRDR, *SPLWTR, *SYS,
or *SCPF may be specified to select only those jobs
that have the same type.
ESCAPE Whether to send an escape message if no jobs exist
for the qualified job name, status, and type. The
default is *YES which means the TAA9895 escape
message would be sent.
*NO may be specified to cause the subfile to be
displayed with an appropriate message.
Restrictions
------------
There are differences between WRKJOB and WRKJOB2 when the subfile is
displayed. WRKJOB2 does not show all of the detail job types
supported by WRKJOB nor some of the details of the Status field.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKJOBCTL Check job control
CVTDAT Convert date program
FILEFDBCK File feedback
SNDESCMSG Send escape message
UNADOPT Unadopt
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
WRKJOB2 *CMD TAAJOCR QATTCMD
TAAJOCRC *PGM CLP TAAJOCRC QATTCL
TAAJOCRC2 *PGM CLP TAAJOCRC2 QATTCL
TAAJOCRR *PGM RPG TAAJOCRR QATTRPG
TAAJOCRD *FILE DSPF TAAJOCRD QATTDDS
|
