109 lines
3.2 KiB
HTML
109 lines
3.2 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>dataq - Send or receive messages from i5/OS<SUP>(TM)</SUP> data queue</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>
|
||
|
|
dataq - Send or receive messages from i5/OS<SUP>(TM)</SUP> data queue</h2>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<strong>Synopsis</strong>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p><strong>dataq -c [-l]</strong> <em>queue</em></p>
|
||
|
|
|
||
|
|
<p><strong>dataq -r [-lp] [-n</strong> <em>number</em><strong>]
|
||
|
|
[-t</strong> <em>seconds</em><strong>]</strong> <em>queue</em></p>
|
||
|
|
|
||
|
|
<p><strong>dataq -w [-l] [-n</strong> <em>number</em><strong>]</strong> <em>queue</em>
|
||
|
|
<strong>[</strong> <em>data</em> ... <strong>]</strong></p>
|
||
|
|
|
||
|
|
<p><strong>Description</strong></p>
|
||
|
|
|
||
|
|
<p>The <strong>dataq</strong> utility clears messages from a data queue, reads messages from a data queue,
|
||
|
|
or writes messages to a data queue.</p>
|
||
|
|
|
||
|
|
<p>In the first synopsis form, <strong>dataq</strong> clears all of the messages from the
|
||
|
|
<em>queue</em>.</p>
|
||
|
|
|
||
|
|
<p>In the second synopsis form, <strong>dataq</strong> reads messages from the
|
||
|
|
<em>queue</em> and writes them to standard output. By default, it reads one
|
||
|
|
message from the <em>queue</em>. If no messages are available from the
|
||
|
|
<em>queue</em>, <strong>dataq</strong> waits for a message.</p>
|
||
|
|
|
||
|
|
<p>In the third synopsis form, <strong>dataq</strong> writes messages to the
|
||
|
|
<em>queue</em>. If <em>data</em> is specified, it is written as one message
|
||
|
|
to the <em>queue</em>. Otherwise, each line read from standard input is written
|
||
|
|
as a message to the <em>queue</em>.</p>
|
||
|
|
|
||
|
|
<p><strong>Options</strong></p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>-c</strong></dt>
|
||
|
|
|
||
|
|
<dd>Clear all of the messages from the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-l</strong></dt>
|
||
|
|
|
||
|
|
<dd>When a relative path name is specified, use the library list to find the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-n</strong> <em>number</em></dt>
|
||
|
|
|
||
|
|
<dd>If the <strong>-r</strong> option is specified, read <em>number</em> messages
|
||
|
|
from the <em>queue</em>. If the <strong>-w</strong> option is specified, write
|
||
|
|
<em>number</em> messages to the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-p</strong></dt>
|
||
|
|
|
||
|
|
<dd>Peek mode. When reading messages, the messages are left on the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-r</strong></dt>
|
||
|
|
|
||
|
|
<dd>Read messages from the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-t</strong> <em>seconds</em></dt>
|
||
|
|
|
||
|
|
<dd>When reading messages, exit if no messages have been received after <em>seconds</em> seconds
|
||
|
|
of waiting.</dd>
|
||
|
|
|
||
|
|
<dt><strong>-w</strong></dt>
|
||
|
|
|
||
|
|
<dd>Write messages from the <em>queue</em>.</dd>
|
||
|
|
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<p><strong>Operands</strong></p>
|
||
|
|
|
||
|
|
<p>The <em>queue</em> is the path name to a data queue. A data queue can only exist in
|
||
|
|
the QSYS.LIB file system.</p>
|
||
|
|
|
||
|
|
<p><strong>Exit Status</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>0 when successful</li>
|
||
|
|
|
||
|
|
<li>>0 when unsuccessful</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Related information</strong></p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="datarea.htm">datarea - Read or write i5/OS<SUP>(TM)</SUP> data area</a></li>
|
||
|
|
|
||
|
|
<li><a href="rfile.htm">Rfile - Read or write record files</a></li>
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|