123 lines
7.3 KiB
HTML
123 lines
7.3 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="TRNSPY (Transparency) keyword in printer files" />
|
|
<meta name="abstract" content="This field-level keyword prevents code points that you have redefined (using the DFNCHR keyword) from being interpreted as SCS printer control commands when your program sends an output operation that prints the field that you are defining." />
|
|
<meta name="description" content="This field-level keyword prevents code points that you have redefined (using the DFNCHR keyword) from being interpreted as SCS printer control commands when your program sends an output operation that prints the field that you are defining." />
|
|
<meta name="DC.subject" content="TRNSPY (Transparency) keyword, Transparency (TRNSPY) keyword" />
|
|
<meta name="keywords" content="TRNSPY (Transparency) keyword, Transparency (TRNSPY) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptcvtct.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="rzakdmsttrspy" />
|
|
<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>TRNSPY (Transparency) keyword in printer files</title>
|
|
</head>
|
|
<body id="rzakdmsttrspy"><a name="rzakdmsttrspy"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">TRNSPY (Transparency) keyword in printer files</h1>
|
|
<div><p>This field-level keyword prevents code points that you have redefined
|
|
(using the DFNCHR keyword) from being interpreted as SCS printer control commands
|
|
when your program sends an output operation that prints the field that you
|
|
are defining.</p>
|
|
<div class="section"><p>This keyword has no parameters.</p>
|
|
<p>If you do not specify the
|
|
TRNSPY keyword for a field in which your program passes hexadecimal data to
|
|
an SCS printer, code points can be interpreted as SCS commands that affect
|
|
printer operation. A <strong>code point</strong> is one of the 256 values that you can
|
|
assign a character in a character set. On the <span class="keyword">iSeries™</span> servers,
|
|
a code point is identified by a 2-digit hexadecimal number.</p>
|
|
<div class="p">You must
|
|
specify the TRNSPY keyword when you specify: <ul><li>The CVTDTA keyword in a printer file created with DEVTYPE(*SCS)</li>
|
|
<li>A hexadecimal value (with or without the DFT keyword explicitly specified)</li>
|
|
</ul>
|
|
</div>
|
|
<p>In a file created with DEVTYPE(*IPDS), you need not specify the
|
|
TRNSPY keyword with the CVTDTA keyword. However, a warning message appears
|
|
stating that the DEVTYPE should not be changed to *SCS.</p>
|
|
<p>If you specify
|
|
TRNSPY in a file created with DEVTYPE(*AFPDS), a warning message appears at
|
|
create time.</p>
|
|
<p>The TRNSPY keyword is valid only when the data type is
|
|
character.</p>
|
|
<p>When you specify the TRNSPY keyword with the CVTDTA keyword,
|
|
your program can place character data in the field and the <span class="keyword"><font color="Purple">i5/OS™</font></span> operating system converts it to hexadecimal
|
|
data when the field is passed to the printer. Each pair of hexadecimal digits
|
|
corresponds to a code point in the character set of your system. Using the
|
|
DFNCHR keyword, you can define characters of your own design for the 5224
|
|
Printer or 5225 Printer. Also, the printed length of the field is one half
|
|
the length you specify. Therefore, the length of the field must be an even
|
|
number.</p>
|
|
<p>If you specify the TRNSPY keyword without the CVTDTA keyword,
|
|
the field length you specify is the printed length.</p>
|
|
<p>This keyword is
|
|
supported only for the 5224 Printer and 5225 Printer.</p>
|
|
<p>Option indicators
|
|
are not valid for this keyword.</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Examples</h4><p>The following examples show how to specify
|
|
the TRNSPY keyword.</p>
|
|
<p><strong>Example 1:</strong></p>
|
|
<p>The following example shows
|
|
how to specify the TRNSPY keyword with the CVTDTA keyword. When your program
|
|
passes character data in a field, the <span class="keyword"><font color="Purple">i5/OS</font></span> operation system converts it to hexadecimal
|
|
data.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A R RECORD SPACEB(1)
|
|
00020A FLD1 10 1TRNSPY CVTDTA
|
|
00030A FLD2 20 6TRNSPY CVTDTA
|
|
A</pre>
|
|
<p>The program can pass character data in FLD1 and FLD2.
|
|
The <span class="keyword"><font color="Purple">i5/OS</font></span> operating
|
|
system converts it to hexadecimal data for the printer. Only
|
|
the characters 0 through 9 and A through F are valid. Blanks are not valid.</p>
|
|
<p>The
|
|
printed length of FLD1 and FLD2 is one half the specified length (FLD1 is
|
|
5 positions long; FLD2 is 10 positions long).</p>
|
|
<p>You must also specify
|
|
the DFNCHR keyword with this DDS in order to print user-defined characters.</p>
|
|
<p>The
|
|
following is how RECORD prints when the contents of FLD1 are 'C1C1C1C1C1'
|
|
and the contents of FLD2 are 'C2C2C2C2C2C2C2C2C2C2':</p>
|
|
<pre>AAAAABBBBBBBBBB</pre>
|
|
<p><strong>Example
|
|
2:</strong></p>
|
|
<p>The following example shows how to specify the TRNSPY keyword
|
|
without the CVTDTA keyword. In this example, your program must pass hexadecimal
|
|
data in the field.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A R RECORD2 SPACEB(1)
|
|
00020A FLD3 5 1TRNSPY
|
|
00030A FLD4 10 6TRNSPY
|
|
A</pre>
|
|
<p>The program must pass hexadecimal data in FLD3 and FLD4.
|
|
Only hexadecimal characters 0 through 9 and A through F are valid. Blanks
|
|
are not valid. Without the CVTDTA keyword, the printed length of both fields
|
|
is the specified length.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakdmstptcvtct.htm" title="This field-level keyword converts character data to hexadecimal data when the field is passed to the printer.">CVTDTA (Convert Data) keyword in printer files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |