ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdfsetof.htm

87 lines
5.2 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="SETOF (Set Off) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword to specify that when an input operation sent to this record format is completed, the specified response indicator is to be set off." />
<meta name="description" content="Use this record-level keyword to specify that when an input operation sent to this record format is completed, the specified response indicator is to be set off." />
<meta name="DC.subject" content="SETOF (Set Off) keyword" />
<meta name="keywords" content="SETOF (Set Off) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsoff.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="rzakcmstdfsetof" />
<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>SETOF (Set Off) keyword for display files</title>
</head>
<body id="rzakcmstdfsetof"><a name="rzakcmstdfsetof"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SETOF (Set Off) keyword for display files</h1>
<div><p>Use this record-level keyword to specify that when an input operation
sent to this record format is completed, the specified response indicator
is to be set off.</p>
<div class="section"><p>See the <a href="s36env.htm">System/36 environment considerations for display files</a> topic for information
about how to specify the SETOF keyword in files that are used in the System/36™ environment.</p>
<div class="p">The
format of the keyword is: <pre>SETOF(response-indicator ['text'])</pre>
</div>
<p>The
optional text is included on the computer printout created at program compilation
to explain the intended use of the indicator. This text functions only as
a comment in the file or program. The single quotation marks are required.
If you specify more than 50 characters between the single quotation marks,
the text is truncated to 50 characters on the program listing.</p>
<p>This
keyword can be used to cause an option indicator that is on for an output
operation to be returned in the off condition when the next input operation
to the record is completed. (If no input operation is performed, the response
indicator remains unchanged.) Your program does not need to turn off the indicator.</p>
<p>SETOF
is equivalent to the SETOFF keyword.</p>
<p>Any indicator is valid for this
keyword. It does not need to be previously defined as an option or a response
indicator. The indicator becomes a response indicator when you specify SETOF.</p>
<p>If
the indicator used with the SETOF keyword is also used with another keyword,
such as CHANGE, the on/off status of the indicator is controlled by the other
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 SETOF keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R CUSMST SETOF(63 'On=display MSG2000 +
00020A CONSOLEMSG')
00030A QRYORD 3 0I 5 3
00040A 63 ERRMSGID(MSG2000 CONSOLEMSG)
A</pre>
<p>A MSG2000 message is displayed on the message line when
the program sends an output operation to CUSMST with indicator 63 set on.
On the next input operation to CUSMST, the SETOF keyword sets off indicator
63. (Indicator 63 is used as both an option and a response indicator.)</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfsoff.htm" title="The SETOFF keyword is equivalent to the SETOF keyword.">SETOFF (Set Off) keyword for display files</a></div>
</div>
</div>
</body>
</html>