432 lines
26 KiB
HTML
432 lines
26 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Detect unused objects on the system" />
|
|
<meta name="abstract" content="Information provided in the object description can help you detect and manage unused objects on the system." />
|
|
<meta name="description" content="Information provided in the object description can help you detect and manage unused objects on the system." />
|
|
<meta name="DC.subject" content="detecting unused object on system, object, detecting unused, updating, usage information, usage information, table, type, application programming interface (API), days used count, API (application programming interface), no updating" />
|
|
<meta name="keywords" content="detecting unused object on system, object, detecting unused, updating, usage information, usage information, table, type, application programming interface (API), days used count, API (application programming interface), no updating" />
|
|
<meta name="DC.Relation" scheme="URI" content="objec.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="detob" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Detect unused objects on the system</title>
|
|
</head>
|
|
<body id="detob"><a name="detob"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Detect unused objects on the system</h1>
|
|
<div><p>Information provided in the object description can help you detect
|
|
and manage unused objects on the system.</p>
|
|
<div class="section"><p>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. </p>
|
|
<ul><li>Date and time of last change <ul><li>When an object is created or changed, the system time stamps the object,
|
|
indicating the date and time the change occurred.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Date of last use <ul><li>The date of last use is only updated once per day (the first time an object
|
|
is used in a day). The system date is used.</li>
|
|
<li>An unsuccessful attempt to use an object does not update the last used
|
|
date. For example, if a user tries to use an object for which the user is
|
|
not authorized, the date of last use does not change.</li>
|
|
<li>The date of last use is blank for new objects.</li>
|
|
<li>When an object that already exists on the system is restored, the date
|
|
of last use comes from the object on the system. If it does not already exist
|
|
when restored, the date is blank.</li>
|
|
<li>Objects that are deleted and recreated during the restore operation lose
|
|
the date of last use.</li>
|
|
<li>The last used date for a database file is <strong>not</strong> updated when the
|
|
number of members in the file is zero. For example, if you use the <span class="cmdname">Create
|
|
Duplicate Object (CRTDUPOBJ)</span> to copy objects and there are no members
|
|
in the database file, the last used date is not updated.</li>
|
|
<li>The last used date for a database file is the last used date of the file
|
|
member with the most current last used date.</li>
|
|
<li>For logical files, the last used date is the last time a logical member
|
|
(or cursor) was used.</li>
|
|
<li>For physical files, the last used date is the last time the data in the
|
|
data space was used through a physical or logical access.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section">
|
|
<div class="tablenoborder"><a name="detob__objfnc"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="detob__objfnc" frame="hsides" border="1" rules="rows"><caption>Table 1. Updating Usage Information</caption><thead align="left"><tr><th align="left" valign="bottom" width="28.200371057513912%" id="d0e101">Type of Object</th>
|
|
<th align="left" valign="bottom" width="71.79962894248608%" id="d0e103">Commands and Operations</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">All object types</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Create Duplicate Object (CRTDUPOBJ)</span> command
|
|
and other commands, such as the <span class="cmdname">Copy Library (CPYLIB)</span> command,
|
|
that use CRTDUPOBJ to copy objects. <p><span class="cmdname">Grant Object Authority (GRTOBJAUT)</span> command
|
|
(for referenced objects)</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Binding directory</td>
|
|
<td valign="top" width="71.79962894248608%" headers="d0e103 ">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).</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Change Request Description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Change Command Change Request Activity
|
|
(CHGCMDCRQA)</span></td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Chart format</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Display Chart (DSPCHT)</span> command</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">C locale description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Retrieve C Locale Description Source
|
|
(RTVCLDSRC)</span> command or when referred to in a C program</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Class</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to start a job</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Command</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When run<p>When compiled in a CL program</p>
|
|
<p>When
|
|
prompted during entry of source entry utility (SEU) source</p>
|
|
<p>When calling
|
|
the system in check mode </p>
|
|
<div class="note"><span class="notetitle">Note:</span> Prompting from the command line and then
|
|
pressing F3 is not counted as a use of a command.</div>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Communications side information (CSI)</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the CPI-Communications Initialize Conversation
|
|
(CMINIT) call is used to initialize values for various conversation characteristics
|
|
from the side information object.</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Connection list</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the connection list goes beyond status
|
|
of vary on pending</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Cross system product map</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to in a CSP application</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Cross system product table</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to in a CSP application</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Controller description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the controller goes beyond status of
|
|
vary on pending</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Device description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the device goes beyond status of vary
|
|
on pending</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Data area</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Retrieve Data Area (RTVDTAARA)</span> command
|
|
<p><span class="cmdname">Display Data Area (DSPDTAARA)</span> command</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Data queue</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Usage information for the following APIs
|
|
is updated only once per job (the first time one of the APIs is initiated).
|
|
<p><span class="apiname">Send Data Queue (QSNDDTAQ)</span> API</p>
|
|
<p><span class="apiname">Receive
|
|
Data Queue (QRCVDTAQ)</span> API</p>
|
|
<p><span class="apiname">Retrieve Data Queue (QMHQRDQD)</span> API</p>
|
|
<p><span class="apiname">Read
|
|
Data Queue (QMHRDQM)</span> API</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">File (database file only unless specified
|
|
otherwise)</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When closed (other files, such as device
|
|
and save files, also updated when closed) <p>When cleared</p>
|
|
<p>When initialized</p>
|
|
<p>When
|
|
reorganized</p>
|
|
<p>Commands: </p>
|
|
<ul><li><span class="cmdname">Apply Journaled Changes (APYJRNCHG)</span> command</li>
|
|
<li><span class="cmdname">Remove Journaled Changes (RMVJRNCHG)</span> command</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Font resource</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Form definition</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Graphics symbol set</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to by a GDDM* or PGR graphics
|
|
application program <p>When loaded internally or using GSLSS</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Job description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to establish a job</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Job schedule</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the system submits a job for a job schedule
|
|
entry <p>When the user takes 'Option 10 = submit immediately' from the WRKJOBSCDE
|
|
panel</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Job queue</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When an entry is placed on or removed from
|
|
the queue</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Line description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the line goes beyond status of vary
|
|
on pending</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Locale</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Retrieve locale API QLGRTVLC <p>When a job
|
|
starts if the user profile LOCALE value contains a path name to a valid *LOCALE
|
|
object.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Management collection</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Only updated by commands and operations that
|
|
affect all object types.</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Media definition</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">The SAVLIB, SAVOBJ, RSTLIB, RSTOBJ, SAVCHGOBJ
|
|
commands; as well as, the BRMS and QSRSAVO API.</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Menu</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When a menu is displayed using the GO command</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Message files</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">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) <p>Merge
|
|
Message File (MRGMSGF) command except when the message file is QCPFMSG, ##MSG1,
|
|
##MSG2, or QSSPMSG</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Message queue</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When a message is sent to, received from,
|
|
or listed message queue other than QSYSOPR and QHST</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Module</td>
|
|
<td valign="top" width="71.79962894248608%" headers="d0e103 ">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 <span class="cmdname">Update Program (UPDPGM)</span> command or <span class="cmdname">Update
|
|
Service Program (UPDSRVPGM)</span> command.</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Network interface description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the network interface description goes
|
|
beyond status of vary on pending</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Node List</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Only updated by commands and operations that
|
|
affect all object types</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Output queue</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When an entry is placed on or removed from
|
|
the queue</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Overlay</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Page definition</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Page segment</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Panel group</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the Help key is used to request help
|
|
information for a specific prompt or panel, the date of usage is updated <p>When
|
|
a panel is displayed or printed from a panel group</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="28.200371057513912%" headers="d0e101 ">PDF map</td>
|
|
<td valign="top" width="71.79962894248608%" headers="d0e103 "><span class="apiname">Add PDF Map Entry (QPQAPME)</span> API <p><span class="cmdname">Work
|
|
with PDF Map Entries (WRKPDFMAPE)</span> command</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Print descriptor group</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Product Availability</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "> Only updated by commands and operations
|
|
that affect all object types</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Product Load</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "> Only updated by commands and operations
|
|
that affect all object types</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Program</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname"> Retrieve CL Source (RTVCLSRC)</span> command <p>When
|
|
run and not a system program</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">PSF Configuration</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When referred to during a print operation</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Query definition</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to generate a report <p>When extracted
|
|
or exported</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Query manager form</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to generate a report <p>When extracted
|
|
or exported</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Query manager query</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to generate a report <p>When extracted
|
|
or exported</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Search index</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When the F11 key is used through the online
|
|
help information <p>When the <span class="cmdname">Start Search Index (STRSCHIDX)</span> command
|
|
is used</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Server storage</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 "><span class="cmdname">Vary Configuration (VRYCFG)</span> is
|
|
run against a network server description object</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Service program</td>
|
|
<td valign="top" width="71.79962894248608%" headers="d0e103 ">When a bound service program is activated</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">SQL Package</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Only updated by commands and operations that
|
|
affect all object types</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Subsystem description</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When subsystem is started</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Spelling aid dictionary</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used to create another dictionary <p>When
|
|
retrieved</p>
|
|
<p>When a word is found in the dictionary during a spell check
|
|
and the dictionary is not an IBM-supplied spelling aid dictionary</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Table</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When used by a program for translation</td>
|
|
</tr>
|
|
<tr><td valign="top" width="28.200371057513912%" headers="d0e101 ">Time zone description</td>
|
|
<td valign="top" width="71.79962894248608%" headers="d0e103 "><ul><li>Starting a job with the time zone description.</li>
|
|
<li>Referencing the time zone description in order to calculate a new current
|
|
offset when a DST (Daylight Savings Time) boundary is crossed.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">User profile</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">When a job is initiated for the profile <p>When
|
|
the profile is a group profile and a job is started using a member of the
|
|
group</p>
|
|
<p><span class="cmdname">Grant User Authority (GRTUSRAUT)</span> command (for
|
|
referenced profile)</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td align="left" valign="top" width="28.200371057513912%" headers="d0e101 ">Workstation User Customization</td>
|
|
<td align="left" valign="top" width="71.79962894248608%" headers="d0e103 ">Only updated by commands and operations that
|
|
affect all object types</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><p>The following is additional object usage information provided
|
|
in the object description: </p>
|
|
<ul><li>Counter of number of days used <ul><li>The count is increased when the date of last use is updated.</li>
|
|
<li>When an object that already exists on the system is restored, the number
|
|
of days used comes from the object on the system. If it does not already exist
|
|
when restored, the count is zero.</li>
|
|
<li>Objects that are deleted and recreated during the restore operation lose
|
|
the days used count.</li>
|
|
<li>The days used count is zero for new objects. <div class="note"><span class="notetitle">Note:</span> The iSeries™ server <em>cannot</em> determine
|
|
the difference between old and new device files. If you restore a device
|
|
file on to the system and a device file of that same name already exists,
|
|
delete the existing file if you want the days used count to be reset to zero.
|
|
If the file is not deleted, the system will interpret this as a restore operation
|
|
of an old object and retain the days used count.</div>
|
|
</li>
|
|
<li>The days used count for a database file is the sum of the days used counts
|
|
for all file members. If there is an overflow on the sum, the maximum value
|
|
(of the days used counts field) is shown.</li>
|
|
</ul>
|
|
</li>
|
|
<li>Date days used count was reset <ul><li>When the days used count is reset using the <span class="cmdname">Change Object Description
|
|
(CHGOBJD)</span> command or the <span class="apiname">Change Object Description (QLICOBJD)</span> API,
|
|
the date is recorded. The user then knows how long the days used count has
|
|
been active.</li>
|
|
<li>If the days used count is reset for a file, all of the members have their
|
|
days used count reset.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>Common situations that can delete the days used count and the last
|
|
used date are as follows: </p>
|
|
<ul><li>Restoring damaged objects on the system.</li>
|
|
<li>Restoring programs when the system is not in a restricted state.</li>
|
|
</ul>
|
|
<p>The <span class="cmdname">Display Object Description (DSPOBJD)</span> 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 <span class="cmdname">Retrieve Object Description (RTVOBJD)</span> command.
|
|
</p>
|
|
<div class="note"><span class="notetitle">Note:</span> The <a href="../apis/qusrobjd.htm">Retrieve
|
|
Object Description (QUSROBJD) API</a> provides the same information as
|
|
the Retrieve Object Description command.</div>
|
|
<p>The <span class="cmdname">Retrieve Member
|
|
Description (RTVMBRD)</span> command and <span class="cmdname">Display File Description
|
|
(DSPFD)</span> command provide similar information for members in a file.</p>
|
|
<p>Object
|
|
usage information is not updated for the following object types: </p>
|
|
<ul><li>Alert table (*ALRTBL)</li>
|
|
<li>Authorization list (*AUTL)</li>
|
|
<li>Configuration list (*CFGL)</li>
|
|
<li>Class-of-service description (*COSD)</li>
|
|
<li>Data Dictionary (*DTADCT)</li>
|
|
<li>Double-byte character set dictionary (*IGCDCT)</li>
|
|
<li>Double-byte character set sort (*IGCSRT)</li>
|
|
<li>Double-byte character set table (*IGCTBL)</li>
|
|
<li>Edit description (*EDTD)</li>
|
|
<li>Exit Registration (*EXITRG)</li>
|
|
<li>Filter (*FTR)</li>
|
|
<li>Forms control table (*FCT)</li>
|
|
<li>Folder (*FLR)</li>
|
|
<li>Internet Packet Exchange Description (*IPXD)</li>
|
|
<li>Journal (*JRN)</li>
|
|
<li>Journal receiver (*JRNRCV)</li>
|
|
<li>Library (*LIB)</li>
|
|
<li>Mode description (*MODD)</li>
|
|
<li><img src="./delta.gif" alt="Start of change" />Network Server Configuration (*NWSCFG)<img src="./deltaend.gif" alt="End of change" /></li>
|
|
<li>Network Server Description (*NWSD)</li>
|
|
<li>NetBIOS Description (*NTBD)</li>
|
|
<li>Product definition (*PRDDFN)</li>
|
|
<li>Reference code translation table (*RCT)</li>
|
|
<li>Session description (*SSND)</li>
|
|
<li>S/36 machine description (*S36)</li>
|
|
<li>User-defined SQL type (*SQLUDT)</li>
|
|
<li>User queue (*USRQ)</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="objec.htm" title="This provides tasks and concepts specific to objects and libraries, including functions performed on objects, creating libraries, and specifying object authority.">Objects and libraries</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |