Displaying object descriptions

The Display Object Description (DSPOBJD) or Work with Objects (WRKOBJ) command displays 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 Library ASP group device Object type Extended attribute Object size Text description (partial)	Object name Library name Library ASP device Object type Owner Library ASP group device 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 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 Object ASP group device Journaling status Current or last journal Journal images Journal entries omitted Remote journal filter Journal start date and time Starting journal receiver for apply Library name for starting journal Library ASP device for starting journal Library ASP group device for starting journal Save operation date and time Restore operation date and time Save command Device type Sequence number File label ID Save format	Object name Library name Library ASP device Library ASP group device 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 changed by user Licensed program PTF number APAR ID Text description of object or object status conditions

Notes:

The service information is used by programming support personnel to determine the level of the system on which an object was created and whether 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.
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:

Name
Generic name
Type
Name or generic name within object type

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:


                      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

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:


                      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


                      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


                      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


                      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