TAA Tools
RPLJOBDLIB      REPLACE JOB DESCRIPTION LIBRARY        TAAJBDL

The Replace  Job Description  Library command  allows a  replace of  an
existing  library in  one  or more  job descriptions  with  a different
library  name.  The  replace library takes the  position in the library
list of  the  library being  replaced.   RPLJOBDLIB  can be  useful  if
library names must be changed.

You  must have  *ALLOBJ special  authority  to specify  a JOBD  library
qualifier of *ALL or *ALLUSR.

The   DSPJOBDLIB  command  may   be  used  to  determine   if  any  Job
Descriptions contain either library name.

A typical  command to  replace library  ABC from  all Job  Descriptions
with the library DEF would be:

            RPLJOBDLIB   CURLIB(ABC) RPLLIB(DEF) JOBD(*ALL/*ALL)

A  listing  would  be  displayed of  the  job  descriptions  that  were
processed.  Job descriptions that were changed are flagged.

It  is not an error  if a job  description does not  contain the CURLIB
name.  It is  an error if  a job description  contains both the  CURLIB
name and  the RPLLIB  name as  the same  name may not  exist more  than
once in the library list.

The RPLLIB library must exist.

RPLJOBDLIB escape messages you can monitor for
----------------------------------------------

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

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

   CURLIB        The   library  to  be   replaced  in  the   named  Job
                 Description.   It is not an  error if the library does
                 not exist in the library list.

   RPLLIB        The library to  replace in the named  Job Description.
                 The library  must exist.  The library  will assume the
                 place  in   the  library  list  where  the  CURLIB  is
                 positioned.

                 It is  an error  if a  job  description contains  both
                 the CURLIB name  and the RPLLIB name as  the same name
                 may not exist more than once in the library list.

   JOBD          The  qualified name of  the Job  Description to change
                 the specified library list.   A specific JOBD name,  a
                 generic  name,  or  the special  value  *ALL  for  all
                 JOBDs may be used.

                 The  library  value defaults  to  *LIBL.   A  specific
                 library,  *USRLIBL, *CURLIB,  *ALL, or  *ALLUSR may be
                 entered.

   OUTPUT        How to  output  the  results.   *  is the  default  to
                 display  the spooled  file if  the command  is entered
                 interactively.   The spooled file  is deleted after it
                 is displayed.

                 If the  command  is  entered  in batch  or  *PRINT  is
                 specified, the  spooled file  is output  and retained.


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

You  must have  *ALLOBJ  special authority  to specify  a  JOBD library
qualifier of *ALL or *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVJOBD         Retrieve job description
     RTVSYSVAL3      Retrieve system value 3
     SCNVAR2         Scan variable 2
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   RPLJOBDLIB    *CMD                   TAAJBDL       QATTCMD
   TAAJBDLC      *PGM       CLP         TAAJBDLC      QATTCL
   TAAJBDLR      *PGM       RPG         TAAJBDLR      QATTRPG
					

Added to TAA Productivity tools October 15, 2008


Home Page Up to Top