145 lines
9.1 KiB
HTML
145 lines
9.1 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="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>
|