91 lines
5.7 KiB
HTML
91 lines
5.7 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="Group data area" />
|
||
|
|
<meta name="abstract" content="The system creates a group data area when an interactive job becomes a group job (using the Change Group Attributes (CHGGRPA) command)." />
|
||
|
|
<meta name="description" content="The system creates a group data area when an interactive job becomes a group job (using the Change Group Attributes (CHGGRPA) command)." />
|
||
|
|
<meta name="DC.subject" content="data area, group" />
|
||
|
|
<meta name="keywords" content="data area, group" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="dtaas.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chggrpa.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="grpda" />
|
||
|
|
<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>Group data area</title>
|
||
|
|
</head>
|
||
|
|
<body id="grpda"><a name="grpda"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Group data area</h1>
|
||
|
|
<div><p>The system creates a group data area when an interactive job becomes
|
||
|
|
a group job (using the <span class="cmdname">Change Group Attributes (CHGGRPA)</span> command). </p>
|
||
|
|
<p>Only one group data area can exist for a group. The group data area is
|
||
|
|
deleted when the last job in the group is ended (with the ENDJOB, SIGNOFF,
|
||
|
|
or ENDGRPJOB command, or with an abnormal end), or when the job is no longer
|
||
|
|
part of the group job (using the CHGGRPA command with GRPJOB(*NONE) specified).</p>
|
||
|
|
<p>A group data area, which is initially filled with blanks, has a length
|
||
|
|
of 512 and type *CHAR. You can use a group data area from within a group job
|
||
|
|
by specifying *GDA for the DTAARA parameter on the CHGDTAARA, RTVDTAARA, and
|
||
|
|
DSPDTAARA commands. A group data area is accessible to all of the jobs in
|
||
|
|
the group.</p>
|
||
|
|
<p>The following are true for a group data area: </p>
|
||
|
|
<ul><li>You cannot use the group data area as a substitute for a character variable
|
||
|
|
on the substring built-in function (%SUBSTRING or %SST). (You can, however,
|
||
|
|
move a 512-byte character variable used by the substring function into or
|
||
|
|
out of the group data area.)</li>
|
||
|
|
<li>A group data area cannot be referred to by jobs outside the group.</li>
|
||
|
|
<li>You cannot create, delete, or allocate a group data area.</li>
|
||
|
|
<li>No library is associated with a group data area.</li>
|
||
|
|
</ul>
|
||
|
|
<p>The contents of a group data area are unchanged by the <span class="cmdname">Transfer
|
||
|
|
to Group Job (TFRGRPJOB)</span> command.</p>
|
||
|
|
<p>In addition to using the group data area as you use other data areas, you
|
||
|
|
can use the group data area to communicate information between group jobs
|
||
|
|
in the same group. For example, after issuing the <span class="cmdname">Change Group Job
|
||
|
|
Attributes (CHGGRPA)</span> command, the following command can be used
|
||
|
|
to set the value of the group data area: </p>
|
||
|
|
<pre>CHGDTAARA DTAARA(*GDA) VALUE('January1988')</pre>
|
||
|
|
<p>This command can be run from a program or can be issued by the workstation
|
||
|
|
user.</p>
|
||
|
|
<p>Any other CL procedure or program in the group can retrieve the value of
|
||
|
|
the group data area with the following CL command: </p>
|
||
|
|
<pre>RTVDTAARA DTAARA(*GDA) RTNVAR(&GRPARA)</pre>
|
||
|
|
<p>This command places the value of the group data area (<samp class="codeph">January1988</samp>)
|
||
|
|
into CL variable &GRPARA.</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="../clfinder/finder.htm">CL command finder</a></div>
|
||
|
|
<div><a href="../cl/chggrpa.htm">Change Group Attributes (CHGGRPA) command</a></div>
|
||
|
|
<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>
|