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

81 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="VARBUFMGT (Variable Buffer Management) keyword for ICF files" />
<meta name="abstract" content="Use this record-level keyword to send or receive multiple or partial records using one record format per output operation." />
<meta name="description" content="Use this record-level keyword to send or receive multiple or partial records using one record format per output operation." />
<meta name="DC.subject" content="VARBUFMGT (Variable Buffer Management) keyword, Variable Buffer Management (VARBUFMGT) keyword" />
<meta name="keywords" content="VARBUFMGT (Variable Buffer Management) keyword, Variable Buffer Management (VARBUFMGT) 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="icfvarb" />
<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, VARBUFMGT</title>
</head>
<body id="icfvarb"><a name="icfvarb"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">VARBUFMGT (Variable Buffer Management) keyword for ICF files</h1>
<div><p>Use this record-level keyword to send or receive multiple or partial
records using one record format per output operation.</p>
<div class="section"><p>On a send operation, you must specify the length of data to be
sent using the VARLEN keyword. Otherwise, the length of the record format
is used. On a receive operation, the length of data received is the length
of the record format.</p>
<p>This keyword has no parameters.</p>
<p>VARBUFMGT
is ignored at run time when a 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 VARBUFMGT keyword specified. If a CANCEL,
EOS, FAIL, NEGRSP, or RQSWRT keyword with no option indicator applies to a
record for which VARBUFMGT applies, an error message results and the VARBUFMGT
keyword is ignored at create time.</p>
<p>Specify at least one data field (usage
B or blank) for the user data in the record format.</p>
<div class="p">You cannot specify
the VARBUFMGT keyword: <ul><li>When the TIMER keyword is used</li>
<li>On the same record format as the RECID keyword</li>
<li>On the RECID or INVITE default record formats</li>
</ul>
</div>
<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 VARBUFMGT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R MULTFMT1
00020A VARBUFMGT
00030A DATAFLD 32A
00040A R MULTFMT2
00050A VARLEN(&amp;LENFLD);
00060A VARBUFMGT
00070A DATAFLD 32A
00080A LENFLD 5S P</pre>
<p>Suppose <samp class="codeph">42THIS
RECORD WILL NOT FIT INTO ONE BUFFER</samp> was the data to be sent or received.
The VARBUFMGT keyword on the first record format sends or receives the first
32 bytes of data. The second record format sends 10 bytes of data. The data
length of 10 is 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>