The Display Empty Save File command displays or lists one or more
save files that have no objects. The default is to bypass save file
names beginning with Q as there may be many PTF save files in
existence.
You must have *ALLOBJ special authority to use DSPEMTSAVF for *ALL or
*ALLUSR libraries.
A typical command would be:
DSPEMTSAVF LIB(xxx)
A display would appear with one line per save file that does not have
any objects. Any save file names beginning with Q are bypassed by
default.
DSPEMTSAVF escape messages you can monitor for
----------------------------------------------
TAA9891 No save files exist
Escape messages from based on functions will be re-sent.
DSPEMTSAVF Command parameters *CMD
-----------------------------
SAVF The save file to be checked. A generic name may be
used. The special value *ALL may be used.
The library value defaults to *LIBL. *USRLIBL,
*CURLIB, *ALL, or *ALLUSR may be entered.
BYPQNAMES A *YES/NO value for whether to bypass save file
names beginning with Q.
*YES is the default. This will bypass PTF save
files, but will also bypass any save file names that
you have created that start with Q.
*NO may be specified to process all save files
named.
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.
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
Specifies whether the single ASP device or the
entire ASP group named in element 1 is to be
searched.
*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.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. If the display is ended with F3/F12
or the Enter key, the spooled file is deleted after
it is displayed. To retain the spooled file, you
may use the the System Request 'Cancel' function and
the spooled file will exist in a HLD status.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
You must have *ALLOBJ special authority to use DSPEMTSAVF with a
library value of *ALL or *ALLUSR.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKOBJ3 Check object 3
CVTOBJD6 Convert object description 6
CVTOBJD6 Convert object description 6
RSNLSTMSG Resend last message
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPEMTSAVF *CMD TAASAWP QATTCMD
TAASAWPC *PGM CLP TAASAWPC QATTCL
TAASAWPR *PGM RPG TAASAWPR QATTRPG
|
