TAA Tools

The Save and  Restore Job Queue  tool supports two commands  to provide
for a  save and restore  of a job  queue.  CVTJOBQ2  creates an outfile
of  information about the jobs on  a job queue.   The file can be saved
and restored to the same  or a different system.  The  SBMJOBQ2 command
may then  be used  to read the  outfile and perform  a SBMJOB  for each
job found in the outfile.  Some restrictions exist.

You  must  have *ALLOBJ  special authority  to  use either  CVTJOBQ2 or

On the source system, a typical command would be:


The jobs  in  JOBQ1  would  be  read and  information  about  each  job
written to the JOBQP2 file in library ABC.

After  restoring  or  transferring  the  file  to  a  different  system
(assume the  entire ABC library is  transferred), the following command
would be used to place the jobs onto JOBQ1:

             SBMJOBQ2   OUTLIB(ABC)

The default  assumes  that  the  same  job  queue  will  be  used.    A
different job queue  could be assigned.   A listing would  be displayed
with each job listed and the command command that will be used.

If an error  had occurred, it is noted on  the listing and the messages
associated  with  the  error are  noted  in  the job  log.    An escape
message would be issued if any errors occur.

It is possible to  use CVTJOBQ2 multiple times to convert  multiple job
queues to  the same  JOBQP2 file.   The default on  SBMJOBQ2 is  to use
the same job queue name in the JOBQP2 as was captured by SBMJOBQ2.


  **   When  the tool  was first issued  (July 2011),  PTFs were needed
       for the sub tool  RTVJOBA2.  This added  the format JOBI0310  to
       the  API QUSRJOBI.   If  the  command fails,  check with  system
       support to get the latest PTFs that affect the API.

  **   An *ALLOBJ user is required for both CVTJOBQ2 and SBMJOBQ2.

  **   Both  the  CVTJOBQ2 and  SBMJOBQ2  commands use  the  model file
       TAAJOFQP.  The  level ID must  be the same  if SBMJOBQ2 is  used
       on a different system.

  **   Any  objects such  as job  descriptions,  user profiles,  output
       queues,  etc described for  the jobs  to be captured  must exist
       on the system where SBMJOBQ2 is used.

  **   To  access the command for  a job on a  job queue, the RTVSBMCMD
       TAA command  is  used.   This accesses  the  information from  a
       listing created by  the internal use of DSPJOBLOG.   The job log
       listing must be in either lower or upper case English.

  **   The  RQSDTA parameter of  the original SBMJOB (if  it exists) is
       assumed to be  a command  and will  be used on  the SBMJOB  when
       SBMJOBQ2 runs.

  **   The  system  library  list  parameter  (SYSLIBL)  on  SBMJOB  is
       defaulted  to *CURRENT.  This  means you must  ensure the system
       library list is  the same  (or will  not change  the results  of
       the job).

  **   The  following  parameters  (in addition  to  SYSLIBL)  are  not
       supported and  the SBMJOB default will be  used when SBMJOBQ2 is


CVTMSGQ2 escape messages you can monitor for

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

SBMJOBQ2 escape messages you can monitor for

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

CVTJOBQ2 Command parameters                           *CMD

   JOBQ          The  qualified  name  of  the  job  queue  to  capture
                 information  from.   The  library  value  defaults  to
                 *LIBL.   A  specific library  or *CURLIB  may  also be

   OUTLIB        The  name  of the  library where  the  job information
                 will be  written  to the  JOBQP2  file.   The  library
                 qualifier  defaults to  *LIBL.    If the  JOBQP2  file
                 does not exist, a specific library must be named.

                 *CURLIB may be used for the library qualifier.

   OUTMBR        The  member  of  the JOBQP2  file  to  be written  to.
                 JOBQP2 is  the  default.   A  specific member  may  be

   REPLACE       A  *YES/*NO value  for whether  the  member should  be
                 cleared before  writing records into it.   The default
                 is *YES.

                 *NO  may be  specified to  add records  to an existing

SBMJOBQ2 Command parameters                           *CMD

   JOBQP2LIB     The library  containing  the JOBQP2  file.   The  file
                 must  have been  created by  the CVTJOBQ2  command and
                 must  have  the same  level  ID  as that  used  by the
                 CVTJOBQ2 command.

   JOBQ          The qualified  name of  the job  queue  to be  written

                 *OUTFILE is the  default meaning to use  the job queue
                 name  that  exists in  the outfile  when  converted by
                 the  CVTJOBQ2  command.     It  is  possible  to   use
                 CVTJOBQ2 to  write the  information from multiple  job
                 queues  to  the same  JOBQP2  file.    If *OUTFILE  is
                 used, the library qualifier must be blank.

                 If  a  specific job  queue  is named  and  the library
                 qualifier is  blank,  *LIBL is  assumed.   A  specific
                 library may  be named or  the special values  *LIBL or

   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.


See the previous section.


The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     CVTJOBQ         Convert job queue
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RSNALLMSG       Resend all messages
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVFMT          Retrieve format
     RTVJOBA2        Retrieve job attributes 2
     RTVSBMCMD       Retrieve submitted command
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

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

   CVTJOBQ2      *CMD                   TAAJOFQ       QATTCMD
   SBMJOBQ2      *CMD                   TAAJOFQ2      QATTCMD
   TAAJOFQC      *PGM       CLP         TAAJOFQC      QATTCL
   TAAJOFQC2     *PGM       CLP         TAAJOFQC2     QATTCL
   TAAJOFQR      *PGM       RPG         TAAJOFQR      QATTRPG
   TAAJOFQR2     *PGM       RPG         TAAJOFQR2     QATTRPG
   TAAJOFQP      *FILE      PF          TAAJOFQP      QATTDDS


   TAAJOFQC   CL pgm

   TAAJOFQC2   CL pgm

Added to TAA Productivity tools July 15, 2011

Home Page Up to Top