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

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.