NETWORK MANAGEMENT

This section describes the support that IRMA WorkStation 
provides for centralized network management. The following 
topics are discussed:

* Connections used for the NetView and Response Time Monitor 
(RTM) facilities
* Link alerts
* Link statistics
* Application-generated alerts, and alerts generated through 
the NVAlert and NVRunCmd services
* RTM statistics
* Local logging of network management data

For information about configuring the IRMA WorkStation to 
work with NetView and/or RTM, and information about 
configuring the NVAlert and NVRunCmd services, 
see the Administrator's Guide.

Connections Used for NetView and RTM

IRMA WorkStation can make use of NetView, a reporting system 
that runs on an IBM host (mainframe). NetView sends alerts 
between the host and the PCs that connect to it. IRMA 
WorkStation can also receive information from RTM, a 3270 
and NetView facility that monitors the amount of time it 
takes for a host to respond during 3270 display sessions.

To send link alerts, link statistics, and application-
generated alerts to the NetView program at the host, you 
must specify the connection on which the alerts will be 
sent.

To specify the connection on which NetView data should be 
sent:

1. Using the SNA Admin program choose NetView from the 
Options menu.

2. Under Send NetView Management Data to Connection, select 
a connection.

The connection must be a host connection (not peer or 
downstream), and must not be a distributed function terminal 
(DFT) connection.

3. Choose the OK button.

RTM data and NetView alerts sent to the host by 3270 users 
are not necessarily sent via the NetView connection. RTM 
data is sent on the connection for the session to which it 
refers, while 3270 user alerts are sent on the connection 
for the currently selected 3270 session.

For information about configuring the IRMA WorkStation to 
work with NetView and/or RTM, and information about 
configuring the NVAlert and NVRunCmd services, 
see the Administrator's Guide.

Link Alerts for SDLC and Token Ring

When a Synchronous Data Link Control (SDLC) or token ring 
connection fails, IRMA WorkStation logs diagnostic 
information, called link alerts, about the connection 
failure. The alerts are logged in a log file that can be 
viewed using the Windows NT Event Viewer. To find an SNA 
log, in the Event Viewer, from the Log menu, make sure 
Application is selected. Under the "Source" heading, the 
application log file will have a name starting with "SNA."

The link alerts are also used to build a network management 
vector transport (NMVT) alert, which includes probable 
causes and suggested actions for the alert. If a connection 
on the server running IRMA WorkStation has been designated 
for NetView, and the connection is active, the NMVT alert 
will be sent on that connection.  

This section contains the following information:
* An explanation of the general format of link alerts, 
common to both SDLC and token ring.

* Descriptions of individual alerts produced by the SDLC 
link service.
* Detailed information about the local logging of SDLC 
alerts.
* Descriptions of individual alerts produced by the token 
ring link service.
* Details of the local logging of token ring alerts.

For information about the NetView vectors supported by the 
NVAlert and NVRunCmd services, see "Alerts Used by 
Applications, NVAlert, and NVRunCmd" later in this file.

Link Alert Format and Common Subvectors

The general format of link alerts is as follows:

NMVT HEADER
41 03 8D 00 00 00 00 00     NMVT Header

Major Vector Header
LL LL     Length of Major Vector
00 00     Alert major vector

The specific alert is identified by the alert description 
and alert ID (part of the generic alert subvector). Common 
subvectors are listed later in this section.  SDLC and token 
ring failure alerts are described in the "SDLC Failure 
Alerts" and "Token Ring Failure Alerts" sections, 
respectively, later in this file.

Each subvector or subfield begins with a 1-byte length field 
and a 1-byte key identifying the subvector or subfield. The 
length field contains the length in bytes of the entire 
subvector or subfield, including the length and key bytes. 
Where the length byte is shown as LL, this indicates that 
the length is not fixed because different alerts require 
different data to be included.

Table 1 lists all the possible subvectors used in the alert, 
with their subvector keys (identifiers).

Table 1.  LINK ALERT SUBVECTORS  

SUBVECTOR KEY 
(IDENTIFIER)              SUBVECTOR

05                        Hierarchy/Resource List Subvector.

03                        Hierarchy Name List Subvector.

01                        Date/Time Subvector.

10                        Product Set ID Subvector (this 
                          appears twice, as Alert Sender 
                          PSID and Indicated Resource PSID).

51                        LAN LCS Data Subvector.

52                        LCS Configuration Data Subvector.

8C                        Link Station Data Subvector.

91                        Basic Alert Subvector.

92                        Generic Alert Subvector.

93                        Probable Cause Subvector.

94                        User Causes Subvector.

95                        Install Causes Subvector.

96                        Failure Causes Subvector.

A1                        Detail Qualifier Subvector.


The following tables describe the formats of link alert 
subvectors. Additional tables, later in this file, describe 
the individual link alerts.

HIERARCHY/RESOURCE LIST SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 05                     Hierarchy/Resource List Subvector.

LL 10                     Hierarchy/Resource List Subfield.

hh                        Flags:
                             80 (1-User)
                             00 (Server).

LL                        Name field length: name length 
                          plus this length byte.

hh...hh                   Adapter name in EBCDIC, 8 bytes.

00                        Flags byte: always 0.

3F                        Resource type: port.

Optional second name      Remote host name. For token ring,  
                          local ring name. See individual 
                          alert descriptions.

LL                        Name field length: name length 
                          plus this length byte.

hh...hh                   Name in EBCDIC, up to 8 bytes.

00                        Flags byte: always 0.

F4 or 2E                  Resource type: control point or 
                          token ring.


HIERARCHY/NAME LIST SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 03                     Hierarchy Name List subvector.

00 or 03                  Reserved byte.

hh                        Number of names in the hierarchy 
                          name list.

LL                        Length of each name, including 
                          this length byte.

hh...hh                   Name of resource for each name.

D3 C3 D6 D5               Resource type identifier: LCON 
                          (logical link connection not known 
                          to SNA).


DATE/TIME SUBVECTOR ALERTS

FORMAT AND CONTENTS       DESCRIPTION

0A 01                     Date/Time Subvector.

08 10                     Local Date/Time subfield.

hh                        Year - two digits.

hh                        Month.

hh                        Date.

hh                        Hours.

hh                        Minutes.

hh                        Seconds (binary).


PRODUCT SET ID SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

2A 10                     Product Set ID subvector.

00                        (unused field).

27 11                     Product ID subvector.

0C                        Product classification: non-IBM 
                          software.

08 04                     Software product common level 
                          subfield.

F0 F2                     Version identifier: 02.

F0 F0                     Release identifier: 00.

F0 F0                     Modification identifier: 00.

13 06                     Software product common name
                          subfield.

C4 C3 C1 61 D4 E2 40      Product name:
C3 D6 D4 D4 40               MS
E2 C5 D9 E5 D9               SNA Server


09 08                     Software product program number 
                          subfield.

F0 F0 F0 F0 F0 F0 F0      Product program number: zeros.


LAN LINK CONNECTION SUBSYSTEM DATA SUBVECTOR*

FORMAT AND CONTENTS       DESCRIPTION

LL 51                     LAN LCS Data Subvector.

04 02                     Ring Identifier subfield.

hh hh                     Ring number.

08 03                     Local Individual MAC Address 
                          subfield.

hh...hh                   Local individual MAC address.

08 04                     Remote Individual MAC Address 
                          subfield.

hh...hh                   Remote individual MAC address.

LL 05                     LAN Routing Information subfield.

hh...hh                   LAN routing information

* Token ring only.



LINK CONNECTION SUBSYSTEM CONFIGURATION DATA SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 52                     LCS Configuration Data Subvector.

04 01                     Port Address subfield.

hh hh                     Port address.

03 02                     Remote Device Address subfield.

hh                        Remote device address.

03 04                     Local Device Address subfield.

hh                        Local device address.

04 06                     Link Station Attributes subfield.

01 or 02 or 03            Link station role: Primary, 
                          Secondary, or Negotiable.

03 or 04                  Remote node type: Type 4 or Type 
                          2.1.

06 07                     Link Attributes subfield.

01 or 02                  Link connection type: nonswitched 
                          or switched.

01 or 02                  Half-duplex or full-duplex.

01                        Protocol: SDLC.

01 or 02                  Point-to-point or multipoint.


LINK STATION DATA SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 8C                     Link Station Data Subvector.

04 01                     N(s) and N(r) counts subfield.

hh                        N(s) count.

hh                        N(r) count.

03 02                     Outstanding frame count subfield.

hh                        Outstanding frame count.

04 03                     Last SDLC Control Field Received 
                          subfield.

hh hh                     Last control field received.

04 04                     Last SDLC Control Field Sent 
                          subfield.

hh hh                     Last control field sent.

03 05                     Sequence Number Modulus subfield.

80                        Sequence number modulus.

03 06                     Link Station State subfield.

80 or 40                  Link station state: local or 
                          remote station sending RNR.

04 07                     LLC Reply Timer Expiration Count 
                          subfield.

hh hh                     Reply timer expiration count.

03 08                     Last Received N(r) Count subfield.

hh                        Last received N(r) (binary).


BASIC ALERT SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

0E 91                     Basic Alert subvector.

00                        Not operator initiated.

01                        Alert type: permanent.

0E                        General cause code: link-level 
                          protocol error.

00 80 or 00 34            Specific component code: token
                          ring LAN or SDLC data link 
                          control.

00 00                     Alert description code.

00 00                     User action code.

00 00                     Detail text reference code.

00                        Unused field.


GENERIC ALERT SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

0B 92                     Generic Alert subvector.

00 00                     Flags: not operator initiated, not 
                          a held alert.

01                        Alert type: permanent.

hh hh                     Alert description: See alert 
                          descriptions.

hh hh hh hh               Alert ID number (unique to a 
                          particular alert).


PROBABLE CAUSE SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 93                     Probable cause subvector.

hh hh                     Probable cause: See individual 
                          alert descriptions. This 
                          alert may include more than one 
                          entry.


USER CAUSES SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 94                     User Causes Subvector.

LL 01                     User causes subfield.

hh hh                     User cause: See individual alert 
                          descriptions. More than one entry 
                          may appear here.

LL 81                     Recommended actions subfield.

hh hh                     Recommended action: See individual 
                          alert descriptions.  More than one 
                          entry may appear here.

03 83                     Product set ID index subfield.

99                        Product Set ID index.

LL 82                     Detailed data subfield. This 
                          subfield may appear more than 
                          once.

99                        Product Set ID code.

hh                        Data ID: See individual alert 
                          descriptions.

00                        Data encoding: hexadecimal.

hh...hh                   Detailed data: See individual 
                          alert descriptions.


INSTALL CAUSE SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 95                     Install Causes Subvector.

LL 01                     Install causes subfield.

hh hh                     Install cause: See individual 
                          alert descriptions. More than 
                          one entry may appear here.

LL 81                     Recommended actions subfield.

hh hh                     Recommended action: See individual 
                          alert descriptions. More than one 
                          entry may appear here.

03 83                     Product set ID index subfield.

99                        Product Set ID index.

LL 82                     Detailed data subfield. This 
                          subfield may occur more than 
                          once.

99                        Product Set ID code.

hh                        Data ID: See individual alert
                          descriptions.

00                        Data encoding: hexadecimal.

hh...hh                   Detailed data: See individual 
                          alert descriptions.


FAILURE CAUSE SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

LL 96                     Failure Causes Subvector.

LL 01                     Failure causes subfield.

hh hh                     Failure cause: See individual 
                          alert descriptions. More than one 
                          entry may appear here.

LL 81                     Recommended actions subfield.

hh hh                     Recommended action: See individual 
                          alert descriptions. More than one
                          entry may appear here.

03 83                     Product set ID index subfield.

99                        Product Set ID index.

LL 82                     Detailed data subfield. This 
                          subfield may occur more than 
                          once.

99                        Product Set ID code.

hh                        Data ID: See individual alert 
                          descriptions.

00                        Data encoding: hexadecimal.

hh...hh                   Detailed data: See individual
                          alert descriptions.


DETAIL QUALIFIER (HEXADECIMAL) SUBVECTOR

FORMAT AND CONTENTS       DESCRIPTION

06 A1                     Detail Qualifier subvector.

hh hh hh hh               Detail Qualifier subfield - four 
                          bytes as follows:
                          * Token ring: adapter number
                          * Alert number
                          * Two-byte error code SDLC: link 
                            ID
                          * Station address, outage


SDLC Failure Alerts

The tables in this section describe the alerts generated by 
the SDLC link service provided with IRMA WorkStation. The 
alerts are listed in numerical order by alert description 
and within each description in numerical order by alert ID.

WRITE TIMEOUT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  1000           Equipment malfunction

Alert ID:           61D0 2E7B


Probable causes:    2031           Line
                    3601           Local modem
                    2200           Remote node
                    3603           Remote modem

Failure causes:     3511           Line
                    3601           Local modem
                    2200           Remote node
                    3603           Remote modem
                    F034           CTS failed to rise

Recommended actions:0403           Run modem tests
                    2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   2E             Write timeout retry 
                                   exceeded


ABNORMAL MODEM RESPONSE ALERT


                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  1000           Equipment malfunction

Alert ID:           70A1 5CB0


Probable causes:    3601           Local modem
                    3401           Local cable
                    3302           Communications adapter

User causes:        3401           Cabling installed 
                                   incorrectly

Recommended actions:0301           Check cable and its 
                                   connections

Failure causes:     3601           Local modem
                    3401           Local cable
                    3302           Communications adapter
                    F035           DSR dropped

Recommended actions:0403           Run modem tests
                    2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following   
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   2D             Abnormal response


DSR FAILURE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  1000           Equipment malfunction

Alert ID:           83BB 6EC8

Probable causes:    3601           Local modem
                    3401           Local cable
                    3302           Communications adapter

User causes:        3400           Cable loose
                    0205           Local modem power off

Failure causes:     3601           Local modem
                    3401           Local cable
                    3302           Communications adapter
                    F035           DSR dropped

Recommended actions:0403           Run modem tests
                    2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   11             DSR failure


DCD FAILURE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION


Alert description:  1000           Equipment malfunction

Alert ID:           C3BB 504A


Probable causes:    2031           Line
                    3601           Local modem

Failure causes:     3511           Line
                    3601           Local modem
                    F038           Carrier detect lost

Recommended actions:0403           Run modem tests
                    2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   14             DCD failure


INVALID FRAME RECEIVED: I-FIELD NOT PERMITTED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           1103 D152

Probable causes:    2004           SDLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F021           I-field received when not 
                                   permitted

Recommended actions:2011           Review hexadecimal 
                                   display of alert 
                                   report
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   87             Invalid frame received


INVALID FRAME RECEIVED: INVALID/UNSUPPORTED CMD/RSP ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           15C2 CCE5

Probable causes:    2004           SDLC communications
                    1023           Communications program in
                                   remote node

Failure causes:     1023           Communications program in
                                   remote node
                    F020           Invalid/unsupported 
                                   command or response 
                                   received

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   87             Invalid frame received


INVALID FRAME RECEIVED: INVALID N(R) RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           1C40F78B


Probable causes:    2004           SDLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F022           Invalid N(R) received

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   87             Invalid frame received


RIM/RD RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           29BF 0032


Probable causes:    2104           SDLC communications/ 
                                   remote node
                    1023           Communications program in 
                                   remote node

Failure causes:     2104           SDLC communications/ 
                                   remote node
                    3511           Line

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   88             RIM received
                    89             RD received


INVALID FRAME RECEIVED: MAX I-FIELD LENGTH EXCEEDED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           5F76 24FD

Probable causes:    2104           SDLC communications/ 
                                   remote node
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F023           Received I-field exceeded 
                                   maximum length

Recommended actions:2011           Review hexadecimal
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   87             Invalid frame received


FRMR RECEIVED: NO REASON GIVEN ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           A472 BC48      

Probable causes:    2004           SDLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F014           FRMR received: no reason 
                                   specified

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   86             FRMR received


FRMR RECEIVED: I-FIELD RECEIVED WHEN NOT PERMITTED

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           B3B7 D723       

Probable causes:    2004           SDLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F011           FRMR received: I-field 
                                   sent when not permitted

Recommended actions:2011           Review hexadecimal
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   86             FRMR received


FRMR RECEIVED: INVALID/UNSUPPORTED COMMAND OR RESPONSE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           B776 CA94


Probable causes:    2004           SDLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F010           FRMR received: invalid/ 
                                   unsupported command or 
                                   response sent

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   86             FRMR received


FRMR RECEIVED: MAX I-FIELD LENGTH EXCEEDED ALERTS

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           BA35 EC4D

Probable causes:    2004           SDLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F013           FRMR received: maximum I-
                                   field length exceeded

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   86             FRMR received


FRMR RECEIVED: INVALID N(R) SENT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           BEF4 F1FA

Probable causes:    2004           SDLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F012           FRMR received: invalid
                                   N(R) sent

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 
Detail qualifier:   86             FRMR received


DISK/SNRM RECEIVED: SNRM RECEIVED IN NRM ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           D635 CA1E

Probable causes:    2004           SDLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F015           SNRM received while in
                                   NRM

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   15             Connection terminated by
                                   host


CTS FAILURE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           0231 CF0A

Probable causes:    2031           Line
                    3601           Local modem

Failure causes:     3511           Line
                    3601           Local modem
                    F030           CTS dropped

Recommended actions:0403           Run modem tests
                    2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   12             CTS failure


CONNECTION PROBLEM: XID RETRANSMISSION ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           0AEC C2A6

Probable causes:    2104           SDLC communications/
                                   remote node
                    2031           Line

User causes:        0209           Remote device power off

Recommended action: 0200           Check power

Failure causes:     2104           SDLC communications/ 
                                   remote node
                    3511           Line
                    F018           XID poll count exhausted


IDLE TIMEOUT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           0E2D DF11

Probable causes:    2104           SDLC communications/ 
                                   remote node

                    2031           Line

User causes:        0209           Remote device power off

Recommended action: 0200           Check power

Failure causes:     2104           SDLC communications/
                                   remote node
                    3511           Line
                    F019           Inactivity timer expired

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   25             Idle timeout retry
                                   exceeded


POLL COUNT EXHAUSTED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           32A3 7F1B

Probable causes:    2104           SDLC communications/  
                                   remote node
                    2031           Line

User causes:        0209           Remote device power off

Recommended action: 0200           Check power

Failure causes:     2104           SDLC communications/ 
                                   remote node
                    3511           Line
                    F017           Poll count exhausted

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   81             Disconnect retry limit
                    82             Contact retry limit
                    83             Poll retry limit
                    84             No response retry limit


REMOTE BUSY RETRY ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           66D6 DA74

Probable causes:    2104           SDLC communications/
                                   remote node

User causes:        0209           Remote device power off

Recommended actions:0200           Check power

Failure causes:     2104           SDLC communications/
                                   remote node
                    3511           Line
                    F00F           RNR received threshold 
                                   reached

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   85             Remote busy retry limit


DM RECEIVED IN INFORMATION TRANSFER ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           BD84 C4C9

Probable causes:    2004           SDLC communications

Failure causes:     2004           SDLC communications
                    F01A           DM received

Recommended actions:2011           Review hexadecimal  
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   80             DM received


NONPRODUCTIVE RECEIVE TIMEOUT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           C458 E284

Probable causes:    2104           SDLC communications/ 
                                   remote node
                    2031           Line

User causes:        0209           Remote device power off

Recommended action: 0200           Check power

Failure causes:     2104           SDLC communications/ 
                                   remote node
                    3511           Line
                    F00E           NPR timeout retry limit 
                                   reached

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   24             Nonproductive receive 
                                   retry exceeded


DISK/SNRM RECEIVED: DISK RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           D9C4 172B

Probable causes:    2004           SDLC communications

Failure causes:     2004           SDLC communications

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   15             Connection terminated by 
                                   host


CONNECTION PROBLEM: I-FRAME RETRANSMISSION ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3300           Link error

Alert ID:           E3DA E42F

Probable causes:    2104           SDLC communications/
                                   remote node
                    2031           Line

User causes:        0209           Remote device power off

Recommended action: 0200           Check power

Failure causes:     2104           SDLC communications/
                                   remote node
                    3511           Line
                    F06A           Transmit retry limit
                                   reached

Recommended actions:2011           Review hexadecimal 
                                   display of alert
                    32A0           Report the following 
                                   detail qualifier:
                                   Outage qualifier 

Detail qualifier:   29             Connection problem


SDLC Alert Local Logging

Before IRMA WorkStation attempts to build and send an SDLC 
Link Alert, information about the outage that caused the 
alert is logged in a log file that can be viewed 
using the Windows NT Event Viewer. Message 182 will always 
be logged, as follows:

182I:  Connection failure, code = (outagecode)

Cause Data                          = hh...hh
Link Role                           = hh
Remote Node Type                    = hh

The Outage Code (outagecode) is also reported on a 23 
message. For a complete list of these codes, the conditions 
they represent, and the specific Link Alerts on 
which they are used, see the next section.

Cause Data is a list of the failure causes from the Failure 
causes subvector in the alert. Link Role and Remote Node 
type are as described in the Link Connection Subsystem 
Configuration Data subvector in the alert.A connection 
failure can be due to a station outage, rather than a link 
outage. If it is due to a station outage - which can be 
recognized by outage code values of X'80' or higher - then 
message 183, formatted as follows, will also be logged:
183I:

Detailed diagnostic data for station (stationaddress):

SBSY   CFTX   CFRX   V(S)   V(R)   N(R)   OSFC   T1CT
hh     hhhh   hhhh   hh     hh     hh     hh     hhhh

The value (stationaddress) is the station address as given 
in the Detail qualifier subvector in the alert.The other 
fields are all data from the Link Station Data subvector, as 
follows:

FIELD              DESCRIPTION

SBSY               Link station state: 80 or 40
                   (local or remote station sending RNR)

CFTX               Last SDLC control field sent

CRX                Last SDLC control field received

V(S)               N(S) count

V(R)               N(R) count

N(R)               Last received N(R)

OSFC               Outstanding frame count

T1CT               Reply timer expiration count


Identifying Alerts from Local Logs Only

When only the local log of an alert is available, you can 
still obtain the information that would have been supplied 
on the alert. To do this, check the outage code given on the 
182 message against the following list to find the alert 
that uses this outage code, and then check the alert data in 
"SDLC Failure Alerts" earlier in this file. Some Outage 
Codes are used for more than one alert; in these cases, you 
can find the appropriate alert by comparing the failure 
causes codes given on the 182 message with those given in 
the alert data.


SDLC OUTAGE CODES 

OUTAGE CODE   CONDITION              ALERT DESCRIPTION/ID

11            DSR failure            1000 : 83BB6EC8

12            CTS failure            3300 : 0231CF0A

14            DCD failure            1000 : C3BB504A

15            Connection terminated  2100 : D635CA1E
              by host                2100 : D9C4172B

24            Nonproductive receive  3300 : C458E284
              retry exceeded

25            Idle timeout retry     3300: 0E2DDF11
              exceeded

29            Connection problem     3300 : 0AECC2A6
                                     3300 : E3DAE42F

2D            Abnormal response      1000 : 70A15CB0

2E            Write timeout retry    1000 : 61D02E7B
              exceeded

80            DM received            3300 : BD84C4C9

81            Disconnect retry limit 3300 : 32A37F1B

82            Contact retry limit    3300 : 32A37F1B

83            Poll retry limit       3300 : 32A37F1B

84            No response retry      3300 : 32A37F1B
              limit

85            Remote busy retry      3300 : 66D6DA74
              limit

86            FRMR received          2100 : A472BC48
                                     2100 : B3B7D723
                                     2100 : B776CA94
                                     2100 : BA35EC4D
                                     2100 : BEF4F1FA

87            Invalid frame received 2100 : 1103D152
                                     2100 : 15C2CCE5
                                     2100 : 1C40F78B
                                     2100 : 5F7624FD

88, 89        RIM received or RD     2100 : 29BF0032
              received


Token Ring Failure Alerts

The tables in this section describe the alerts generated by 
the token ring link service provided with IRMA WorkStation. 
The alerts are listed in numerical order by alert 
description and within each description in numerical order 
by alert ID.

ADAPTER CHECK ERROR: ADAPTER ERROR ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  1010           Adapter error

Alert ID:           3BA0 3B6D

Probable causes:    3320           Local token ring adapter

Failure causes:     3320           Local token ring adapter

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for 
                                   this LAN
                    32C0           Report the following 
                                   detail qualifier:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed Data:      02             Data ID: adapter check 
                                   status
                    hh hh          Adapter check status

LAN LCS:                           Ring identifier 
                                   Local individual MAC 
                                   address


DLC Status Error: FRMR Sent-Invalid N(R) Received

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list                               node CP name

Alert description:  2100           Software program error

Alert ID:           216D 1033


Probable causes:    2007           LAN LLC communications
                    1023           Communications program in
                                   remote node

Failure causes:     1023           Communications program in
                                   remote node
                    F012           Invalid N(r) received

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR SENT-RECEIVED I-FIELD EXCEEDED 
MAXIMUM LENGTH ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list                               node CP name

Alert description:  2100           Software program error

Alert ID:           25AC 0D84

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F023           Received I-field exceeded 
                                   maximum length

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR SENT-INVALID/UNSUPPORTED 
COMMAND/RESPONSE RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           28EF 2B5D

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F020           Invalid/unsupported 
                                   command or response
                                   received

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR SENT-I-FIELD RECEIVED WHEN NOT 
PERMITTED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           2C2E 36EA

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F021           I-field received when not 
                                   permitted

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


ADAPTER COMMAND ERROR: SOFTWARE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           3EF7 89B7

Probable causes:    1000           Software program

Failure causes:     1000           Software program

Recommended actions:30E1           Contact service 
                                   representative
                    32C0           Report the following
                                   data:

                                   Product Set ID index
                                   subfield included

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      03             Data ID: adapter return
                                   code
                    hh             Adapter return code


DLC STATUS ERROR: DM OR DISK RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           4B74 26FB

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in
                                   remote node
                    F01A           DM received

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3101           Contact token ring
                                   administrator for this
                                   LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data 
subvector included


DLC STATUS ERROR: FRMR RECEIVED-INVALID N(R) SENT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           83D9 1642


Probable causes:    2007           LAN LLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F012           Frame reject received:
                                   Invalid N(r) sent

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN 
                    32A0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR RECEIVED-MAX I-FIELD LENGTH

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           8718 0BF5

Probable causes:    2007           LAN LLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F013           Frame reject received: 
                                   maximum I-field length 
                                   exceeded

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR RECEIVED-INVALID/UNSUPPORTED 
COMMANDS/RESPONSE SENT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           8A5B 2D2C

Probable causes:    2007           LAN LLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F010           Frame reject received:
                                   Invalid/unsupported 
                                   command or response sent

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: FRMR RECEIVED-I-FIELD SENT WHEN NOT 
PERMITTED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           8E9A 309B

Probable causes:    2007           LAN LLC communications
                    1000           Software program

Failure causes:     1000           Software program
                    F011           Frame reject received: I-
                                   field sent when not 
                                   permitted

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


Software Program Error: Adapter Interface Alert

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  2100           Software program error

Alert ID:           DA7B C09D

Probable causes:    3220           Token ring adapter 
                                   interface

Install causes:     1600           Mismatch between software 
                                   and microcode
                    1601           Incorrect customization
                                   image

Recommended actions:1500           Correct installation 
                                   problem
                    1502           Correct customization 
                                   parameters

Failure causes:     3220           Token ring adapter 
                                   interface

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address


DLC STATUS ERROR: SABME RECEIVED FOR OPEN LINK STATION ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote
list:                              node CP name

Alert description:  2100           Software program error

Alert ID:           E65B 0B7F

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in 
                                   remote node

Failure causes:     1023           Communications program in 
                                   remote node
                    F016           SABME received while in 
                                   ABME

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


BRING-UP ERROR ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3210           Initialization failure

Alert ID:           AB86 8B0B

Probable causes:    3320           Local token ring adapter

Install causes:     1200           Incorrect hardware 
                                   configuration
                    1402           Mismatch between hardware 
                                   and software configura-
                                   tions

Recommended actions:1503           Correct configuration

Failure causes:     3320           Local token ring adapter

Recommended actions:30E1           Contact service 
                                   representative
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Local individual MAC 
                                   address


ADAPTER OPEN ERROR: OPEN FAILURE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is ring name
list:

Alert description:  3211           Open failure

Alert ID:           016E 5F4E

Probable causes:    3702           Token ring lobe
                    3701           Token ring LAN component

Failure causes:     3712           Local token ring lobe
                    3701           Token ring LAN component
                    2600           Interference

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Local individual MAC 
                                   address


ADAPTER OPEN ERROR: REMOVE COMMAND RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3211           Open failure

Alert ID:           44D1 AD86

Probable causes:    3705           Token ring remove command 
                                   received

User causes:        3320           Token ring remove adapter 
                                   command received

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this 
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Local individual MAC 
                                   address


ADAPTER OPEN ERROR: PROBLEM ON LOCAL LOBE ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3211           Open failure

Alert ID:           55BF 3E1C

Probable causes:    3702           Token ring lobe

Failure causes:     3320           Local token ring adapter
                    3711           Local token ring lobe
                    3434           Local lobe cables

Recommended actions:1009           Try reopening adapter 
                                   after 30 seconds
                    3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Local individual MAC 
                                   address


ADAPTER OPEN ERROR: BEACONING DETECTED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3211           Open failure

Alert ID:           CAF3 C58A

Hierarchy/resource                 Second name is ring name
list:

Probable causes:    3703           Token ring fault domain

Failure causes:     3703           Token ring fault domain

Recommended actions:1009           Try reopening adapter 
                                   after 30 seconds
                    3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3101           Contact token ring
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code


ADAPTER OPEN ERROR: DUPLICATE ADDRESS ALERT


                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3211           Open failure

Alert ID:           D615 A61E

Probable causes:    3704           Token ring duplicate 
                                   station address

Install causes:     3704           Token ring duplicate 
                                   station address assigned

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Local individual MAC 
                                   address


SYSTEM ACTION: OPERATOR CAUSED LAN ADAPTER TO BE RESET ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3211           Open failure

Alert ID:           F7A6 2F59

Probable causes:    7001           Resources not active

User causes:        3300           Adapter not ready

Recommended actions:1300           Correct then retry
                    2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for 
                                   this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier local 
                                   individual MAC address


NETWORK STATUS ERROR: LOBE WIRE FAULT ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is ring name
list:

Alert description:  3212           Wire fault

Alert ID:           A676 B230

Probable causes:    3702           Token ring lobe

Failure causes:     3711           Local access unit
                    3434           Local lobe cables
                    3320           Local token ring adapter

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      17             Data ID: ring status code
                    hh hh          Ring status code

LAN LCS:                           Local individual MAC 
                                   address


NETWORK STATUS ERROR: AUTO-REMOVAL ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is ring name
list:

Alert description:  3213           Auto-removal

Alert ID:           EB61 E14F

Probable causes:    3702           Token ring lobe

Failure causes:     3320           Local token ring adapter
                    3711           Local access unit
                    3434           Local lobe cables

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      17             Data ID: ring status code
                    hh hh          Ring status code

LAN LCS:                           Local individual MAC 
                                   address

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      17             Data ID: ring status code
                    hh hh          Ring status code

LAN LCS:                           Local individual MAC 
                                   address


NETWORK STATUS ERROR: TOKEN RING REMOVE ADAPTER COMMAND 
RECEIVED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  3214           Remove adapter command
                                   received

Alert ID:           59F3 2622

Probable causes:    7013           LAN Manager operator

User causes:        7101           Token ring remove adapter
                                   command received

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      17             Data ID: ring status code
                    hh hh          Ring status code

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address


NETWORK STATUS ERROR: LLC REMOVE ADAPTER COMMAND RECEIVED 
ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  3300           Link error

Alert ID:           5B8F 5BA7

Probable causes:    2017           LAN LLC communications/ 
                                   remote node

Failure causes:     2107           LAN LLC communications/ 
                                   remote node
                    F017           Poll count exhausted

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32A0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address

Link Station Data
subvector included


DLC STATUS ERROR: LINK LOST ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  3300           Link error

Alert ID:           9921 0A2B

Probable causes:    3321           Remote token ring adapter

Failure causes:     3321           Remote token ring adapter

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32A0           Report the following
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address


DLC ERROR: REMOTE STATION NOT ON LOCAL OR ATTACHED RINGS 
ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Hierarchy/resource                 Second name is remote 
list:                              node CP name

Alert description:  3305           Unable to communicate
                                   with remote node

Alert ID:           D91B 9E2D

Probable causes:    2007           LAN LLC communications
                    1023           Communications program in 
                                   remote node

User causes:        0209           Remote device power off

Recommended actions:0200           Check power

Failure causes:     1023           Communications program in 
                                   remote node

Recommended actions:3301           If problem persists do 
                                   the following:
                    2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32A0           Report the following  
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address
                                   Remote individual MAC 
                                   address
                                   LAN routing information

LCS configuration:                 Remote device address
                                   Local device address


ADAPTER COMMAND ERROR: STORAGE CAPACITY EXCEEDED ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  5003           Capacity exceeded

Alert ID:           9C35 13D5

Probable causes:    0101           Main storage

Failure causes:     0110           Storage control

Recommended actions:2010           Review link detailed data
                    3103           Contact LAN administrator 
                                   responsible for this LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      03             Data ID: adapter return 
                                   code
                    hh             Adapter return code

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address


ADAPTER CHECK ERROR: RECEIVE QUEUE OVERRUN ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  5012           Receive queue overrun

Alert ID:           14D5 3710

Probable causes:    1000           Software program

Failure causes:     1000           Software program

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32A0           Report the following  
                                   data:

                                   Product Set ID index
                                   subfield included

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address


ADAPTER CHECK ERROR: MICROCODE PROGRAM ABNORMALLY TERMINATED 
ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  6000           Microcode program 
                                   abnormally terminated

Alert ID:           E1EC 74A7

Probable causes:    3320           Local token ring adapter

Failure causes:     3320           Local token ring adapter

Recommended actions:2010           Review link detailed data
                    3101           Contact token ring 
                                   administrator for this
                                   LAN
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      07             Data ID: error code
                    hh hh          Error code

LAN LCS:                           Ring identifier
                                   Local individual MAC 
                                   address


ADAPTER COMMAND ERROR: CONFIGURATION ALERT

                    HEXADECIMAL
NAME OF             VALUE IN
SUBVECTOR           SUBVECTOR      DESCRIPTION

Alert description:  8000           Configuration error

Alert ID:           B8AB EF98

Probable causes:    7001           Local system operator

Install causes:     1501           Incorrect customization 
                                   parameters
                    1400           Mismatch between hardware 
                                   and software

Recommended actions:3110           Contact communications 
                                   systems programmer
                    32C0           Report the following 
                                   data:

Detailed data:      61             Data ID: adapter number
                    hh             Adapter number

Detailed data:      03             Data ID: adapter return 
                                   code
                    hh             Adapter return code


Link Statistics

For SDLC and token ring connections, IRMA WorkStation 
maintains statistics on link usage and errors. This 
information is logged when a connection ends or when the 
counter for a particular error or time-out reaches its 
maximum value.

Format for Link Statistics

When an SDLC or token ring connection ends, or when an error 
counter reaches its maximum value, statistics on link usage 
are recorded. These statistics include information such as 
the adapter number, the date and time the link was 
established, and counts of errors and time-outs. This data 
is also logged in NMVT format if a connection has been 
specified for carrying NetView data, and is then 
sent if that connection and the server that owns that 
connection are both active.

SDLC Link Statistics

Link statistics are generated when a link is closed or when 
one of the wrap counters listed later in this section is 
about to wrap. Whenever a link statistics message is built, 
all the wrap counters are reset to 0. The cumulative 
counters are not reset, and provide statistics from the 
point at which the particular link service was started.
The NMVT generated has the following format:

NMVT Header

41 03 8D 00 00 00 00 00        NMVT Header


Major Vector Header

00 69                          Length of major vector
00 25                          Link Statistics major vector


Data Link Traffic Counters Subvector

65 9A                          Data Link Traffic Counters 
                               subvector
03                             DLC type: SDLC
hh                             Adapter number (01+04)


Date/Time Link Established

hh                             Date
hh                             Month
hh hh                          Year
hh                             Hour
hh                             Minute
hh                             Second
hh                             Hundredths of a second
hh                             Counter


Wrap Counters

hh                             Transmit I-frames OK
hh                             Transmit I-frames not OK
hh                             Retransmit I-frames
hh                             Received I-FCS OK
hh                             Received I-FCS not OK
hh                             Total frames sent
00                             Reserved
hh                             Lost data frames received
hh                             FRMR conditions sent
00                             Reserved
hh                             CTS drop
00                             Reserved
00                             Reserved
hh                             DSR drop out
hh                             Inactivity timeouts
00                             Reserved
hh                             DMA underruns
00                             Reserved
hh                             Transmit fail timeouts
00                             Reserved


Cumulative Counters

The cumulative counters are the same counters as the wrap 
counters, with reserved bytes in the same positions.

Token Ring Link Statistics

Link statistics are generated when a link is closed or when 
one of the following counters is about to wrap. Whenever a 
link statistics message is built, all the counters are reset 
to 0.

The NMVT generated has the following format:

NMVT Header

41 03 8D 00 00 00 00 00         NMVT Header


Major Vector Header

00 32                           Length of major vector
00 25                           Link Statistics major vector


Data Link Traffic Counters Subvector

2E9A                            Data Link Traffic Counters 
                                subvector
04                              DLC type: token ring
01 or 02                        Statistics type: link 
                                counter overflow or adapter 
                                counter overflow


Token Ring Adapter Log Information and Counters

hh                              Adapter number (01+04)
00                              Reserved
hh                              Line error
hh                              Internal error
hh                              Burst error
hh                              ARI/FCI error
hh                              End delimiter
00                              Reserved
hh                              Lost frame
hh                              Receive congestion
hh                              Frame copied error
hh                              Frequency error
hh                              Token error
00 00 00                        Reserved


DLC SAP Station Information

hh hh hh hh                     Count of frames transmitted 
                                OK
hh hh hh hh                     Count of frames received OK
hh hh hh hh                     Count of frames discarded
hh hh hh hh                     Lost data
hh hh                           Buffer available in SAP


DLC Link Station Information

hh hh                           Count of I-frames
                                transmitted
hh hh                           Count of I-frames received
hh                              Received I-frames error 
                                count
hh                              Transmitted I-frames error 
                                count
hh hh                           T1 timer expired count


Alerts Used by Applications, NVAlert, and NVRunCmd

Application programs and the NVAlert and NVRunCmd services 
can generate alerts using the Common Service Verb (CSV) 
TRANSFER_MS_DATA. An application or service can supply 
subvectors, which are required to build an NMVT, or it can 
supply the complete NMVT; in both cases the completed 
NMVT will be logged locally, and may also be sent on the 
connection designated for NetView if one is configured and 
is active. An application or service can also supply user-
defined alert data, in which case the data will be logged 
locally but cannot be sent.

For information about how the NVAlert and NVRunCmd services 
work, see the Administrator's Guide.

Format for Alerts Used by Applications, NVAlert, and 
NVRunCmd

An application program or the NVAlert and NVRunCmd services 
can use the CSV TRANSFER_MS_DATA to issue alerts. The alerts 
are logged in a log file that can be viewed using the 
Windows NT Event Viewer, and may also be sent on the NetView 
connection. The data supplied to TRANSFER_MS_DATA may be in 
any of the following formats.

NMVT
The application or service supplies a complete NMVT, 
including the header information.

ALERT_SUBVECTORS
The application or service supplies the subvectors required 
for an alert, but without the NMVT header or major vector 
header. IRMA WorkStation adds the header information, as 
described in the next section.

PDSTATS_SUBVECTORS
The application or service supplies the subvectors required 
for a Problem Determination Statistics NMVT, but without the 
NMVT header or major vector header. IRMA WorkStation adds 
the header information, as described in the next section.

USER_DEFINED
The application or service supplies data in its own format. 
This data cannot be sent on the connection designated for 
NetView, but is logged in the same way as the other data 
formats.

The application or service can also request IRMA WorkStation 
to add the Product Set ID subvector (for all data types 
except user_defined), the Date/Time subvector, or both to 
the supplied data. The format of these added subvectors 
is described in the next section.

For all data types, the data (with added headers and 
subvectors, if appropriate) is logged locally in NMVT 
format, whether or not a connection has been 
specified for NetView.

Added Headers and Subvectors


NMVT Header

41 03 8D 00 00 00 00 00         NMVT Header


Major Vector Header

LL LL                           Length of Major Vector
00 00 or 00 25                  Alert major vector (for
                                data type alert_subvectors), 
                                or Problem Determination 
                                Statistics major vector (for 
                                data type pstats_subvectors)


Product Set ID Subvector

4D 10                           Product Set ID subvector

00                              Unused field

34 11                           Product ID subvector

0C                              Product classification: non-
                                IBM software

08 04                           Software product common 
                                level subfield

F0 F2                           Version identifier: 02

F0 F0                           Release identifier: 00

F0 F0                           Modification identifier: 00

20 06                           Software product common name 
                                subfield

C4 C3 C1 61 D4 E2 40            Product name:
C3 D6 D4 D4 40                     MS
E2 C5 D9 E5 D9                     SNA Server

00 .. 00                        Name padded with nulls to 30 
                                characters

09 08                           Software product program 
                                number subfield

F0 F0 F0 F0 F0 F0 F0            Product program number: 
                                zeros

16 11                           Product ID subvector

03                              Product classification: 
                                hardware

13 00                           Hardware Product ID subfield

00                              Format type: undefined

hh...hh                         Server: Windows NT-based 
                                computer name


Date/Time Subvector

0A 01                           Date/Time Subvector
08 10                           Local Date/Time subfield
hh                              Year - two digits
hh                              Month
hh                              Date
hh                              Hours
hh                              Minutes
hh                              Seconds


Response Time Monitor

During 3270 emulation, statistics are maintained on the time 
taken for the host to respond to 3270 client requests. RTM 
data can be sent to the host for collection and analysis; 
the 3270 user can also view a graphical display of the 
spread of response times on a particular 3270 emulation 
session. The time for the last transaction executed can also 
be displayed on the status line. 

Use the SNA Admin program to choose the way in which 
response times are measured and classified. RTM statistics 
for a particular LU are sent to the host that owns that LU 
rather than being sent on the connection designated for 
NetView data.


Collecting RTM Data and Sending it to the Host

IRMA WorkStation always collects RTM data while 3270 
emulation is active. The data for each 3270 LU will then be 
sent to the host to which the LU is connected under various 
criteria.

You configure the initial criteria for IRMA WorkStation to 
send RTM data to the host when any of the RTM counters 
reaches its maximum value, and/or each time a 
3270 session ends. (For instructions on configuring the RTM 
function, see the Administrator's Guide.) The RTM counters 
are reset each time the RTM data is sent in this way.
Although initial criteria apply to all IRMA WorkStation LUs, 
any host can change the criteria for any LU or all LUs it 
owns, and solicit or reset any LU counters. 


Boundaries and Measurement Definition

RTM data is collected by comparing host response times 
against a series of four boundary values. Each time a host 
transaction occurs, the response time is compared with the 
boundary values, and the appropriate counter is incremented. 
There is a counter for each of the four intervals defined by 
the boundary values, and an overflow counter for response 
times above the largest boundary value. 

You can change the default boundaries - 0.5, 1, 2, and 5 
seconds - using the SNA Admin program. You also can select 
which of three response time definitions to set as default. 
For instructions, see the Administrator's Guide.

The response time is measured from the time the user presses 
ENTER until one of the following events occurs:

* The first character of host data reaches the 3270 display.
* The keyboard is unlocked.
* The user is allowed to send data.

Again, a host can override the default boundaries and other 
host response time settings for any LU or all LUs it 
controls. (For more information, see "Host Modification of 
RTM Parameters" later in this file.)


Local Display

You can use the SNA Admin program to allow a 3270 user to 
view the last transaction time on the status line and a 
graphical display of the response times for each 3270 
display session. For instructions, see the Administrator's 
Guide. Again, the host can override this ability to 
view the RTM data locally.


Reuse of LUs by Different Users

Response times are recorded for a specific LU rather than 
for a specific 3270 session. This means that if a 3270 
session ends and another session (of the same or a different 
3270 user) then uses the same LU, the response time counters 
will include responses from the previous session as well as 
those from the new session. This does not happen, however, 
if the RTM counters were reset before the new session began 
to use the LU (the counters are reset when the host requests 
that they be reset or when RTM data is sent unsolicited by 
IRMA WorkStation). When hosts request RTM data they 
typically also request that the counters be reset.

If you want to ensure that the RTM data displayed relates 
only to the current 3270 session, you should select the RTM 
Data Sent at End-of-Session checkbox when configuring RTM 
parameters for IRMA WorkStation. This will ensure that the 
RTM counters are reset at the end of each 3270 session and 
will therefore be 0 at the start of each 3270 session. The 
host can, of course, override this setting.


Host Modification of RTM Parameters

Although you can configure the RTM boundaries and definition 
that you want to use on your IRMA WorkStation, the host can 
override these configured values, either for an individual 
3270 LU or for all LUs it controls. The host can also 
specify whether to permit local display of RTM data, and, 
when IRMA WorkStation sends RTM data, it can disable 
collection of RTM statistics completely.


Lost-Data Indicator

When IRMA WorkStation sends RTM data to the host, it can 
indicate to the host that RTM data may have been lost (that 
is, some host response times were not included in the RTM 
data sent to the host). This indication is sent in the 
following cases:

* One of the RTM counters reaches its maximum value, and 
IRMA WorkStation is not configured to send RTM data 
unsolicited at counter overflow. When this occurs, IRMA 
WorkStation stops recording response times until the host 
requests the data (or until end-of-session, if unsolicited 
sending at end-of-session is configured); the data is sent 
with an indication that data may have been lost due to 
counter overflow. 

* When the local server terminates abnormally, RTM data 
obviously is lost and any connection to the host is 
terminated. When the connection to the host is 
started, there is no way of knowing whether the connection 
was previously terminated by a server failure; therefore, 
the first RTM data sent to the host after the connection is 
established includes the lost-data indicator, to indicate 
that data may have been lost due to failure of the local 
server.

* When IRMA WorkStation is configured to send RTM data at 
end-of-session, and a new 3270 session is started before the 
RTM data for the previous 3270 session on the same LU can be 
sent, response times for the new session are discarded 
until the RTM data from the previous session is sent and the 
counters are reset. When RTM data is next sent on the new 
session, it includes the lost data indicator to indicate 
this condition.


Local Logging of Network Management Data

Data is logged in a Windows NT Event Viewer log file in two 
ways. First, the data from the alert is logged in a more 
readable format, using standard log messages. The format is 
specific to the alert type; for the message numbers used 
and explanations of the data, see the section in this file 
that relates specifically to that type of alert.

If a connection has been designated for carrying NetView 
data and the server that owns the connection is active, the 
alert NMVT containing the data is also logged in NMVT format 
as it would be sent. The NMVT appears as message 540 
followed by message 541. Note that this logging occurs 
before IRMA WorkStation attempts to send the NMVT; the log 
is therefore no guarantee that the NMVT is sent 
successfully.

Additional information about local logging of alert 
information is presented in the section of this file that 
relates specifically to that type of alert.


