CL Programming


Displaying 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 4-2. Attributes Displayed for Object Descriptions

Basic Attributes Full Attributes Service Attributes (see Notes)
  • Object name
  • Library name
  • Library ASP device
  • Object type
  • Extended attribute
  • Object size
  • Text description (partial)

  • Object name
  • Library name
  • Library ASP device
  • Object type
  • Owner
  • 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
  • Freed status
  • Compression status
  • Object ASP number
  • Object overflowed
  • Object ASP device
  • Journaling status
  • Current or last journal
  • Journal images
  • Journal entries omitted
  • Journal start date and time
  • Save operation date and time
  • Restore operation date and time
  • Save command
  • Device type

  • Object name
  • Library name
  • Library ASP 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 or not changed by user
  • Licensed program
  • PTF number
  • APAR ID
  • Text description of object or object status conditions

Notes:

  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 API (QLIRLIBD) or the command DSPLIB OUTPUT(*PRINT) to find the total size of the library.

Using the DSPOBJD or 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 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                    |
|                                                                                |
|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 Primary group . . . : *NONE                      |
|Type . . . . . . . . :    *FILE                                                 |
|User-defined information:                                                       |
|   Attribute . . . . . . . . . . . . :                                          |
|   Text  . . . . . . . . . . . . . . :                                          |
|Creation information:                                                           |
|  Creation date and time . . . . . . :   06/08/89  10:17:03                     |
|  Created by user  . . . . . . . . . :   QSECOFR                                |
|  System created on  . . . . . . . . :   SYSTEM01                               |
|  Object domain  . . . . . . . . . . :   *SYSTEM                                |
|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 information:                                                           |
|  Object auditing value  . . . . . . :   *NONE                                  |
|  Digitally signed . . . . . . . . . :   NO                                     |
|Press Enter to continue.                                                        |
|F3=Exit   F12=Cancel                      (C) COPYRIGHT IBM CORP. 1980, 1993.   |
+--------------------------------------------------------------------------------+

+--------------------------------------------------------------------------------+
|                     Display Object Description - Full                          |
|                                                                  Library 1 of 1|
|Object . . . . . . . :    ORDDTLP        Attribute  . . . . . :   PF            |
|  Library  . . . . . :      DISTLIB      Owner  . . . . . . . :   QSECOFR       |
|Type . . . . . . . . :    *FILE                                                 |
|                                                                                |
|Storage information:                                                            |
|  Size . . . . . . . . . . . . . . . :   8192                                   |
|  Offline size . . . . . . . . . . . :   0                                      |
|  Freed  . . . . . . . . . . . . . . :   NO                                     |
|  Compressed . . . . . . . . . . . . :   NO                                     |
|  Object ASP number  . . . . . . . . : 1                                        |
|  Object overflowed  . . . . . . . . : NO                                       |
|  Object ASP device  . . . . . . . . : *SYSBAS                                  |
|    Object overflowed  . . . . . . . :   NO                                     |
|Journaling information:                                                         |
|    Currently journaled  . . . . . . :   NO                                     |
|Save/Restore information:                                                       |
|  Save date/time . . . . . . . . . . :                                          |
|  Restore date/time  . . . . . . . . :                                          |
|  Save command . . . . . . . . . . . :                                          |
|  Device type  . . . . . . . . . . . :                                          |
|                                                                       Bottom   |
|Press Enter to continue.                                                        |
|                                                                                |
|                                                                                |
|F3=Exit   F12=Cancel                                                            |
|                                          (C) COPYRIGHT IBM CORP. 1980, 1993.   |
+--------------------------------------------------------------------------------+


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]