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

107 lines
5.7 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<?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="SUBDEV (Subdevice) keyword for ICF files" />
<meta name="abstract" content="Use this file- or record-level keyword to allow your program to request a specific subdevice (for example, a printer) to which transmitted data should be directed." />
<meta name="description" content="Use this file- or record-level keyword to allow your program to request a specific subdevice (for example, a printer) to which transmitted data should be directed." />
<meta name="DC.subject" content="SUBDEV (Subdevice) keyword" />
<meta name="keywords" content="SUBDEV (Subdevice) 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="icfsubd" />
<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, SUBDEV</title>
</head>
<body id="icfsubd"><a name="icfsubd"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SUBDEV (Subdevice) keyword for ICF files</h1>
<div><p>Use this file- or record-level keyword to allow your program to
request a specific subdevice (for example, a printer) to which transmitted
data should be directed.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>SUBDEV(*DC1 | *DC2 | *DC3 | *DC4)</pre>
</div>
<p>The
SUBDEV keyword is ignored at run time when EOS, DETACH, RSPCONFIRM, or RQSWRT
is in effect. These keywords must have option indicators when they apply
to a record for which the SUBDEV keyword applies. If an EOS, DETACH, RSPCONFIRM,
or RQSWRT keyword with no option indicator applies to a record for which SUBDEV
applies, an error message is issued and the SUBDEV keyword is ignored at creation
time.</p>
<p>You can specify only one parameter value for each SUBDEV keyword.</p>
<p>You
can specify this keyword more than once in the file; however, you cannot specify
the same parameter value at the file level and again at the record-level.
This is true even if you specify option indicators each time. For example,
if you specify SUBDEV(*DC1) at the file level, you cannot specify SUBDEV(*DC1)
anywhere else in the file.</p>
<p>If you specify the SUBDEV keyword at both
the file level and the record level, and your program selects the one at the
file level, the record-level keyword(s) have no effect even if also selected.</p>
<p>You
can specify the SUBDEV keyword a maximum of four times for each record format.
If you specify the SUBDEV keyword more than once, you must specify option
indicators each time, and you can specify each keyword value only once.</p>
<p>The <span class="keyword">i5/OS™</span> operating
system sends a device selection character as follows. The meaning of the
device selection character is set by the remote system or device. </p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr valign="bottom"><th valign="bottom" id="d0e45">Parameter value</th>
<th valign="bottom" id="d0e47">Character sent</th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e45 ">*DC1</td>
<td valign="top" headers="d0e47 ">Hex 11</td>
</tr>
<tr><td valign="top" headers="d0e45 ">*DC2</td>
<td valign="top" headers="d0e47 ">Hex 12</td>
</tr>
<tr><td valign="top" headers="d0e45 ">*DC3</td>
<td valign="top" headers="d0e47 ">Hex 13</td>
</tr>
<tr><td valign="top" headers="d0e45 ">*DC4</td>
<td valign="top" headers="d0e47 ">Hex 5D</td>
</tr>
</tbody>
</table>
</div>
<p>You cannot specify SUBDEV 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 SUBDEV keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A 01 SUBDEV(*DC1)
00020A 02 SUBDEV(*DC4)
A R RECORD
A</pre>
<p>If indicator 01 is on, the <span class="keyword">i5/OS</span> operating system sends the
component selection character hex 11 on an output operation (no matter how
indicator 02 is set).</p>
<p>If indicator
02 is on and indicator 01 is off, the <span class="keyword">i5/OS</span> operating
system sends component selection character hex 5D.</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>