ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/prtdskinf.htm

360 lines
13 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Print Disk Information (PRTDSKINF)</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="PRTDSKINF.Top_Of_Page"></a>
<h2>Print Disk Information (PRTDSKINF)</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="#PRTDSKINF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTDSKINF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTDSKINF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTDSKINF"></a>
<p>The Print Disk Information (PRTDSKINF) command is used to print disk space information that was stored in database file QAEZDISK or QAEZDnnnnn by the Retrieve Disk Information (RTVDSKINF) command, where 'nnnnn' is the ASP number of the independent ASP for which disk space information was retrieved. The output with file name QPEZDISK goes to the spool queue associated with the job using this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTDSKINF.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="#PRTDSKINF.RPTTYPE"><b>RPTTYPE</b></a></td>
<td valign="top">Type of report</td>
<td valign="top">*LIB, *FLR, *OWN, *OBJ, *SYS</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.ASPDEV"><b>ASPDEV</b></a></td>
<td valign="top">ASP device</td>
<td valign="top"><i>Name</i>, <b><u>*SYSBAS</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.LIB"><b>LIB</b></a></td>
<td valign="top">Libraries</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.OWNER"><b>OWNER</b></a></td>
<td valign="top">Owners</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.FLR"><b>FLR</b></a></td>
<td valign="top">Folders</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.DOC"><b>DOC</b></a></td>
<td valign="top">Documents</td>
<td valign="top"><i>Generic name, name</i>, *ALL, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.OBJ"><b>OBJ</b></a></td>
<td valign="top">Objects</td>
<td valign="top"><i>Generic name, name</i>, *ALL, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object types</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 60 repetitions): *ALRTBL, *AUTL, *BLKSF, *BNDDIR, *CFGL, *CHTFMT, *CHRSF, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DEACR, *DEADI, *DEADS, *DIR, *DIRCR, *DIRDS, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FIFO, *FILE, *FLR, *FNTRSC, *FORMDF, *FTR, *GSS, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *MENU, *MGTCOL, *MRD, *MODD, *MODULE, *MSGF, *MSGQ, *NODL, *NODGRP, *NWID, *NWSCFG, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SRVPGM, *SSND, *STMF, *SVRSTG, *SOCKET, *SYMLNK, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.MINSIZE"><b>MINSIZE</b></a></td>
<td valign="top">Smallest size</td>
<td valign="top"><i>Decimal number</i>, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTDSKINF.SORT"><b>SORT</b></a></td>
<td valign="top">Sort by</td>
<td valign="top"><b><u>*SIZE</u></b>, *OWNER, *LSTCHG, *LSTUSE, *NAME</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTDSKINF.RPTTYPE"></a>
<h3>Type of report (RPTTYPE)</h3>
<p>Specifies the type of report to print. The report information is taken from member QCURRENT in QAEZDISK or QAEZDnnnnn, where 'nnnnn' is the ASP number of the independent ASP for which disk space information was retrieved. If QCURRENT does not contain any data, an error message is sent.
</p>
<p>This is a required parameter.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>If option *FLR is specified for the RPTTYPE parameter, *SYSBAS must be specified for the ASPDEV parameter. Folders are not allowed on auxiliary storage pool (ASP) devices, they are only allowed on the system ASP and basic ASPs.
</li>
</ul>
<dl>
<dt><b>*LIB</b></dt>
<dd>A report of the library information contained in the file is printed.
</dd>
<dt><b>*FLR</b></dt>
<dd>A report of the folder information contained in the file is printed.
</dd>
<dt><b>*OWN</b></dt>
<dd>A report of the user profile (owner) information contained in the file is printed.
</dd>
<dt><b>*OBJ</b></dt>
<dd>A report of object information contained in the file is printed.
</dd>
<dt><b>*SYS</b></dt>
<dd>A report of only the system information contained in the file is printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.ASPDEV"></a>
<h3>ASP device (ASPDEV)</h3>
<p>Specifies the auxiliary storage pool (ASP) device for which disk space information is to be printed.
</p>
<dl>
<dt><b><u>*SYSBAS</u></b></dt>
<dd>Disk information for the system ASP and all basic ASPs is printed. File QAEZDISK in library QUSRSYS contains the disk space information that is to be printed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the ASP device for which disk space information is to be printed. File QAEZDnnnnn in library QUSRSYS contains the disk space information that is to be printed, where 'nnnnn' is the ASP number of the specified ASP device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.LIB"></a>
<h3>Libraries (LIB)</h3>
<p>Specifies the names of the libraries to print information about.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The report has information on all user libraries on the system.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user library.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic library name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.OWNER"></a>
<h3>Owners (OWNER)</h3>
<p>Specifies the names of the owners (user profiles) to print information about.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The report contains information on all user profiles on the system.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of a user profile.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic user profile name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.FLR"></a>
<h3>Folders (FLR)</h3>
<p>Specifies the names of the folders to print information about.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The report has information on all user folders on the system.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the folder name.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic folder name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.DOC"></a>
<h3>Documents (DOC)</h3>
<p>Specifies the names of the documents to print information about.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The report contains information on all documents in the specified folder.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the document by the given name within the specified folder.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the documents specified by the generic qualification.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.OBJ"></a>
<h3>Objects (OBJ)</h3>
<p>Specifies the names of the objects to print information about.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>If you specify a library or owner, then the object information is all objects within the library or those controlled by the owner.
</dd>
<dt><b>*NONE</b></dt>
<dd>No library or owner is specified.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify a library or owner, then the object information is the object specified by the given name within the library or controlled by the owner.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify a library or owner, then the object information are the objects that meet the specified generic qualification within the library or controlled by the owner.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.OBJTYPE"></a>
<h3>Object types (OBJTYPE)</h3>
<p>Specifies the object types to print information about.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>If you specify a library or owner, information is printed on all the specified object types within the library or controlled by the owner. If an object name is specified, information on all object types with that name, within the library, or controlled by the owner is printed. If a library or owner is not specified, the report has information on all object types on the system. If an object name is specified, information only on object types with that name is printed.
</dd>
</dl>
<p><b>Other values (up to 60 repetitions)</b>
</p>
<dl>
<dt><b><i>object-type</i></b></dt>
<dd>Specify a library or owner, then the object type information is the object type specified within the library or controlled by the owner. If an object is specified, the report has information on the objects with the specified object type within the library or controlled by the owner.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.MINSIZE"></a>
<h3>Smallest size (MINSIZE)</h3>
<p>Specifies the size of the smallest piece of information to include. For example, if a library report is requested without objects, then this size would be the size of the smallest library to include. If objects within the library are requested, then this would be the size of the smallest object within the library to include.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>All objects are included regardless of size.
</dd>
<dt><b><i>size</i></b></dt>
<dd>Specify size in thousands of bytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTDSKINF.SORT"></a>
<h3>Sort by (SORT)</h3>
<p>Specifies the order in which the information should be sorted.
</p>
<dl>
<dt><b><u>*SIZE</u></b></dt>
<dd>Information is sorted from large to small.
</dd>
<dt><b>*OWNER</b></dt>
<dd>The information is sorted in alphabetical order by owner name.
</dd>
<dt><b>*LSTCHG</b></dt>
<dd>The information is sorted by last-change date with the oldest information first.
</dd>
<dt><b>*LSTUSE</b></dt>
<dd>The information is sorted by last-use date with the oldest information first.
</dd>
<dt><b>*NAME</b></dt>
<dd>Information is sorted in alphabetical order according to the report type.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTDSKINF.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
PRTDSKINF ASPDEV(*SYSBAS) RPTTYPE(*LIB) LIB(*ALL) OBJ(*ALL)
SORT(*SIZE)
</pre>
</p>
<p>This command prints a library report from database file QAEZDISK in library QUSRSYS in member QCURRENT, containing information about all libraries, objects, and object types in the libraries. The information is sorted by size and sent to the printer file QPEZDISK.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTDSKINF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1ED0</b></dt>
<dd>Current collection of disk space information not found.
</dd>
<dt><b>CPF1ED1</b></dt>
<dd>Not authorized to collect disk space information.
</dd>
<dt><b>CPF1ED2</b></dt>
<dd>File &amp;1 is in use and cannot be accessed.
</dd>
<dt><b>CPF1EEC</b></dt>
<dd>Not authorized to file &amp;1.
</dd>
<dt><b>CPF1E99</b></dt>
<dd>Unexpected error occurred.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>