The Display Restore Date command displays or lists the objects that
have been created or restored to a library after the library was
restored. More than one library or the entire system may be
reviewed. Options exist to list the new libraries and new objects
(never restored). DSPRSTDAT assists in understanding what objects
have been restored or created since the last restore of a library.
You must have *ALLOBJ special authority to specify a library value of
*ALL or *ALLUSR.
A typical command would be:
DSPRSTDAT LIB(ABC)
The date/time of the restore of library ABC would be determined and
is displayed on a single line. Any objects in the library that were
restored after that library restore date/time would be displayed.
All user libraries can be reviewed with the command (slow running
command should be submitted to batch):
DSPRSTDAT LIB(*ALLUSR)
For libraries that have are new (have not been restored) the default
is to bypass the objects in these libraries. The command also
defaults to list those objects that have not been restored (created
after the library was restored).
To display the new objects in new libraries in addition, specify:
DSPRSTDAT LIB(*ALLUSR) LSTNEWOBJ(*YES)
NEWLIB(*PROCESS)
If LIB(*ALL) is specified or QSYS is named in the library parameter,
all libraries will appear as a library line. Normally, QSYS will not
have a restore date.
DSPRSTDAT escape messages you can monitor for
---------------------------------------------
TAA9891 No objects exist in the library
Escape messages from based on functions will be re-sent.
DSPRSTDAT Command parameters *CMD
----------------------------
LIB The list of libraries to be processed. Up to 300
libraries may be entered (including generic names)
or the special values *USRLIBL, *CURLIB, *ALLUSR, or
*ALL.
You must have *ALLOBJ authority to specify a value
of *ALL or *ALLUSR.
DATE The date to be checked against for individual
objects.
*RSTLIB is the default meaning the date/time that
the library was restored. The date/time is compared
against the restore date/time of the individual
objects in the library.
A specific date may be entered (job format). Any
objects restored on or after the specified date
would be listed.
LSTNEWOBJ A *YES/*NO option that determines whether new
objects (that do not have a restore date) would be
listed.
*YES is the default list any objects that do not
have a restore date (created after the restore of
the library). If a library does not have a restore
date, you must specify NEWLIB(*PROCESS) to list
these objects.
*NO may be specified to bypass the listing of new
objects. A summary total is provided.
NEWLIB A *BYPASS/*PROCESS option that determines if any new
libraries (libraries that have not been restored)
are considered.
*BYPASS is the default to bypass a new library (one
that does not have a restore date). The library
line will still occur.
*PROCESS may be specified to consider new libraries.
If LSTNEWOBJ(*NO) is specified, only those objects
with a restore date will be listed. If
LSTNEWOBJ(*YES) is specified, all objects will be
listed.
LIBTYPE Whether to select all or a specified library type.
*ALL is the default to select all types.
*PROD may be used to select only production (PROD)
libraries.
*TEST may be used to select only test (TEST)
libraries.
OMITLIB A list of up to 300 libraries or generic library
names that should be omitted. *NONE is the default.
An omit list may not be entered for LIB(*CURLIB).
No check occurs to see if an omit library would have
been selected. For example, if LIB(*USRLIBL) is
entered with OMITLIB(ABC) and library ABC is not on
the library list, no error occurs.
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 special authority to specify a library value of
*ALL or *ALLUSR.
If LIB(*ALL) is specified or QSYS is named in the library parameter,
all libraries will appear as a library line. Normally, QSYS will not
have a restore date.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CVTDAT Convert date
CVTLIBOBJD Convert library object description
EDTVAR Edit variable
EXTLST2 Extract list 2
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
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPRSTDAT *CMD TAARSTL QATTCMD
TAARSTLC *PGM CLP TAARSTLC QATTCL
TAARSTLR *PGM RPG TAARSTLR QATTRPG
|
