TAA Tools
DSPSPLOWN       DISPLAY SPOOLED FILES OWNER            TAASPOT

The Display Spooled  Files Owner command  displays or lists  by spooled
file owner either  each owned spooled file or a  summary by user.  This
allows  a review of  how many spooled  files and how  much spooled file
storage is  owned by users.   Specific  libraries may be  named or  all
libraries.

You must  have *ALLOBJ  authority to specify  a library value  of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

A typical command would be:

             DSPSPLOWN  LIB(*ALL)

Because  all  libraries are  specified, this  would  be a  slow running
command as CVTOUTQ must be used  for every output queue on the  system.

A spooled file  would be displayed by  user name of each  owned spooled
file with a summary by user.

DSPSPLOWN escape messages you can monitor for
---------------------------------------------

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

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

   LIB           The  library  or  libraries to  be  scanned  for *OUTQ
                 objects.  A list of  to 300 libraries may be  entered.
                 A  generic name  may  be used  or  the special  values
                 *LIBL, *USRLIBL, *CURLIB, or *ALLUSR.

                 You  must have  *ALLOBJ special  authority  to specify
                 *ALLUSR.

   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.

   LIBTYPE       The type of library to  be processed.  The default  is
                 *ALL for both production and test.

                 *PROD may be used for just production libraries.

                 *TEST may be used for just test libraries.

   OMITLIB       A list  of up  to 300  libraries or generic  libraries
                 to be omitted.

                 An omit list may not be entered for LIB(*CURLIB).

                 Any library entered is checked for existence.

                 No check  occurs to see if an  omit library would have
                 been   selected.    For   example,  if  LIB(*LIBL)  is
                 entered with  OMITLIB(ABC) and library  ABC is not  on
                 the library list, no error occurs.

   DETAIL        A  *YES/*NO value  to determine  whether each  spooled
                 file is listed or just a summary.

                 *YES is the default to list each spooled file.

                 *NO  may be specified to list  just a summary by user.

   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  authority to specify  a library value  of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKDUPLST       Check duplicate list
     CHKGENERC       Check generic
     CHKGENOBJ       Check generic object
     CHKOBJ3         Check object 3
     CRTDUPPF        Create duplicate physical file
     CVTDAT          Convert date
     CVTLIBOBJD      Convert library object description
     CVTOUTQ         Convert output queue
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVASPSTS       Retrieve ASP status
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message
     SNDSTSMSG       Send status message
     SORTDBF         Sort data base file

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

None, the tool is ready to use.

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

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

   DSPSPLOWN     *CMD                   TAASPOT       QATTCMD
   TAASPOTC      *PGM       CLP         TAASPOTC      QATTCL
   TAASPOTC2     *PGM       CLP         TAASPOTC2     QATTCL
   TAASPOTR      *PGM       RPG         TAASPOTR      QATTRPG
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top