ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahz_5.4.0.1/datarea.htm

90 lines
2.7 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8">
<title>datarea - Read or write i5/OS<SUP>(TM)</SUP> data area</title>
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</HEAD>
<body bgcolor="#FFFFFF">
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h2>
datarea - Read or write i5/OS<SUP>(TM)</SUP> data area</h2>
<p>
<strong>Synopsis</strong>
</p>
<p><strong>datarea -r [-l] [-s</strong> <em>substring</em><strong>]</strong> <em>data-area</em></p>
<p><strong>datarea -w [-l] [-s</strong> <em>substring</em><strong>]</strong> <em>data-area</em>
<strong>[</strong> <em>data</em> ... <strong>]</strong></p>
<p><strong>Description</strong></p>
<p>The <strong>datarea</strong> utility reads or writes a data area.</p>
<p>In the first synopsis form, <strong>datarea</strong> reads the contents of the
<em>data-area</em> and writes it to standard output. By default, it reads the
entire data area.</p>
<p>In the second synopsis form, <strong>datarea</strong> writes to the
<em>data-area</em>. If <em>data</em> is specified, it is written
to the <em>data-area</em>. Otherwise, one line is read from standard input and written
to the <em>data-area</em>.</p>
<p><strong>Options</strong></p>
<dl>
<dt><strong>-l</strong></dt>
<dd>When a relative path name is specified, use the library list to find the <em>data-area</em>.</dd>
<dt><strong>-r</strong></dt>
<dd>Read from the <em>data-area</em>.</dd>
<dt><strong>-s</strong> <em>substring</em></dt>
<dd>For a character type data area, read or write the character positions specified by <em>substring</em>.
The <em>substring</em> is specified as a number range that consists of a number, a dash (-), and a
second number to select the character positions from the first number to the second number, inclusive.
If the first number is omitted, character positions from 1 to the second number are selected. If
the second number is omitted, character positions from the first number to the end of the data area
are selected.</dd>
<dt><strong>-w</strong></dt>
<dd>Write to the <em>data-area</em>.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>The <em>data-area</em> is the path name to a data area. A data area can only exist in
the QSYS.LIB file system.</p>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 when successful</li>
<li>&gt;0 when unsuccessful</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="dataq.htm">dataq - Send and receive messages from i5/OS<SUP>(TM)</SUP> data queue</a></li>
<li><a href="rfile.htm">Rfile - Read or write record files</a></li>
</ul>
</body>
</html>