TAA Tools
DSPCRTDAT       DISPLAY CREATE DATE                    TAAOBLS

The  Display Create  Date  command provides  a  display or  listing  of
objects  with selection  on  the create  date  and time.    The default
displays  the  objects  in  descending  create  date  and  time  order.
DSPCRTDAT may be useful in understanding recent changes.

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

A typical command would be:

             DSPCRTDAT   LIB(xxx) FROMDATE(101108)

All objects created on or after 10/11/08 would be displayed.

Selection by date
-----------------

Because  the  DSPOBJD outfile  used  has  dates  in MMDDYY  order,  the
selection  of the date/time range  must be done in  the RPG program and
not by the SORTDBF command.

DSPCRTDAT escape messages you can monitor for
---------------------------------------------

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

DSPCRTDAT Command parameters                          *CMD
----------------------------

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

   FROMDATE      The first create  date and time  of the objects  to be
                 considered.   The  default  is *FIRST  for  any create
                 date.

                 The  special  value *CURRENT  may  be entered  to mean
                 today's date.

                 A specific date may  be entered in job format.   If no
                 time is entered, a time of 000000 is used.

   TODATE        The last  create date  and time of  the objects  to be
                 considered.   The default is *LAST  to use the current
                 date and time.

                 A specific date may be entered in job format.

                 A specific time may be  entered in HHMMSS format.   If
                 no time is entered, a time of 235959 is used.

   OBJTYPE       The object type to be selected.

                 *ALL is the default.

                 For a complete list, use the prompter.

   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.

   SEQ           The sequence of the listing.

                 *CRTDATE  is  the  default  to  list  the  objects  in
                 descending sequence by create date and time.

                 *SYS  may be  specified  to list  the  objects in  the
                 same  order  as  DSPLIB  (*PGM objects  appear  before
                 *FILE objects).

   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
     CVTDAT          Convert date
     CVTTIM          Convert time
     DUPTAADBF       Duplicate TAA data base file
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVASPSTS       Retrieve ASP status
     RTVDAT          Retrieve date
     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
   ------        ----    ---------      ----------    ----------

   DSPCRTDAT     *CMD                   TAAOBLS       QATTCMD
   TAAOBLSC      *PGM       CLP         TAAOBLSC      QATTCL
   TAAOBLSR      *PGM       RPG         TAAOBLSR      QATTRPG
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top