DSPOBJ2 -- Display Object 2 - Simple Subfile/DSPOBJD2 Option

DSPOBJ2 DISPLAY OBJECT DESCRIPTION 2 TAAOBMP
The Display Object 2 command provides a subfile display of one or more objects. The display format is similar to WRKOBJ, but supports only a single option 5=Display. This invokes the TAA DSPOBJD2 command which provides other display options such as DSPOBJAUT and the F8 option which changes based on the object type to allow a display of additional details. The QGYOLOBJ and QGYGTLE APIs are used. The advantage of DSPOBJ2 is that only 'display' functions are provided for users who need a general object display, but should not be authorized to change functions. DSPOBJ2 is also helpful for a quick review of what exists by library, by object type, by generic name, etc. A typical command would be: DSPOBJ2 OBJ(xxx) All objects starting with the generic name on the library list would be displayed. Option 5 may be used for the DSPOBJD2 command. This will display high level details of the object. F8 may be used to display further information about the specific object type. DSPOBJ2 escape messages you can monitor for ------------------------------------------- None. Escape messages from based on functions will be re-sent. DSPOBJ2 Command parameters CMD -------------------------- OBJ The qualified name of the object to be displayed. A generic name may be entered. The library value defaults to LIBL. A specific library or CURLIB may also be used. 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: ASP 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. Specifies that only the 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: ADJVAR Adjust variable CHKALLOBJ Check ALLOBJ special authority CHKOBJ3 Check object 3 DSPOBJD2 Display Object Description 2 RTVASPSTS Retrieve ASP status RTVLCKEXCL Retrieve lock exclusive 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 ------ ---- --------- ---------- ---------- DSPOBJ2 CMD TAAOBMP QATTCMD TAAOBMPC PGM CLP TAAOBMPC QATTCL TAAOBMPC2 PGM CLP TAAOBMPC2 QATTCL TAAOBMPC3 PGM CLP TAAOBMPC3 QATTCL TAAOBMPR PGM RPG TAAOBMPR QATTRPG TAAOBMPR2 PGM RPGLE TAAOBMPR2 QATTRPG TAAOBMPD *FILE DSPF TAAOBMPD QATTDDS

DSPOBJ2         DISPLAY OBJECT DESCRIPTION 2           TAAOBMP


The Display  Object  2 command  provides a  subfile display  of one  or
more objects.   The display  format is similar to  WRKOBJ, but supports
only  a  single  option  5=Display.    This  invokes  the  TAA DSPOBJD2
command which  provides other  display  options such  as DSPOBJAUT  and
the  F8 option  which  changes based  on  the object  type  to allow  a
display  of  additional details.   The  QGYOLOBJ  and QGYGTLE  APIs are
used.

The  advantage  of  DSPOBJ2  is  that  only  'display'  functions   are
provided for  users who need a  general object display, but  should not
be authorized to change functions.

DSPOBJ2 is  also helpful for a quick review  of what exists by library,
by object type, by generic name, etc.

A typical command would be:

             DSPOBJ2    OBJ(xxx*)

All objects starting with  the generic name on  the library list  would
be displayed.

Option 5  may be  used for  the DSPOBJD2  command.   This will  display
high level  details of the object.   F8 may be used  to display further
information about the specific object type.

DSPOBJ2 escape messages you can monitor for
-------------------------------------------

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

DSPOBJ2 Command parameters                            *CMD
--------------------------

   OBJ           The  qualified name of the object  to be displayed.  A
                 generic name may be entered.

                 The  library value  defaults  to  *LIBL.   A  specific
                 library or *CURLIB may also be used.

   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:

                 ASP 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.  Specifies that only the

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

     ADJVAR          Adjust variable
     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     DSPOBJD2        Display Object Description 2
     RTVASPSTS       Retrieve ASP status
     RTVLCKEXCL      Retrieve lock exclusive
     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
   ------        ----    ---------      ----------    ----------

   DSPOBJ2       *CMD                   TAAOBMP       QATTCMD
   TAAOBMPC      *PGM       CLP         TAAOBMPC      QATTCL
   TAAOBMPC2     *PGM       CLP         TAAOBMPC2     QATTCL
   TAAOBMPC3     *PGM       CLP         TAAOBMPC3     QATTCL
   TAAOBMPR      *PGM       RPG         TAAOBMPR      QATTRPG
   TAAOBMPR2     *PGM       RPGLE       TAAOBMPR2     QATTRPG
   TAAOBMPD      *FILE      DSPF        TAAOBMPD      QATTDDS

Added to TAA Productivity tools October 15, 2012

Home Page

Up to Top