850 lines
25 KiB
HTML
850 lines
25 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
<html>
|
||
|
<head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
<title>Retrieve Data Queue Description (QMHQRDQD) API</title>
|
||
|
<!-- Begin Header Records ========================================== -->
|
||
|
<!-- 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. -->
|
||
|
<!-- QMHQRDQD SCRIPT A converted by B2H R4.1 (346) (CMS) by PMHALL at -->
|
||
|
<!-- RCHVMW2 on 2 Oct 1998 at 13:46:25 -->
|
||
|
<!-- Change History: -->
|
||
|
<!-- YYMMDD USERID Change description -->
|
||
|
<!-- Edited by Kersten Jan 02 -->
|
||
|
<!--End Header Records -->
|
||
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
</head>
|
||
|
<body>
|
||
|
<a name="Top_Of_Page"></a>
|
||
|
<!-- Java sync-link -->
|
||
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
||
|
</script>
|
||
|
|
||
|
<h2>Retrieve Data Queue Description (QMHQRDQD) API</h2>
|
||
|
|
||
|
<div class="box" style="width: 60%;">
|
||
|
<br>
|
||
|
Required Parameter Group:<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
<table width="100%">
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">1</td>
|
||
|
<td align="left" valign="top" width="50%">Receiver variable</td>
|
||
|
<td align="left" valign="top" width="20%">Output</td>
|
||
|
<td align="left" valign="top" width="20%">Char(*)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">2</td>
|
||
|
<td align="left" valign="top">Length of receiver variable</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">3</td>
|
||
|
<td align="left" valign="top">Format name</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(8)</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="left" valign="top">Qualified data queue name</td>
|
||
|
<td align="left" valign="top">Input</td>
|
||
|
<td align="left" valign="top">Char(20)</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
Default Public Authority: *USE<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
Threadsafe: Yes<br>
|
||
|
<!-- iddvc RMBR -->
|
||
|
<br>
|
||
|
</div>
|
||
|
|
||
|
<p>The Retrieve Data Queue Description (QMHQRDQD) API retrieves the description
|
||
|
and attributes of a data queue. Examples include the number of entries
|
||
|
currently on the data queue, the text description of the data queue, whether
|
||
|
the queue includes sender ID information, and whether the data queue is
|
||
|
keyed.</p>
|
||
|
|
||
|
<p>The attributes of a distributed data management (DDM) data queue can be
|
||
|
retrieved with this API.</p>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Authorities and Locks</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><em>Data Queue Authority</em></dt>
|
||
|
|
||
|
<dd>*OBJOPR and *READ</dd>
|
||
|
|
||
|
<dt><em>Data Queue Library Authority</em></dt>
|
||
|
|
||
|
<dd>*EXECUTE</dd>
|
||
|
|
||
|
<dt><em>Data Queue Lock</em></dt>
|
||
|
|
||
|
<dd>*EXCLRD</dd>
|
||
|
</dl>
|
||
|
|
||
|
<p>Internally, when a job uses API QSNDDTAQ (Send Data Queue), QRCVDTAQ
|
||
|
(Receive Data Queue), QMHQRDQD (Retrieve Data Queue Description), or QMHRDQM
|
||
|
(Retrieve Data Queue Message), a cache is created to allow faster access to the
|
||
|
data queue. An entry in the cache means a user is authorized to the data queue.
|
||
|
An entry is added to the cache when a user calling one of the APIs has the
|
||
|
required authority to the data queue. An entry is also added to the cache when
|
||
|
QSNDDTAQ is called to handle a journal entry for a data queue created with the
|
||
|
sender ID attribute set to *YES, and the user requesting the the send function
|
||
|
has the required authority to the current profile name in the sender ID
|
||
|
information of the journal entry. The data in the cache is used until the job
|
||
|
ends, so if you need to immediately change a user's authority to one of these
|
||
|
objects, you may need to end that user's jobs.</p>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Required Parameter Group</h3>
|
||
|
|
||
|
<dl>
|
||
|
<dt><strong>Receiver variable</strong></dt>
|
||
|
|
||
|
<dd>OUTPUT; CHAR(*)
|
||
|
|
||
|
<p>The receiver variable that receives the information requested. You can
|
||
|
specify the size of the area to be smaller than the format requested as long as
|
||
|
you specify the length parameter correctly. As a result, the API returns only
|
||
|
the data that the area can hold.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Length of receiver variable</strong></dt>
|
||
|
|
||
|
<dd>INPUT; BINARY(4)
|
||
|
|
||
|
<p>The length of the receiver variable provided. The length of receiver
|
||
|
variable parameter may be specified up to the size of the receiver variable
|
||
|
specified in the user program. If the length of receiver variable parameter
|
||
|
specified is larger than the allocated size of the receiver variable specified
|
||
|
in the user program, the results are not predictable. The minimum length is 8
|
||
|
bytes.</p>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Format name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(8)
|
||
|
|
||
|
<p>The format of the data queue description to be returned.</p>
|
||
|
|
||
|
<p>The valid format names are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><a href="#HDRRDQD10">RDQD0100</a></em></td>
|
||
|
<td align="left" valign="top">Basic data queue description.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em><a href="#HDRRDQD12">RDQD0200</a></em></td>
|
||
|
<td align="left" valign="top">DDM data queue description. This is valid for DDM
|
||
|
data queues only.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
</dd>
|
||
|
|
||
|
<dt><strong>Qualified data queue name</strong></dt>
|
||
|
|
||
|
<dd>INPUT; CHAR(20)
|
||
|
|
||
|
<p>The data queue whose description is to be returned. The first 10 characters
|
||
|
contain the data queue name, and the second 10 characters contain the data
|
||
|
queue library name.</p>
|
||
|
|
||
|
<p>You can use these special values for the library name:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
||
|
<td align="left" valign="top">The job's current library</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
||
|
<td align="left" valign="top">The library list</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p><strong>Note:</strong> To improve data queue performance, the data queue
|
||
|
APIs remember addressing information for the last data queues used. This occurs
|
||
|
when a specific (not *LIBL or *CURLIB) value is provided for the library name,
|
||
|
and the data queue is located
|
||
|
in the system auxiliary storage pool (ASP number 1) or a basic user ASP (ASP
|
||
|
numbers 2-32). The addressing information for data queues located in
|
||
|
independent ASPs is not saved.</p>
|
||
|
|
||
|
<p>Because the addressing information is saved, users of this API should be
|
||
|
aware of the following scenario:</p>
|
||
|
|
||
|
<p>If, a job references a data queue the data queue is moved using the Move
|
||
|
Object (MOVOBJ) command or renamed using the Rename Object (RNMOBJ) command,
|
||
|
and a new data queue is created with the same name and library as the data
|
||
|
queue that was renamed or moved, then, the job continues to reference the
|
||
|
original data queue, not the newly created data queue.</p>
|
||
|
|
||
|
<p>The actual name of the data queue and the library in which it is found are
|
||
|
returned by this API.</p>
|
||
|
</dd>
|
||
|
</dl>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRDQD10">RDQD0100 Format</a></h3>
|
||
|
|
||
|
<p>The following table shows the information placed in the receiver variable
|
||
|
parameter for the RDQD0100 format. For a detailed description of each field,
|
||
|
see <a href="#HDRRDQD01F">Field Descriptions</a>.</p>
|
||
|
|
||
|
<table border width="80%">
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom">Dec</th>
|
||
|
<th align="center" valign="bottom">Hex</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">Bytes returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Bytes available</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">8</td>
|
||
|
<td align="center" valign="top">8</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Message length</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">12</td>
|
||
|
<td align="center" valign="top">C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Key length</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">16</td>
|
||
|
<td align="center" valign="top">10</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Sequence</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">17</td>
|
||
|
<td align="center" valign="top">11</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Include sender ID</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">18</td>
|
||
|
<td align="center" valign="top">12</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Force indicator</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">19</td>
|
||
|
<td align="center" valign="top">13</td>
|
||
|
<td align="left" valign="top">CHAR(50)</td>
|
||
|
<td align="left" valign="top">Text description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">69</td>
|
||
|
<td align="center" valign="top">45</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Type of data queue</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">70</td>
|
||
|
<td align="center" valign="top">46</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Automatic Reclaim</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">71</td>
|
||
|
<td align="center" valign="top">47</td>
|
||
|
<td align="left" valign="top">CHAR(1)</td>
|
||
|
<td align="left" valign="top">Reserved</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">72</td>
|
||
|
<td align="center" valign="top">48</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of messages</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">76</td>
|
||
|
<td align="center" valign="top">4C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Number of entries currently allocated</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">80</td>
|
||
|
<td align="center" valign="top">50</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Data queue name used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">90</td>
|
||
|
<td align="center" valign="top">5A</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Data queue library used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">100</td>
|
||
|
<td align="center" valign="top">64</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Maximum number of entries allowed</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">104</td>
|
||
|
<td align="center" valign="top">68</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Initial number of entries</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
|
||
|
<td align="center" valign="top">108</td>
|
||
|
<td align="center" valign="top">6C</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Maximum number of entries specified
|
||
|
</td>
|
||
|
|
||
|
</tr>
|
||
|
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRDQD12">RDQD0200 Format</a></h3>
|
||
|
|
||
|
<p>The following table shows the information placed in the receiver variable
|
||
|
parameter for the RDQD0200 format. For a detailed description of each field,
|
||
|
see <a href="#HDRRDQD01F">Field Descriptions</a>.</p>
|
||
|
|
||
|
<table border width="80%">
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
||
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<th align="center" valign="bottom">Dec</th>
|
||
|
<th align="center" valign="bottom">Hex</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="center" valign="top" width="10%">0</td>
|
||
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
||
|
<td align="left" valign="top" width="60%">Bytes returned</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="center" valign="top">4</td>
|
||
|
<td align="left" valign="top">BINARY(4)</td>
|
||
|
<td align="left" valign="top">Bytes available</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">8</td>
|
||
|
<td align="center" valign="top">8</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">APPC device description</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">18</td>
|
||
|
<td align="center" valign="top">12</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Mode</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">26</td>
|
||
|
<td align="center" valign="top">1A</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Remote location name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">34</td>
|
||
|
<td align="center" valign="top">22</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Local location name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">42</td>
|
||
|
<td align="center" valign="top">2A</td>
|
||
|
<td align="left" valign="top">CHAR(8)</td>
|
||
|
<td align="left" valign="top">Remote network identifier</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">50</td>
|
||
|
<td align="center" valign="top">32</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Remote data queue name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">60</td>
|
||
|
<td align="center" valign="top">3C</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Remote data queue library name</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">70</td>
|
||
|
<td align="center" valign="top">46</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Data queue name used</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="center" valign="top">80</td>
|
||
|
<td align="center" valign="top">50</td>
|
||
|
<td align="left" valign="top">CHAR(10)</td>
|
||
|
<td align="left" valign="top">Data queue library used</td>
|
||
|
</tr>
|
||
|
<tr>
|
||
|
|
||
|
<td align="center" valign="top">90</td>
|
||
|
<td align="center" valign="top">5A</td>
|
||
|
<td align="left" valign="top">CHAR(18)</td>
|
||
|
<td align="left" valign="top">Relational database name
|
||
|
</td>
|
||
|
|
||
|
</tr>
|
||
|
|
||
|
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3><a name="HDRRDQD01F">Field Descriptions</a></h3>
|
||
|
|
||
|
<p><strong>APPC device description.</strong> The name of the APPC device
|
||
|
description on the source system that is used with this DDM data queue. The
|
||
|
special value *LOC can be returned. This is the name that was specified on the
|
||
|
DEV parameter of the CRTDTAQ command.
|
||
|
This will be blank for RDB type DDM data queues.
|
||
|
</p>
|
||
|
|
||
|
|
||
|
<p><strong>Automatic reclaim.</strong> Whether or not the data queue has the
|
||
|
amount of storage allocated for the queue reclaimed when the queue is
|
||
|
empty.</p>
|
||
|
|
||
|
<p>Possible values returned are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
<td align="left" valign="top">Storage is not reclaimed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">Storage is reclaimed when the queue is empty. The
|
||
|
amount of storage allocated will be set to the initial number of entries.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>This will be blank for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Bytes available.</strong> The number of bytes of data available to
|
||
|
be returned. All available data is returned if enough space is provided.</p>
|
||
|
|
||
|
<p><strong>Bytes returned.</strong> The number of bytes of data returned.</p>
|
||
|
|
||
|
<p><strong>Data queue library used.</strong> The library in which the data
|
||
|
queue is found. If *LIBL or *CURLIB is specified for the library name, this
|
||
|
field is the actual name of the library in which the data queue was found. If a
|
||
|
specific library (not *LIBL or *CURLIB) is specified, and the data queue is
|
||
|
moved from that library to a different library after this job first accessed
|
||
|
the data queue, this will be set to the name of the library in which the data
|
||
|
queue currently exists.</p>
|
||
|
|
||
|
<p><strong>Data queue name used.</strong> The name of the data queue. This will
|
||
|
be the same as the name specified unless the data queue was renamed after this
|
||
|
job first accessed the data queue.</p>
|
||
|
|
||
|
<p><strong>Force indicator.</strong> Whether or not the data queue is forced to
|
||
|
auxiliary storage when entries are sent or received for the specified data
|
||
|
queue.</p>
|
||
|
|
||
|
<p>Possible values returned are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>Y</em></td>
|
||
|
<td align="left" valign="top">The data queue is forced to auxiliary storage
|
||
|
after entries are sent or received.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>N</em></td>
|
||
|
<td align="left" valign="top">The data queue is not forced to auxiliary storage
|
||
|
after entries are sent or received.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>This will be blank for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Include sender ID.</strong> If the queue was created to include the
|
||
|
sender ID with sent messages.</p>
|
||
|
|
||
|
<p>Possible values returned are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>Y</em></td>
|
||
|
<td align="left" valign="top">The sender ID is included when data is sent to
|
||
|
the data queue.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>N</em></td>
|
||
|
<td align="left" valign="top">The sender ID is not included when data is sent
|
||
|
to the data queue.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>This will be blank for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Initial number of entries.</strong> The number of messages that will
|
||
|
fit into the storage allocated for the data queue when it is created or when it
|
||
|
is automatically reclaimed. This will be 0 for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Key length.</strong> If the specified data queue was created as a
|
||
|
keyed type, this field contains the length, in bytes, of the message reference
|
||
|
key. Values range from 1 to 256. If the specified queue is not a keyed queue or
|
||
|
is a DDM data queue, the value is 0.</p>
|
||
|
|
||
|
<p><strong>Local location name.</strong> The name of the local location. The
|
||
|
special values *LOC and *NETATR can be returned. This is the name that was
|
||
|
specified on the LCLLOCNAME parameter of the CRTDTAQ command.
|
||
|
This will be blank for RDB type DDM data queues.</p>
|
||
|
|
||
|
<p><strong>Maximum number of entries allowed.</strong> The maximum number of
|
||
|
messages that will fit into the data queue when it is full. This will be 0 for
|
||
|
a DDM data queue.</p>
|
||
|
|
||
|
|
||
|
<p><strong>Maximum number of entries specified.</strong> The maximum number of
|
||
|
messages that was specified on the SIZE keyword of the CRTDTAQ command. This
|
||
|
will be 0 for a DDM data queue. This will be set to -1 for data queues created
|
||
|
prior to release V4R5M0, when support for the SIZE keyword was added to the
|
||
|
CRTDTAQ command.</p>
|
||
|
|
||
|
<p>The number of entries specified or one of the following special values
|
||
|
will be returned:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-1</em></td>
|
||
|
<td align="left" valign="top">*MAX16MB was specified for the data queue size.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>-2</em></td>
|
||
|
<td align="left" valign="top">*MAX2GB was specified for the data queue size.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
|
||
|
<p><strong>Message length.</strong> The maximum length allowed for messages.
|
||
|
The is the value that was specified with the MAXLEN keyword on the CRTDTAQ
|
||
|
command. This will be 0 for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Mode.</strong> The mode name used with the remote location name to
|
||
|
communicate with the target system. The special value *NETATR can be returned.
|
||
|
This is the name that was specified on the MODE parameter of the CRTDTAQ
|
||
|
command. This will be blank for RDB type DDM data queues.
|
||
|
</p>
|
||
|
|
||
|
<p><strong>Number of entries currently allocated.</strong> The number of
|
||
|
entries that will fit into the data queue before it is extended. When the queue
|
||
|
is extended, additional storage is allocated for the queue. The data queue can
|
||
|
be extended until it reaches the value for the maximum number of entries
|
||
|
allowed. This will be 0 for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Number of messages.</strong> The number of messages currently on the
|
||
|
data queue. This will be 0 for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Relational database name.</strong>
|
||
|
The name of the relational database entry that identifies the target system
|
||
|
or target ASP group. This field will be set to blanks unless the data queue
|
||
|
is an RDB type DDM data queue. This is the name that was specifed on the
|
||
|
RDB parameter of the CRTDTAQ command. </p>
|
||
|
|
||
|
<p><strong>Remote data queue library name.</strong> The name of the library for
|
||
|
the remote data queue on the target system. The special values *LIBL and
|
||
|
*CURLIB can be returned. This is the data queue name that was specified on the
|
||
|
RMTDTAQ parameter of the CRTDTAQ command.</p>
|
||
|
|
||
|
<p><strong>Remote data queue name.</strong> The name of the remote data queue
|
||
|
on the target system. This is the data queue name that was specified on the
|
||
|
RMTDTAQ parameter of the CRTDTAQ command.</p>
|
||
|
|
||
|
<p><strong>Remote location name.</strong> The name of the remote location that
|
||
|
is used with this object. This is the name that was specified on the RMTLOCNAME
|
||
|
parameter of the CRTDTAQ command.
|
||
|
|
||
|
A special value of *RDB indicates that the remote location information
|
||
|
from the relational database entry returned in the relational database
|
||
|
entry name field is used to determine the remote system.</p>
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
<p><strong>Remote network identifier.</strong> The remote network identifier in
|
||
|
which the remote location used to communcate with the target system. The
|
||
|
special values *LOC, *NETATR, and *NONE can be returned. This is the name that
|
||
|
was specified on the RMTNETID parameter of the CRTDTAQ command.
|
||
|
|
||
|
This will be blank for RDB type DDM data queues.</p>
|
||
|
|
||
|
|
||
|
|
||
|
<p><strong>Reserved.</strong> An unused field.</p>
|
||
|
|
||
|
<p><strong>Sequence.</strong> The sequence in which messages can be removed
|
||
|
from the queue.</p>
|
||
|
|
||
|
<p>Possible values returned are:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>F</em></td>
|
||
|
<td align="left" valign="top">First-in first-out</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>K</em></td>
|
||
|
<td align="left" valign="top">Keyed</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>L</em></td>
|
||
|
<td align="left" valign="top">Last-in first-out</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>This will be blank for a DDM data queue.</p>
|
||
|
|
||
|
<p><strong>Text description.</strong> The text description of the data queue.
|
||
|
The field contains blanks if no text description was specified when the data
|
||
|
queue was created.</p>
|
||
|
|
||
|
<p><strong>Type of data queue.</strong></p>
|
||
|
|
||
|
<p>This will be set to one of the following values:</p>
|
||
|
|
||
|
<table cellpadding="5">
|
||
|
<!-- cols="5 95" -->
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
<td align="left" valign="top">The data queue is a standard data queue.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top"><em>1</em></td>
|
||
|
<td align="left" valign="top">The data queue is a DDM data queue.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
|
||
|
|
||
|
<h3>Error Messages</h3>
|
||
|
|
||
|
<table width="100%" cellpadding="5">
|
||
|
<!-- cols="15 85" -->
|
||
|
<tr>
|
||
|
<th align="left" valign="top">Message ID</th>
|
||
|
<th align="left" valign="top">Error Message Text</th>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td width="15%" valign="top">CPF2150 E</td>
|
||
|
<td width="85%" valign="top">Object information function failed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF2151 E</td>
|
||
|
<td align="left" valign="top">Operation failed for &2 in &1 type
|
||
|
*&3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF24B4 E</td>
|
||
|
<td align="left" valign="top">Severe error while addressing parameter
|
||
|
list.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C21 E</td>
|
||
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C24 E</td>
|
||
|
<td align="left" valign="top">Length of the receiver variable is not
|
||
|
valid.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF3C90 E</td>
|
||
|
<td align="left" valign="top">Literal value cannot be changed.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9503 E</td>
|
||
|
<td align="left" valign="top">Cannot lock data queue &1 in &2.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9509 E</td>
|
||
|
<td align="left" valign="top">Space access error.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9516 E</td>
|
||
|
<td align="left" valign="top">Format &1 not allowed for data queue.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9801 E</td>
|
||
|
<td align="left" valign="top">Object &2 in library &3 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9802 E</td>
|
||
|
<td align="left" valign="top">Not authorized to object &2 in &3.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">
|
||
|
|
||
|
|
||
|
|
||
|
CPF9803 E</td>
|
||
|
<td align="left" valign="top">Cannot allocate object &2 in library &3.
|
||
|
|
||
|
|
||
|
|
||
|
</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9807 E</td>
|
||
|
<td align="left" valign="top">One or more libraries in library list
|
||
|
deleted.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9808 E</td>
|
||
|
<td align="left" valign="top">Cannot allocate one or more libraries on library
|
||
|
list.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9810 E</td>
|
||
|
<td align="left" valign="top">Library &1 not found.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9820 E</td>
|
||
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9830 E</td>
|
||
|
<td align="left" valign="top">Cannot assign library &1.</td>
|
||
|
</tr>
|
||
|
|
||
|
<tr>
|
||
|
<td align="left" valign="top">CPF9872 E</td>
|
||
|
<td align="left" valign="top">Program or service program &1 in library
|
||
|
&2 ended. Reason code &3.</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<br>
|
||
|
<hr>
|
||
|
API introduced: V2R1
|
||
|
|
||
|
<hr>
|
||
|
<table cellpadding="2" cellspacing="2" align="center">
|
||
|
<tr align="center">
|
||
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
|
||
|
"obj1.htm">Object API categories</a> | <a href="aplist.htm">API by
|
||
|
category</a></td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
</body>
|
||
|
</html>
|
||
|
|