The Display Job 2 command is a more powerful version of the system
DSPJOB command. Both commands display the 'Display Job' menu if only
a single job exists. Both commands display a subfile if multiple
jobs exist. DSPJOB2 supports options for DSPJOB and DSPJOB
OUTPUT(*PRINT) and all of the detail options available on the DSPJOB
menu. When the option completes, the subfile is re-displayed.
DSPJOB2 also allows options for all jobs, all users, job status, and
job type.
To request a job other than the current job, the user must have
*JOBCTL authority.
A typical command would be:
DSPJOB2 JOB(xxx)
If only a single job exists for the qualified job name, the 'Display
Job' menu appears.
If multiple jobs exist for the same qualified job name, a subfile
display appears and options exist to use DSPJOB or DSPJOB
OUTPUT(*PRINT) or directly access the detail options of the DSPJOB
display. When the option is complete, the subfile is displayed
again.
Command selection options exist for:
** Job name for *CURRENT or all jobs.
** User name for *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 WRKJOB2
------------------------
DSPJOB2 differs from the WRKJOB2 command in that no options exist to
cause changes such as changing spooled files or ending jobs that have
locks.
DSPJOB2 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 or *CURRENT may be specified.
The default for the USER portion is *CURRENT. A
specific user 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 DSPJOB and DSPJOB2 when the subfile is
displayed. DSPJOB2 does not show all of the detail job types
supported by DSPJOB 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
TAAEXC TAA Execute command
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPJOB2 *CMD TAAJOCS QATTCMD
TAAJOCSC *PGM CLP TAAJOCSC QATTCL
TAAJOCSC2 *PGM CLP TAAJOCSC2 QATTCL
TAAJOCSR *PGM RPG TAAJOCSR QATTRPG
TAAJOCSD *FILE DSPF TAAJOCSD QATTDDS
|
