How to display hardware inbound data stream errors


The Hardware Inbound Data Stream Errors panel displays information about any hardware inbound data stream errors that were found by the Optimizer. These errors can also be caused by the following items:

  • Incorrect microcode in the device controller
  • Incorrect 3270 emulation
  • Applids acting as secondary LUs that generate incorrect data streams or incorrect scripts in such an Applid

Displaying the hardware inbound data stream errors panel

Summary: In this task, you will display the Hardware Inbound Data Stream Errors panel.

To display the Hardware Inbound Data Stream Errors panel, perform the following steps:

  1. Select option 3 on the Monitor Primary Menu panel.
  2. Press Enter.
    The Data Stream Analysis Menu is displayed.
  3. Select option 2.
  4. Press Enter.
    The Hardware Inbound Data Stream Errors panel is displayed.

Following block shows a typical example of the information that is provided by the Optimizer for any errors in your inbound data streams. Twenty-one types of errors can occur. Following hardware inbound data stream error codes table lists all possible error codes and provides a description of each one. The Monitor displays only errors that are found by the Optimizer. If the Optimizer determines that a data stream contains an error, the data stream is excluded from optimization.

(3.2.0) 3270 SUPEROPTIMIZER/CICS August 10, 2001
Option. . ______ Hardware Inbound Data Stream Errors 16:33:21
CICSID:CICS212

------Error------ -------------Data Stream Error Information ------------
Code Description Frequency Termid Transid SF PI PS Dspl OR/COM TV/A
H17 Structured field longer than data stream
3 NS11 SIM1 80 00 0000 002B 88 0011

Total Inbound Errors. . . . : 3
Total Errors. . . . . . . . : 5
F1=Help F2=Keys F3=End F4=Return F9=Print

The statistics that are displayed by the Application Outbound Data Stream Errors panel and the Hardware Inbound Data Stream Errors panel are reset at the following times:

  • Cold-start of CICS
  • When the Optimizer is shut down
  • User-specified times

The Reset Statistics options can be set by using option 9. For more information about this option, see Printing-and-Resetting-Optimization-Statistics.

If a COPSHUT statement is in your DFHPLTSD table, and the COPOPT file is available, these statistics are retained when you perform a warm-start of CICS.

For more information on inbound data stream errors, see the IBM 3270 Information Display System Data Stream Programmer’s Reference.

Table data stream error information provides a description of the fields that are displayed on the Hardware Inbound Data Stream Errors panel.

Following table lists hardware inbound data stream error codes that you can receive, their associated error message, and descriptions of the errors.

Error Code

Description

H01

Truncated parameter list

An inbound data stream ended with an incomplete 3270 order

H02

Unknown character set attribute

An SA, SFE, or MF order contains an unknown local character set identifier (LCID). The LCID should have been loaded by a previous load programmed symbol (LPS) structured field.

This is usually a hardware error. The Optimizer might have detected this error incorrectly if the data stream containing the LPS was excluded from optimization or the Optimizer was not active at the time that the LPS was sent to the controller.

H03

Partition ID unknown or invalid

The partition ID specified in the structured field was either unknown or invalid for the device.

This is usually a hardware error. The Optimizer might have detected this error incorrectly if the data stream containing the Create Partition (CP) was excluded from optimization or the Optimizer was not active at the time that the CP was sent to the controller

H04

Invalid structured field

An unknown or invalid structured field was detected.

H05

Invalid data stream order

An invalid 3270 data stream order was detected when

  • An order (for example, SBA) occurred in an unformatted read-modified or READB data stream is detected
  • A protected non-light-pen-detectable field is modified by a terminal operator. See the glossary for a list of valid 3270 orders.

H06

Invalid address

An invalid buffer address was detected in an EUA, RA, or SBA order. One of the following conditions was found:

  • Address is unknown.
  • Address is larger than the current device buffer size.
  • Addressing mode is not in sync with the data stream (12, 14, or 16-bit addressing mode). The addressing mode is set in the CP (Create Partition) structured field.
  • An SBA order’s nonzero address was not greater than the previous SBA order’s address.
  • An SBA order does not correspond to a field on the screen.

H07

Invalid attribute type

An invalid attribute type was detected in an MF, SA, or SFE order. Valid attribute types are

  • 3270 Field Attributes
  • Extended Highlighting
  • Extended Color
  • Character Set
  • Field Outlining
  • Background Transparency
  • Field Validation

H08

Invalid attribute value

An invalid attribute value was found for an attribute type other than Character Set in an MF, SA, or SFE order.

H09

Invalid character set

An invalid LCID was found in the attribute value field of an attribute type Character Set (programmed symbols) in an MF, SA, or SFE order. This value must be X’00’ or X’40’ to X’FE’.

H10

Invalid graphic escape character

An invalid Graphic Escape (GE) order was detected. Valid values are: X’40’ to X’FE’.

H11

Invalid AID

An invalid AID was detected in a 3270 outbound data stream.

H12

Data stream SBA out of sequence

An SBA was encountered in the inbound data stream whose address was less than the address of the preceding SBA. This situation is not valid for inbound data streams unless the address is zero (X’4040’)

H13

Data stream field longer than image field

A field was present in the inbound data stream that was longer than the field which was last sent to the screen at that location.

H14

Data stream contains both SF and SBA

An inbound data stream contains both Start Field and Set Buffer Address orders. This situation is not valid for inbound data streams.

H15

SBA found but not at start of data

An SBA at the beginning of the inbound data stream indicates a formatted Read Modified (RM) data stream. If no SBA is present at the beginning of the data stream, the data stream is unformatted and cannot contain other SBA orders

H16

Unmodifiable field in Read Modified

A field that is protected and not pre-modified or Select Pen Detectable has been found in the inbound data stream. This situation cannot occur with a valid 3270 device.

H17

Structured field longer than data stream

A structured field length is larger than the remaining length of the data stream.

H18

Incomplete Read Buffer

A Read Buffer (RB) data stream was found to be too short (not all data was read from the buffer) or too long (more data was read than the buffer should contain).

H19

Data stream protected field differs from image field

An inbound field that is protected has been changed since the data was last sent to the screen. This situation is not possible with a valid 3270 device.

H20

Data stream protected field shorter than image field

In the inbound data stream, a field was found that was shorter than the field that was last sent to the device. This situation is not valid if the field is protected.

H21

Query reply descriptor length invalid

The Descriptor Length in the Character Sets or Graphic Symbol Set query reply was invalid or zero.

Related topic


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*