Understanding the OIA

oia.dita

The OIA (Operator Information Area) is the area at the bottom of the screen where session indicators and messages appear. Session indicators show information about the workstation, host system, and attachment. Z and I Emulator for Web offers two versions of the OIA: a graphical OIA and a textual OIA.

The textual OIA is a new accessibility feature that responds to Section 508 of the US Rehabilitation Act, which outlines technology-based requirements for users who have physical disabilities, such as restricted mobility or limited vision. The textual OIA is designed to work with screen readers, so users with limited vision can use the OIA to find out their current cursor position on the green screen and diagnose possible problems with the session. For more information about the textual OIA, refer to Accessibility in the online help.

Listed below are the session information fields, which are grouped according to the columns in which they appear.

Control unit status (column 1) Connection protocol (column 2) System available (column 3) Security (column 4) Session shortname (column 7) Program messages (columns 9-17) Communications messages (columns 19-25) Message waiting indicator (columns 26-27) APL mode (columns 37-39) Insert mode (column 52) Graphics cursor mode (columns 54-56) Document Mode (columns 66-69) Word Wrap (column 70) Current page (columns 72-73) Cursor's current row and column number (columns 74-80)

Note: Sometimes two session indicators represent the same message. Which indicator you see on your OIA depends on which Java fonts you have loaded on your machine.

 

Control unit status (column 1) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

The presence of a character indicates that a session is actively using a control unit. The character indicates a type of control unit attachment.

Connection protocol (column 2) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

System available (column 3) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

A symbol indicates whether your workstation is accessing a host or an application.

Security (column 4) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

Session shortname (column 7) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

Program messages (columns 9-17) (3270, CICS, and 5250)

This message accompanies the X in column 9 and explains why input is inhibited.

Program Check These messages indicate that there is an error in the datastream sent from the host application.
Prog 750
A 3270 command was received that is not valid.
Prog 751
A START FIELD EXTENDED, MODIFY FIELD, or SET ATTRIBUTE order was received which specified a character set that is not valid.
Prog 752
A SET BUFFER ADDRESS, REPEAT TO ADDRESS, or ERASE UNPROTECTED TO ADDRESS order was received which specified an address that is not valid.
Prog 753
One or more of the following conditions occurred:
  • A READ MODIFIED, READ MODIFIED ALL, or READ BUFFER command that also contained data was received.
  • A REPEAT TO ADDRESS or GRAPHIC ESCAPE order was received which specified a character set that is not valid.
  • A START FIELD EXTENDED, MODIFY FIELD, or SET ATTRIBUTE order was received which specified an attribute value or character set that is not valid.
Prog 754
One of the following commands was received without the required parameters:
  • SET BUFFER ADDRESS
  • REPEAT TO ADDRESS
  • ERASE UNPROTECTED TO ADDRESS
  • START FIELD
  • START FIELD EXTENDED
  • MODIFY FIELD
  • SET ATTRIBUTE
  • GRAPHIC ESCAPE
Prog 755
A character code was received that is not valid.
Prog 756
A WRITE STRUCTURED FIELD command was received with a structured field that is not valid.
Prog 758
A SET REPLY MODE command was received with a mode that is not valid.
Prog 759
A WRITE STRUCTURED FIELD command was received with a structured field length that is not valid.
Prog 760
A WRITE STRUCTURED FIELD command was received with reserved fields that are not zero.
Prog 761
A WRITE STRUCTURED FIELD command was received with a partition identifier that is not valid.
Prog 780
An internal message was received with an incorrect direction.
Prog 797
SO was received; however, SO/SI are not paired correctly.
Prog 798
SO/SI or GRAPHIC ESCAPE was received in a DBCS field.
Prog 799
One or more of the following conditions occurred:
  • Address points to the second byte of a DBCS character.
  • A character attribute in a DBCS subfield is not valid.
  • STOP address is not valid.
  • General DBCS error.

Communications messages (columns 19-25) (3270, 3270 Printer, CICS, 5250, 5250 Printer, and VT)

Communications Check These messages indicate a communications problem between Z and I Emulator for Web and the server or host to which it is trying to connect.

These messages are preceded by a lightning bolt if the session is using the IBM 3270 font; otherwise, they are preceded by COMM.
Comm 654
The session could not establish a connection to the Telnet3270E server because the specified LU name is not valid. The LU name may not be valid for the following reasons:
  • The LU name is already in use by another session.
  • The LU name is not defined at the Telnet server.
  • The Telnet server does not support the LU type of the specified LU.
  • The LU name is not compatible with the requested LU type. For example, the session type is Display, but the specified LU is a Printer.
  • The Telnet server is unable to process this type of request. Contact your system administrator for help.
  • An unknown error occurred during Telnet device-type negotiations. Contact your system administrator for help.

Ensure that your session's destination address, port, and LU name are correct. Also, ensure that your Telnet server is configured for the LU name that you are requesting. To determine which error condition is occurring, take a Transport Level 1 trace of your session startup.

Comm 655
  • The socket connection to the Telnet server has been established and the session is waiting for negotiation to finish.
  • The client has SSL off and has tried to connect to the server on an SSL port.

Check that the SSL lock icon displays in the lower, right-hand corner of the session screen. If not, the host system port has not been configured for SSL. Try setting SSL on the client and reconnecting.

Comm 657
  • The session is in the process of establishing the TCP/IP connection to the Telnet server.
  • For SSL:
    • The client has SSL on and has tried to connect to the server on a non-configured port. You will first receive a brief COMM657, which changes to COMM659. If Auto-reconnect is enabled, the emulator will cycle in this pattern; otherwise, COMM659 remains.
    • The client has SSL on and has tried to connect to the server on a non-SSL port. You will first receive a COMM657, which changes to COMM659 after some time. If Auto-reconnect is enabled, the emulator cycles in this pattern; otherwise, it stays at COMM659.
    • The signer certificate that corresponds to the client SSL certificate being used to establish a secure connection has expired. The client certificate may be valid when the signer certificate has expired.

When you close a session that displays COMM657, there may be some delay before it closes. The delay varies. If you are in a hurry, close the browser.

Comm 658
The session is initializing the TCP/IP connection for Telnet3270E.
Comm 659
  • The Telnet TCP connection to the session has not succeeded or has failed.
    • The TCP/IP connection to the Telnet3270 server could not be established.
    • You clicked Disconnect on the Communication menu.
    • The Telnet server closed the TCP/IP connection either by application control or because it detected an error.
    • For 5250, the specified workstation ID is already in use, and the host closed the connection.

    Ensure that your Telnet server and its port customization settings are correct. Also, ensure that your Telnet server is running and that it is configured correctly. To determine which error condition is occurring, take a Transport Level 1 trace when the error occurs.

  • For SSL:
    • The client has SSL off and has tried to connect to the server on a non-configured port.
    • The client has SSL on and has tried to connect to the server on a non-configured port. You will first receive a brief COMM657, which changes to COMM659. If Auto-reconnect is enabled, the emulator will cycle in this pattern; otherwise, COMM659 remains.
    • The client has SSL on and has tried to connect to the server on a non-SSL port. You will first receive a COMM657, which changes to COMM659 after some time. If Auto-recomment is enabled, the emulator cycles in this pattern; otherwise, it stays at COMM659.
  • The client has SSL on but cannot gain access to the key database on the server. This can happen if, for example, the database is not there, is currupted, or does not have a password.
Comm 662
The server presented a certificate that was not trusted.
Comm 663
The server's certificate did not match its name. Because the session requested server authentication, the connection was refused.
Comm 664
A secure connection could not be completed.
Comm 665
The server's certificate is not yet valid.
Comm 666
The server's certificate has expired.

Message Waiting Indicator (Columns 26-27) (5250)

MW  The host system has one or more messages for the session.

APL mode (columns 37-39) (3270 and CICS)

APL  The keyboard is in APL mode.

Insert mode (column 52) (3270, CICS, and 5250)

The keyboard is in Insert mode. A character may be inserted at the cursor location. Characters beyond the cursor position move to make room for the inserted character.

Graphics cursor mode (columns 54-56) (3270)

+CR The graphics cursor (crosshair cursor) is enabled.

Document Mode (columns 66-69) (3270)

DOC Entry Assist Document Mode is enabled.

Word Wrap (column 70) (3270)

V or  Entry Assist Word Wrap is enabled. Word wrap is a function that automatically moves the last word on a line to the next line if the word would otherwise overrun the right margin. Word wrap can only occur if Entry Assist Document Mode is enabled.

The current page (columns 72-73) (VT)

pn This indicates the current page where the cursor is located.

Cursor's current row and column number (columns 74-80) (3270, CICS, 5250, and VT)

yy/zzz  This indicates the position of the cursor in a row/column format, where yy is the row number and zzz is the column number. In the OIA, the row numbers are located in columns 74-76, the divider symbol (/) is located in column 77, and the column numbers are located in columns 78-80.

Top of page Table of contents