DSPOBJDMG -- Display Object Damage

DSPOBJDMG DISPLAY OBJECT DAMAGE TAAOBMU
The Display Object Damage command displays object damage as reported by the object list API (QGYOLOBJ). This may not be the only damage to an object. If damage is reported, you should re-create any such objects. You must have ALLOBJ special authority to use a library value of ALL or ALLUSR. A typical command would be: DSPOBJDMG OBJ(LIBA/ALL) All objects in LIBA would be checked for damage. If any damage exists, the objects would be shown on the display. Two types of damage may be reported. The information is not complete. All of the information to be returned about an object cannot be retrieved. Partial damage Some damage has been detected. DSPOBJDMG escape messages you can monitor for --------------------------------------------- None. Escape messages from based on functions will be re-sent. DSPOBJDMG Command parameters CMD ---------------------------- OBJ The qualified name of the object to be displayed. A specific or generic name may be entered or the special value ALL. The API used does not report an error on an object name that does not exist. Be sure the object name is correct or ALL is specified. The library value defaults to LIBL. A specific library, CURLIB, USRLIBL, ALLUSR, or ALL may also be entered. OBJTYPE A list of up to 300 object types to be displayed. The default is ALL. For a list of the specific values, 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 name. 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. Restrictions ------------ None. Prerequisites ------------- The following TAA Tools must be on your system: CHKALLOBJ Check ALLOBJ special authority RTVASPSTS Retrieve ASP status 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 ------ ---- --------- ---------- ---------- DSPOBJDMG CMD TAAOBMU QATTCMD TAAOBMUC PGM CLP TAAOBMUC QATTCL TAAOBMUC3 PGM CLP TAAOBMUC3 QATTCL TAAOBMUR PGM RPG TAAOBMUR QATTRPG TAAOBMUR2 PGM RPGLE TAAOBMUR2 QATTRPG TAAOBMUD FILE DSPF TAAOBMUD QATTDDS

DSPOBJDMG       DISPLAY OBJECT DAMAGE                  TAAOBMU


The Display  Object Damage command  displays object damage  as reported
by the  object list API  (QGYOLOBJ).  This  may not be  the only damage
to  an object.   If damage is  reported, you should  re-create any such
objects.

You must  have *ALLOBJ  special authority  to  use a  library value  of
*ALL or *ALLUSR.

A typical command would be:

             DSPOBJDMG  OBJ(LIBA/*ALL)

All  objects in  LIBA  would be  checked  for damage.    If any  damage
exists, the objects would be shown on the display.

Two types of damage may be reported.

  **   The  information is not complete.  All  of the information to be
       returned about an object cannot be retrieved.

  **   Partial damage Some damage has been detected.

DSPOBJDMG escape messages you can monitor for
---------------------------------------------

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

DSPOBJDMG Command parameters                          *CMD
----------------------------

   OBJ           The qualified name of the  object to be displayed.   A
                 specific  or  generic  name  may  be  entered  or  the
                 special value  *ALL.  The API used  does not report an
                 error on  an object  name  that does  not exist.    Be
                 sure  the   object  name   is  correct   or  *ALL   is
                 specified.

                 The  library  value defaults  to  *LIBL.   A  specific
                 library,  *CURLIB,  *USRLIBL,  *ALLUSR,  or  *ALL  may
                 also be entered.

   OBJTYPE       A list  of up  to 300  object types  to be  displayed.
                 The  default is  *ALL.   For  a list  of the  specific
                 values, 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 name.

                 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.


Restrictions
------------

None.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     RTVASPSTS       Retrieve ASP status
     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
   ------        ----    ---------      ----------    ----------

   DSPOBJDMG     *CMD                   TAAOBMU       QATTCMD
   TAAOBMUC      *PGM       CLP         TAAOBMUC      QATTCL
   TAAOBMUC3     *PGM       CLP         TAAOBMUC3     QATTCL
   TAAOBMUR      *PGM       RPG         TAAOBMUR      QATTRPG
   TAAOBMUR2     *PGM       RPGLE       TAAOBMUR2     QATTRPG
   TAAOBMUD      *FILE      DSPF        TAAOBMUD      QATTDDS

Added to TAA Productivity tools January 15, 2013

Home Page

Up to Top