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

210 lines
7.8 KiB
HTML
Raw Permalink 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>Display Software Resources (DSPSFWRSC)</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="DSPSFWRSC.Top_Of_Page"></a>
<h2>Display Software Resources (DSPSFWRSC)</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="#DSPSFWRSC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPSFWRSC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPSFWRSC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPSFWRSC"></a>
<p>The Display Software Resources (DSPSFWRSC) command allows you to show, print, or write to an output file the list of installed software resources.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPSFWRSC.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="#DSPSFWRSC.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 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPSFWRSC.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 2</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="#DSPSFWRSC.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</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>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPSFWRSC.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>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</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 output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
</dd>
</dl>
<p>
<b>Note: </b>If OUTPUT(*OUTFILE) is used, the name of the database file is required.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPSFWRSC.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the name and library of the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses the physical file QARZLCOF in the library list as a model file. The file has a record format name of QARZLCGD. Field level information can be obtained using the Display File Field Description (DSPFFD) command and specifying QARZLCOF as the file name and *LIBL as the library. If this function creates the file, the text says "Output file for DSPSFWRSC". The authority for users other than those who have specific authority, group authority, or authority from an authorization list, is the same as the create authority specified for the library in which the file is created. This parameter is valid only if OUTPUT(*OUTFILE) is specified.
</p>
<p>The name of the database file can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPSFWRSC.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the name of the database file member that receives the output of the command.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
</dd>
</dl>
<dl>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it. If the member exists, you have the option to add records to the end of the existing member, or clear the existing member and then add the new records.
</dd>
</dl>
<p>The optional values are:
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The system clears the existing member and adds the new records.
</dd>
</dl>
<dl>
<dt><b>*ADD</b></dt>
<dd>The system adds the new records to the end of the existing records.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPSFWRSC.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPSFWRSC OUTPUT(*OUTFILE) OUTFILE(*CURLIB/NAMES)
</pre>
</p>
<p>This command sends the output from the command to the first member of the file NAMES in the current library. The output replaces the information in the member.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPSFWRSC.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF0C4A</b></dt>
<dd>Product record not found.
</dd>
<dt><b>CPF0C4B</b></dt>
<dd>Product availability object &amp;2/&amp;1 recovery required.
</dd>
<dt><b>CPF0C4C</b></dt>
<dd>Cannot allocate object &amp;1 in library &amp;2.
</dd>
<dt><b>CPF0C4D</b></dt>
<dd>Error occurred while processing object &amp;1 in library &amp;2.
</dd>
<dt><b>CPF0C54</b></dt>
<dd>Data in product record not correct.
</dd>
<dt><b>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
<dt><b>CPF9871</b></dt>
<dd>Error occurred while processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPSFWRSC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>