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

191 lines
5.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>Change Data (CHGDTA)</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="CHGDTA.Top_Of_Page"></a>
<h2>Change Data (CHGDTA)</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="#CHGDTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGDTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGDTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGDTA"></a>
<p>The Control Language (CL) command CHGDTA lets you add, change, or delete records in an existing database file.
</p>
<h3>Error messages for CHGDTA</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IDU0120</b></dt>
<dd>Critical table missing. Command terminated.
</dd>
<dt><b>IDU0141</b></dt>
<dd>Critical table inconsistent. Command terminated.
</dd>
<dt><b>IDU0167</b></dt>
<dd>Not authorized to &amp;1.&amp;2.
</dd>
<dt><b>IDU1205</b></dt>
<dd>Application &amp;1.&amp;2 not found.
</dd>
<dt><b>IDU9001</b></dt>
<dd>Error found on &amp;1 command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDTA.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="#CHGDTA.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">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: DFU program</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="#CHGDTA.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 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Data base file</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></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"><a href="#CHGDTA.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGDTA.DFUPGM"></a>
<h3>DFU program (DFUPGM)</h3>
<p>Specifies the qualified name of the DFU program that will control the interactive update of data.
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>DFU will use your library list to search for a specified program.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Type *CURLIB to use your current library. If no current library entry exists in the library list, QGPL is used. If you do not specify a library name, *LIBL is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDTA.FILE"></a>
<h3>Data base file (FILE)</h3>
<p>Specifies the database file you want to process.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>DFU will use the file that was used to define the program.
</dd>
<dt><b>file-name</b></dt>
<dd>Type the qualified name of the data file you want DFU to process. The file should have at least one record format name in common with the file used to define the program.
</dd>
<dt><b>*LIBL</b></dt>
<dd>DFU will use your library list to search for a specified program.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Type *CURLIB to use your current library. If no current library entry exists in the library list, QGPL is used. If you do not specify a library name, *LIBL is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGDTA.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the member in the file you want to process.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>DFU will use the first member of the file.
</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="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGDTA.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGDTA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>IDU0120</b></dt>
<dd>Critical table missing. Command terminated.
</dd>
<dt><b>IDU0141</b></dt>
<dd>Critical table inconsistent. Command terminated.
</dd>
<dt><b>IDU0167</b></dt>
<dd>Not authorized to &amp;1.&amp;2.
</dd>
<dt><b>IDU1205</b></dt>
<dd>Application &amp;1.&amp;2 not found.
</dd>
<dt><b>IDU9001</b></dt>
<dd>Error found on &amp;1 command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGDTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>