TAA Tools
CHGJOBD2        CHANGE JOB DESCRIPTION 2               TAAJBDN

The Change  Job Description 2  command allows a  change to one  or more
*JOBD object  types.  Not all of the  CHGJOBD parameters are supported.
CHGJOBD2  simplifies making mass changes to  *JOBD objects.  For a more
complete understanding  of  the  parameters, see  the  CHGJOBD  command
help text.   A  *JOBD object owned  by one of  the system  profiles may
not be changed.

You must have *ALLOBJ special authority to use CHGJOBD2.

A typical command would be:

             CHGJOBD2  JOBD(ABC/*ALL) JOBPTY(4)

All  *JOBD objects in library  ABC would be changed  so that the JOBPTY
would be set to 4.   All other values in job description objects  would
remain unchanged.

At  least one  of the  values  to be  changed  must be  other than  the
default of *SAME.

CHGJOBD2 escape messages you can monitor for
--------------------------------------------

      TAA9891    The command failed.  Diagnostic messages will exist
      TAA9892    Not all values to be changed can be *SAME

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

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

   JOBD          The   qualified  name  of  the   *JOBD  object  to  be
                 changed.  A  single job description,  a generic  name,
                 or the special value *ALL may be used.

                 A single library must be specified.

   JOBQ          The  job queue  to submit  a  job to.    *SAME is  the
                 default.

                 If  a  JOBQ is  specified,  a  qualified library  name
                 must be entered.

   JOBPTY        The  job  priority on  the job  queue.   *SAME  is the
                 default.  A value between 1 and 9 may be entered.

   OUTPTY        The  output  queue  priority  on  the   output  queue.
                 *SAME is  the default.   A value  between 1 and  9 may
                 be entered.

   PRTDEV        The  default printer  device associated with  the job.
                 *SAME is the  default.  A  device name or  one of  the
                 special  values *USRPRF,  *SYSVAL, or  *WRKSTN may  be
                 entered.

   OUTQ          The  default  output queue  associated  with  the job.
                 *SAME is the default.

                 If an OUTQ is  specified, a library  name or *LIBL  or
                 *CURLIB must be entered.

   INLLIBL       The initial library  list for the  job.  *SAME  is the
                 default.   Up to 250  libraries may be  entered or the
                 special values *SYSVAL or *NONE.

   LOG           The  logging levels for  the job.   A 3 part parameter
                 may be described.

                 Part 1 is  the logging level.   *SAME is the  default.
                 A value between 0 and 4 may be entered.

                 Part 2 is  the severity of the message.   *SAME is the
                 default.   A  value between 0  and 99  may be entered.
                 *SAME is the default.

                 Part 3 is the  text type of the  message.  One of  the
                 special  values  *MSG,  *SECLVL,  or  *NOLIST  may  be
                 entered.

   LOGCLPGM      Whether  to log the commands  in a CL  program.  *SAME
                 is the default.  A *YES or *NO may be entered.

   LOGOUTPUT     Describes how  the job  log will  be output  when  the
                 job ends.  *SAME  is the default.  The  special values
                 *SYSVAL,   *JOBLOGSVR,  *JOBEND,   or   *PND   may  be
                 entered.

   JOBMSGQMX     Describes  the  size  of the  job  log  message queue.
                 *SAME is  the  default.   A  value  between 2  and  64
                 megabytes  or   the  special  value   *SYSVAL  may  be
                 entered.

   JOBMSGQFL     Describes  the  action if  the job  log  message queue
                 becomes full.   *SAME  is the  default.   The  special
                 values  *SYSVAL, *NOWRAP,  *WRAP, or  *PRTWRAP may  be
                 entered.

   SYNTAX        Describes  the syntax  checking level  to be  done for
                 jobs placed on  a job  queue.  *SAME  is the  default.
                 A value between 0  and 99 or the special  value *NOCHK
                 may be entered.

   ENDSEV        The default  end job severity of  messages received to
                 the  job.   *SAME is the  default.  A  value between 0
                 and 99 may be entered.

   INQMSGRPY     The  default  setting  for  the  handling  of  inquiry
                 messages received  in the job.  *SAME  is the default.
                 One  of  the special  values *RQD,  *DFT,  or *SYSRPYL
                 may be entered.

   DEVRCYACN     The default setting  for the  device recovery  action.
                 *SAME  is the  default.   One  of  the special  values
                 *SYSVAL,   *MSG,  *DSCMSG,  *DSCENDRQS,   *ENDJOB,  or
                 *ENDJOBNOLIST may be entered.

   TSEPOOL       The time slice end pool  to be used if an  interactive
                 job is  ended by the  TIMESLICE parameter of  the job.
                 *SAME  is the  default.    One of  the  special values
                 *NONE or *BASE may be entered.

   ALWMLTTHD     Whether  to allow multiple threads  in the job.  *SAME
                 is the default.  A *YES or *NO may be entered.

   SPLFACN       Whether  to  allow   spooled  files  to   be  accessed
                 through job  interfaces (such as  WRKSBMJOB) after the
                 job  ends.  *SAME is the  default.  *SYSVAL, *KEEP, or
                 *DETACH may be entered.,

   DDMCNV        Whether the connections for  a DDM job remain  active.
                 *SAME  is  the  default.     *KEEP  or  *DROP  may  be
                 entered.

   INLASPGRP     Specifies  the   initial  setting  for  the  auxiliary
                 storage pool (ASP) group  name for the initial  thread
                 of jobs  using  this job  description.   A thread  can
                 use  the Set ASP  Group (SETASPGRP) command  to change
                 its  library  name  space.    When  an  ASP  group  is
                 associated  with  a  thread,  all  libraries   in  the
                 independent ASPs  in the ASP group  are accessible and
                 objects  in those  libraries  can be  referenced using
                 regular library-qualified  object  name syntax.    The
                 libraries  in the  independent ASPs  in the  specified
                 ASP  group plus the  libraries in the  system ASP (ASP
                 number 1) and  basic user  ASPs (ASP numbers  2 -  32)
                 form the library name space for the thread.

                 Restrictions:

                 The job  descriptions  QGPL/QDFTJOBD and  QGPL/QDFTSVR
                 cannot  be  changed to  specify  the  name  of an  ASP
                 group.    For  these job  descriptions,  the INLASPGRP
                 must be *NONE.

                 Values:

                 *SAME - The value does not change.

                 *NONE -  Specifies the  initial thread  of jobs  using
                 this  job  description will  be  started  with no  ASP
                 group.    The  library  name  space  will not  include
                 libraries from any ASP group.   Only the libraries  in
                 the system  ASP and  any basic  user ASPs  will be  in
                 the library name space.

                 Name -  Specifies the name of the  ASP group to be set
                 set for  the initial  thread of  jobs using  this  job
                 description.  The  ASP group name  is the name  of the
                 primary  ASP  device   within  the  ASP  group.    All
                 libraries  from  all ASPs  in this  ASP group  will be
                 included in the library name space.


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

You must have *ALLOBJ special authority to use CHGJOBD2.

A  *JOBD object  owned  by  one  of  the system  profiles  may  not  be
changed.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKIBMPRF       Check IBM profile
     CHKOBJ3         Check object 3
     CVTOBJD2        Convert object description 2
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDIAGMSG      Retrieve diagnostic message
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHGJOBD2      *CMD                   TAAJBDN       QATTCMD
   TAAJBDNC      *PGM       CLP         TAAJBDNC      QATTCL
					

Added to TAA Productivity tools April 15, 2013


Home Page Up to Top