91 lines
5.5 KiB
HTML
91 lines
5.5 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="concept" />
|
||
|
|
<meta name="DC.Title" content="Local data area" />
|
||
|
|
<meta name="abstract" content="A local data area is created for each job in the system, including autostart jobs, jobs started on the system by a reader, and subsystem monitor jobs." />
|
||
|
|
<meta name="description" content="A local data area is created for each job in the system, including autostart jobs, jobs started on the system by a reader, and subsystem monitor jobs." />
|
||
|
|
<meta name="DC.subject" content="local data area, LDA (local data area), *LDA value, local" />
|
||
|
|
<meta name="keywords" content="local data area, LDA (local data area), *LDA value, local" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="dtaas.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/crtdtaara.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rtvdtaara.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgdtaara.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspdtaara.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dltdtaara.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="lclda" />
|
||
|
|
<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>Local data area</title>
|
||
|
|
</head>
|
||
|
|
<body id="lclda"><a name="lclda"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Local data area</h1>
|
||
|
|
<div><p>A local data area is created for each job in the system, including
|
||
|
|
autostart jobs, jobs started on the system by a reader, and subsystem monitor
|
||
|
|
jobs.</p>
|
||
|
|
<p>The system creates a local data area, which is initially filled with blanks,
|
||
|
|
with a length of 1024 and type *CHAR. When you submit a job using the SBMJOB
|
||
|
|
command, the value of the submitting job's local data area is
|
||
|
|
copied into the submitted job's local data area. You can refer to your job's
|
||
|
|
local data area by specifying *LDA for the DTAARA keyword on the CHGDTAARA,
|
||
|
|
RTVDTAARA, and DSPDTAARA commands or *LDA for the substring built-in function
|
||
|
|
(%SST).</p>
|
||
|
|
<p>The following is true of a local data area: </p>
|
||
|
|
<ul><li>The local data area cannot be referred to from any other job.</li>
|
||
|
|
<li>You cannot create, delete, or allocate a local data area.</li>
|
||
|
|
<li>No library is associated with the local data area.</li>
|
||
|
|
<li>You cannot change the local data area in a secondary thread.</li>
|
||
|
|
<li>The ILE CL compiler generates code to ensure that a procedure running
|
||
|
|
in a secondary thread cannot access the local data area while a procedure
|
||
|
|
running in the initial thread is changing it.</li>
|
||
|
|
</ul>
|
||
|
|
<p>The local data area contents exist across routing step boundaries. Therefore,
|
||
|
|
using a <span class="cmdname">Transfer Job (TFRJOB)</span>, <span class="cmdname">Transfer Batch
|
||
|
|
Job (TFRBCHJOB)</span>, <span class="cmdname">Reroute Job (RRTJOB)</span>, or <span class="cmdname">Return
|
||
|
|
(RETURN)</span> command does not affect the contents of the local data
|
||
|
|
area.</p>
|
||
|
|
<p>You can use the local data area to: </p>
|
||
|
|
<ul><li>Pass information to a procedure or program without the use of a parameter
|
||
|
|
list.</li>
|
||
|
|
<li>Pass information to a submitted job by loading your information into the
|
||
|
|
local data area and submitting the job. Then, you can access the data from
|
||
|
|
within your submitted job.</li>
|
||
|
|
<li>Improve performance over other types of data area accesses from a CL procedure
|
||
|
|
or program.</li>
|
||
|
|
<li>Store information without the overhead of creating and deleting a data
|
||
|
|
area yourself.</li>
|
||
|
|
</ul>
|
||
|
|
<p>Most high-level languages can also use the local data area. The SBMxxxJOB
|
||
|
|
and STRxxxRDR commands cause jobs to start with a local data area initialized
|
||
|
|
to blanks. Only the SBMJOB command allows the contents of the submitting
|
||
|
|
job's local data area to be passed to the new job.</p>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dtaas.htm" title="A data area is an object used to hold data for access by any job running on the system.">Use data areas</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../cl/crtdtaara.htm">Create Data Area (CRTDTAARA) command</a></div>
|
||
|
|
<div><a href="../cl/rtvdtaara.htm">Retrieve Data Area (RTVDTAARA) command</a></div>
|
||
|
|
<div><a href="../cl/chgdtaara.htm">Change Data Area (CHGDTAARA) command</a></div>
|
||
|
|
<div><a href="../cl/dspdtaara.htm">Display Data Area (DSPDTAARA) command</a></div>
|
||
|
|
<div><a href="../cl/dltdtaara.htm">Delete Data Area (DLTDTAARA) command</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|