326 lines
13 KiB
HTML
326 lines
13 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>Display Hardware Resources (DSPHDWRSC)</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="DSPHDWRSC.Top_Of_Page"></a>
|
|
<h2>Display Hardware Resources (DSPHDWRSC)</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="#DSPHDWRSC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPHDWRSC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPHDWRSC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPHDWRSC"></a>
|
|
<p>The Display Hardware Resources (DSPHDWRSC) command is used to display, print, or save in an output file the various types of System Resource Management (SRM) information.
|
|
</p>
|
|
<p><b>Restriction:</b> The Work with LAN Adapters (WRKLANADPT) command must be run before running this command; otherwise, there is no information to display.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPHDWRSC.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="#DSPHDWRSC.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top">*AHW, *CMN, *CRP, *CSA, *LAN, *LWS, *PRC, *STG</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPHDWRSC.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPHDWRSC.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">File to receive output</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#DSPHDWRSC.OUTMBR"><b>OUTMBR</b></a></td>
|
|
<td valign="top">Output member options</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Member to receive output</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replace or add records</td>
|
|
<td valign="top">
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPHDWRSC.OUTFILFMT"><b>OUTFILFMT</b></a></td>
|
|
<td valign="top">Outfile format</td>
|
|
<td valign="top"><b><u>*TYPE1</u></b>, *TYPE2</td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPHDWRSC.LINETYPE"><b>LINETYPE</b></a></td>
|
|
<td valign="top">Line type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *DDI, *TRN</td>
|
|
<td valign="top">Optional, Positional 6</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPHDWRSC.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies the type of information that is to be displayed, printed, or written to an output file.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AHW</b></dt>
|
|
<dd>Displays, prints, or directs to an output file the combined contents of all hardware resource records. This includes all *CMN, *CRP, *CSA, *LWS, *PRC, and *STG records.
|
|
</dd>
|
|
<dt><b>*CMN</b></dt>
|
|
<dd>Displays, prints, or writes to an output file the communications resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
|
|
</dd>
|
|
<dt><b>*CRP</b></dt>
|
|
<dd>Displays, prints, or writes to an output file the cryptographic resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
|
|
</dd>
|
|
<dt><b>*CSA</b></dt>
|
|
<dd>Displays, prints, or directs to an output file the coupled adapter resource information. This information consists of resource name, model, status, location, resource description, and the system the adapter is connected to.
|
|
</dd>
|
|
<dt><b>*LAN</b></dt>
|
|
<dd>Displays, prints, or directs token-ring or distributed data interface adapter resource information to an output file. This information consists of the LAN controller adapter address, adapter name, line type, and adapter description.
|
|
</dd>
|
|
<dt><b>*LWS</b></dt>
|
|
<dd>Displays, prints, or writes to an output file the local work station resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
|
|
</dd>
|
|
<dt><b>*PRC</b></dt>
|
|
<dd>Displays, prints, or writes to an output file the processor resource information. This information consists of the resource name, resource type, serial number, location, status, and resource description.
|
|
</dd>
|
|
<dt><b>*STG</b></dt>
|
|
<dd>Displays, prints, or writes to an output file the storage devices resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPHDWRSC.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>Output requested by an interactive job is shown in the display. Output requested by a batch job is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*OUTFILE</b></dt>
|
|
<dd>The requested data is stored in an output database file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPHDWRSC.OUTFILE"></a>
|
|
<h3>File to receive output (OUTFILE)</h3>
|
|
<p>Specifies the name and library of the output file used to store the requested System Resource Management (SRM) data. Only one of the following types of resource information can be stored per output file: *CMN, *CRP, *CSA, *LWS, *PRC, *STG, or *LAN. If the output file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses as a model one of the following file names with one of the following format names, depending on the value specified on the <b>Type</b> prompt (TYPE parameter).
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TYPE Parameter Output File Created
|
|
Value Output File Format
|
|
*CMN QARZDCMN QRZDCMN
|
|
*CRP QARZDCRP QRZDCRP
|
|
*CSA QARZDCSA QRZDCSA
|
|
*LWS QARZDLWS QRZDLWS
|
|
*PRC QARZDPRC QRZDPRC
|
|
*STG QARZDSTG QRZDSTG
|
|
*LAN QARZDTRA QRZDTRA
|
|
</pre>
|
|
</p>
|
|
<p>This parameter is valid only if *OUTFILE is specified on the <b>Output</b> prompt (OUTPUT parameter).
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the output file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the output file is located.
|
|
</dd>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the name of the file where the requested information is to be stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPHDWRSC.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The requested SRM data is stored in the first member.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member used to store the requested SRM data. Valid values range from 1 through 10 characters.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible <b>optional</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>If a member exists, the old information is cleared and the new information is added.
|
|
</dd>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>If a member exists, the new information is added to the end of the existing information.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPHDWRSC.OUTFILFMT"></a>
|
|
<h3>Outfile format (OUTFILFMT)</h3>
|
|
<p>Specifies the physical file model used to format the output file.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is not used when TYPE(*LAN) is specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TYPE1</u></b></dt>
|
|
<dd>The format of the output file is the same as that of the physical file models, QARZDCMN, QARZDCRP, QARZDCSA, QARZDLWS, QARZDPRC, and QARZDSTG.
|
|
</dd>
|
|
<dt><b>*TYPE2</b></dt>
|
|
<dd>The format of the output file is the same as that of the physical file model, QARZALLF, and its associated record format model, QRZALL. This value is the functional equivalent of the physical file, QARZHWOF, which was used by the DSPLCLHDW command in releases prior to V3R6M0.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPHDWRSC.LINETYPE"></a>
|
|
<h3>Line type (LINETYPE)</h3>
|
|
<p>Specifies the local area network (LAN) type for which information will be displayed, printed, or directed to an output file.
|
|
</p>
|
|
<p>This parameter is required if TYPE(*LAN) was specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Both distributed data interface and token-ring network adapter resource information is displayed, printed, or directed to an output file.
|
|
</dd>
|
|
<dt><b>*DDI</b></dt>
|
|
<dd>All distributed data interface adapter resource information is displayed, printed, or directed to an output file.
|
|
</dd>
|
|
<dt><b>*TRN</b></dt>
|
|
<dd>All token-ring network adapter resource information is displayed, printed, or directed to an output file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPHDWRSC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
DSPHDWRSC TYPE(*STG)
|
|
OUTPUT(*OUTFILE) OUTFILE(STG) OUTFILFMT(*TYPE2)
|
|
</pre>
|
|
</p>
|
|
<p>This command places SRM information for storage resources in the output file STG, which is formatted like the physical file model, QARZALLF. If output file STG is located in the library list, the records of its first member are replaced by the new records. If output file STG is not located in the library list, it is created in the current library with first member STG. This member contains the new records.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPHDWRSC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8B75</b></dt>
|
|
<dd>No adapter entries in network adapter file.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9815</b></dt>
|
|
<dd>Member &5 file &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9860</b></dt>
|
|
<dd>Error occurred during output file processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPHDWRSC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|