ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/remdq.htm

89 lines
5.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="task" />
<meta name="DC.Title" content="Remote data queues" />
<meta name="abstract" content="Remote data queues are data queues that reside on a remote server." />
<meta name="description" content="Remote data queues are data queues that reside on a remote server." />
<meta name="DC.subject" content="remote data queues" />
<meta name="keywords" content="remote data queues" />
<meta name="DC.Relation" scheme="URI" content="qcomm.htm" />
<meta name="DC.Relation" scheme="URI" content="../ddm/rbae5crtdq.htm" />
<meta name="DC.Relation" scheme="URI" content="../ddm/rbae5kickoff.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="remdq" />
<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>Remote data queues</title>
</head>
<body id="remdq"><a name="remdq"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Remote data queues</h1>
<div><p>Remote data queues are data queues that reside on a remote server.</p>
<div class="section"> <p>You can access remote data queues with Distributed Data Management
(DDM) files. DDM files make it possible for a program residing on one server
to access a data queue on a remote server to perform any of the following
functions: </p>
<ul><li>send data to a data queue</li>
<li>receive data from a data queue</li>
<li>clear data from a data queue</li>
</ul>
<p>An application program that currently uses a standard data queue can
also access a remote DDM data queue without changing or compiling the application
again. To ensure the correct data queue is accessed, you may need to do one
of the following: </p>
<ul><li>Delete the standard data queue and create a DDM data queue that has the
same name as the original standard data queue.</li>
<li>Rename the standard data queue.</li>
</ul>
<p>You can create a DDM data queue with the following command: </p>
<pre> CRTDTAQ DTAQ(LOCALLIB/DDMDTAQ) TYPE(*DDM)
RMTDTAQ(REMOTELIB/REMOTEDTAQ) RMTLOCNAME(SYSTEMB)
TEXT('DDM data queue to access data queue on SYSTEMB')</pre>
<p>You can also use an expansion of the previous example ("Master
Job/Server Job") to create a DDM data queue to use with remote data queues.
The master job resides on SystemA; the data queues and server jobs are moved
to SystemB. After creating two DDM data queues (INPUT and STATUS), the master
job continues to communicate asynchronously with the server jobs that reside
on SystemB. The following example shows how to create a DDM data queue with
remote data queues: </p>
<pre> CRTDTAQ DTAQ(LOCALLIB/INPUT) TYPE(*DDM)
RMTDTAQ(REMOTELIB/INPUT) RMTLOCNAME(SystemB)
TEXT('DDM data queue to access INPUT on SYSTEMB')
CRTDTAQ DTAQ(LOCALLIB/STATUS) TYPE(*DDM)
RMTDTAQ(REMOTELIB/STATUS) RMTLOCNAME(SystemB)
TEXT('DDM data queue to access STATUS on SYSTEMB')</pre>
<p>The master job calls QSNDDTAQ, then passes the data queue name
of LOCALLIB/INPUT and sends the data to the remote data queue (REMOTELIB/INPUT)
on SystemB. To receive data from the remote data queue, (REMOTELIB/STATUS),
the master job passes the data queue name of LOCALLIB/STATUS for the call
to QRCVDTAQ.</p>
<div class="fignone" id="remdq__rmtdq"><a name="remdq__rmtdq"><!-- --></a><span class="figcap">Figure 1. Example of Accessing
a Remote Data Queue</span><br /><img src="rbafn538.gif" alt="Example of Accessing a Remote Data Queue" /><br /></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="qcomm.htm" title="Data queues are a type of system object that you can create, to which one HLL procedure or program can send data, and from which another HLL procedure or program can receive data.">Use data queues</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../ddm/rbae5crtdq.htm">CRTDTAQ (Create Data Queue) command in DDM</a></div>
<div><a href="../ddm/rbae5kickoff.htm">Distributed data management</a></div>
</div>
</div>
</body>
</html>