146 lines
9.6 KiB
HTML
146 lines
9.6 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="CRTDTAARA (Create Data Area) command" />
|
||
|
|
<meta name="abstract" content="The Create Data Area (CRTDTAARA) command creates a data area and stores it in a specified library. It also specifies the attributes of the data. The data area can be optionally initialized to a specific value." />
|
||
|
|
<meta name="description" content="The Create Data Area (CRTDTAARA) command creates a data area and stores it in a specified library. It also specifies the attributes of the data. The data area can be optionally initialized to a specific value." />
|
||
|
|
<meta name="DC.subject" content="command, DDM-related, CL command considerations, CRTDTAARA (Create Data Area), command, Create Data Area (CRTDTAARA), command, CL, Create Data Area (CRTDTAARA), data area, creating, command, CL, CRTDTAARA (Create Data Area), TYPE parameter, RMTDTAARA parameter, RMTLOCNAME parameter, DEV parameter, LCLLOCNAME parameter, MODE parameter, RMTNETID parameter" />
|
||
|
|
<meta name="keywords" content="command, DDM-related, CL command considerations, CRTDTAARA (Create Data Area), command, Create Data Area (CRTDTAARA), command, CL, Create Data Area (CRTDTAARA), data area, creating, command, CL, CRTDTAARA (Create Data Area), TYPE parameter, RMTDTAARA parameter, RMTLOCNAME parameter, DEV parameter, LCLLOCNAME parameter, MODE parameter, RMTNETID parameter" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbae5cmdcnsd.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rbae5crtdt" />
|
||
|
|
<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>CRTDTAARA (Create Data Area) command</title>
|
||
|
|
</head>
|
||
|
|
<body id="rbae5crtdt"><a name="rbae5crtdt"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1"><span class="cmdname">CRTDTAARA (Create Data Area)</span> command</h1>
|
||
|
|
<div><p>The<span class="cmdname"> Create Data Area (CRTDTAARA)</span> command creates
|
||
|
|
a data area and stores it in a specified library. It also specifies the attributes
|
||
|
|
of the data. The data area can be optionally initialized to a specific value.</p>
|
||
|
|
<div class="section"><p>You can create a DDM data area by specifying *DDM on the TYPE
|
||
|
|
parameter. The DDM data area is used as a reference data area by programs
|
||
|
|
to access data areas located on a remote (target) server in the DDM network.
|
||
|
|
Programs on the local (source) server reference a remote data area by the
|
||
|
|
DDM data area's name, not by the remote data area's name. (The DDM data area
|
||
|
|
name can be the same as the remote data area name.)</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The DDM data area (on the source server) contains the name of
|
||
|
|
the remote data area and the name of the remote (target) server on which the
|
||
|
|
remote data area is located.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The DDM data area can be used with the <span class="cmdname">Retrieve Data
|
||
|
|
Area (RTVDTAARA)</span> command and the <span class="cmdname">Change Data Area (CHGDTAARA)</span> command
|
||
|
|
to retrieve and update data areas on remote servers. A DDM data area can also
|
||
|
|
be used with the <span class="apiname">Retrieve Data Area (QWCRDTAA)</span> API.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>Consider the following items when using this command with DDM:</p>
|
||
|
|
<ul><li>The RMTDTAARA parameter is the name of the remote data area on the target
|
||
|
|
server. The data area does not need to exist when the DDM data area is created.</li>
|
||
|
|
<li>The RMTLOCNAME parameter is the name of the remote location that is used
|
||
|
|
with this object. Multiple DDM data areas can use the same remote location
|
||
|
|
for the target system. RMTLOCNAME must point to a target server that is an <span class="keyword">iSeries™</span> running at a release of <span class="keyword">i5/OS™</span> that supports remote data
|
||
|
|
areas. The possible values for RMTLOCNAME include: <ul><li><samp class="codeph">remote-location-name</samp>: Specifies 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 area is created, but it must exist when the DDM data area is accessed.</li>
|
||
|
|
<li>*RDB: The remote location information for the relational database entry
|
||
|
|
specified in the relational database (RDB) parameter is used to determine
|
||
|
|
the remote system.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The DEV parameter is the name of the APPC device description on the source
|
||
|
|
server that is used with this DDM data area. The device description does not
|
||
|
|
need to exist when the DDM data area is created.</li>
|
||
|
|
<li>The LCLLOCNAME parameter is the local location name.</li>
|
||
|
|
<li>The MODE parameter is the mode name that is used with the remote location
|
||
|
|
name to communicate with the target server.</li>
|
||
|
|
<li>The RMTNETID parameter is the remote network ID in which the remote location
|
||
|
|
resides that is used to communicate with the target server.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>Consider the following restrictions when using this command with
|
||
|
|
DDM:</p>
|
||
|
|
<ul><li>You cannot create a DDM data area using the names *LDA, *GDA, or *PDA.</li>
|
||
|
|
<li>You cannot create a data area remotely. This function can be done remotely
|
||
|
|
by using the <span class="cmdname">Submit Remote Command (SBMRMTCMD)</span> command.</li>
|
||
|
|
<li>You can remotely display data areas by using the <span class="cmdname">SBMRMTCMD</span> command.</li>
|
||
|
|
<li>You can display the contents of remote data areas by using the <span class="cmdname">Display
|
||
|
|
Data Area (DSPDTAARA)</span> command; specify *RMT on the SYSTEM parameter.
|
||
|
|
The data in the data area is displayed in the same format as that used for
|
||
|
|
local data areas, with the exception of the TEXT field, which is the text
|
||
|
|
description provided when the DDM data area was created. If you specify *LCL
|
||
|
|
on the SYSTEM parameter for a DDM data area, the output looks similar to the
|
||
|
|
following display:</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><div class="p"> <pre> Data area . . . . . . . : DDMDTAARA
|
||
|
|
Library . . . . . . . : DDMLIB
|
||
|
|
Type . . . . . . . . . : *DDM
|
||
|
|
Length . . . . . . . . : 62
|
||
|
|
Text . . . . . . . . . : 'This is a DDM data area'
|
||
|
|
|
||
|
|
Value
|
||
|
|
Offset *...+....1....+....2....+....3....+....4....+....5
|
||
|
|
0 '*LOC *NETATR SYSTEMA *LOC *LOC LCLDTAAR'
|
||
|
|
50 'A LCLLIB '</pre>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"> <p>Use the following chart to interpret the values: </p>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><a name="rbae5crtdt__offset"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rbae5crtdt__offset" width="100%" frame="void" border="0" rules="none"><caption>Table 1. Offset values</caption><thead align="left"><tr><th valign="top" width="12.709030100334449%" id="d0e158">Offset</th>
|
||
|
|
<th valign="top" width="87.29096989966555%" id="d0e160">DDMDTAARA fields</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">1-10</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">DEV</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">11-18</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">MODE</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">19-26</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">RMTLOCNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">27-34</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">LCLLOCNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">35-42</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">RMTNETID</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">43-52</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">RMTDTAARA (name)</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.709030100334449%" headers="d0e158 ">53-62</td>
|
||
|
|
<td valign="top" width="87.29096989966555%" headers="d0e160 ">RMTDTAARA (library)</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbae5cmdcnsd.htm" title="This topic collection describes DDM-related specifics about iSeries CL commands when they are used with DDM files. These topics discuss running the commands on the source server and do not discuss them being submitted to run on the target server by the Submit Remote Command (SBMRMTCMD) command.">DDM-related CL command considerations</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="../rbam6/rbam6clmain.htm">Control language</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|