friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0332907f0f
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspflr.htm

289 lines
9.9 KiB
HTML
Raw Blame History

<!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 Folder (DSPFLR)</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="DSPFLR.Top_Of_Page"></a>
<h2>Display Folder (DSPFLR)</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="#DSPFLR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPFLR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPFLR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPFLR"></a>
<p>The Display Folder (DSPFLR) command allows you to display or print a list of folders and documents, or to create an output file that contains the list of folders or documents.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPFLR.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="#DSPFLR.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPFLR.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type of object</td>
<td valign="top"><b><u>*FLR</u></b>, *DOC</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPFLR.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 3</td>
</tr>
<tr>
<td valign="top"><a href="#DSPFLR.LEVEL"><b>LEVEL</b></a></td>
<td valign="top">Level of list</td>
<td valign="top">*ALL, <b><u>*CURRENT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPFLR.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</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="#DSPFLR.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>
<tr>
<td valign="top"><a href="#DSPFLR.OUTFILFMT"><b>OUTFILFMT</b></a></td>
<td valign="top">Outfile format</td>
<td valign="top">*TYPE1, <b><u>*TYPE2</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPFLR.FLR"></a>
<h3>Folder (FLR)</h3>
<p>Specifies the names of folders or members on the list.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All folders that the user has authority to see are listed.
</dd>
<dt><b><i>folder-name</i></b></dt>
<dd>Specify the name of the folder whose contents is listed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.TYPE"></a>
<h3>Type of object (TYPE)</h3>
<p>Specifies whether folders or documents are listed.
</p>
<dl>
<dt><b><u>*FLR</u></b></dt>
<dd>The list contains folders that the user has authority to see.
</dd>
<dt><b>*DOC</b></dt>
<dd>The list contains documents that the user has authority to see.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.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>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed.
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
</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>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.LEVEL"></a>
<h3>Level of list (LEVEL)</h3>
<p>Specifies whether the list includes folders nested within the folders listed or only the folders at the current level. This parameter is not allowed when (*) is specified on the <b>Output</b> prompt (OUTPUT parameter).
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>The list includes folders nested within the folders at the specified level.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>Only folders at the specified level are listed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the name and library of the database file that receives the output of the command. If the file does not exist, this command creates a database file in the specified library.
</p>
<p>The possible library 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 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 file is located.
</dd>
</dl>
<p>
<b>Note: </b>If you specify *FLR on the <b>Type of object</b> prompt (TYPE parameter) and a new file is created, system file QADSPFLR in system library QSYS with a format name of FLRDTL is used as a model.
</p>
<p>If you specify *DOC on the <b>Type of object</b> prompt (TYPE parameter) and a new file is created, system file QADSPDOC in system library QSYS with a format name of DOCDTL is used as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.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 <b>member to receive output</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If the file member does not exist, the system creates a member with the name of the file specified in the <b>File to receive output</b> prompt (OUTFILE parameter).
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If the file member does not exist, the system creates the member.
</dd>
</dl>
<p>The possible <b>replace or add records</b> values are:
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The output data replaces any existing records in the specified member.
</dd>
<dt><b>*ADD</b></dt>
<dd>The output data is added to the end of the existing records in the specified member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPFLR.OUTFILFMT"></a>
<h3>Outfile format (OUTFILFMT)</h3>
<p>Specifies the format of the database file to which the output of the display is directed.
</p>
<dl>
<dt><b>*TYPE1</b></dt>
<dd>Output is directed to the file format used for Release V2R2 and all releases prior to V2R2. The format used is defined by model output file QADSPSDC (Document format) and QADSPSFR (Folder format) in library QSYS with record named DOCDTLS and FLRDTLS respectively.
</dd>
<dt><b>*TYPE2</b></dt>
<dd>Output is directed to the file format used for Release V2R3 and all releases thereafter. The format used is defined by model output file QADSPDOC (Document Format) and QADSPFLR (Folder format) in library QSYS with record format named DOCDTL and FLRDTL respectively.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPFLR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying or Printing Output</b>
</p>
<p>
<pre>
DSPFLR FLR(GENERAL) TYPE(*FLR) OUTPUT(*)
</pre>
</p>
<p>This command shows a list of folders for the folder, GENERAL, at the requesting work station (if requested by an interactive job) or the output is printed with the job's spooled output (if requested by a batch job).
</p>
<p><b>Example 2: Directing Output to a Database File</b>
</p>
<p>
<pre>
DSPFLR FLR(*ALL) TYPE(*FLR) OUTPUT(*OUTFILE) LEVEL(*ALL)
OUTFILE(MYLIB/MYFILE) OUTMBR(MYMBR *REPLACE)
</pre>
</p>
<p>This command shows all the folders that the user has authority to view. The output is directed to MYMBR, in MYFILE located in MYLIB. If member MYMBR already exists, MYMBR is cleared and then the new records are added.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPFLR.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPFLR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink