TAA Tools
CHGJOBQJOB      CHANGE JOB QUEUE JOBS                  TAAJOCY

The Change Job  Queue Jobs command  allows changes to one,  generic, or
all jobs  in a job  queue.  The jobs  may be held,  released, or ended.
In  addition, some parameters from CHGJOB  are also valid such as JOBQ,
RUNPTY, OUTPTY, OUTQ, etc.  *JOBCTL special authority is required.

A typical command to  hold all jobs in  a job queue beginning with  the
name WRK:

          CHGJOBQJOB    JOBQ(xxx) JOB(WRK*) STATUS(*HLD)

A  typical command  to change  all  jobs beginning  with PAY  in a  job
queue to the job queue NIGHT:

          CHGJOBQJOB    JOBQ(xxx) JOB(PAY*) TOJOBQ(NIGHT)

A  typical command  to change  all jobs  in a  job queue  to RUNPTY(32)
would be:

          CHGJOBQJOB    JOBQ(xxx) RUNPTY(32)

If a STATUS(*HLD) is specified and  the job is already held, an  escape
message will occur at the end of the command.

If a  STATUS(*RLS) is  specified and  the job  is already released,  an
escape message will occur at the end of the command.

If all  of the parameters are specified  as *SAME, a completion message
occurs stating that no changes occurred.

If one of  the CHGJOB  type parameters  is specified  (such as  TOJOBQ)
and specifies  the current  value for  the job, the  job is  considered
changed.   For example, if  TOJOBQ(NIGHTQ) is specified and  the job is
already on the NIGHT job queue, the job is considered changed.

CHGJOBQJOB escape messages you can monitor for
----------------------------------------------

      TAA9895    No jobs on job queue or no job by job parm name.
      TAA9896    Some errors occurred - See previous messages

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   JOBQ          The  qualified name  of the  job queue  where the jobs
                 exist.     The  library   value  defaults  to   *LIBL.
                 *CURLIB may also be used.

   JOB           The job name  to be changed.  The  default is *ALL for
                 all  jobs on the job queue.   A specific job name or a
                 generic job name may be entered.

   STATUS        The status the  job should  be set to.   For  example,
                 the job  may be in a  'released' status waiting  to be
                 run  and  you  want to  set  it  to  a 'hold'  status.
                 *SAME is  the  default meaning  whatever  the  current
                 status is.

                 *HLD may be specified  to hold the job.   The job must
                 be in a 'release' status.

                 *RLS  may be specified  to release  the job.   The job
                 must be in a 'hold' status.

                 *END  may be specified to end the  job.  The may be in
                 either a 'release' or 'hold' status.

   SEQ           How to  sequence  the jobs  when they  are  processed.
                 The default  is *API meaning  the data appears  in the
                 sequence as extracted from the API.

                 *WRKJOBQ  may be  specified to duplicate  the sequence
                 of the  jobs  as they  appear  on the  system  WRKJOBQ
                 display.   In  most  situations this  will  be a  100%
                 match.    See  the discussion  of  sequencing  for the
                 CVTJOBQ command.

   TOJOBQ        The qualified  name  of  the  job  queue  to  be  used
                 instead of  the  current job  queue.   The default  is
                 *SAME meaning  the job's current job queue.   *LIBL or
                 *CURLIB  or  a specific  library may  be used  for the
                 qualified name.

   JOBPTY        The job  priority  of the  job  (priority on  the  job
                 queue).    *SAME  is  the default  meaning  the  job's
                 current  job queue priority.  A  value between 1 and 9
                 may be  entered  (1 is  the  highest priority).    The
                 value is  restricted by  the PTYLMT  parameter of  the
                 user profile.

   OUTPTY        The  output  priority  of  the  job  (priority on  the
                 output queue).    *SAME  is the  default  meaning  the
                 job's  current  output   queue  priority.     A  value
                 between  1 and  9  may be  entered (1  is  the highest
                 priority).    The value  is  restricted by  the PTYLMT
                 parameter of the user profile.

   OUTQ          The qualified  name of  the  output queue  to be  used
                 for the job.   *SAME is the default  meaning the job's
                 current   output  queue.    *LIBL   or  *CURLIB  or  a
                 specific library may be  used for the qualified  name.

   RUNPTY        The run  priority of  the job.   *SAME is  the default
                 meaning  the  job's  current run  priority.    A value
                 from 1  to  99  may  be  entered  (1  is  the  highest
                 priority).

   PRTTXT        The 'Print Text'  for the job  that will print  at the
                 bottom of  any printed output.   *SAME is  the default
                 meaning  the job's current 'Print  Text'.  A string of
                 up to 30 bytes may be entered.

   LOG           The Message  Logging of  the job.   This is  a 3  part
                 parameter that  is the same  as on CHGJOB.   The parts
                 are:

                 Level.    The  default  is  *SAME  meaning  the  job's
                 current message level.  0-4 may be entered.

                 Severity.   The default  is  *SAME meaning  the  job's
                 current message severity.  00-99 may be entered.

                 Text.    The  default  is   *SAME  meaning  the  job's
                 current  message   text  value.    *MSG,  *SEVLVL,  or
                 *NOLIST may be entered.

   INQMSGRPY     The Inquiry Message  Reply for the  job.  The  default
                 is *SAME  meaning  the job's  current Inquiry  Message
                 Reply  value.     *RQD,  *DFT,  or   *SYSRPYL  may  be
                 entered.

   DATE          The  job  date  for  the  job.    The  date  should be
                 entered in job format.

   SCDDATE       The date  the  job  should  be scheduled.    The  date
                 should be entered in job format.

   SCDTIME       The  time  the job  should  be  scheduled.   The  time
                 should be entered in hhmmss format.

Restrictions
------------

*JOBCTL special authority is required.

The  priority  values  cannot  be changed  to  a  better  priority than
exists in the user profile.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKJOBCTL       Check *JOBCTL special authority
     CHKOBJ3         Check object 3
     CVTJOBQ         Convert job queue
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CHGJOBQJOB    *CMD                   TAAJOCY       QATTCMD
   TAAJOCYC      *PGM       CLP         TAAJOCYC      QATTCL
					

Added to TAA Productivity tools December 15, 2000


Home Page Up to Top