716 lines
28 KiB
HTML
716 lines
28 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">
|
|
<title>Create Data Queue (CRTDTAQ)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CRTDTAQ.Top_Of_Page"></a>
|
|
<h2>Create Data Queue (CRTDTAQ)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>Yes
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CRTDTAQ.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTDTAQ.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTDTAQ.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTDTAQ"></a>
|
|
<p>The Create Data Queue (CRTDTAQ) command creates a data queue and stores it in a specified library.
|
|
</p>
|
|
<p>Data queues, which are a type of OS/400 system object, are used to communicate and store data used by several programs either within a job or between jobs. Multiple jobs can send or receive data from a single queue.
|
|
</p>
|
|
<p>For more information about data queues on output queues, see the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>The Create Data Queue (CRTDTAQ) command optionally creates a distributed data management (DDM) data queue when TYPE(*DDM) is specified. The DDM data queue is used as a reference data queue by programs to access data queues located on a remote (target) system in the DDM network. Programs on the local (source) system refer to a remote data queue by the DDM data queue's name, not by the remote data queue's name. The DDM data queue name, however, can be the same as the remote data queue name.
|
|
</p>
|
|
<p>The DDM data queue on the source system contains the name of the remote data queue and the name of the remote (target) system on which the remote data queue is located.
|
|
</p>
|
|
<p><b>Restrictions:</b> Users of this command must have add (*ADD) authority for the library where the data queue is located.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTDTAQ.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTDTAQ.DTAQ"><b>DTAQ</b></a></td>
|
|
<td valign="top">Data queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Data queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTDTAQ.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*STD</u></b>, *DDM</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.MAXLEN"><b>MAXLEN</b></a></td>
|
|
<td valign="top">Maximum entry length</td>
|
|
<td valign="top">1-64512</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.FORCE"><b>FORCE</b></a></td>
|
|
<td valign="top">Force to auxiliary storage</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.SEQ"><b>SEQ</b></a></td>
|
|
<td valign="top">Sequence</td>
|
|
<td valign="top"><b><u>*FIFO</u></b>, *LIFO, *KEYED</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.KEYLEN"><b>KEYLEN</b></a></td>
|
|
<td valign="top">Key length</td>
|
|
<td valign="top">1-256</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.SENDERID"><b>SENDERID</b></a></td>
|
|
<td valign="top">Include sender ID</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTDTAQ.SIZE"><b>SIZE</b></a></td>
|
|
<td valign="top">Queue size</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Maximum number of entries</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, <b><u>*MAX16MB</u></b>, *MAX2GB</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Initial number of entries</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, <b><u>16</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.AUTORCL"><b>AUTORCL</b></a></td>
|
|
<td valign="top">Automatic reclaim</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTDTAQ.RMTDTAQ"><b>RMTDTAQ</b></a></td>
|
|
<td valign="top">Remote data queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Remote data queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTDTAQ.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
|
<td valign="top">Remote location</td>
|
|
<td valign="top"><i>Communications name</i>, *RDB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.RDB"><b>RDB</b></a></td>
|
|
<td valign="top">Relational database</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">APPC device description</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LOC</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
|
<td valign="top">Local location</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.MODE"><b>MODE</b></a></td>
|
|
<td valign="top">Mode</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.RMTNETID"><b>RMTNETID</b></a></td>
|
|
<td valign="top">Remote network identifier</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTDTAQ.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTDTAQ.DTAQ"></a>
|
|
<h3>Data queue (DTAQ)</h3>
|
|
<p>Specifies the data queue to be created.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Data queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the data queue.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The current library for the job is used to locate the data queue. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the data queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies the type of data queue to be created. A standard data queue or a distributed data management (DDM) data queue can be created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*STD</u></b></dt>
|
|
<dd>A standard data queue is created. The MAXLEN parameter is required with the use of this value.
|
|
</dd>
|
|
<dt><b>*DDM</b></dt>
|
|
<dd>A DDM data queue is created. This value requires the name of the remote data queue accessed (RMTDTAQ parameter) and the name of the remote (target) system that the data queue is located on (RMTLOCNAME parameter).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.MAXLEN"></a>
|
|
<h3>Maximum entry length (MAXLEN)</h3>
|
|
<p>Specifies the maximum length of the entry that is sent to the data queue.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If the data queue is associated with an output queue, the maximum length value should be at least 128.
|
|
</li>
|
|
<li>This parameter is valid only when TYPE(*STD) is specified.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><i>1-64512</i></b></dt>
|
|
<dd>Specify the maximum entry length. Valid values range from 1 through 64512.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.FORCE"></a>
|
|
<h3>Force to auxiliary storage (FORCE)</h3>
|
|
<p>Specifies whether the data queue is forced to auxiliary storage when entries are sent or received for this data queue.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when TYPE(*STD) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Send and receive operations are not immediately forced to auxiliary storage.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Send and receive operations are immediately forced to auxiliary storage. This ensures that the changes are not lost if a system failure occurs. This requires additional system overhead.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.SEQ"></a>
|
|
<h3>Sequence (SEQ)</h3>
|
|
<p>Specifies the sequence in which entries are received from the data queue.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If the data queue is associated with an output queue, the sequence value should be *FIFO or *LIFO."
|
|
</li>
|
|
<li>This parameter is valid only when TYPE(*STD) is specified.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*FIFO</u></b></dt>
|
|
<dd>Data queue entries are received in a first-in first-out sequence.
|
|
</dd>
|
|
<dt><b>*LIFO</b></dt>
|
|
<dd>Data queue entries are received in a last-in first-out sequence.
|
|
</dd>
|
|
<dt><b>*KEYED</b></dt>
|
|
<dd>Data queue entries are received by key. A key is a prefix added to an entry by its sender.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.KEYLEN"></a>
|
|
<h3>Key length (KEYLEN)</h3>
|
|
<p>Specifies the number of characters in the key.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when <b>SEQ(*KEYED)</b> and <b>TYPE(*STD)</b> are specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-256</i></b></dt>
|
|
<dd>Specify the key length. Valid values range from 1 through 256.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.SENDERID"></a>
|
|
<h3>Include sender ID (SENDERID)</h3>
|
|
<p>Specifies a sender ID to be attached to each message sent to the Data Queue. The ID contains the job name and the sender's current user profile.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when TYPE(*STD) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Messages sent do not include the sender ID.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Messages sent include the sender ID.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.SIZE"></a>
|
|
<h3>Queue size (SIZE)</h3>
|
|
<p>Specifies the amount of storage allocated for the data queue. Parameter elements consist of the maximum number of entries and the initial number of entries for the data queue.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when TYPE(*STD) is specified.
|
|
</p>
|
|
<p><b>Element 1: Maximum number of entries</b>
|
|
</p>
|
|
<p>One of the following is used to specify the maximum number of entries that can be added to a data queue.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MAX16MB</u></b></dt>
|
|
<dd>The system will calculate the maximum number of entries that can be added to the queue and will be allowed to grow to a maximum size of approximately 16 megabytes(MB). One megabyte equals 1,048,576 bytes. This value with an initial number of entries of 16 provides compatibility with releases of the operating system earlier than Version 4 Release 5 Modification 0 (V4R5M0).
|
|
</dd>
|
|
<dt><b>*MAX2GB</b></dt>
|
|
<dd>The system will calculate the maximum number of entries that can be added to the data queue. The data queue will be allowed to grow to a maximum size of approximately 2 gigabytes (GB). One gigabyte equals 1,073,741,824 bytes.
|
|
</dd>
|
|
<dt><b><i>number-of-entries</i></b></dt>
|
|
<dd>The data queue will be allowed to hold at least this number of entries. Based on the extend size used by the machine, the maximum number of data queue entries may be slightly higher than the specified value. The value specified must be greater than 0.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Initial number of entries</b>
|
|
</p>
|
|
<p>Specifies the amount of storage that will initially be allocated to the data queue. The queue will be created to hold the initial number of entries of the maximum entry length.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>16</u></b></dt>
|
|
<dd>Initially, storage is allocated to hold 16 entries of the maximum entry length.
|
|
</dd>
|
|
<dt><b><i>initial-number-of-entries</i></b></dt>
|
|
<dd>Specify the value for the initial number of entries that the data queue can hold. The value must be greater than 0.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.AUTORCL"></a>
|
|
<h3>Automatic reclaim (AUTORCL)</h3>
|
|
<p>Specifies whether the storage allocated for the data queue is automatically reclaimed (released) when the data queue is empty.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only when TYPE(*STD) is specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The storage allocated for the data queue is not released when the data queue is empty.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The storage allocated for the data queue is released when the data queue is empty. Storage for the Initial Number of Entries value will remain allocated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.RMTDTAQ"></a>
|
|
<h3>Remote data queue (RMTDTAQ)</h3>
|
|
<p>Specifies the remote data queue on the target system. The data queue does not need to exist when the DDM data queue is created.
|
|
</p>
|
|
<p><b>Qualifier 1: Remote data queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the data queue that identifies the remote data queue accessed. The name cannot exceed 10 characters.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
<ul>
|
|
<li>If *LIBL (the default library qualifier) is specified or assumed, the library list in the called job on the target system is searched to locate the data queue.
|
|
</li>
|
|
<li>If *CURLIB is specified, the current library in the called job on the target system is searched to locate the data queue.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.RMTLOCNAME"></a>
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
|
<p>Specifies the name of the remote location that is used with this object.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Multiple DDM data queues can use the same remote location for the target system. The remote locations used must point to iSeries systems that are at a release of OS/400 that supports remote data queues.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*RDB</b></dt>
|
|
<dd>The remote location information from the relational database entry specified for the <b>Relational database (RDB)</b> parameter is used to determine the remote system.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the remote location that is associated with the target system. The remote location, which is used in accessing the target system, does not need to exist when the DDM data queue is created but must exist when the DDM data queue is accessed.
|
|
<p>More information on remote locations is in the APPC Programming book, SC41-5443.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.RDB"></a>
|
|
<h3>Relational database (RDB)</h3>
|
|
<p>Specifies the relational database entry that is used to determine the remote location information for the DDM data queue.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>communications-name</i></b></dt>
|
|
<dd>Specify the name of the relational database entry that identifies the target system or target ASP group. The relational database name can refer to a remote system or an ASP group that is configured and available on a remote system. The relational database entry does not need to exist when the DDM data queue is created but must exist when the DDM data queue is used. This parameter is required when *RDB is specified for the <b>Remote location (RMTLOCNAME)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.DEV"></a>
|
|
<h3>APPC device description (DEV)</h3>
|
|
<p>Specifies the name of the APPC device description on the source system that is used with this DDM data queue. The device description does not need to exist when the DDM data queue is created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of a communications device associated with the remote location. If the device name is not valid for the remote location, a message is sent when the program device entry is required. More information on device names is in the APPC Programming book, SC41-5443.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.LCLLOCNAME"></a>
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
|
<p>Specifies the local location name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.
|
|
</dd>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The LCLLOCNAME value specified in the system network attributes is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the local location that is associated with the remote location. The local location name is specified only if the user indicates a specific local location for the remote location. If the local location name is not valid for the remote location, an escape message is sent when the DDM data queue is accessed.
|
|
<p>More information on local location names is in the APPC Programming book, SC41-5443.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.MODE"></a>
|
|
<h3>Mode (MODE)</h3>
|
|
<p>Specifies the mode name that is used with the remote location name to communicate with the target system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NETATR</u></b></dt>
|
|
<dd>The mode name specified in the network attributes is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the mode that is used to communicate with the remote system. If the mode name is not valid for any combination of remote location and local location, an escape message is sent when the DDM data queue is accessed.
|
|
<p>More information on mode names is in the APPC Programming book, SC41-5443.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.RMTNETID"></a>
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
|
<p>Specifies the remote network identifier (ID) in which the remote location resides that is used to communicate with the target system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>The remote network ID associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
|
|
</dd>
|
|
<dt><b>*NETATR</b></dt>
|
|
<dd>The RMTNETID value specified in the system network attributes is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No remote network ID is used.
|
|
</dd>
|
|
<dt><b><i>remote-network-ID</i></b></dt>
|
|
<dd>Specify the remote network ID that is associated with the remote location. The remote network ID is specified only if the user indicates a specific remote network ID for the remote location. If the remote network ID is not valid for the remote location, an escape message is sent when the DDM data queue is accessed.
|
|
<p>More information on remote network IDs is in the APPC Programming book, SC41-5443.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies text that briefly describes the data queue.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify no more than 50 characters, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTDTAQ.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTDTAQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Creating a Standard Data Queue</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTDTAQ DTAQ(DEPTADTA) MAXLEN(100) AUT(*EXCLUDE)
|
|
TEXT('Special data + files for DEPTA')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a data queue named DEPTADTA and puts it in the current library; the maximum length entry is 100. Because AUT(*EXCLUDE) is specified, the data queue can be used and controlled only by the user who created the queue and by users who have been given specific authority. Users in Department A can be given authority to use this data queue by using the Grant Object Authority (GTROBJAUT) command.
|
|
</p>
|
|
<p><b>Example 2: Creating a DDM Data Queue to Access a Data Queue at Another iSeries 400</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTDTAQ DTAQ(SOURCE/SALES) TYPE(*DDM)
|
|
RMTDTAQ(REMOTE/SALES) RMTLOCNAME(NEWYORK)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a DDM data queue named SALES and stores it in the SOURCE library on the source system. This DDM data queue uses the remote location named NEWYORK to access a remote data queue named SALES stored in the REMOTE library on an iSeries 400 in New York.
|
|
</p>
|
|
<p><b>Example 3: Creating a Data Queue Specifying Size Attributes and Automatic Reclaim</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTDTAQ DTAQ(MYLIB/MYDTAQ) MAXLEN(80)
|
|
SIZE(*MAX2GB 100) AUTORCL(*YES)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a data queue named MYDTAQ and stores it in the MYLIB library. The maximum entry length is 80 bytes and the queue entries are received in a first-in-first-out (FIFO) sequence. The data queue will initially have storage allocated to hold 100 entries. The data queue can grow to a maximum size of approximately 2 gigabytes. If all queue entries are received, storage for the data queue will be automatically reclaimed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTDTAQ.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2105</b></dt>
|
|
<dd>Object &1 in &2 type *&3 not found.
|
|
</dd>
|
|
<dt><b>CPF2108</b></dt>
|
|
<dd>Object &1 type *&3 not added to library &2.
|
|
</dd>
|
|
<dt><b>CPF2109</b></dt>
|
|
<dd>NEWOBJ must be *SAME when OBJ parameter is *ALL or generic name.
|
|
</dd>
|
|
<dt><b>CPF2110</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2113</b></dt>
|
|
<dd>Cannot allocate library &1.
|
|
</dd>
|
|
<dt><b>CPF2116</b></dt>
|
|
<dd>DATA(*YES) specified and *ALL or *FILE not in OBJTYPE list.
|
|
</dd>
|
|
<dt><b>CPF2122</b></dt>
|
|
<dd>Storage limit exceeded for user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2123</b></dt>
|
|
<dd>No objects of specified name or type exist in library &2.
|
|
</dd>
|
|
<dt><b>CPF2130</b></dt>
|
|
<dd>&1 objects duplicated. &2 objects not duplicated.
|
|
</dd>
|
|
<dt><b>CPF2151</b></dt>
|
|
<dd>Operation failed for &2 in &1 type *&3.
|
|
</dd>
|
|
<dt><b>CPF2152</b></dt>
|
|
<dd>Objects of type *&1 cannot be created into QTEMP.
|
|
</dd>
|
|
<dt><b>CPF2162</b></dt>
|
|
<dd>Duplication of all objects in library &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF2176</b></dt>
|
|
<dd>Library &1 damaged.
|
|
</dd>
|
|
<dt><b>CPF2182</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF2185</b></dt>
|
|
<dd>TOLIB, TOASPDEV, or NEWOBJ parameter not correct.
|
|
</dd>
|
|
<dt><b>CPF2186</b></dt>
|
|
<dd>Object &1 cannot be created into library &2.
|
|
</dd>
|
|
<dt><b>CPF2283</b></dt>
|
|
<dd>Authorization list &1 does not exist.
|
|
</dd>
|
|
<dt><b>CPF327E</b></dt>
|
|
<dd>Alternative name for file &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF6565</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9827</b></dt>
|
|
<dd>Object &1 cannot be created or moved into &2.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9870</b></dt>
|
|
<dd>Object &2 type *&5 already exists in library &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTDTAQ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|