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
|
