212 lines
6.5 KiB
HTML
212 lines
6.5 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>Start DFU (STRDFU)</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="STRDFU.Top_Of_Page"></a>
|
|
<h2>Start DFU (STRDFU)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#STRDFU.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRDFU.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRDFU.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRDFU"></a>
|
|
<p>The Control Language (CL) command STRDFU starts the data file utility (DFU).
|
|
</p>
|
|
<h3>Error messages for STRDFU</h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>DFU0005</b></dt>
|
|
<dd>The command failed.
|
|
</dd>
|
|
<dt><b>DFU0018</b></dt>
|
|
<dd>The Run option is not valid.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRDFU.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" rowspan="3"><a href="#STRDFU.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: DFU option</td>
|
|
<td valign="top">
|
|
1-5, <b><u>*SELECT</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Run option</td>
|
|
<td valign="top">
|
|
1-2, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRDFU.DFUPGM"><b>DFUPGM</b></a></td>
|
|
<td valign="top">DFU program</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: DFU program</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#STRDFU.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Data base file</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: Data base file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *SAME</td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRDFU.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *FIRST</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRDFU.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies the option to use as a value for the DFU main menu.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SELECT</u></b></dt>
|
|
<dd>The DFU main menu appears. You can select an option from the menu.
|
|
</dd>
|
|
<dt><b>first-menu-option</b></dt>
|
|
<dd>Type a number between 1 and 5. Type 1 to run, 2 to create, 3 to change, or 4 to delete a DFU program. Type 5 to run a temporary DFU program.
|
|
</dd>
|
|
<dt><b>second-menu-option</b></dt>
|
|
<dd>If you type 1 (to run a DFU program), you can also type a second option. The second option must be 1 or 2. Type 1 to change data, or 2 to display data without changing it.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDFU.DFUPGM"></a>
|
|
<h3>DFU program (DFUPGM)</h3>
|
|
<p>Specifies the name of the DFU program to be run, created, changed, or deleted. You do not use this parameter if you select option 5 (to run a temporary DFU program).
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>DFU will use the program that was used in your last DFU session.
|
|
</dd>
|
|
<dt><b>program-name</b></dt>
|
|
<dd>Type the qualified name of the DFU program to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDFU.FILE"></a>
|
|
<h3>Data base file (FILE)</h3>
|
|
<p>Specifies the database file you want to change or display.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>DFU will use the file that was used in your last DFU session.
|
|
</dd>
|
|
<dt><b>*SAME</b></dt>
|
|
<dd>DFU will use the file that was used to define the program. You can specify *SAME only if you select option 1 (to run a DFU program) or option 3 (to change a DFU program).
|
|
</dd>
|
|
<dt><b>file-name</b></dt>
|
|
<dd>Type the qualified name of the data file you want DFU to process. (If you do not specify a library name, *LIBL is used.)
|
|
<p>
|
|
<b>Note: </b>Make sure the data-file name is different from the DFU program name.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDFU.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member in the file you want to change or display.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>DFU will use the member that was used in your last DFU session.
|
|
</dd>
|
|
<dt><b>member-name</b></dt>
|
|
<dd>Type the name of the member you want DFU to process.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="STRDFU.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRDFU.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>DFU0005</b></dt>
|
|
<dd>The command failed.
|
|
</dd>
|
|
<dt><b>DFU0018</b></dt>
|
|
<dd>The Run option is not valid.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDFU.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|