179 lines
5.7 KiB
HTML
179 lines
5.7 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<title>Using the Data Stream Translation APIs</title>
|
||
|
|
<!-- Begin Header Records ========================================= -->
|
||
|
|
<!-- 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. -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- COMM4 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2DCIJB at -->
|
||
|
|
<!-- RCHVMW2 on 1 Jun 1999 at 17:32:50 -->
|
||
|
|
<!-- Graphics included: RBAFX635 and 636 -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<h2>Using the Data Stream Translation APIs</h2>
|
||
|
|
|
||
|
|
<p>Using the data stream APIs, your applications can:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Translate from a 3270 output data stream to a formatted buffer<br>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>Translate from a 3270 output data stream to a 5250 data stream</li>
|
||
|
|
|
||
|
|
<li>Translate from a formatted output buffer to a 5250 data stream</li>
|
||
|
|
|
||
|
|
<li>Translate from a formatted input buffer to a 3270 data stream</li>
|
||
|
|
|
||
|
|
<li>Translate from a 5250 input data stream to a formatted buffer</li>
|
||
|
|
|
||
|
|
<li>Translate from a 5250 input data stream to a 3270 data stream</li>
|
||
|
|
|
||
|
|
<li>Translate from a 5250 read screen format to a 3270 read buffer format</li>
|
||
|
|
|
||
|
|
<li>Translate from a 5250 read screen with extended attributes to a 3270 read
|
||
|
|
buffer format</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>The following figures show the translation options available when your
|
||
|
|
application calls the data stream translation APIs.</p>
|
||
|
|
|
||
|
|
<p><strong><a name="FIGTRANOUT">Translations for Output
|
||
|
|
Operations</a></strong></p>
|
||
|
|
|
||
|
|
<p><img src="RBAFX635.gif" alt="Translations for Output Operations"></p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
<p><strong><a name="FIGTRANSIN">Translations for Input
|
||
|
|
Operations</a></strong></p>
|
||
|
|
|
||
|
|
<p><img src="RBAFX636.gif" alt="Translations for Input Operations"></p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
<p>When your application calls the QD0STRTS API, a translation session is
|
||
|
|
opened using a user-specified device as a basis for the translation parameters.
|
||
|
|
You can open as many sessions as you need, because for every session a unique
|
||
|
|
translation session handle is passed back to your application.</p>
|
||
|
|
|
||
|
|
<p>A call to the QD0TRNDS API does the actual data stream translation using the
|
||
|
|
specified parameters to indicate the type of translation. Multiple translation
|
||
|
|
sessions can be active at the same time. A translation session remains open,
|
||
|
|
that is the handle remains valid, until the QD0ENDTS API is called using that
|
||
|
|
handle or the job that called QD0STRTS ends. The final call to the QD0ENDTS API
|
||
|
|
closes or ends the translation session.</p>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> If you are using the same translation parameters for
|
||
|
|
many translations, you may decide to use only one QD0STRTS call for each unique
|
||
|
|
set of parameters to enhance performance.</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
|
||
|
|
<h3>Programming Restrictions</h3>
|
||
|
|
|
||
|
|
<p>The 5250 data streams generated by the QD0TRNDS API for your application
|
||
|
|
have the following restrictions:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>Read commands are not added to the end of a data stream. Your application
|
||
|
|
is responsible for sending Read modified data tag (MDT) fields to the
|
||
|
|
destination display.<br>
|
||
|
|
<br>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>If the device for which the data stream is intended does not support data
|
||
|
|
in row 1, column 1 then this location is restricted from use in the input
|
||
|
|
field.<br>
|
||
|
|
<br>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>The number of input fields is dependent on the type of work station
|
||
|
|
controller. The following is a list of the maximum number of input and output
|
||
|
|
fields allowed per device:<br>
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<table cellpadding="3">
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>126</em></td>
|
||
|
|
<td align="left" valign="top">3270 display station</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>255</em></td>
|
||
|
|
<td align="left" valign="top">5250 local display station</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>126</em></td>
|
||
|
|
<td align="left" valign="top">5250 pass-through</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>126</em></td>
|
||
|
|
<td align="left" valign="top">5251 display station</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>230</em></td>
|
||
|
|
<td align="left" valign="top">5294 Remote Control Unit</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>255</em></td>
|
||
|
|
<td align="left" valign="top">5394 Remote Control Unit</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>255</em></td>
|
||
|
|
<td align="left" valign="top">5494 Remote Control Unit</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>254</em></td>
|
||
|
|
<td align="left" valign="top">Client Access running work station function</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li>Fields that are detectable by light pens are not supported.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>There are some 3270 data stream commands, orders, and attributes that are
|
||
|
|
not supported. For a list of the 3270 data stream commands, orders, and
|
||
|
|
attributes that are supported, see the <a href="../booksc4154080.pdf"
|
||
|
|
target="_blank">3270 Device Emulation Support</a><img src="wbpdf.gif" alt="Link to PDF"> book on the V5R1 Supplemental Manuals Web site.</p>
|
||
|
|
|
||
|
|
<p>All parameter values must be uppercased and left justified.</p>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="comm.htm">Communications APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|