<?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="Retrieve object descriptions" /> <meta name="abstract" content="You can use the Retrieve Object Description (RTVOBJD) command to return the descriptions of a specific object to a CL procedure." /> <meta name="description" content="You can use the Retrieve Object Description (RTVOBJD) command to return the descriptions of a specific object to a CL procedure." /> <meta name="DC.subject" content="RTVOBJD (Retrieve Object Description) command, Retrieve Object Description (RTVOBJD) command, command, CL, RTVOBJD (Retrieve Object Description), command, CL, Retrieve Object Description (RTVOBJD), object description, retrieving, library, retrieving object description" /> <meta name="keywords" content="RTVOBJD (Retrieve Object Description) command, Retrieve Object Description (RTVOBJD) command, command, CL, RTVOBJD (Retrieve Object Description), command, CL, Retrieve Object Description (RTVOBJD), object description, retrieving, library, retrieving object description" /> <meta name="DC.Relation" scheme="URI" content="objec.htm" /> <meta name="DC.Relation" scheme="URI" content="rtobjd.htm" /> <meta name="DC.Relation" scheme="URI" content="../apis/qusrobjd.htm" /> <meta name="DC.Relation" scheme="URI" content="../cl/rtvobjd.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="retod" /> <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>Retrieve object descriptions</title> </head> <body id="retod"><a name="retod"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">Retrieve object descriptions</h1> <div><p>You can use the <span class="cmdname">Retrieve Object Description (RTVOBJD)</span> command to return the descriptions of a specific object to a CL procedure. </p> <div class="section"><p>Variables are used to return the descriptions. You can use these descriptions to help you detect unused objects on the system.</p> <p>You can also use the <span class="apiname">Retrieve Object Description (QUSROBJD)</span> API to return the description of a specific object to a procedure. The system uses a variable to return the descriptions.</p> <p>The <span class="cmdname">Retrieve Object Description (RTVOBJD)</span> command can return the following descriptions as variables for an object:</p> <ul><li>The name of the library that contains the object</li> <li>Any extended attribute of an object (such as program or file type)</li> <li>User-defined attribute</li> <li>Text description of the object</li> <li>Name of the object owner's user profile</li> <li>Name of the primary group for the object</li> <li>Object ASP number</li> <li>Library ASP number</li> <li>Object ASP device</li> <li><img src="./delta.gif" alt="Start of change" />Object ASP group device<img src="./deltaend.gif" alt="End of change" /></li> <li>Library ASP device</li> <li><img src="./delta.gif" alt="Start of change" />Library ASP group device<img src="./deltaend.gif" alt="End of change" /></li> <li>Indication of whether or not the object overflowed the ASP in which it resides</li> <li>Date and time the object was created</li> <li>Date and time the object was last changed</li> <li>Date and time the object was last saved</li> <li>Date and time the object was last saved during a SAVACT (*LIB, *SYSDFN, or *YES) save operation</li> <li>Date and time the object was last restored</li> <li>Name of the object creator's user profile</li> <li>System the object was created on</li> <li>Object domain</li> <li>Whether or not usage data was collected</li> <li>Date the object was last used</li> <li>Count (number) of days the object was used</li> <li>Date the use count was last reset</li> <li>Storage status of the object data</li> <li>Compression status of the object</li> <li>Size of the object in bytes</li> <li><img src="./delta.gif" alt="Start of change" />Size of the primary associated space of object in bytes<img src="./deltaend.gif" alt="End of change" /></li> <li><img src="./delta.gif" alt="Start of change" />Indication of whether the space associated with the object has been optimally aligned<img src="./deltaend.gif" alt="End of change" /></li> <li>Size of the object in bytes of storage at the time of the last save</li> <li>Command used to save the object</li> <li>Tape sequence number generated when the object was saved on tape</li> <li>Tape or diskette volumes used for saving the object</li> <li>Type of the device the object was last saved to</li> <li>Name of the save file if the object was saved to a save file</li> <li>Name of the library that contains the save file if the object was saved to a save file</li> <li>File label used when the object was saved</li> <li>Name of the source file that was used to create the object</li> <li>Name of the library that contains the source file that was used to create the object</li> <li>Name of the member in the source file</li> <li>Date and time the member in the source file was last updated</li> <li>Level of the operating system when the object was created</li> <li>Licensed program identifier, release level, and modification level of the compiler</li> <li>Object control level for the created object</li> <li>Information about whether or not the object can be changed by the <span class="apiname">Change Object Description (QLICOBJDD)</span> API</li> <li>Indication of whether or not the object has been modified with the <span class="apiname">Change Object Description (QLICOBJD)</span> API</li> <li>Information about whether or not the program was changed by the user</li> <li>Name, release level, and modification level of the licensed program if the retrieved object is part of a licensed program</li> <li>Program Temporary Fix (PTF) number that resulted in the creation of the retrieved object</li> <li>Authorized Program Analysis Report (APAR) identification</li> <li>Type of auditing for the object</li> <li>Whether or not the object is digitally signed</li> <li>Digitally signed system-trusted source</li> <li>Digitally signed multiple signatures</li> <li>Current journal status for the object</li> <li>Current or last journal</li> <li>Journal image information</li> <li>Journal entries to be omitted information</li> <li>The date and time that journaling was last started</li> <li><img src="./delta.gif" alt="Start of change" />Name of the oldest journal receiver needed to successfully use the <span class="cmdname">Apply Journaled Changes (APYJRNCHG)</span> or <span class="cmdname">Remove Journaled Changes (RMVJRNCHG)</span> command<img src="./deltaend.gif" alt="End of change" /></li> <li><img src="./delta.gif" alt="Start of change" />Name of the library that contains the starting journal<img src="./deltaend.gif" alt="End of change" /></li> <li><img src="./delta.gif" alt="Start of change" />Name of the auxiliary storage pool (ASP) device where storage is allocated for the library that contains the starting journal receiver<img src="./deltaend.gif" alt="End of change" /></li> <li><img src="./delta.gif" alt="Start of change" />Name of the auxiliary storage pool (ASP) group where storage is allocated for the library that contains the starting journal receiver<img src="./deltaend.gif" alt="End of change" /></li> </ul> </div> </div> <div> <ul class="ullinks"> <li class="ulchildlink"><strong><a href="rtobjd.htm">Example: Use RTVOBJD</a></strong><br /> In this example CL procedure, a <span class="cmdname">Retrieve Object Description (RTVOBJD)</span> command retrieves the description of a specific object. </li> </ul> <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="../apis/qusrobjd.htm">Retrieve Object Description (QUSROBJD) API</a></div> <div><a href="../cl/rtvobjd.htm">Retrieve Object Description (RTVOBJD) command</a></div> </div> </div> </body> </html>