820 lines
22 KiB
HTML
820 lines
22 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>5250 Data Stream Details</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 -->
|
|
<!-- DSMMST1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 29 Jan 1999 at 16:05:09 -->
|
|
<!-- File Edited November 2001 -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<!-- Java sync-link -->
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
|
|
|
|
<h2>5250 Data Stream Details</h2>
|
|
|
|
<h3><a name="HDRAID">AID-Generating Keys</a></h3>
|
|
|
|
<p>The AID (attention indicator) code identifies to the host system the
|
|
function being requested from the keyboard. The AID code is returned by certain
|
|
input operations when the operator presses an AID-generating key. The following
|
|
table lists the AID-generating keys and the AID codes associated with each key.
|
|
See <a href="QsnCrtEnv.htm#HDRLLDESC">Format of the Low-Level Environment
|
|
Description</a> for instructions on how to specify an alternative help key.</p>
|
|
|
|
<table border>
|
|
<tr>
|
|
<th align="left" valign="top" colspan="3"><em>AID Codes</em></th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="top">AID key</th>
|
|
<th align="left" valign="top">Mnemonic</th>
|
|
<th align="left" valign="top">AID Code</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Cmd 1 - 12 (cmd 1=x'31', cmd12=x'3C')</td>
|
|
<td align="left" valign="top">QSN_F1 - QSN_F12</td>
|
|
<td align="left" valign="top">x'31' - x'3C'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Selector Light Pen Auto Enter</td>
|
|
<td align="left" valign="top">QSN_SLP</td>
|
|
<td align="left" valign="top">x'3F'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Forward Edge Trigger Auto Enter</td>
|
|
<td align="left" valign="top">QSN_FET</td>
|
|
<td align="left" valign="top">x'50'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">PA1</td>
|
|
<td align="left" valign="top">QSN_PA1</td>
|
|
<td align="left" valign="top">x'6C'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">PA2</td>
|
|
<td align="left" valign="top">QSN_PA2</td>
|
|
<td align="left" valign="top">x'6E'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">PA3</td>
|
|
<td align="left" valign="top">QSN_PA3</td>
|
|
<td align="left" valign="top">x'6B'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Cmd 13 - 24 (cmd 13=x'B1', cmd24=x'BC')</td>
|
|
<td align="left" valign="top">QSN_F13 - QSN_F24</td>
|
|
<td align="left" valign="top">x'B1' - x'BC'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Clear</td>
|
|
<td align="left" valign="top">QSN_CLEAR</td>
|
|
<td align="left" valign="top">x'BD'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Enter or Record Advance</td>
|
|
<td align="left" valign="top">QSN_ENTER</td>
|
|
<td align="left" valign="top">x'F1'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Help (not in error state)</td>
|
|
<td align="left" valign="top">QSN_HELP</td>
|
|
<td align="left" valign="top">x'F3'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Roll Down or Page Up</td>
|
|
<td align="left" valign="top">QSN_ROLLDOWN or QSN_PAGEUP</td>
|
|
<td align="left" valign="top">x'F4'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Roll Up or Page Down</td>
|
|
<td align="left" valign="top">QSN_ROLLUP or QSN_PAGEDOWN</td>
|
|
<td align="left" valign="top">x'F5'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Print</td>
|
|
<td align="left" valign="top">QSN_PRINT</td>
|
|
<td align="left" valign="top">x'F6'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Record Backspace</td>
|
|
<td align="left" valign="top">QSN_RECBS</td>
|
|
<td align="left" valign="top">x'F8'</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRCC">Control Characters</a></h3>
|
|
|
|
<p>The display control characters (CCs) are always specified as a pair of
|
|
1-byte fields. They are used on the QsnWTD, QsnReadInp, QsnReadMDT, and
|
|
QsnReadMDTAlt APIs. These characters select specific operations for the display
|
|
station to perform. Byte 1 is always processed first. When the CCs are used
|
|
with the QsnWTD API, the first CC is processed immediately while the second CC
|
|
is not processed until all the other information associated with the API has
|
|
been processed. When used with an input operation, both CCs are processed after
|
|
the operation has completed. The following two tables list the valid control
|
|
character values and their associated mnemonics.</p>
|
|
|
|
<table border="1">
|
|
<!-- cols="24 10 10 15 15 13 13" -->
|
|
<tr>
|
|
<th align="left" valign="bottom" colspan="7"><em>Control Character Byte
|
|
1</em></th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Mnemonic</th>
|
|
<th align="left" valign="bottom">Bits 0-2</th>
|
|
<th align="left" valign="bottom">Reset Pending Aid; Lock Keyboard</th>
|
|
<th align="left" valign="bottom">Clear Master MDT; Reset MDT Flags in<br>
|
|
Nonbypass<br>
|
|
Fields</th>
|
|
<th align="left" valign="bottom">Clear Master MDT; Reset MDT Flags in All
|
|
Fields</th>
|
|
<th align="left" valign="bottom">Null Nonbypass Fields with MDT On</th>
|
|
<th align="left" valign="bottom">Null All Nonbypass Fields</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_ NULL</td>
|
|
<td align="left" valign="top">000</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_ LOCKBD</td>
|
|
<td align="left" valign="top">001</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_ MDTNBY</td>
|
|
<td align="left" valign="top">010</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_ MDTALL</td>
|
|
<td align="left" valign="top">011</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_ CLRMOD</td>
|
|
<td align="left" valign="top">100</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_MDTNBY_ CLRALL</td>
|
|
<td align="left" valign="top">101</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_MDTNBY_ CLRMOD</td>
|
|
<td align="left" valign="top">110</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC1_MDTALL_ CLRALL</td>
|
|
<td align="left" valign="top">111</td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top">x</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="7"><strong>Note:</strong>
|
|
|
|
<ol>
|
|
<li>Bits 3 through 7 are reserved and must be 0. A CPFA31C error will be issued
|
|
if this is not the case.<br>
|
|
<br>
|
|
</li>
|
|
|
|
<li>If there are no bypass fields with MDT flags on, then the master MDT will
|
|
be cleared.</li>
|
|
</ol>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<table border="1">
|
|
<tr>
|
|
<th align="left" valign="top" colspan="3"><em>Control Character Byte
|
|
2</em></th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="top">Mnemonic</th>
|
|
<th align="center" valign="top">Bit</th>
|
|
<th align="left" valign="top">Meaning</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="30%"> </td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="60%">reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_NO_IC</td>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Cursor moves to default or IC order position when keyboard unlocks</p>
|
|
|
|
<p>1: Cursor does not move when keyboard unlocks</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_RST_CSR_BL</td>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Reset blinking cursor</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_SET_CSR_BL</td>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Set blinking cursor</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_UNLOCKBD</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Unlock the keyboard and reset any pending AID bytes</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_ALARM</td>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Sound alarm</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="2%">QSN_CC2_MSG_OFF</td>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top" width="98%">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Set Message Waiting indicator off</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_CC2_MSG_ON</td>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: no action</p>
|
|
|
|
<p>1: Set Message Waiting indicator on</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="3"><strong>Notes:</strong>
|
|
|
|
<ul>
|
|
<li>The mnemonics for control character byte 2 can be combined with a bitwise
|
|
OR operation.<br>
|
|
<br>
|
|
</li>
|
|
|
|
<li>See notes in the 5250 data stream documentation for further details
|
|
regarding these functions.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
<h3><a name="HDRSCRATTR">Screen Attribute Characters</a></h3>
|
|
|
|
<p>The screen or field attributes control the image produced on the display
|
|
station screen. Each attribute occupies one character position in the display
|
|
station regeneration buffer and is displayed as a blank. The effect produced by
|
|
an attribute begins at its location in the regeneration buffer and continues
|
|
until the next attribute appears. The attributes for non-color displays are
|
|
shown in the table below and for color displays in the <a href=
|
|
"#TBLATTRCOL">Screen Attributes for Color Displays</a> table. There are certain
|
|
operations that allow a value to be specified for a screen attribute that
|
|
indicates no screen attribute should be used. Where supported, the value is
|
|
X'00' and the mnemonic is QSN_NO_SA.</p>
|
|
|
|
<table border="1">
|
|
<tr>
|
|
<th align="left" valign="top" colspan="3"><a name="TBLATTRBW"><em>Screen
|
|
Attributes for Non-Color Displays</em></a></th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="top">Mnemonic</th>
|
|
<th align="center" valign="top">Bits</th>
|
|
<th align="left" valign="top">Value</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="30%">QSN_SA_NORM</td>
|
|
<td align="center" valign="top" width="10%">0-2</td>
|
|
<td align="left" valign="top" width="60%">001: Attribute identification
|
|
flag</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_CS</td>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Column separator off</p>
|
|
|
|
<p>1: Column separator on</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_BL</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Do not blink field</p>
|
|
|
|
<p>1: Blink field</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_UL</td>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Do not underscore field</p>
|
|
|
|
<p>1: Underscore field</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_HI</td>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Low intensity</p>
|
|
|
|
<p>1: High intensity</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RI</td>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">
|
|
<blockquote>
|
|
<p>0: Normal image</p>
|
|
|
|
<p>1: Reverse image</p>
|
|
</blockquote>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_ND</td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">Non-display: equivalent to specifying QSN_SA_UL,
|
|
QSN_SA_HI, and QSN_SA_RI.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="3"><strong>Note:</strong> Multiple
|
|
functions can be selected by combining the mnemonics with a bitwise OR
|
|
operation.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<table border="1">
|
|
<tr>
|
|
<th align="left" valign="top" colspan="3"><em><a name="TBLATTRCOL">Screen
|
|
Attributes for Color Displays</a></em></th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="top">Mnemonic</th>
|
|
<th align="center" valign="top">Value</th>
|
|
<th align="left" valign="top">Meaning</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="30%">QSN_SA_GRN</td>
|
|
<td align="center" valign="top" width="20%">x'20'</td>
|
|
<td align="left" valign="top" width="50%">Green</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_GRN_RI</td>
|
|
<td align="center" valign="top">x'21'</td>
|
|
<td align="left" valign="top">Green/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_WHT</td>
|
|
<td align="center" valign="top">x'22'</td>
|
|
<td align="left" valign="top">White</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_WHT_RI</td>
|
|
<td align="center" valign="top">x'23'</td>
|
|
<td align="left" valign="top">White/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_GRN_UL</td>
|
|
<td align="center" valign="top">x'24'</td>
|
|
<td align="left" valign="top">Green/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_GRN_UL_RI</td>
|
|
<td align="center" valign="top">x'25'</td>
|
|
<td align="left" valign="top">Green/Underscore/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_WHT_UL</td>
|
|
<td align="center" valign="top">x'26'</td>
|
|
<td align="left" valign="top">White/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_ND</td>
|
|
<td align="center" valign="top">x'27'</td>
|
|
<td align="left" valign="top">Nondisplay</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED</td>
|
|
<td align="center" valign="top">x'28'</td>
|
|
<td align="left" valign="top">Red</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_RI</td>
|
|
<td align="center" valign="top">x'29'</td>
|
|
<td align="left" valign="top">Red/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_BL</td>
|
|
<td align="center" valign="top">x'2A'</td>
|
|
<td align="left" valign="top">Red/Blink</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_RI_BL</td>
|
|
<td align="center" valign="top">x'2B'</td>
|
|
<td align="left" valign="top">Red/Reverse Image/Blink</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_UL</td>
|
|
<td align="center" valign="top">x'2C'</td>
|
|
<td align="left" valign="top">Red/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_UL_RI</td>
|
|
<td align="center" valign="top">x'2D'</td>
|
|
<td align="left" valign="top">Red/Underscore/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_RED_UL_BL</td>
|
|
<td align="center" valign="top">x'2E'</td>
|
|
<td align="left" valign="top">Red/Underscore/Blink</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_ND_2F</td>
|
|
<td align="center" valign="top">x'2F'</td>
|
|
<td align="left" valign="top">Nondisplay</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_TRQ_CS</td>
|
|
<td align="center" valign="top">x'30'</td>
|
|
<td align="left" valign="top">Turquoise/Column Separators</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_TRQ_CS_RI</td>
|
|
<td align="center" valign="top">x'31'</td>
|
|
<td align="left" valign="top">Turquoise/Column Separators/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_YLW_CS</td>
|
|
<td align="center" valign="top">x'32'</td>
|
|
<td align="left" valign="top">Yellow/Column Separators</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_YLW_CS_RI</td>
|
|
<td align="center" valign="top">x'33'</td>
|
|
<td align="left" valign="top">Yellow/Column Separators/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_TRQ_UL</td>
|
|
<td align="center" valign="top">x'34'</td>
|
|
<td align="left" valign="top">Turquoise/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_TRQ_UL_RI</td>
|
|
<td align="center" valign="top">x'35'</td>
|
|
<td align="left" valign="top">Turquoise/Underscore/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_YLW_UL</td>
|
|
<td align="center" valign="top">x'36'</td>
|
|
<td align="left" valign="top">Yellow/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_ND_37</td>
|
|
<td align="center" valign="top">x'37'</td>
|
|
<td align="left" valign="top">Nondisplay</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_PNK</td>
|
|
<td align="center" valign="top">x'38'</td>
|
|
<td align="left" valign="top">Pink</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_PNK_RI</td>
|
|
<td align="center" valign="top">x'39'</td>
|
|
<td align="left" valign="top">Pink/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_BLU</td>
|
|
<td align="center" valign="top">x'3A'</td>
|
|
<td align="left" valign="top">Blue</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_BLU_RI</td>
|
|
<td align="center" valign="top">x'3B'</td>
|
|
<td align="left" valign="top">Blue/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_PNK_UL</td>
|
|
<td align="center" valign="top">x'3C'</td>
|
|
<td align="left" valign="top">Pink/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_PNK_UL_RI</td>
|
|
<td align="center" valign="top">x'3D'</td>
|
|
<td align="left" valign="top">Pink/Underscore/Reverse Image</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_BLU_UL</td>
|
|
<td align="center" valign="top">x'3E'</td>
|
|
<td align="left" valign="top">Blue/Underscore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">QSN_SA_ND_3F</td>
|
|
<td align="center" valign="top">x'3F'</td>
|
|
<td align="left" valign="top">Nondisplay</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
<h3><a name="HDRDSPADDR">Display Address</a></h3>
|
|
|
|
<p>The display address is the address at which data is displayed or a field
|
|
definition begins. This can be modified explicitly with a Set Output Address
|
|
(QsnSetOutAdr) call, or implicitly with output operations, such as those
|
|
associated with the Write Data (QsnWrtDta) API, that accept a cursor position.
|
|
The 5250 Write to Display (WTD) command initializes the display address to row
|
|
1, column 1. Because each output operation contains a WTD command, this means
|
|
that the display address is reset on each direct screen output operation.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRICADDR">Insert Cursor Address</a></h3>
|
|
|
|
<p>The insert cursor (IC) order specifies the position of the cursor when the
|
|
host system unlocks the keyboard and when the display station operator presses
|
|
the Home key. The display address is not affected by this address. This can be
|
|
set with the Insert Cursor (QsnInsCsr) API, and in some cases with the Set
|
|
Cursor Address (QsnSetCsrAdr) API (only when the Move Cursor (MC) order is not
|
|
supported).</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRMDT">Modified Data Tag (MDT) Bit</a></h3>
|
|
|
|
<p>There is a modified data tag (MDT) bit for each input field and a master MDT
|
|
bit. These bits are used to determine which fields should be returned in
|
|
response to the Read Modified Fields (QsnReadMDT), Read Modified Alternate
|
|
(QsnReadMDTAlt), and Read Modified Immediate Alternate (QsnReadMDTImmAlt) APIs.
|
|
The MDT bit for a field and the master MDT bit can be set using bit 4 of the
|
|
field format word (see <a href="QsnSetFld.htm#HDRFFW">Format of the Field
|
|
Format Word</a>) on a Set Field (QsnSetFld) API. The master MDT bit and the MDT
|
|
bit for a field are set on anytime the operator types into or alters a field on
|
|
the display. Once the bits are set, only a control character for resetting them
|
|
(see <a href="#TBLCC1">Table 2</a>), or a clear screen operation using the
|
|
Clear Screen (QsnClrScr) API or a Start of Header order, can reset them.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRRESEQ">Resequencing</a></h3>
|
|
|
|
<p>Resequencing allows the control unit to return up to 128 input fields in any
|
|
specified order. Resequencing is accomplished by chaining input fields together
|
|
with Field Control Words specifying resequencing. (See <a href=
|
|
"QsnSetFld.htm#HDRFCW">Format of the Field Control Word</a> and the 5250 data
|
|
stream documentation for details.)</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSTATMOD">States and Modes</a></h3>
|
|
|
|
<p>The display station can be in one of several states (conditions), each with
|
|
its accompanying modes (methods of operation). The following is a list of these
|
|
states and their associated modes:</p>
|
|
|
|
<ul>
|
|
<li>Hardware error state</li>
|
|
|
|
<li>Normal locked state</li>
|
|
|
|
<li>Normal unlocked state
|
|
|
|
<ul>
|
|
<li>Command mode</li>
|
|
|
|
<li>Insert mode</li>
|
|
|
|
<li>Data mode</li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li>Power-on state</li>
|
|
|
|
<li>Prehelp error state</li>
|
|
|
|
<li>Post-help error state</li>
|
|
|
|
<li>System services (SS) message state</li>
|
|
|
|
<li>System request state</li>
|
|
</ul>
|
|
|
|
<p>See the 5250 data stream documentation for a detailed explanation of each
|
|
state and mode.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRDUMP">Dumping the 5250 Data Stream Commands</a></h3>
|
|
|
|
<p>If you wish to produce a dump of the 5250 data stream commands that are
|
|
produced by the DSM APIs, you should create a physical file (using the CRTPF
|
|
command) having a record length of 2000. Name the physical file QSNDEBUGF, and
|
|
ensure that the QSNDEBUGF file exists in the library list. DSM will dump the
|
|
5250 data stream commands to that file.</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=
|
|
"dsm.htm">Dynamic Screen Manager APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
</body>
|
|
</html>
|
|
|