TAA Tools
CVTALLJOBQ        CONVERT ALL JOB QUEUES             TAAJOBH

The Convert  All Job Queues  command accesses one  or more job  queues,
accesses  the  attributes  of  each,  and  creates  a  data  base  file
ALLJOBQP  with  one record  per  job queue.    The record  includes the
number of  jobs  which are  on  the  job queue.    This allows  you  to
automate several functions involving batch jobs.

A typical command would be entered as:

   CVTALLJOBQ       OUTLIB(QTEMP)

The  command creates a  file named  ALLJOBQP in  QTEMP with  one record
for  each job queue.  You can  then read the file in  a CL or other HLL
program.  For  example, you could  determine if the  job queue had  any
jobs and issue the CVTJOBQ command to determine what the jobs are.

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

   LIB           The  library to  convert  the job  queues  from.   The
                 default  is *ALL.   If  a library  is named,  only the
                 job queues in that library will be converted.

   OUTLIB        The  library  in  which  the  file  ALLJOBQP  will  be
                 placed.  The default  is *LIBL.  If the  ALLJOBQP file
                 does not exist, a library must be specified.

   OUTMBR        The member  of the ALLJOBQP  file to be used.   If the
                 member  does not exist,  it is added.   The default is
                 ALLJOBQP.

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

   ASPDEV        Specifies  the  auxiliary  storage  pool (ASP)  device
                 name where  storage  for the  library  containing  the
                 object is  allocated.   If the  library resides in  an
                 ASP  that is  not part  of  the thread's  library name
                 space, this  parameter  must be  specified  to  ensure
                 the correct  library is searched.   If  this parameter
                 is used  when the library qualifier  specified for the
                 Object  prompt (OBJ  parameter) is  *CURLIB, *LIBL, or
                 *USRLIBL, ASPDEV(*) is the only valid value.

                 This parameter  can  be specified  as  a list  of  two
                 values  (elements)   or  as  a  single   value.    The
                 possible single values are:

                 *  = The ASPs that are  currently part of the thread's
                 library name  space  will be  searched to  locate  the
                 library.   This includes the  system ASP (ASP  1), all
                 defined  basic  user  ASPs (ASPs  2-32),  and,  if the
                 thread has  an ASP  group, the  primary and  secondary
                 ASPs in the thread's ASP group.

                 *ALLAVL = All  available ASPs will be searched.   This
                 includes  the system  ASP (ASP  1), all  defined basic
                 user  ASPs (ASPs 2-32), and  all available primary and
                 secondary  ASPs,  (ASPs  33-255)  with  a   status  of
                 'Available'.

                 *CURASPGRP  = If  the  thread has  an  ASP group,  the
                 primary  and secondary ASPs in  the thread's ASP group
                 will be searched  to locate the  library.  The  system
                 ASP (ASP  1) and defined  basic user ASPs  (ASPs 2-32)
                 will not  be searched.  If no  ASP group is associated
                 with the thread, an error will be issued.

                 *SYSBAS =  The  system ASP  (ASP  1) and  all  defined
                 basic  user  ASPs  (ASPs 2-32)  will  be  searched  to
                 locate  the library.    No primary  or  secondary ASPs
                 will  be  searched  even  if  the  thread  has  an ASP
                 group.

                 Element 1: Device

                 The device  name of the  primary or  secondary ASP  to
                 be searched.   The primary or secondary  ASP must have
                 been  activated  (by varying  on the  ASP  device) and
                 have a status  of 'Available'.   The  system ASP  (ASP
                 1) and  defined user basic  ASPs (ASPs 2-32)  will not
                 be searched.

                 Element 2: Search type

                 *ASP  =  Specifies  that  only  the  single  auxiliary
                 storage pool (ASP)  device named  in element  1 is  to
                 be searched.

                 *ASPGRP  = Specifies  that  the  entire group  of  the
                 primary auxiliary  storage pool (ASP)  device named in
                 element 1 is to be searched.

File format
-----------

The file name that is output is ALLJOBQP.

The model file used is TAAJOBHP with a format name of AJRCD.

To see the field names used:

       DSPFMT    TAAJOBHP

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

Because  all  job  queues  must  be  accessed,  you  must  have *ALLOBJ
authority to use CVTALLJOBQ.

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

The following TAA Tools must be on your system:

           EDTVAR       Edit variable
           RTVJOBQA     Retrieve job queue attributes
           RTVSYSVAL3   Retrieve system value 3
           SNDCOMPMSG   Send completion message
           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
   ------        -----      ---------      ----------     -----------

   CVTALLJOBQ    *CMD                      TAAJOBH        QATTCMD
   TAAJOBHP      *FILE         PF          TAAJOBHP       QATTDDS
   TAAJOBHC      *PGM          CLP         TAAJOBHC       QATTCL
   TAAJOBHC2     *PGM          CLP         TAAJOBHC2      QATTCL
   TAAJOBHR      *PGM          RPG         TAAJOBHR       QATTRPG
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top