TAA Tools
SCNOBJDA        SCAN OBJECT DESCRIPTION ATTRIBUTES     TAAOBLT

The  Scan Object  Description  Attributes  command  scans one  or  more
objects  for  attribute  values.    This  acts  as a  simple  query  to
determine the value of attributes of objects.

A typical command would be:

              SCNLFA    ATTR(DAMAGE) OBJ(xxx/*ALL)
                         SCNVAL(*NONE) SCNOPR(*NE)

A  spooled  file would  be displayed  of all  objects in  the specified
library that have a damage condition that is not *NONE.

SCNOBJDA escape messages you can monitor for
--------------------------------------------

      TAA9891    No objects exist

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

SCNOBJDA Command parameters                             *CMD
---------------------------

   ATTR          The Object  Description attribute to  be scanned  for.
                 The value must be one of the following:

                 ALWCHGAPI.   Whether the object can be  changed by the
                 QLICOBJD API.

                 CHGDATE.   The  last change date  to the  object.  The
                 scan value must be a valid date.

                 COMPRESS.   Whether the  object has  been  compressed.
                 It must be a scan value of *YES or *NO.

                 CRTDATE.  The  date the object was created.   The scan
                 value must be a valid date.

                 CRTSYS.   The system  the object  was created on.   It
                 must be a scan operator of *EQ or *NE.

                 CRTUSR.  The  user who  created the object.   It  must
                 be a scan operator of *EQ or *NE.

                 DAMAGE.  Whether  the object is  damaged.  It  must be
                 a scan value of *NONE, *PARTIAL, or *FULL.

                 DOMAIN.   The domain the  object resides in.   It must
                 be a scan value of *USER or *SYSTEM.

                 JRN.    The  journal  name  the  object  is  (or  was)
                 journaled to.   It must be a  scan operator of *EQ  or
                 *NE.

                 JRNL.   The  library containing  the journal  that the
                 object  is (or was) journaled  to.  It must  be a scan
                 operator of *EQ or *NE.

                 OBJATR.  The  attribute of the object  such as CLP  or
                 PF.  It must be a scan operator of *EQ or *NE.

                 OBJASP.  The ASP  the object exists in.   It must be a
                 scan  operator of *EQ or  *NE.  An ASP  or *SYSBAS may
                 be named.

                 OBJASPL.  The ASP library  that the object exists  in.
                 It must be a scan  operator of *EQ or *NE.   An ASP or
                 *SYSBAS may be named.

                 OBJAUD.   The auditing  attribute of  the object.   It
                 must  be  a scan  operator of  *EQ or  *NE.   The scan
                 value must be *NONE, *USRPRF, *CHANGE, or *ALL.

                 OFLASP.  Whether the  ASP has overflowed.  It  must be
                 a scan value of *YES or *NO.

                 OWNER.   The owner name of  the object.  It  must be a
                 scan operator of *EQ or *NE.

                 PTFNBR.    The  PTF number  (if  any)  applied  to the
                 object.  It must be a scan operator of *EQ or *NE.

                 RESETDATE.  The date the  use count of the object  has
                 been reset.   A valid date  or blanks may  be entered.

                 RSTDATE.   The date the object was  restored.  A valid
                 date or blanks may be entered.

                 SAVACTDATE.   The  date  the  object  was  saved  with
                 SAVACT(*YES).    A   valid  date  or  blanks   may  be
                 entered.

                 SAVDATE.   The  date the  object was  saved.   A valid
                 date or blanks may be entered.

                 SAVF.   The  save file  the object  was saved to.   It
                 must be a scan operator of *EQ or *NE.

                 SAVFL.   The save file  the object was  saved to.   It
                 must be a scan operator of *EQ or *NE.

                 SIZE.  The  size of the object.  It  must be a decimal
                 scan value.

                 SAVACTDATE.   The last change date  to the source used
                 to create  the  object (if  any).    A valid  date  or
                 blanks may be entered.

                 SRCFILE.   The name of the  source file (if  any) used
                 to create  the object.  It must  be a scan operator of
                 *EQ or *NE.

                 SRCLIB The  name of  the library  of the  source  file
                 (if any)  used to  create the  object.  It  must be  a
                 scan operator of *EQ or *NE.

                 SRCMBR.   The name  of the  member of the  source file
                 (if  any) used  to create  the object.   It must  be a
                 scan operator of *EQ or *NE.

                 SYSVER.   The version  of  the system  (e.g.   V7R5M0)
                 the  object  was  created  on.   It  must  be  a  scan
                 operator of *EQ or *NE.

                 STGFREE.    Whether  the storage  was  freed  when the
                 object was saved.  It  must be a scan operator of  *EQ
                 or *NE.

                 USECNT.  The  number of days the object was  used.  It
                 must be a decimal value.

                 USEDATE.    The last  date  the object  was  used.   A
                 valid date or blanks may be entered.

                 USRDFNATR.    The  user   defined  attribute  of   the
                 object.  It must be a scan operator of *EQ or *NE.

                 USRMDFY.   Whether  the object  has  been modified  by
                 the QLICOBJD  API.  It must be a  scan operator of *EQ
                 or *NE.

                 TEXT.   The text description of  the object.  The scan
                 operator must  be *CT  and a non-blank  value must  be
                 entered.

   OBJ           The  qualified name  of the  object description  to be
                 scanned.   A  single object,  a generic name,  or *ALL
                 may be entered.

                 The library qualifier  defaults to  *LIBL.   *USRLIBL,
                 *CURLIB, *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ, or  *IBM
                 may  be  entered.   For  a full  description  of these
                 values, see the CVTLIBOBJD command.

   OBJTYPE       The object type  to be  scanned for.   The default  is
                 *ALL.  Use the prompter for the full list.

   SCNVAL        The value to  be scanned for.   Up to 10 bytes  may be
                 entered.

                 To   scan  for  non-blank   entries  enter  '   '  and
                 SCNOPR(*NE).

                 If  SCNOPR(*CT)  is  entered,  the  SCNVAL  should  be
                 entered   without   quotes   as   the    object   text
                 description  will  be  folded  to  upper  case  before
                 scanning.

   SCNOPR        The scan operator to be used.  *EQ is the default.

                 *NE,  *GT, *GE,  *LT,  *LE, or  *CT (contains)  may be
                 entered.   Non-meaningful functions  such as  scanning
                 the EXTDSC attribute  (supports only *YES or  *NO) for
                 a scan operator other than *EQ/*NE are rejected.

   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
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CVTLIBOBJD      Convert library object description
     RTVVALA         Retrieve value attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SCNOBJDA      *CMD                   TAAOBLT       QATTCMD
   TAAOBLTC      *PGM       CLP         TAAOBLTC      QATTCL
   TAAOBLTR      *PGM       RPG         TAAOBLTR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top