New in this release

This overview includes the following sets of features added to IBM(R) Tivoli(R) OMEGAMON(R) for Mainframe Networks in V4.2 and later fix packs:

New features introduced since Fix Pack 3

The following changes were introduced to OMEGAMON XE for Mainframe Networks online help by APARs.

New features in Version 4.2.0 Fix Pack 3 for Enhanced Monitoring and z/OS v1.12 Compatibility

IBM® Tivoli® OMEGAMON® XE for Mainframe Networks Fix Pack 3 for Enhanced Monitoring and z/OS® v1.12 Compatibility is a function-rich addition to your OMEGAMON XE for Mainframe Networks environment that exploits the new callable network management interfaces (NMIs) available with zOS v1.12. This fix pack includes the following new functionality:

Support for z/OS v1.12

OMEGAMON XE for Mainframe Networks exploits the new capabilities of z/OS v1.12, bringing the enhanced monitoring power of the newest version of z/OS Communications Server to Tivoli Enterprise Portal.

The version of the z/OS Communications Server that is part of z/OS v1.12 supports implementation of new network management interface (NMI) calls that enable the OMEGAMON XE for Mainframe Networks monitoring agent to greatly reduce the amount of CPU usage related to SNMP queries. SNMP is now required only for collecting Open System Adaptor (OSA) performance data in a z/OS v1.12 or later environment.

Because of these differences, workspaces running under different versions of z/OS retrieve data differently depending on z/OS level. For these data types (TCP/IP Stack Layer, TCP/IP Address Space, Interface, Device, and Gateways), data is no longer retrieved using SNMP but instead uses the callable NMIs.

If the address space being monitored is running z/OS v1.11 or earlier, attribute values are retrieved using SNMP. If the address space being monitored is running z/OS v1.12 or later, the attribute values are retrieved using the z/OS Communications Server callable network management interface (NMI). For more granular understanding of data sources, see the individual attributes and workspaces, or see the data source table in the IBM Tivoli OMEGAMON XE for Mainframe Networks: User Guide.

If you are viewing any of the new or updated workspaces discussed in the sections that follow on z/OS v1.12, non-strategic interfaces have status information only reported. Performance-related attributes show a value of zero (0). The strategic interfaces have one of the following Interface Types:

Impact:

New workspaces and attributes that exploit z/OS v1.12

Exploitation of the new version of z/OS Communications Server that is part of z/OS v1.12 makes it possible for OMEGAMON XE for Mainframe Networks to bring you more than 300 new attributes spread across 8 new workspaces. The new attribute groups and workspaces summarized in Table 1 were added to take advantage of new monitoring capabilities introduced in z/OS v1.12.

Table 1. New workspaces, attribute groups, and attributes added in this fix pack
Attribute group Attributes
Data Link Control (DLC) Read and Write Queue Statistics workspace: Analyzes input at the Data Link Control (DLC) layer level providing z/OS Communications Server tuning statistics for the following types of interfaces on a z/OS v1.12 or later system:
  • HiperSockets
  • Queued direct I/O (QDIO) OSA features
KN3 Interface Read Queue Attributes

The KN3 Interface Read Queue attribute group includes the following attributes:

  • Accelerated Bytes
  • Accelerated Packets
  • Average Bytes Per SBAL
  • Average Packets Per SBAL
  • Frame Invalidation Packets
  • Frame Invalidation Support
  • Interface Index
  • Interface Name
  • Interface Status
  • Interface Type
  • Percent Accelerated Packets
  • Percent Frame Invalidation Packets
  • Percent Real PCI
  • Percent Threshold PCI Interrupts
  • Percent Unproductive PCI Interrupts
  • Percent Virtual PCI Interrupts
  • QDIO Accelerator
  • Queue Workload Name
  • Read Control Device Number
  • Read Processing Deferral Rate
  • Read Processing Deferrals
  • Read Replenishment Deferral Rate
  • Read Replenishment Deferrals
  • Reads Exhausted
  • Reads Exhausted Rate
  • Real PCI Interrupts
  • Received Bytes
  • Received Packets
  • Reset Time Stamp
  • Threshold PCI Interrupts
  • Total Read Processing Deferrals
  • Total Read Replenishment Deferrals
  • Total Reads Exhausted
  • TRLE Name
  • Unproductive PCI Interrupts
  • Used SBALs
  • Virtual PCI Interrupts
KN3 Interface Write Queue Attributes The KN3 Interface Write Queue attribute group includes the following attributes:
  • Accelerated Bytes
  • Accelerated Packets
  • Average Active SBALs
  • Average SBALs Per SIGA
  • Average Staging Queue Depth
  • Datapath Device Number
  • Frame Invalidation Support
  • Interface Index
  • Interface Name
  • Interface Status
  • Interface Type
  • iQDIO Multiple Write SIGA Count
  • Maximum Active SBALs
  • Maximum Staging Queue Depth
  • Percent Accelerated Bytes
  • Percent Accelerated Packets
  • QDIO Accelerator
  • QDIO SIGA Count
  • Queue Priority
  • Reset Time Stamp
  • SBALs Per SIGA
  • Transmitted Bytes
  • TRANSPKTS Transmitted Packets
  • TRLE Name
  • Used SBALs
  • Write Control Device Number
ICMP Statistics workspace: Displays statistics for the Internet Control Message Protocol (ICMP) and ICMPv6 on z/OS v1.12 or later systems.
KN3 ICMP Global Counters Attributes The KN3 ICMP Global Counter attribute group includes the following attributes:
  • ICMP Version
  • Percent Inbound In Error
  • Total Inbound Messages In Error
  • Total Messages Received
  • Total Messages Sent
  • Total Messages Sent Received
  • Total Outbound Messages In Error
  • Total Percent Inbound In Error
  • Total Percent Outbound In Error
KN3 ICMP Type Counters Attributes The KN3 ICMP Type Counters attribute group includes the following attributes:
  • ICMP Type
  • ICMP Version (not displayed)
  • Percent Inbound In Error
  • Percent Outbound In Error
  • Total Inbound Messages In Error
  • Total Messages Received
  • Total Messages Sent
  • Total Messages Sent Received
  • Total Outbound Messages In Error
  • Total Percent Inbound In Error
  • Total Percent Outbound In Error
Interface Statistics workspace : Displays information about the data that flows through the following types of interface and the IP addresses associated with all interfaces on a z/OS v1.12 or later system:
  • Loopback
  • OSA-Express Queued Direct I/O (QDIO) Ethernet
  • HiperSockets
  • Multipath Channel Point-To-Point (MPCPTP)
  • Virtual IP Address (VIPA)
KN3 Interface Address Attributes The KN3 Interface Address attribute group includes the following attributes:
  • Interface Index
  • IP Address
  • IP Address Type
  • IP Address Version
  • IPv4 Primary Address
  • IPv6 Address Unavailable
  • IPv6 Address Unavailable Reason
  • IPv6 Autoconfigured Address
  • IPv6 Deprecated Address
  • IPv6 Manual Prefix
  • IPv6 Temporary Address
KN3 Interface Statistics Attributes

The KN3 Interface Statistics attribute group includes the following attributes:

  • Bandwidth Utilization
  • Bytes Received
  • Bytes Transmitted
  • Device or Datapath Status
  • Inbound Packet Discard Rate
  • Inbound Packets Discarded
  • Interface Index
  • Interface Index Specified
  • Interface Name
  • Interface Status
  • Interface Type
  • IP Address Version
  • Multi/Broadcast Receive Packet Rate
  • Multi/Broadcast Transmit Packet Rate
  • Outbound Packet Discard Rate
  • Outbound Packets Discarded
  • Outbound Packets Discarded In Error
  • Percent Inbound Packets in Error
  • Percent Outbound Packets in Error
  • Percent Packets Discarded
  • Percent Packets in Error
  • Receive Bandwidth Utilization
  • Receive Error Rate
  • Receive Packet Rate
  • Received Packets Discarded In Error
  • Reset Time Stamp
  • Total Broadcast Packets Received
  • Total Broadcast Packets Transmitted
  • Total Bytes Received
  • Total Bytes Transmitted
  • Total Inbound Packets Discarded In Error
  • Total Multicast Packets Received
  • Total Multicast Packets Transmitted
  • Total Outbound Packets Discarded in Error
  • Total Outbound Packets Discarded for No Storage
  • Total Outbound Packets Queued
  • Total Packets Discarded for Unknown Protocol
  • Total Received Packets Discarded for No Storage
  • Total Unicast Packets Received
  • Total Unicast Packets Transmitted
  • Transmit Bandwidth Utilization
  • Transmit Error Rate
  • Transmit Packet Rate
Interface Status: Displays status information for all interfaces defined to a z/OS v1.12 or later system.
KN3 Interface Address Attributes The KN3 Interface Address attribute group includes the following attributes:
  • Interface Index
  • IP Address
  • IP Address Type
  • IP Address Version
  • IPv4 Primary Address
  • IPv6 Address Unavailable
  • IPv6 Address Unavailable Reason
  • IPv6 Autoconfigured Address
  • IPv6 Deprecated Address
  • IPv6 Manual Prefix
  • IPv6 Temporary Address
KN3 Interface Status Attributes The KN3 Interface Status attribute group includes the following attributes:
  • Actual Dynamic Type
  • Actual Inbound Performance Type
  • Actual MTU Value
  • Actual Router Type
  • ARP Offload Active
  • ARP Offload Reported
  • ARP or ND VIPA Owner
  • Autorestart Active
  • Checksum Offload Active
  • CHPID
  • Configured Dynamic Type
  • Configured Inbound Performance Type
  • Configured MTU Value
  • Configured Router Type
  • Datapath Device Number
  • Destination Address
  • Device or Datapath Status
  • Duplicate Address Count
  • Dynamic VLAN Registration Capable
  • Dynamic VLAN Registration Configured
  • Dynamic XCF Interface
  • Interface Associated Name
  • Interface Definition
  • Interface Description
  • Interface ID
  • Interface ID Specified
  • Interface Index
  • Interface Index Specified
  • Interface Name
  • Interface Speed
  • Interface Status
  • Interface Type
  • IP Address Version
  • ISOLATE Specified
KN3 Interface Status Attributes (continued)
  • LAN ARP or ND Owner
  • LAN Group Number
  • Last Status Change
  • MONSYSPLEX Active
  • MONSYSPLEX Configured
  • MPCPTP Checksum
  • Multicast Capable
  • Multiwrite Status
  • OLM Active
  • OLM Configured
  • OSA Code Level
  • Outbound Hop Limit
  • Physical MAC Address
  • Port Interface Index
  • Read Storage Size
  • Read Storage Type
  • Routing Mask Bits
  • Routing Metric
  • Routing MTU Size
  • SECCLASS Value
  • Send Receive Broadcast Packets
  • Source VIPA Name
  • Source VIPA Specified
  • TCP Segmentation Offload Active
  • Temporary IP Address Prefix
  • Temporary Prefix Type
  • VLAN ID
  • VLAN ID Specified
  • VLAN Priority Tagging Active
  • VMAC Active
  • VMAC Address Specified
  • VMAC ROUTELCL Active
IP Statistics workspace: Displays statistics for IPv4 and IPv6 on z/OS v1.12 or later systems.
KN3 IP Counter Statistics Attributes The KN3 IP Counter Statistics attribute group includes the following attributes:
  • Input Datagram Delivery Rate
  • Input Datagram Forward Rate
  • Input Datagrams Discarded
  • Input Discard Percentage
  • IP Version
  • Output Datagrams Discarded
  • Output Discard Percentage
  • Receive Datagram Rate
  • Total Fragmentation Creates
  • Total Fragmentation Failure Percentage
  • Total Fragmentation Failures
  • Total Fragmentation Percentage
  • Total Fragmentations
  • Total Fragmentations Required
  • Total Header Errors
  • Total Input Datagrams Delivered
  • Total Input Datagrams Discarded
  • Total Input Datagrams Forwarded
  • Total Input Datagrams Received
  • Total Input Discard Percentage
  • Total Input zIIP Packets
  • Total Invalid Address Errors
  • Total No Route Errors
  • Total Output Datagram Requests
  • Total Output Datagrams Discarded
  • Total Output Datagrams Forwarded
  • Total Output Discard Percentage
  • Total Output No Routes
  • Total Output zIIP Packets
  • Total Truncation Errors
  • Total Reassemblies
  • Total Reassemblies Required
  • Total Reassembly Failure Percentage
  • Total Reassembly Failures
  • Total Reassembly Percentage
  • Total Reassembly Timeouts
  • Total Unknown Protocol Errors
  • Transmit Datagram Rate
KN3 IP General Statistics Attributes The KN3 IP General Statistics attribute group includes the following attributes.
  • Total Device Layer Calls
  • Total Frame Unpack Errors
  • Total Input Datagram Discarded for Memory Shortage
  • Total Output Datagrams Discarded for Asynchronous Error
  • Total Output Datagrams Discarded for Memory Shortage
  • Total Output Datagrams Discarded for Synchronous Error
TCP Statistics workspace: Displays TCP protocol statistics for the selected the TCP/IP stack on a z/OS v1.12 or later system.
KN3 TCP Counter Statistics Attributes The KN3 TCP Counter Statistics attribute group includes the following attributes:
  • Connections Established
  • Out-of-Order Segments Percentage
  • Receive Segment Rate
  • Received Segment Error Rate
  • Segment Retransmission Rate
  • Total Accepted Connections
  • Total ACKs with Header Prediction
  • Total Active Socket OPENs
  • Total All Data After Window
  • Total All Data Before Window
  • Total Attempt Failures
  • Total Bulkdata AIQ Segments
  • Total Connections Closed
  • Total Data Segments Predicted
  • Total Delayed Output ACKs
  • Total Discards for Bad Checksum
  • Total Discards for Bad Length
  • Total Discards for Old time Stamp
  • Total Duplicate ACKs
  • Total Established Resets
  • Total FINWAIT2 Drops
  • Total Flow Controls
  • Total Input After Closed
  • Total Input Segments Received
  • Total Input Window Probes
  • Total Input Window Updates
  • Total Keepalive Drops
  • Total Keepalive Probes
  • Total Out-of-Order Segments
  • Total Output RSTs
  • Total Output Segments Sent
  • Total Output Window Probes
  • Total Output Window Updates
  • Total Passive Drops
  • Total Passive Socket OPENs
  • Total PMTU Errors
  • Total PMTU Retransmits
  • Total Retransmission Percentage
  • Total Retransmit Drops
  • Total Retransmit Timeouts
  • Total Segments Discarded
  • Total Segments Retransmitted
  • Total Some Data After Window
  • Total Some Data Before Window
  • Total Timewait Reused
  • Total Window Probe Drops
  • Transmit Segment Rate
UDP Statistics workspace: Displays UDP protocol statistics for the selected the TCP/IP stack on z/OS v1.12 or later systems.
KN3 UDP Counter Statistics Attributes The KN3 UDP Counter Statistics attribute group includes the following attributes.
  • Datagram Error Percentage
  • Discard Percentage
  • Receive Datagram Rate
  • Total Datagram Error Percentage
  • Total Datagrams Discarded
  • Total Datagrams Received
  • Total Datagrams Sent
  • Total Datagrams Sent Received
  • Total Discard Percentage
  • Total Input Datagrams in Error
  • Total No Ports
  • Transmit Datagram Rate

Impact:

Updated workspaces and attributes that exploit z/OS v1.12

Existing OMEGAMON XE for Mainframe Networks workspaces and attribute groups have been enhanced to give you fast, efficient access to the data now available through z/OS v1.12 callable NMIs. The attribute groups and workspaces listed in Table 2 have been enhanced.

Table 2. Existing workspaces and attribute groups updated to exploit z/OS v1.12
Attribute group Workspace
Address Space Attributes (KN3TAS) TCPIP Address Space

If the address space being monitored is running on z/OS v1.11 or earlier, the values for this attribute group are retrieved using SNMP. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the z/OS Communications Server callable network management interface (NMI)

TCP/IP Summary

A new Interface Count attribute was added to the TCPIP Address Space Attributes and is displayed in the TCPIP Summary workspace. This attribute is defined as the number of interfaces defined for the TCP/IP stack.

If the address space being monitored is running on z/OS v1.11 or earlier, the values for this attribute group are retrieved using SNMP. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the z/OS Communications Server callable network management interface (NMI)

TCP/IP Summary History

A new Interface Count attribute was added to the TCPIP Address Space Attributes and is displayed in the TCPIP Summary workspace. This attribute is defined as the number of interfaces defined for the TCP/IP stack.

If the address space being monitored is running on z/OS v1.11 or earlier, the values for this attribute group are retrieved using SNMP. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the z/OS Communications Server callable network management interface (NMI).

Devices Attributes (KN3TDV) Gateways and Devices workspace, Devices table View
  1. If the address space being monitored is running on z/OS v1.11 or earlier, the values for this attribute group are retrieved using SNMP.
  2. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the z/OS Communications Server callable network management interfaces (NMIs).
  3. A new attribute has been added to enable linking between this workspace and z/OS v1.12 or later OSA devices and interfaces. That attribute is Port Interface Index, defined as the interface port index associated with an OSA device or interface.
Gateways Attributes (KN3TGA) Gateways and Devices workspace, Gateways table View
  1. If the address space being monitored is running on z/OS v1.9 or earlier, the values for this attribute group are retrieved using SNMP.
  2. If the agent address space being monitored is running on z/OS v1.10 or v.1.11, the route information in this workspace is retrieved using the I/O control (IOCTL). Link or Interface attributes associated with the Gateway are retrieved using SNMP.
  3. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the I/O control (IOCTL) interface. Link or Interface attributes associated with the Gateway are retrieved using the z/OS Communications Server callable network management interfaces (NMIs).

Six new attributes were added:

  • Dynamic Route Indicates whether the route used by this gateway was dynamically created (valid for IPv4 only). If you are viewing this workspace on an LPAR running z/OS 1.9 or earlier, this attribute is unavailable and will be blank.
  • IP Version The IP version of the route used by this gateway.
  • MTU Value The maximum transmission unit (MTU) in bytes for the route. If you are viewing this workspace on an LPAR running z/OS 1.9 or earlier, this attribute is unavailable and will be displayed as a zero (0).
  • Network Route Indicates whether the route used by this gateway was defined as a network route. If you are viewing this workspace on an LPAR running z/OS 1.9 or earlier, this attribute is unavailable and will be blank.
  • Route Status The status of route used by this gateway. If you are viewing this workspace on an LPAR running z/OS 1.9 or earlier, this attribute is unavailable and will be blank.
  • Route Type The type of route used by this gateway. If you are viewing this workspace on an LPAR running z/OS 1.9 or earlier, this attribute will be blank.

The existing Link Name attribute is now called Link or Interface Name. The existing Link Status attribute is now called Link or Interface Status.

Interfaces (KN3TIF) Interfaces workspace

Two attributes in the Interfaces Attributes have been updated to accommodate z/OS v1.12.

  • Interface Capacity: An estimate, in bits per second (z/OS v.1.11 or earlier) or million bits per second (z/OS v.1.12 or later), of the current data rate capacity for the interface. The format is this attribute has been updated when the workspace being monitored is running z/OS v1.12 or later. This attribute now expresses capacity in millions of bits per second instead of in bits per second.
  • Physical Address: The address of the interface at the protocol sublayer. The length of this attribute has been increased, and this field now shows data for ATM, HYPERchannel, LCS Ethernet, and MPCIPA OSA-Express QDIO interface types only. The old version of this attribute was deprecated.
KN3 TCP Collector Status (KN3TCS) Agent Status workspace

A new attribute was added to accommodate z/OS v.1.12:

  • Data Link Control Statistics Collection: Indicates whether Interface Data Link Control (DLC) statistics are to be collected for this stack.

Three additional attributes were added that are z/OS release independent:

  • Data Link Control Statistics Collection: Indicates whether Interface Data Link Control (DLC) statistics are to be collected for this stack.
  • Interface Statistics Collection: Indicates whether Interface statistics are to be collected for this stack.
  • OSA Statistics Collection: Indicates whether OSA statistics are to be collected for this stack.
  • Stack Layer Statistics Collection: Indicates whether Stack Layer statistics are to be collected for this stack.
TCPIP Stack Layer (KN3TSL) TCP/IP Stack Layers workspace

If the address space being monitored is running on z/OS v1.11 or earlier, the values for this attribute group are retrieved using SNMP. If the address space being monitored is running on z/OS v1.12 or later, the values for this attribute group are retrieved using the z/OS Communications Server callable network management interface (NMI)

Impact:

New product-provided situations

To take advantage of all the new and enhanced attribute groups, nine new situations have been added:

Impact:

Support for the zEnterprise mainframe server

IBM recently announced the zEnterprise mainframe server, a powerful, energy-efficient system that enables POWER7® and System x® servers to share resources and be managed as a single, virtualized system. OMEGAMON XE for Mainframe Networks added data types to existing attributes in this fix pack to support zEnterpriseTM. For more information about zEnterpriseTM, see http://www-03.ibm.com/press/us/en/pressrelease/32166.wss.

Enhancements to Connections node workspaces

The workspaces related to the Connections node in the navigation tree (Connections, UDP Endpoints, TCP Listeners, TCP Connections, Application Connections, Application UDP Endpoints, Application TCP Listeners, Application TCP Connections, and TCP Connections Link) have been updated to implement a number of customer requirements. The enhanced workspaces add 34 new attributes across four attribute groups to take advantage of enhancements to the z/OS Communications Server callable network management interfaces (NMIs). These updates include:

Additionally, the product-specific Take Action commands (Drop Connection, NSLookup IP Address, Ping IP Address, and Tracerte IP Address) can now be issued from these linked-to workspaces: Application Connections, Application UDP Endpoints, Application TCP Listeners, Application TCP Connections, and TCP Connections Link. Confusing gigabyte and byte representations fields have been eliminated. These fields remain available in queries but are no longer displayed.

The attribute groups and workspaces listed in Table 3 are affected by these enhancements:

Table 3. Workspaces and attribute groups affected by Connections enhancements
Attribute group Workspace
TCPIP Connections Attributes (KN3TCN) TCP Connections, Application TCP Connections, and TCP Connections Link workspaces

The following new attributes were added in this table:

  • Local Port: The local port for this TCP connection. The format of the displayed Local Port attribute is an unsigned integer instead of a string. The existing Local Port attribute, which was defined as a string, is no longer displayed in this workspace.
  • Connection State: The state of the connection. The list of possible states has been updated to show a state of “LISTEN" for a TCP Listener connection and “UDP" for a UDP endpoint connection.
  • Total Bytes: The total number of bytes sent and received since the connection started. This attribute is displayed in place of the deprecated Total Bytes and Total Bytes (in GB) attributes. The format of this new attribute is a long long integer.
  • Total Bytes Received: The total number of bytes received since the connection started. This attribute is displayed in place of the deprecated Total Bytes Received and Total Bytes Received (in GB) attributes. The format of this new attribute is a long long integer.
  • Total Bytes Sent: The total number of bytes sent since the connection started. This attribute is displayed in place of the deprecated Total Bytes Sent and Total Bytes Sent (in GB) attributes. The format of this new attribute is a long long integer.

The following attributes were deprecated in this table:

  • Total Bytes
  • Total Bytes (in GB) (also not displayed)
  • Total Bytes Received
  • Total Bytes Received (in GB) (also not displayed)
  • Total Bytes Sent
  • Total Bytes Sent (in GB) (also not displayed)
TCPIP Details Attributes (KN3TCP) TCP Connections, Application TCP Connections, and TCP Connections Link workspaces.

The following new attributes were added to this table:

  • APPLDATA: The result of an SIOCSAPPLDATA ioctl query.
  • AT-TLS Policy Status: The current Application Transparent Transport Layer Security (AT-TLS) policy status for the connection.
  • AT-TLS Status: The current Application Transparent Transport Layer Security (AT-TLS) status for the connection. This value indicates whether the SSL handshake has completed successfully for the connection.
  • Congestion Window Size: The congestion window size for this connection
  • Duplicate ACKs: The number of duplicate ACKs (TCP acknowledgements) received for this connection
  • Inbound Bytes Buffered: The number of incoming bytes buffered by this connection.
  • Inbound Interface Name: The link name of the receiving interface for this connection.
  • Inbound Queued Data Time Stamp: The time stamp of the oldest inbound data that was queued.
  • Maximum Segment Size: The maximum segment size the connection can send.
  • Maximum Send Window Size: The maximum send window size for the connection.
  • Negotiated Cipher: The negotiated cipher that is in use by the secure connection.
  • Negotiated SSL Protocol: The negotiated SSL protocol in use by the connection.
TCPIP Details Attributes (N3TCP)

(Continued)

TCP Connections, Application TCP Connections, and TCP Connections Link workspaces.

The following new attributes were added to this table:

  • Open Type: The type of open performed for this connection.
  • Outbound Bytes Buffered: The number of outgoing bytes buffered by this connection.
  • Outbound Queued Data Time Stamp: The time and date of the oldest queued data waiting to be sent.
  • Partner User ID: The user ID associated with the partner's certificate.
  • Receive Buffer Size: The receive buffer size for the connection.
  • Registered Ancillary Inbound Queue An indicator of whether the TCP connection is registered with a TCP bulk data ancillary inbound queue.
  • Send Buffer Size: The send buffer size for the connection.
  • Send Window Size: The send window size for the connection.
  • Server Resource ID: The numeric identification of the server (that is, the listener connection) associated with this client connection.
  • Slow Start Threshold: The slow-start threshold for this connection.
  • SSL Session Type: The type of System SSL secure session defined in AT-TLS policy in use by the connection.
  • Sysplex Cluster Connection Type The sysplex cluster connection types for this connection.
  • Telnet Session Type: The type of open performed for this connection.
  • TN3270 Client User ID: The client user ID if the TCP connection is for a TN3270 or TN3270E session.
  • TN3270 Logmode Name: The VTAM® Logmode if the TCP connection is for a TN3270 or TN3270E session.
  • Total Bytes: The total number of bytes sent and received since the connection started. This attribute is displayed in place of the deprecated Total Bytes and Total Bytes (in GB) attributes. The format of this new attribute is a long long integer.
  • Total Bytes Received: The total number of bytes received since the connection started. This attribute is displayed in place of the deprecated Total Bytes Received and Total Bytes Received (in GB) attributes. The format of this new attribute is a long long integer.
  • Total Bytes Sent: The total number of bytes sent since the connection started. This attribute is displayed in place of the deprecated Total Bytes Sent and Total Bytes Sent (in GB) attributes. The format of this new attribute is a long long integer.

The following attributes were deprecated in this table:

  • Total Bytes
  • Total Bytes (in GB) (also not displayed)
  • Total Bytes Received
  • Total Bytes Received (in GB) (also not displayed)
  • Total Bytes Sent
  • Total Bytes Sent (in GB) (also not displayed)
TCP Listener Attributes (KN3TCL) TCP Listeners and Application TCP Listeners workspaces

The following new attributes were added to this table:

  • APPLDATA: The result of an SIOCSAPPLDATA ioctl query.
  • DVIPA: Whether or not the listener socket supports Dynamic Virtual IP Addressing (DVIPA).
  • DVIPA Quiesced: Whether or not Dynamic Virtual IP Addressing (DVIPA) associated with the listener socket has quiesced.
  • Established Connections in Backlog The number of Connections in Backlog that are established.
  • FRCA Connections in Backlog: The number of Connections in Backlog that are established Fast Response Cache Accelerator (FRCA) connections not present to be accepted by the application.
UDP Connections Attributes (KN3UDP) UDP Endpoints and Application UDP Endpoints workspaces

The following new attributes were added to this table:

  • Inbound Queued Data Time Stamp: The time stamp of the oldest queued data that was queued.
  • Last Activity Time Stamp: The last time of connection activity.
  • Total Bytes: The total number of bytes sent and received since the connection started. This value is now calculated differently and is expressed as a long long integer.
  • Total Bytes Received: The total number of bytes received since the connection started. This value is now calculated differently and is expressed as a long long integer.
  • Total Bytes Sent: The total number of bytes sent since the connection started. This value is now calculated differently and is expressed as a long long integer.

The following attributes were deprecated in this table:

  • Total Bytes
  • Total Bytes (in GB) (also not displayed)
  • Total Bytes Received
  • Total Bytes Received (in GB) (also not displayed)
  • Total Bytes Sent
  • Total Bytes Sent (in GB) (also not displayed)
Impact

:

Retrieving route information with IOCTL

When monitoring an address space running on z/OS 1.10 or later, z/OS Communication Server external I/O control (IOCTL) function calls are used to retrieve route information. SNMP was used to previously obtain this data. The change in data retrieval methods was made to reduce CPU utilization when a large number of routes are defined. The route information returned by the IOCTL calls is only from the main route tables (IPv4 and IPv6) for the stack. Policy-based routes are not supported by these IOCTL calls. These IOCTL calls are supported by the z/OS UNIX Systems Services Callable API.

Impact:

DVIPA reporting differences

Differences exist in DVIPA reporting depending on the level of z/OS under which the monitoring agent is running.

z/OS Communications Server does not report performance metrics for DVIPAs; therefore, these interface performance metrics have always displayed as zero. Because of these data collection differences noted earlier, DVIPA data is found in different workspaces depending on the version of z/OS under which the monitoring agent is running.

Impact: More detailed and useful DVIPA data can now be reported

New configuration options for more granular data collection

As part of z/OS v1.12 callable interface support, the ability to turn data collection on and off is now available for the following types of data:

Likewise, granular tracing options have been added for each of these new data types.

These additional data types require new Configuration Tool options and have resulted in new z/OS KN3FCCMD MODIFY commands for stopping and starting these components when the monitoring agent is running. Both of these updates are documented in the IBM Tivoli OMEGAMON XE for Mainframe Networks: Planning and Configuration Guide.

Impact:

Changes to OSA

In this fix pack, you will notice a number of changes to OSA data collection and display, some of which are the result of z/OS v1.12.

Two new attributes were added to the OSA Ports, OSA-Express2 10 Gig Ports Summary, and OSA-Express3 Ports Summary workspaces that enable linking between these workspaces and the Gateways and Devices, Interface Status, and Interface Statistics workspaces for monitoring agents running under z/OS v1.12 or later. For details about the new attributes, see Table 4.

Table 4. New attributes in OSA workspace
Attribute group Workspace New attribute
OSA-Express Ports (KN3TPO) OSA Ports

Two attributes in the OSA-Express Ports attribute group have been added to accommodate z/OS v.1.12 and enable linking between the OSA Ports workspace and the Gateways and Devices, Interface Status and Interface Statistics workspaces. The z/OS Release attribute is defined as the version of z/OS on which this instance of the monitoring agent is running. The Interface Port Index attribute is defined as the OSA-Express queued direct I/O (QDIO) port interface index

OSA 10 Gigabit Ports Summary (KN3TTS) OSA-Express2 10 Gigabit Ports Summary
OSA-Express3 Ports Summary (KN3THS) OSA-Express3 Ports Summary

It is typical for OSA adapters to be shared across multiple LPARs. When the OSA adapters are configured across multiple LPARs, you can collect OSA performance statistics for any LPAR that is sharing the OSA adapter. Consequently, you do not need to turn on OSA data collection for each instance of the OMEGAMON XE for Mainframe Networks monitoring agent in your environment. A review of your sharing configuration of the OSA adapters within a Central Electronics Complex (CEC) might allow you to select only a few monitoring agent instances that need to be configured to collect OSA data for your environment. If all of the monitoring agents are running on z/OS v1.12 or later, then it would be necessary to configure SNMP only on the LPARs where you elect to collect OSA performance metrics.

Options are provided in the Configuration Tool to enable OSA data collection globally for all TCP/IP address spaces running on the system or for individual TCP/IP stacks and in the z/OS KN3FCCMD MODIFY commands to turn OSA data collection on and off dynamically for a selected instance of the monitoring agent.

Filtering provided in the OSA Port Interfaces workspaces has been incorporated into the Interface Status and Interface Statistics workspaces. When the monitoring agent runs in a z/OS v1.12 and later environment, the OSA Port Interfaces workspace is no longer a target of a link, and consequently, this workspace has been deprecated.

Impact:

  1. You can now easily see the relationship between the OSA and interfaces workspaces with new linking attributes.
  2. OSA Port (hardware) data can be associated with a TCP/IP gateway or interface (software) data.
  3. You do not need to turn on OSA data collection for each instance of the monitoring agent in your environment because you can collect OSA performance statistics for any LPAR that is sharing the OSA adapter.

Three new dynamic links to cross-product workspaces were added:

Impact:

Support for the PARMLIB configuration method

The PARMLIB configuration method is a new alternative to using the Configuration Tool (ICAT). Although the Configuration Tool is still the primary method of configuring the Tivoli Management Services on z/OS components and the OMEGAMON XE products, the PARMLIB method might be more suitable for new OMEGAMON XE customers who are already accustomed to supplying parameter values directly in the SYS1.PARMLIB data set and do not want to learn a new tool.

With the PARMLIB configuration method, you edit a comprehensive list of parameters for configuring all installed products and components. You then submit a series of jobs to create a complete runtime environment with the parameter values you specified. All products that you want to configure must be enabled for PARMLIB. OMEGAMON XE for Mainframe Networks Fix Pack 3 is enabled.

If you are an existing Configuration Tool user and already have an existing RTE environment that you want to convert to using PARMLIB, a utility is available to help you. Support for the PMAP utility was introduced in OMEGAMON XE for Mainframe Networks Fix Pack 2 and Interim Features for Self-Diagnosis. The Configuration Tool was modified to enable the parameter mapping (PMAP) report from the Runtime Environment menu.

The output of running this utility is a report that identifies panels where configuration parameters are defined and RKAN*U members where they are saved and can be used to configure using PARMLIB or used to update parameters in the Configuration Tool.

The new IBM Tivoli OMEGAMON XE for Mainframe Networks: Parameter Reference introduced in this fix pack provides complete documentation for the parameters used by the Configuration tool, BATCH, and the PARMLIB configuration methods.

Impact:

New features in Version 4.2.0 Fix Pack 2 and Interim Features for Self-Diagnosis

New features in Version 4.2.0 Fix Pack 1 and Interim Features for Advanced Diagnostics

The following new features were introduced in Version 4.2.0 Fix Pack 1 and Interim Features for Advanced Diagnostics:

New features in V4.2

The following new features were introduced in V4.2: