Information provided in the object description can help you detect and manage unused objects on the system.
To detect an unused object, look at both the last-used date and the last-changed date. Change commands do not update the last-used date unless the commands cause the object to be deleted and created again, or the change operation causes the object to be read as a part of the change.
Table 4-3 contains additional information about operations that cause
the last-used date to be updated for various object types.
Table 4-3. Updating Usage Information
Type of Object | Commands and Operations |
---|---|
All object types | Create Duplicate Object (CRTDUPOBJ) command and other commands, such as
the Copy Library (CPYLIB) command, that use CRTDUPOBJ to copy objects.
Grant Object Authority (GRTOBJAUT) command (for referenced objects) |
Binding directory | When bound with another module or binding directory to create a bound program (CRTPGM command) or bound service program (CRTSRVPGM command). When updated on the Update Program UPDPGM command or Update Service Program (UPDSRVPGM command). |
Change Request Description | Change Command Change Request Activity (CHGCMDCRQA) |
Chart format | Display Chart (DSPCHT) command |
C locale description | Retrieve C Locale Description Source (RTVCLDSRC) command or when referred to in a C program |
Class | When used to start a job |
Command |
When run When compiled in a CL program When prompted during entry of source entry utility (SEU) source When calling the system in check mode
|
Communications side information (CSI) |
When the CPI-Communications Initialize Conversation (CMINIT) call is used
to initialize values for various conversation characteristics from the side
information object.
|
Connection list | When the connection list goes beyond status of vary on pending |
Cross system product map | When referred to in a CSP application |
Cross system product table | When referred to in a CSP application |
Controller description | When the controller goes beyond status of vary on pending |
Device description | When the device goes beyond status of vary on pending |
Data area | Retrieve Data Area (RTVDTAARA) command
Display Data Area (DSPDTAARA) command |
Data queue | Usage information for the following APIs is updated only once per job
(the first time one of the APIs is initiated).
Send Data Queue (QSNDDTAQ) API Receive Data Queue (QRCVDTAQ) API Retrieve Data Queue (QMHQRDQD) API Read Data Queue (QMHRDQM) API |
File (database file only unless specified otherwise) | When closed (other files, such as device and save files, also updated
when closed)
When cleared When initialized When reorganized Commands:
|
Font resource | When referred to during a print operation |
Form definition | When referred to during a print operation |
Graphics symbol set | When referred to by a GDDM* or PGR graphics application program
When loaded internally or using GSLSS |
Job description | When used to establish a job |
Job schedule | When the system submits a job for a job schedule entry |
Job queue | When an entry is placed on or removed from the queue |
Line description | When the line goes beyond status of vary on pending |
Locale | Retrieve locale API QLGRTVLC
When a job starts if the user profile LOCALE value contains a path name to a valid *LOCALE object. |
Management collection | Only updated by commands and operations that affect all object types. |
Media definition | The SAVLIB, SAVOBJ, RSTLIB, RSTOBJ, SAVCHGOBJ commands; as well as, the BRMS and QSRSAVO API. |
Menu | When a menu is displayed using the GO command |
Message files | When a message is retrieved from a message file other than QCPFMSG,
##MSG1, ##MSG2, or QSSPMSG (such as when a job log is built, a message queue
is displayed, help is requested on a message in the QHST log, or a program
receives a message other than a mark message)
Merge Message File (MRGMSGF) command except when the message file is QCPFMSG, ##MSG1, ##MSG2, or QSSPMSG |
Message queue | When a message is sent to, received from, or listed message queue other than QSYSOPR and QHST |
Module | When bound with another module or binding directory to create a bound program (CRTPGM command) or bound service program (CRTSRVPGM command). When updated on the Update Program UPDPGM command or Update Service Program (UPDSRVPGM command). |
Network interface description | When the network interface description goes beyond status of vary on pending |
Node List | Only updated by commands and operations that affect all object types |
Output queue | When an entry is placed on or removed from the queue |
Overlay | When referred to during a print operation |
Page definition | When referred to during a print operation |
Page segment | When referred to during a print operation |
Panel group |
When the Help key is used to request help information for a specific prompt or panel, the date of usage is updated When a panel is displayed or printed from a panel group
|
Print descriptor group | When referred to during a print operation |
Product Availability |
Only updated by commands and operations that affect all object types
|
Product Load |
Only updated by commands and operations that affect all object types
|
Program |
Retrieve CL Source (RTVCLSRC) command When run and not a system program
|
PSF Configuration | When referred to during a print operation |
Query definition | When used to generate a report
When extracted or exported |
Query manager form | When used to generate a report
When extracted or exported |
Query manager query | When used to generate a report
When extracted or exported |
Search index | When the F11 key is used through the online help information
When the Start Search Index (STRSCHIDX) command is used |
Server storage | Vary Configuration (VRYCFG) is run against a network server description object |
Service program | When a bound service program is activated |
SQL Package | Only updated by commands and operations that affect all object types |
Subsystem description | When subsystem is started |
Spelling aid dictionary | When used to create another dictionary
When retrieved When a word is found in the dictionary during a spell check and the dictionary is not an IBM-supplied spelling aid dictionary |
Table | When used by a program for translation |
User profile | When a job is initiated for the profile
When the profile is a group profile and a job is started using a member of the group Grant User Authority (GRTUSRAUT) command (for referenced profile) |
Workstation User Customization | Only updated by commands and operations that affect all object types |
| When the user takes 'Option 10 = submit immediately' from the WRKJOBSCDE panel |
The following is additional object usage information provided in the object description:
Common situations that can delete the days used count and the last used date are as follows:
The Display Object Description (DSPOBJD) command can be used to display a full description of an object. You can use the same command to write the description to an output file. To retrieve the descriptions, use the Retrieve Object Description (RTVOBJD) command.
The Retrieve Member Description (RTVMBRD) command and Display File Description (DSPFD) command provide similar information for members in a file.
Object usage information is not updated for the following object types:
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.