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

116 lines
4.8 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>Retrieve Disk Information (RTVDSKINF)</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="RTVDSKINF.Top_Of_Page"></a>
<h2>Retrieve Disk Information (RTVDSKINF)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>
<ul><li>Batch job (*BATCH)</li>
<li>Batch program (*BPGM)</li>
<li>Batch REXX procedure (*BREXX)</li>
<li>Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)</li>
</ul><b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVDSKINF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVDSKINF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVDSKINF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVDSKINF"></a>
<p>The Retrieve Disk Information (RTVDSKINF) command is used to collect disk space information. The collected information is stored in a database file in library QUSRSYS. The file name depends on the auxiliary storage pool (ASP) device for which disk space information is retrieved. If the information was retrieved from the system and basic ASPs, the collected information will be stored in file QAEZDISK. If the information was retrieved from an independent ASP device, the collected information will be stored in file QAEZnnnnn, where 'nnnnn' is the ASP number of the independent ASP. The information will be stored in a data base file member named QCURRENT.
</p>
<p>Each time this command is run, existing information in QCURRENT is written over. To save existing information in member QCURRENT, rename file QAEZDISK or QAEZDnnnnn, or copy the member to another file.
</p>
<p>To get the most accurate results, this command should be run at a time when there is very little system activity.
</p>
<p>
<b>Note: </b>Do not rename member QCURRENT within file QAEZDISK or QAEZDnnnnn. If there is more than one member in QAEZDISK or QAEZDnnnnn, the results of running this command can be unpredictable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVDSKINF.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="#RTVDSKINF.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, Positional 1</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVDSKINF.ASPDEV"></a>
<h3>ASP device (ASPDEV)</h3>
<p>Specifies the auxiliary storage pool (ASP) device for which disk space information is to be retrieved.
</p>
<dl>
<dt><b><u>*SYSBAS</u></b></dt>
<dd>Disk information for the system ASP and all basic ASPs is retrieved. The system ASP has an ASP number of 1. Basic ASPs have ASP numbers from 2 through 32.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the ASP device for which disk space information is to be retrieved. Independent ASP devices have ASP numbers greater than 32. You can submit multiple jobs, each performing RTVDSKINF on a different ASP device, to retrieve disk space information for multiple ASP devices in parallel.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVDSKINF.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RTVDSKINF ASPDEV(*SYSBAS)
</pre>
</p>
<p>This command retrieves disk space information for the system and basic auxiliary storage pools (ASPs), and stores it in member QCURRENT of database file QAEZDISK. Any information in member QCURRENT is overwritten.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVDSKINF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>CPF1E99</b></dt>
<dd>Unexpected error occurred.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVDSKINF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>