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

80 lines
4.4 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="INVITE (Invite) keyword for ICF files" />
<meta name="abstract" content="Use this file- or record-level keyword to invite the program device for a later read." />
<meta name="description" content="Use this file- or record-level keyword to invite the program device for a later read." />
<meta name="DC.subject" content="INVITE (Invite) keyword" />
<meta name="keywords" content="INVITE (Invite) 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="icfinvi" />
<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, INVITE</title>
</head>
<body id="icfinvi"><a name="icfinvi"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">INVITE (Invite) keyword for ICF files</h1>
<div><p>Use this file- or record-level keyword to invite the program device
for a later read.</p>
<div class="section"><p>To send an invite request to the program device,
your program issues a write operation to that program device with the INVITE
keyword in effect.</p>
<p>The INVITE keyword provides
some performance improvement if your application program is doing interactive
processing with the program device. Normally, a read request is sent to a
device when your program issues an input operation. However, the INVITE keyword
allows you to request the read operation when you issue the output operation.
After the output operation is completed, your program can do other processing
while the invited program device is sending data and the <span class="keyword">i5/OS™</span> program
processes the received data. This might improve the performance of your program.
When your application program is ready to process the data, it issues an
input operation.</p>
<p>This keyword has no parameters.</p>
<p>The INVITE keyword
is ignored at run time when EOS, RSPCONFIRM, or DETACH is in effect. These
keywords must have option indicators when they apply to a record for which
the INVITE keyword applies. If an EOS, RSPCONFIRM, or DETACH keyword with
no option indicator applies to a record for which INVITE applies, an error
message is issued and the INVITE keyword is ignored at creation time.</p>
<p>You
cannot specify INVITE with the TIMER keyword.</p>
<p>Option indicators are
valid for this keyword.</p>
<p>The INVITE keyword cannot be specified at both
the file- and record-level.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4> <p>The following example shows how to specify
the INVITE keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A 01 INVITE
00020A R RCD1
00030A FLD1 10
00040A FLD2 5
A</pre>
<p>The INVITE keyword is in effect only when option indicator
01 is set on.</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>