ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahh_5.4.0.1/dtaqkey.htm

63 lines
4.1 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="Keyed data queues" />
<meta name="abstract" content="The BaseDataQueue and KeyedDataQueue classes provide methods for working with keyed data queues." />
<meta name="description" content="The BaseDataQueue and KeyedDataQueue classes provide methods for working with keyed data queues." />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="dtaqkey" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Keyed data queues</title>
</head>
<body id="dtaqkey"><a name="dtaqkey"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Keyed data queues</h1>
<div><p>The BaseDataQueue and KeyedDataQueue classes provide methods for
working with keyed data queues.</p>
<div class="section"><p><a href="javadoc/com/ibm/as400/access/BaseDataQueue.html#NAVBAR_TOP"> BaseDataQueue</a> </p>
<p><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#NAVBAR_TOP"> KeyedDataQueue</a> </p>
<ul><li><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#CREATE(INT, INT)"> Create</a> a keyed data queue on the server. The Java™ program
must specify key length and maximum size of an entry on the queue. The Java program
can optionally specify authority information, save sender information, force
to disk, and provide a queue description.</li>
<li><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#PEEK(BYTE[])"> Peek</a> at an entry based on the specified key without
removing it from the queue. The Java program can wait or return immediately
if no entry is currently on the queue that matches the key criteria.</li>
<li><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#READ(BYTE[])"> Read</a> an entry off the queue based on the specified key.
The Java program
can wait or return immediately if no entry is available on the queue that
matches the key criteria.</li>
<li><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#WRITE(BYTE[], BYTE[])"> Write</a> a keyed entry to the queue.</li>
<li><a href="javadoc/com/ibm/as400/access/KeyedDataQueue.html#CLEAR(BYTE[])"> Clear</a> all entries or all entries that match a specified
key.</li>
<li><a href="javadoc/com/ibm/as400/access/BaseDataQueue.html#DELETE()"> Delete</a> the queue.</li>
</ul>
<p>The BaseDataQueue and KeyedDataQueue classes also provide additional
methods for retrieving the attributes of the data queue.</p>
</div>
<div class="section"><h4 class="sectiontitle">Examples: Working with keyed data queues</h4><p>The following
keyed data queue examples illustrate how a producer puts items on a data queue,
and how a consumer takes the items off the queue and processes them:</p>
<blockquote><p><a href="dqkeyedproducerexample.htm#dqkeyedproducerexample">Example: Using KeyedDataQueue</a></p>
<p><a href="dqkeyedconsumerexample.htm#dqkeyedconsumerexample">Example: Using KeyedDataQueue classes to read entries off a data queue</a></p>
</blockquote>
</div>
</div>
</body>
</html>