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

96 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="reference" />
<meta name="DC.Title" content="NEGRSP (Negative Response) keyword for ICF files" />
<meta name="abstract" content="Use this file- or record-level keyword to send a negative response to the remote program to indicate that your program detected an error in the data received." />
<meta name="description" content="Use this file- or record-level keyword to send a negative response to the remote program to indicate that your program detected an error in the data received." />
<meta name="DC.subject" content="NEGRSP (Negative Response) keyword, Negative Response (NEGRSP) keyword" />
<meta name="keywords" content="NEGRSP (Negative Response) keyword, Negative Response (NEGRSP) 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="icfnegr" />
<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, NEGRSP</title>
</head>
<body id="icfnegr"><a name="icfnegr"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">NEGRSP (Negative Response) keyword for ICF files</h1>
<div><p>Use this file- or record-level keyword to send a negative response
to the remote program to indicate that your program detected an error in the
data received.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>NEGRSP[(&amp;field-name)]</pre>
</div>
<p>The
optional parameter, &amp;field-name,; specifies the name of a field that contains
sense data to be sent to the remote program with the negative response. The
specified field name must exist in the record format, and the field must be
a character field with length at least 8, data type A, and usage B or blank.</p>
<p>The
NEGRSP keyword must have an option indicator when it applies to a record for
which any of the following keywords apply:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="void" border="0" rules="none"><tbody><tr><td valign="top" width="50%"> <p>CANCEL<br />
CNLINVITE<br />
EVOKE<br />
RQSWRT</p>
</td>
<td valign="top" width="50%"> <p>RSPCONFIRM<br />
VARBUFMGT<br />
VARLEN</p>
</td>
</tr>
</tbody>
</table>
</div>
<p>At run time, these keywords are ignored when the NEGRSP keyword
is in effect. If a NEGRSP keyword with no option indicator applies to a record
for which any of these keywords apply, error messages are issued and these
keywords are ignored at creation time.</p>
<p>NEGRSP is ignored at run time
when EOS or FAIL is in effect. These keywords must have option indicators
if they apply to a record for which NEGRSP applies. If an EOS or FAIL keyword
with no option indicator applies to a record for which NEGRSP applies, an
error message is issued and the NEGRSP keyword is ignored at creation time.</p>
<p>When
you specify NEGRSP at the file level, you cannot specify the
field name parameter.</p>
<p>You cannot specify NEGRSP with the TIMER keyword.</p>
<p>Option
indicators are valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4> <p>The following example shows how to specify
the NEGRSP keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RCD1
A 01 NEGRSP(&amp;FIELDB);
A FIELDA 25A B
A FIELDB 80A B
A</pre>
<p>If indicator 01 is on, a write operation to RCD1 will
send a negative response and send the first 8 bytes of FIELDB to the remote
program. Note that no data from RCD1 other than the sense data will be sent
with the negative response.</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>