TAA Tools
WRKSBMJOB2      WORK SUBMITTED JOBS 2                  TAAJOCT

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
					

Added to TAA Productivity tools November 15, 1999


Home Page Up to Top