231 lines
8.5 KiB
HTML
231 lines
8.5 KiB
HTML
|
|
||
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<title>Analyze User Objects (ANZUSROBJ)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="ANZUSROBJ.Top_Of_Page"></a>
|
||
|
|
<h2>Analyze User Objects (ANZUSROBJ)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#ANZUSROBJ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#ANZUSROBJ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#ANZUSROBJ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="ANZUSROBJ"></a>
|
||
|
|
<p>The Analyze User Objects (ANZUSROBJ) command collects or reports information for user-created objects on the system. It can be used to determine whether source exists which is likely to have been used in the creation of user objects.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The user must have *ALLOBJ special authority.
|
||
|
|
</li>
|
||
|
|
<li>This command, especially the *COLLECT stage, can be very long running. It is suggested that this command be executed in batch.
|
||
|
|
</li>
|
||
|
|
<li>There are three types of objects which are analyzed and reported on. They are:
|
||
|
|
<ul>
|
||
|
|
<li>Objects that appear to be created from source that is not available on the system.
|
||
|
|
</li>
|
||
|
|
<li>Objects which often contain user data but are not created from source.
|
||
|
|
</li>
|
||
|
|
<li>Source files which often contain source members which are part of an application but are not compiled into objects. Examples of these are REXX and FMTDTA source members.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Note that objects previously saved with STG(*FREE) are not analyzed to the same level of detail as other objects. This is done that so automatic retrieval systems are less likely to automatically restore the objects.
|
||
|
|
</p>
|
||
|
|
<p>When an object is listed the following information is reported:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Object name: the name of the user object. For files containing source members this will be blank for the member entries. The members will follow the file within the report.
|
||
|
|
</li>
|
||
|
|
<li>Object type: the type of the object. For files containing source members this will be the member extension for the member entries.
|
||
|
|
</li>
|
||
|
|
<li>Object extension: also used for source member name when listing REXX and FMTDTA members.
|
||
|
|
</li>
|
||
|
|
<li>Text: text description associated with the object or source member.
|
||
|
|
</li>
|
||
|
|
<li>Source last changed date/time: the date of last change for source found. If blank, this indicates the source is not available on the system or the object is an ILE program or service program which is created from modules and not source directly.
|
||
|
|
</li>
|
||
|
|
<li>Object creation source date/time: the date of last change for source used in the creation of the object. If blank, this indicates the object was not created from source or the object is an ILE program or service program which is created from modules and not source directly.
|
||
|
|
</li>
|
||
|
|
<li>Lines: the number of lines of source found.
|
||
|
|
</li>
|
||
|
|
<li>*: A column where a '1' indicates the object has not been used in the last twelve months.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="ANZUSROBJ.PARAMETERS.TABLE">Parameters</a></h3>
|
||
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
||
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
||
|
|
<tr>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
||
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ANZUSROBJ.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">Option</td>
|
||
|
|
<td valign="top">Values (up to 2 repetitions): *COLLECT, *REPORT</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ANZUSROBJ.RPTTYPE"><b>RPTTYPE</b></a></td>
|
||
|
|
<td valign="top">Type of report</td>
|
||
|
|
<td valign="top">Values (up to 3 repetitions): <b><u>*ALL</u></b>, *SYSSUM, *LIBSUM, *LIBDTL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ANZUSROBJ.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Libraries to analyze</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALLUSR</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#ANZUSROBJ.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">ASP device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *SYSBAS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="ANZUSROBJ.OPTION"></a>
|
||
|
|
<h3>Option (OPTION)</h3>
|
||
|
|
<p>Specifies whether data collection, data reporting, or both should be done.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*COLLECT</b></dt>
|
||
|
|
<dd>User object data in all user libraries is searched and collected for later analysis. If more than 333,000 libraries exist on the system, collection will be limited to the first 333,000 libraries. Performance will be better if less than 17,000 objects exist per library. If more than 333,000 objects exist in one library, collection will be limited to the first 333,000 objects in the library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REPORT</b></dt>
|
||
|
|
<dd>User object data is analyzed and reported for the libraries specified (LIB parameter).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ANZUSROBJ.RPTTYPE"></a>
|
||
|
|
<h3>Type of report (RPTTYPE)</h3>
|
||
|
|
<p>Specifies the types of user object reports that are to be generated.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The system summary, library summary, and library detail user object analysis reports are generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSSUM</b></dt>
|
||
|
|
<dd>The system summary report is generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIBSUM</b></dt>
|
||
|
|
<dd>The library summary report is generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIBDTL</b></dt>
|
||
|
|
<dd>The library detail report is generated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ANZUSROBJ.LIB"></a>
|
||
|
|
<h3>Libraries to analyze (LIB)</h3>
|
||
|
|
<p>Specifies the libraries to be analyzed when generating reports.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>All user libraries are analyzed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the library or group of libraries to be analyzed. To specify a generic library name, add an asterisk (*) at the end of the character string common to the names of all the libraries to analyze.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the full name of the library to analyze.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="ANZUSROBJ.ASPDEV"></a>
|
||
|
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
|
<p>Specifies the name of the ASP device to be analyzed when generating reports.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All ASP devices should be analyzed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSBAS</b></dt>
|
||
|
|
<dd>Only the system ASP and defined basic user ASPs should be analyzed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>ASP-device-name</i></b></dt>
|
||
|
|
<dd>Specify the ASP name that should be analyzed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ANZUSROBJ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Collecting Object Information</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ANZUSROBJ OPTION(*COLLECT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Information for user objects is all user libraries is collected for later analysis.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Generate Object Information Reports</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
ANZUSROBJ OPTION(*REPORT) LIB(MYLIB*)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Information previously collected by running ANZUSROBJ with OPTION(*COLLECT) will be analyzed for all libraries with names that begin with 'MYLIB'. System summary, library summary, and library detail user object analysis reports will be generated.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="ANZUSROBJ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#ANZUSROBJ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|