ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzake_5.4.0.1/rzakemsticfvarl.htm

80 lines
4.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="reference" />
<meta name="DC.Title" content="VARLEN (Variable-Length User Data) keyword for ICF files" />
<meta name="abstract" content="Use this record-level keyword to indicate that the length of the record sent across the line is variable. The length is specified at run time in the field parameter." />
<meta name="description" content="Use this record-level keyword to indicate that the length of the record sent across the line is variable. The length is specified at run time in the field parameter." />
<meta name="DC.subject" content="VARLEN (Variable-Length User Data) keyword, Variable-Length User Data (VARLEN) keyword" />
<meta name="keywords" content="VARLEN (Variable-Length User Data) keyword, Variable-Length User Data (VARLEN) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakemstckeyw.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="icfvarl" />
<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>ICF Files, VARLEN</title>
</head>
<body id="icfvarl"><a name="icfvarl"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">VARLEN (Variable-Length User Data) keyword for ICF files</h1>
<div><p>Use this record-level keyword to indicate that the length of the
record sent across the line is variable. The length is specified at run time
in the field parameter.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>VARLEN(&amp;field-name);</pre>
</div>
<p>The &amp;field-name
parameter is required and specifies the name of the field that contains the
length of the user data to be sent. The field name must exist in the record
format and the field must be defined as a zoned field of length 5, data type
S, usage P, and zero decimal positions.</p>
<p>The length value set in the
parameter field is the length of the user data and does not include indicators.
The length value is specified in decimal and is checked at run time. The
value should not be greater than the length of the DDS record format. The
maximum value depends on the communication type you are using.</p>
<p>VARLEN
is valid only on output operations.</p>
<p>VARLEN is ignored at run time when
an CANCEL, EOS, FAIL, NEGRSP, RSPCONFIRM, or RQSWRT keyword is in effect.
These keywords must have option indicators when they apply to a record that
has the VARLEN keyword specified. If a CANCEL, EOS, FAIL, NEGRSP, or RQSWRT
keyword with no option indicator applies to a record for which VARLEN applies,
an error message is issued and the VARLEN keyword is ignored at creation time.</p>
<p>At
least one data field (usage B or blank) for the user data must be specified
in the record format.</p>
<p>You cannot specify VARLEN with the TIMER keyword.</p>
<p>Option
indicators are not valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4> <p>The following example shows how to specify
the VARLEN keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RCD VARLEN(&amp;LENFLD);
A DATAFLD 32760A
A LENFLD 5S P
A</pre>
<p>On an output operation to RCD, the length of the data
in DATAFLD that is sent across the line will be the length set in LENFLD.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakemstckeyw.htm" title="These topics contain the keyword entries that you can specify when you define ICF files.">DDS keyword entries for ICF files (positions 45 through 80)</a></div>
</div>
</div>
</body>
</html>