ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/dlist.htm

83 lines
5.1 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="task" />
<meta name="DC.Title" content="Define lists within lists" />
<meta name="abstract" content="A list within a list can be either a list that can be specified more than once for a parameter (simple or mixed list), or a list that can be specified for a value within a mixed list." />
<meta name="description" content="A list within a list can be either a list that can be specified more than once for a parameter (simple or mixed list), or a list that can be specified for a value within a mixed list." />
<meta name="DC.subject" content="parameter, defining, with list within list, list within list, command, CL, Element (ELEM) statement, example" />
<meta name="keywords" content="parameter, defining, with list within list, list within list, command, CL, Element (ELEM) statement, example" />
<meta name="DC.Relation" scheme="URI" content="dflst.htm" />
<meta name="DC.Relation" scheme="URI" content="defdlclhll.htm" />
<meta name="DC.Relation" scheme="URI" content="llrx.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="dlist" />
<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>Define lists within lists</title>
</head>
<body id="dlist"><a name="dlist"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Define lists within lists</h1>
<div><p>A list within a list can be either a list that can be specified
more than once for a parameter (simple or mixed list), or a list that can
be specified for a value within a mixed list.</p>
<div class="section"> <p>The following is an example of lists within a list. </p>
<pre>STMT((START RESPND) (ADDDSP CONFRM))</pre>
<p>The outside set of parentheses enclose the list that can be
specified for the parameter (the outer list) while each set of inner parentheses
encloses a list within a list (an inner list).</p>
<p>In the following example,
a mixed list is defined within a simple list. A mixed list is specified,
and the MAX value on the PARM statement is greater than 1; therefore, the
mixed list can be specified up to the number of times specified on the MAX
parameter.</p>
<pre> PARM KWD(PARM1) TYPE(LIST1) MAX(5)
LIST1: ELEM TYPE(*CHAR) LEN(10)
ELEM TYPE(*DEC) LEN(3 0)</pre>
<p>In this example, the two elements can be specified up to five
times. When a value is entered for this parameter, it could appear as follows:</p>
<pre>PARM1((VAL1 1.0) (VAR2 2.0) (VAR3 3.0))</pre>
<p>In the following example, a simple list is specified as a value
in a mixed list. In this example, the MAX value on the ELEM statement is
greater than 1; therefore, the element can be repeated up to the number of
times specified on the MAX parameter.</p>
<pre> PARM KWD(PARM2) TYPE(LIST2)
LIST2: ELEM TYPE(*CHAR) LEN(10) MAX(5)
ELEM TYPE(*DEC) LEN(3 0)</pre>
<p>In this example, the first element can be specified up to five
times, but the second element can be specified only once. When a value is
entered for this parameter, it could appear as follows. </p>
<pre>PARM2((NAME1 NAME2 NAME3) 123.0)</pre>
<p>When lists within lists are passed to the command processing
program, the format varies depending on whether you are using CL or HLL, or
REXX.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="defdlclhll.htm">Use CL or HLL for lists within lists</a></strong><br />
This describes the format in which elements in a list within a list are passed when a command is run using CL or a high-level language.</li>
<li class="ulchildlink"><strong><a href="llrx.htm">Use REXX for lists within lists</a></strong><br />
This describes the format in which elements in a list within a list are passed when a command is run using REXX.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dflst.htm" title="You can define a parameter to accept a list of values instead of just a single value.">Define lists for parameters</a></div>
</div>
</div>
</body>
</html>