Display object descriptions

You can use the Display Object Description (DSPOBJD) or Work with Objects (WRKOBJ) command to display descriptions of objects.

These descriptions are helpful for determining if objects exist on the system but are not being used. If you are using batch processing, the descriptions can be printed or written to a database file. If you are using interactive processing, the descriptions can be displayed, printed, or written to a database file.

You can display basic, full, or service attributes for object descriptions. These object descriptions are found in the following table:

Table 1. Attributes Displayed for Object Descriptions
Basic Attributes Full Attributes Service Attributes (see Notes)
  • Object name
  • Library name
  • Library ASP device
  • Start of changeLibrary ASP group deviceEnd of change
  • Object type
  • Extended attribute
  • Object size
  • Text description (partial)
  • Object name
  • Library name
  • Library ASP device
  • Object type
  • Owner
  • Start of changeLibrary ASP group deviceEnd of change
  • Primary Group
  • Extended attribute
  • User-defined attribute
  • Text description
  • Creation date and time
  • User who created object
  • System object created on
  • Object domain
  • Change date and time
  • Whether or not usage data collected
  • Last used date
  • Days used count
  • Days used count reset date
  • Allow change by program
  • Object auditing value
  • Digitally signed
  • Digitally signed system-trusted source
  • Digitally signed multiple signatures
  • Object size
  • Offline size
  • Associated space size
  • Optimum space alignment
  • Freed status
  • Compression status
  • Object ASP number
  • Object overflowed
  • Object ASP device
  • Start of changeObject ASP group deviceEnd of change
  • Journaling status
  • Current or last journal
  • Journal images
  • Journal entries omitted
  • Journal start date and time
  • Start of changeStarting journal receiver for applyEnd of change
  • Start of changeLibrary name for starting journalEnd of change
  • Start of changeLibrary ASP device for starting journalEnd of change
  • Start of changeLibrary ASP group device for starting journalEnd of change
  • Save operation date and time
  • Restore operation date and time
  • Save command
  • Device type
  • Start of changeSequence numberEnd of change
  • Start of changeFile label IDEnd of change
  • Start of changeSave formatEnd of change
  • Object name
  • Library name
  • Library ASP device
  • Start of changeLibrary ASP group deviceEnd of change
  • Object type
  • Source file and library
  • Member name
  • Extended attribute
  • User-defined attribute
  • Freed status
  • Object size
  • Creation date and time
  • Date and time member in source file was last updated
  • System level
  • Compiler
  • Object control level
  • Changed by program
  • Whether or not changed by user
  • Licensed program
  • PTF number
  • APAR ID
  • Text description of object or object status conditions
Note:
  1. The service information is used by programming support personnel to determine the level of the system on which an object was created and whether or not the object has been changed since it was shipped. Some of this information may be helpful to you because it indicates the source member used to create an object and the last date of change to that source from which the object was created.
  2. Library objects contain only the names of the objects included in the library. If DSPOBJD for object type *LIB is used, the object size information refers to the size of the library object only, not the total size of the objects included in the library.

    You can use either the Retrieve Library Description (QLIRLIBD) API or the command DSPLIB OUTPUT(*PRINT) to find the total size of the library.

Using the Display Object Description (DSPOBJD) or Work with Objects (WRKOBJ) command, you can list the objects in a library for which you are authorized by:

The objects are listed by library; within a library, they are listed by type. Within object type, the objects are listed in alphanumeric order.

You may want to use the Display Object Description (DSPOBJD) command in a batch job if you want to display many objects with the *FULL or *SERVICE option. The output can go to a spooled printer file and be printed instead of being shown at the display station, or the output can go to a database file. If you direct the output to a database file, all the attributes of the object are written to the file. Use the Display File Field Description (DSPFFD) command for file QADSPOBJ, in library QSYS, to view the record format for this file.

The following command displays the descriptions of the order entry files (that is, the files in DISTLIB) whose names begin with ORD. ORD* is the generic name.

DSPOBJD   OBJ(DISTLIB/ORD*)  OBJTYPE(*FILE) +
          DETAIL(*BASIC)  OUTPUT(*)

The resulting basic display is:

Start of change
                      Display Object Description - Basic
                                                                 Library 1 of 1
Library . . . . . . :    DISTLIB         Library ASP device . :    *SYSBAS
                                         Library ASP group. . :    *SYSBAS

Type options, press Enter.
  5=Display full attributes   8=Display service attributes
 
Opt  Object      Type      Attribute               Size   Text
 _   ORDDTLP     *FILE        PF                   8192   Order detail
 _   ORDHDRP     *FILE        PF                   8192   Order header
 
                                                                          Bottom
F3=Exit   F12=Cancel   F17=Top   F18=Bottom
End of change

If you specify *FULL instead of *BASIC or if you enter a 5 in front of ORDDTLP on the basic display, the resulting full display is:

Start of change
                      Display Object Description - Full
                                                                Library 1 of 1
Object . . . . . . . :   ORDDTLP         Attribute  . . . . . :   PF
  Library  . . . . . :     DISTLIB       Owner  . . . . . . . :   QSECOFR
Library ASP device . :   *SYSBAS         Library ASP group. . :   *SYSBAS
Type . . . . . . . . :   *FILE           Primary group  . . . :   *NONE

User-defined information:
  Attribute  . . . . . . . . . . . . :
  Text . . . . . . . . . . . . . . . :

Creation information:
  Creation date/time . . . . . . . . :   06/08/05  10:17:03
  Created by user  . . . . . . . . . :   QSECOFR
  System created on  . . . . . . . . :   SYSTEM01
  Object domain  . . . . . . . . . . :   *SYSTEM

                                                                        More...
Press Enter to continue.                

F3=Exit   F12=Cancel
End of change Start of change
                      Display Object Description - Full
                                                                Library 1 of 1
Object . . . . . . . :   ORDDTLP         Attribute  . . . . . :   PF
  Library  . . . . . :     DISTLIB       Owner  . . . . . . . :   QSECOFR
Library ASP device . :   *SYSBAS         Library ASP group. . :   *SYSBAS
Type . . . . . . . . :   *FILE           Primary group  . . . :   *NONE

Change/Usage information:
  Change date/time . . . . . . . . . :   05/11/90  10:03:02
  Usage data collected . . . . . . . :   YES
  Last used date . . . . . . . . . . :   05/11/90
  Days used count  . . . . . . . . . :   20
    Reset date . . . . . . . . . . . :   03/10/90
  Allow change by program  . . . . . :   YES
Auditing/Integrity information:
  Object auditing value  . . . . . . :   *NONE
  Digitally signed . . . . . . . . . :   NO

                                                                        More...
Press Enter to continue.                

F3=Exit   F12=Cancel
End of change Start of change
                      Display Object Description - Full
                                                                Library 1 of 1
Object . . . . . . . :   ORDDTLP         Attribute  . . . . . :   PF
  Library  . . . . . :     DISTLIB       Owner  . . . . . . . :   QSECOFR
Library ASP device . :   *SYSBAS         Library ASP group. . :   *SYSBAS
Type . . . . . . . . :   *FILE           Primary group  . . . :   *NONE

Storage information:
  Size . . . . . . . . . . . . . . . :   32768
  Offline size . . . . . . . . . . . :   0
  Associated space size  . . . . . . :   3840
  Optimum space alignment  . . . . . :   NO
  Freed  . . . . . . . . . . . . . . :   NO
  Compressed . . . . . . . . . . . . :   INELIGIBLE
  Object ASP number  . . . . . . . . :   1
    Object overflowed  . . . . . . . :   NO
  Object ASP device  . . . . . . . . :   *SYSBAS
Journaling information:
  Currently journaled  . . . . . . . :   NO

                                                                        More...
Press Enter to continue.                

F3=Exit   F12=Cancel
End of change Start of change
                      Display Object Description - Full
                                                                Library 1 of 1
Object . . . . . . . :   ORDDTLP         Attribute  . . . . . :   PF
  Library  . . . . . :     DISTLIB       Owner  . . . . . . . :   QSECOFR
Library ASP device . :   *SYSBAS         Library ASP group. . :   *SYSBAS
Type . . . . . . . . :   *FILE           Primary group  . . . :   *NONE

Save/Restore information:
  Save date/time . . . . . . . . . . :
  Restore date/time  . . . . . . . . :
  Save command . . . . . . . . . . . :
  Device type  . . . . . . . . . . . :
                                                                        Bottom
Press Enter to continue.
  
F3=Exit   F12=Cancel
End of change
Parent topic: Objects and libraries
Related concepts
Object types and common attributes