TAA Tools
DSPRSTDAT       DISPLAY RESTORE DATE                   TAARSTL

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
					

Added to TAA Productivity tools October 15, 2008


Home Page Up to Top