Version 3.1publib.boulder.ibm.com/tividd/td/ITOXfOS390/GI11-4038-00/en_US/P… · The 3.1. products...

IBMTivoli®

Version 3.1.0

Release Notes

GI11-4038-00

OMEGAMON XE on z/OS

12

1

2

IBMTivoli®

Version 3.1.0

OMEGAMON XE on z/OS

Release Notes

GI11-4038-00

12

1

First Edition (October 2005)

This edition applies to version 3, release 1, modification 0 of IBM Tivoli OMEGAMON XE on z/OS (product number 5698-A59) and to all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright International Business Machines Corporation 1996, 2005. All rights reserved.

Note to U.S. Government Users Restricted Rights—Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

2

Before using this information and the product it supports, read the information in "Notices" on page 27.

Note

Contents 5

Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Where to find the latest information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Changes in product and component names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8OMEGAMON II documentation for monitoring agents . . . . . . . . . . . . . . . . . . . . . . . . . .9OMEGAVIEW documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Changes to the location of information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Using Tivoli OMEGAMON XE on z/OS V3.1 with Tivoli Monitoring Services V6.1 . . . .10Changes to OMEGAMON for MVS Classic Component . . . . . . . . . . . . . . . . . . . . . . . .13

Appendix A. Support Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Appendix B. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

Contents

6 IBM Tivoli OMEGAMON XE on z/OS Release Notes

Release Notes 7

Release Notes

OverviewIBM® Tivoli® OMEGAMON® XE on z/OS®, Version 3.1.0 is a member of the latest generation of OMEGAMON family of mainframe monitoring products. It enables you to monitor and manage the availability, performance, and resource utilization of your z/OS systems, either at a system level or within a Parallel Sysplex®. The intuitive browser interface enables you to clearly see and understand system events.

Tivoli OMEGAMON XE on z/OS also acts as a powerful analytic interface to classic OMEGAMON and OMEGAMON II for MVS® monitoring products. Used in conjunction with other OMEGAMON XE monitoring products, the data, analyses, and alerts presented by Tivoli OMEGAMON XE on z/OS help you develop a holistic view of your entire computing enterprise from a single console.

These release notes provide the following important information about the Tivoli OMEGAMON XE on z/OS product:

� Where to find the latest information

� Changes in product and component names

� OMEGAMON II documentation for monitoring agents

� OMEGAVIEW documentation

� Changes to the location of information

� Using Tivoli OMEGAMON XE on z/OS with Tivoli Monitoring Services version 6.1

� Known issues for version 3.1.0 of the configuration tool version

� Known issues for the install, configuration, or use of Tivoli OMEGAMON XE on z/OS or OMEGAMON Platform components

� Changes to the classic OMEGAMON for MVS component

Where to find the latest informationYou received the documentation for Tivoli OMEGAMON XE on z/OS and for the OMEGAMON Platform components on CD. To ensure you have the most up-to-date information about installation procedures and known workaround and limitations for this product, check this Web site for a later version:

R

Changes in product and component names

8 IBM Tivoli OMEGAMON XE on z/OS V3.1.0 Release Notes

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

As the Web site contains the most current information for the product and takes precedence over all other product documentation, consult this Web site before beginning any of the procedures in the configuration or user guides.

Changes in product and component namesIBM recently acquired Candle® Corporation. The transition of Candle ordering and service processes is complete. Many changes have been made to this product and its publications to deliver it as an IBM product.

Most of the terminology used to describe the OMEGAMON products in these publications remains unchanged. In some cases, the product release number has been modified. For example, the version of CandleNet Portal® required by this release is version 196. Publications that have been modified (such as Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows® and UNIX®) include the new version 196 release number on the cover. Publications that have not been modified (such as Administering OMEGAMON Products: CandleNet Portal Version 195 and Using OMEGAMON Products: CandleNet Portal Version 195) continue to carry the previous version 195 release number. The information provided in those books is still valid for version 196.

Candle products have new IBM names, and during this transition period, some publications use the old names and others use the new names. For example, some publications use the term CandleNet Portal and others use the new name Tivoli Enterprise Portal.

Table 1 shows the mapping of the former Candle names for OMEGAMON components to the new IBM Tivoli Monitoring Services names.

For a more complete mapping of previous Candle names and new IBM names, refer to http://www.ibm.com/software/tivoli/products/product-matrix.html

Table 1. Mapping of former Candle names to new IBM names

Former Name New Name

CandleNet Portal Tivoli Enterprise Portal

CandleNet Portal Server Tivoli Enterprise Portal Server

Candle Management Server Tivoli Enterprise Monitoring Server or monitoring server

Candle agent Tivoli Enterprise Monitoring Agent or monitoring agent

OMEGAMON Tivoli Monitoring Services

OMEGAMON Platform IBM Tivoli Monitoring

Manage Candle Services Manage Tivoli Monitoring Services

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

http://www.ibm.com/software/tivoli/products/product-matrix.html

Release Notes 9

OMEGAMON II documentation for monitoring agents

OMEGAMON II documentation for monitoring agentsPublications for most OMEGAMON II® products have not been updated. These publications refer to the Candle Support structure rather than to IBM Software Support. References to Candle Support processes and procedures are obsolete. For details about IBM Software Support, see �Support Information� on page 21.

OMEGAVIEW documentationReferences to OMEGAVIEW® and in the the OMEGAMON II documentation sets should not to interpreted to mean that OMEGAVIEW is provided with the product being documented.

The OMEGAVIEW and and OMEGAVIEW II® for the Enterprise products are now components of the IBM Tivoli OMEGAMON DE on z/OS product. To order this product, contact your IBM account representative.

Changes to the location of informationAs part of the transition from Candle to IBM, some of the information to support the monitoring agent products has been moved to new locations. Table 2 maps the old location for familiar information to the new location.

Table 2. Information location changes from OMEGAMON Platform V350 to V360

Information Location in OMEGAMON Platform V350 library

Location in OMEGAMON Platform V360 library

Location of the Tivoli OMEGAMON XE on z/OS messages

Candle Products Messages Manuals Volumes 1�5

IBM Tivoli Candle Products Messages Volumes 1�5

Installation and configuration information for distributed components (for example, CandleNet Portal Server on UNIX®)

Installation guides were organized by platform, with a single guide for installing all products and components on a given platform (z/OS, Windows, or UNIX). A configuration and customization guide was provided for each z/OS-based OMEGAMON product.

� For distributed components:� Installing and Setting

up OMEGAMON Platform and CandleNet Portal on Windows and UNIX

� Configuring IBM Tivoli OMEGAMON XE on z/OS

� For Candle Management Server on z/OS, the Candle Management Server Program Directory and Configuring Candle Management Server on z/OS

Using Tivoli OMEGAMON XE on z/OS V3.1 with Tivoli Monitoring Services V6.1



All Tivoli OMEGAMON XE version 3.1. products are packaged with the OMEGAMON Platform, which includes version 360 of the Candle Management Server and version 196 of the CandleNet Portal. The 3.1. products can also be enabled to run on version 6.1 of the OMEGAMON Platform (Tivoli Monitoring Services), which is packaged with IBM Tivoli Monitoring V6.1 and IBM Tivoli Monitoring Services on z/OS V6.1 (product number 5698-A79).

If you are currently running a Tivoli OMEGAMON XE version 3.1 product and you want to upgrade to IBM Tivoli Monitoring V6.1 or IBM Tivoli Monitoring Services on z/OS 6.1, or if you want to run your Tivoli OMEGAMON XE version 3.1 product in an environment where Tivoli Monitoring Services V6.1 is already installed, refer to the document �OMEGAMON V350/360 agent interoperability�, available from the IBM Tivoli Monitoring Information Center: http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?toc=/com.ibm.itm.doc/toc.xml.

If you decide to install IBM Tivoli Monitoring V6.1 and you have an existing installation of OMEGAMON Platform, take appropriate steps to ensure that the new installation does not overwrite workspaces, situations, and stored data from the previous installation. See IBM Tivoli Monitoring: Installation and Setup Guide for migration instructions.

The publications in the Tivoli OMEGAMON XE on z/OS library assume that you are configuring, using, and administering Tivoli OMEGAMON XE on z/OS with OMEGAMON Platform V360 and V196.

Installation and configuration of the product

You used the Candle Installation and Configuration Assistance Tool (CICAT) to install and configure the product. This process was documented in the online help for CICAT, and in the installation and configuration guides for the OMEGAMON products.

You install the product by using the IBM System Modification Program/Extended (SMP/E) tool and instructions found in the IBM Tivoli OMEGAMON XE on z/OS Program Directory. CICAT has been renamed the Installation and Configuration Tool. You still use this tool to configure the product after the SMP/E installation is complete. Information about this process is found in Configuring IBM Tivoli OMEGAMON XE on z/OS.

Table 2. Information location changes from OMEGAMON Platform V350 to V360

Information Location in OMEGAMON Platform V350 library

Location in OMEGAMON Platform V360 library

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?toc=/com.ibm.itm.doc/toc.xml

Release Notes 11


Known issues for the configuration tool V3.1.0In previous releases, the configuration tool was known as CICAT (the Candle Installation and Configuration Assistance Tool). This tool is still used to perform installation and configuration of former Candle products. In this context, the tool is called the Installation and Configuration Tool. However, for OMEGAMON XE zSeries monitoring agents, the tool is used for configuration only, since these products are installed using SMP/E and is called simply the configuration tool.

Table 3 documents known defects and limitations associated with version 3.1.0 of the configuration tool.

Known issues for product or OMEGAMON Platform

Help merge takes a long timeIf you are installing a large number of products, the merge of the help contents may take a long time and the install process may appear to be hung. (The installer tells you what step it is performing.) Allow the installer time to complete the merge: this could take up to as much as 15 minutes.

This problem is fixed in fixpack FP0004, which is not available at the time of this release.

ABEND message at Candle Management Server terminationOn occasion you may see the following message when the Candle Management Server terminates:

ABNORMAL TERMINATION AVERTED: CODE(0C4000)

Table 3. Defects, limitations, and workarounds for the version 3.1.0 configuration tool

Description of Problem Workaround

The same configuration task might seem to occur more than once as you set up a monitoring agent and the related OMEGAMON components.

Be aware that you perform similar configuration tasks for each component.

When performing an operation on one runtime environment (such as Add or Build) from a list of runtime environments (RTEs), the current RTE will always be at the top when you return to the RTE list. Part of the list of resources might be scrolled off the screen and appear to be missing.

Use PF7 to scroll back and view the other RTEs.

Sometimes, you must back up in the configuration tool to ensure that changes made to values are recognized. If you update a value on an earlier ISPF in the Configuration Tool, you need to run the Create runtime job again, even though it was found earlier in the configuration flow. Likewise, if you update the runtime environment (RTE) value, you then proceed to the next step before the JCL is created and run and the requested updates to the RTE are actually made.

For updated configuration parameters to be used by the RTE, it is necessary to perform all subsequent create runtime members actions associated with the changed parameters.



This is a recurring problem with address space termination. It does not affect normal operation.

Duplicate data reported on Page Dataset Activity workspaceThere is currently no fix for this problem.

Extra entries in Manage Candle Services on UNIXOn UNIX you may see entries for OMEGAMON XE on z/OS and OMEGAMON XE for IMS on z/OS, although no actions can be taken on these entries.

Cannot restart CandleNet Portal client if Help browser is openIf you stop the client while the Help browser is open, you are unable to restart the client. Close the browser before restarting the client.

Release Notes 13

Changes to OMEGAMON for MVS Classic Component


OverviewTivoli OMEGAMON XE on z/OS has added support for zSeries® Application Assist Processors (zAAPs). zAAPs are a special class of assist processor designed to run Java� workloads. Several OMEGAMON for MVS V5.5.0 CPU data collection screens and routines are affected by this support. This section documents these changes.

For reporting purposes, a zAAP is usually referred to as an integrated facility for applications (IFA). You can force Java workloads to execute only on the IFAs, maximizing the offload of work from regular engines, or allow them to execute on CPs when they are not busy. This is known as crossover.

If you allow workloads to run on regular central processors (CPs), you can allow them to run at the priority of the service class (dispatch priority honored) or at a lower priority (dispatch priority not honored).

OMEGAMON Classic Screen Space Changes

Address Space CommandsThree new minor commands have been added:

For example:

Bottleneck Analysis (monj)Two wait reasons have been added to bottleneck analysis:

ifat Time spent by the address space executing on an IFA processor

ifac Time spent the address space executing IFA work on a standard processor

ifax Time spent by the address space executing on a standard processor

Using IFA The percentage of all observed execution states where the address space was found using an IFA. If IFA crossover is permitted, and IFA dispatch priority is honored, execution states where the address space was found to be executing IFA work on a standard central processor, if any, are added to Using CPU. If IFA dispatch priority is not honored, any samples are added to Using IFA.

IFA Wait The percentage of all observed execution states where the address space was found waiting to use an IFA

________________ ZMENU VTM OM/DEX V520./I SP11 10/24/05 19:33:42 JOBN IMS610MC ifat 3.14 ifac .42 ifax 22.73



For example:

Impact Analysis (DIANL)Using IFA data has been added to Impact Analysis. For example

where:

System Environment Information (SYS/ENV)IFA information has also been added to the System Environment Information report:

Using IFA Is the percentage of all observed execution states where the address space was found using an IFA. If IFA crossover is permitted, and IFA dispatch priority is honored, execution states where the address space was found to be executing IFA work on a standard central processor, if any, are added to the impactor�s Using CPU. If IFA dispatch priority is not honored, any samples are added to the impactor�s Using IFA.

IFAS If zAAPs are configured, the number of online and offline zAAPs configured to the current LPAR.

IFA relative processor speed

The speed of IFA processor relative to regular CP expressed as a ratio (n.nn:1)

IFA Crossover Whether or not IFA crossover is allowed

IFA Honor Priority Whether or not service class priority is honored by Java workloads running on regular CPs (if crossover is allowed)

________________ ZMENU VTM OM/DEX V520./I SYS 10/25/05 4:37:35

monj03 IFAJOB ASID=6 % |0 1 2 3 4 5 6 7 8 9 0| + Using CPU 1.1 |> . . . . . . . . . . | + Using IFA 1.0 |> . . . . . . . . . . | + IFA Wait 10.5 |----> . . . . . . . . . | + STIMER Wait 50.0 |------------========> . . . . . | + Disk CPL001 0216 Active 26.3 |----------> . . . . . . . . | + ECB Wait 10.5 |----> . . . . . . . . . | + Disk CPL001 Q0216 Queued 5.3 |--> . . . . . . . . . . |

________________ ZMENU VTM OM/DEX V520./I SYS 10/25/05 4:37:35 DIANL XCFAS + XCFAS IAST=.9 IATH=5 IACS=1 IACL=5 + Productive/Contention/Other | 100.0% .0% .0% | | 75.0% 24.8% .2% | + Contending Address Spaces |Short ( 26 S,30) | |Long ( 1:26 M,97) | + ----------------------------+-1-2-3-4-5-6-7-8-9-+ +-1-2-3-4-5-6-7-8-9-+ + *Total Contention* *0.0*| . . . . . . . . . | *24.8*|---->. . . . . . . | + No Self-contention | | | | + WASJOBO0 0.0| . . . . . . . . . | 24.8|---->. . . . . . . | + Using CPU (0.0)| . . . . . . . . . | (18.8)|---->. . . . . . . |+ Using IFA (0.0)| . . . . . . . . . | (6.0)|---->. . . . . . . |

Release Notes 15


If IFAs are configured and IFA crossover is permitted, you will see a screen similar to the following:

If IFAs are configured but IFA Crossover not permitted, you will see something like the following:

If IFAs are not configured, you will see something like the following:

System CPU Utilization (SPU)The following new data is presented:

NCL Percentage CPU utilization of all enclaves, including foreign, dependent and independent enclaves.

IFA Percentage CPU utilization of all IFAs configured to the current LPAR. (Only displayed if IFAs in configuration)

IFC Percentage CPU utilization of all IFA work run on regular CPs in the current LPAR. (Displayed only if IFAs are configured.)

ICFnn Percentage utilization of individual internal coupling facility (ICF) where nn is the logical CPU ID assigned to the ICF.

IFAnn Percentage utilization of individual IFA where nn is the logical CPU ID assigned to the IFA.

________________ ZMENU VTM OM/DEX V520./I SYS 10/25/05 4:37:35 SYS >> WLM Goal mode OPT=GG SYSRES=(OR16K1,0569) << env z/OS 01.06.00 running in Logical partition 1 on 2084 + IPLed at 2:12:30 on 10/25/05 RMF 7.1.5 is active >> ASID << + ESCON Status: Enabled ESCON Director: In Configuration + WLM Mode=Goal + IFAs: In Configuration (02) IFA relative processor speed: 4.00:1 + IFA Crossover: Yes IFA Honor Priority: Yes

________________ ZMENU VTM OM/DEX V520./I SYS 10/25/05 4:37:35 SYS >> WLM Goal mode OPT=GG SYSRES=(OR16K1,0569) << env z/OS 01.06.00 running in Logical partition 1 on 2084 + IPLed at 2:12:30 on 10/24/05 RMF 7.1.5 is active >> ASID << + ESCON Status: Enabled ESCON Director: In Configuration + WLM Mode=Goal + IFAs: In Configuration (02) IFA relative processor speed: 4.00:1 + IFA Crossover: No IFA Honor Priority: n/a

________________ ZMENU VTM OM/DEX V520./I SYS 10/25/05 4:37:35 SYS >> WLM Goal mode OPT=GG SYSRES=(OR16K1,0569) << env z/OS 01.06.00 running in Logical partition 1 on 2084 + IPLed at 2:12:30 on 10/24/05 RMF 7.1.5 is active >> ASID << + ESCON Status: Enabled ESCON Director: In Configuration + WLM Mode=Goal + IFAs: Not Configured IFA relative processor speed: n/a+ IFA Crossover: Yes IFA Honor Priority: n/a



You should see a screen similar to the following:

System CPU Exceptions (XACB LIST=XCPU)For z/OS Version 1.6 or higher, exceptions have been added for IFA or ICF offline.

IFA/IFA On CP Utilization (SIFA)A new intermediate command has been added. This command displays IFA and IFA on CP utilization of address spaces using more than nn% IFA and IFA on CP combined.

You should see a screen similar to the following:

EPILOG Historical Reporter Changes

CPU Resource Reporting (RCPU)This report has been modified to add the IFA and IFA on CP percentages consumed by all address spaces running during the monitored interval. Additionally, the exisiting LPAR logical, physical, and management overhead percentages attributable to IFA processors

________________ ZMENU VTM OM/DEX * V520./I SYS 10/25/05 6:58:50 135 MCPU99|__Task__ CPU% 0______ 100|__PG N/A in goal mode__|System % 0______ 100| + | | |TCB: 19 ->. . . . .| + | | |SRB: 3 > . . . . .| + | | |NCL: 0 > . . . . .| + | | |MVS: 4 > . . . . .| + | | |IFA: 2 > . . . . .| + | | |IFC: 2 > . . . . .| + | | | 0_______100| + | | |CPU00 14 ->. . . . .| + | | |CPU01 10 ->. . . . .| + | | |CPU02 4 > . . . . .| + | | |ICF03 1 > . . . . .| + | | |IFA04 1 > . . . . .|

________________ ZMENU VTM OM/DEX * V520./I SYS 10/25/04 6:58:50 135 XACB LIST=XCPU TERSE FORCE : XCPU Threshold=N/A Display=CLR1 State=ON Bell=ON + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + + Warning: ICF 03 is not active + + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

+ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + + Warning: IFA 04 is not active + + ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

________________ ZMENU VTM OM/DEX * V520./I SYS 10/25/04 6:58:50 135 SIFA01 IFA% 0__20__40__60__80_100 IFA on CP% 0__20__40__60__80_100+ XCFAS 1.02 > . . . . | 10.11 |-> . . . . |+ WLM 1.30 > . . . . | 4.34 |> . . . . |+ EROMAGTG 11.51 -> . . . . | 0.00 | . . . . |+ TCPIPG 0.00 | . . . . | 12.04 |-> . . . . |+ VECTH@@L 0.53 > . . . . | 1.22 > . . . . |+ Total 18.50 |-->. . . . | 51.22 |--20-=40=> . . | >

Release Notes 17


were added. The exisiting standard CP percentages for these values are also displayed with the distinguishing (CP) text added to the original descriptive text.

You should see a screen something like the following:.

System Information Reporting (RINF)This report was modified to add the the number of IFAs configured to the LPAR, the IFACrossover status, IFA HonorPriority status, and relative IFA processor speed. In addition, the existing physical processors and CP processors numeric fields were

IFA The percentage of IFA resource consumed by all address spaces over the reporting interval

IFACP The percentage of standard CP resource consumed by all address spaces performing IFA work over the reporting interval

IFAnn The IFA processor ID and the percentage resouce consumption over the reporting interval

Average Logical Processor Utilization (IFA)

The average logical IFA percentage for IFAs configured to the LPAR consumption over the reporting interval

Physical CPU Utilization for this Partition (IFA)

Percentage of physical IFA used by the LPAR consumption over the reporting interval

LPAR Management Overhead For This Partition (IFA)

Percentage of IFA used for management of LPARS configured to the LPAR over the reporting interval

IBM 11/10/05 9:16 Mode: PAGE CMD==> *******************************************************************************+============================== CPU Activity =================================+| From: 20:00 to 20:14 on 05/22/03 Elap = 14:59 M SYS |+-----------------------------------------------------------------------------+| Interrupt || Min Max Avg Ready Users Logical CPU Utilization Rate %TPI || --- --- ---- ----------- ------------------------ --------- ----- || Batch 17 18 17.1 In = 1.7 SRB= 7.4% CPU0 = 8.9% 45.1 4.07 || STC 204 205 204.8 Out = .0 TCB= 14.0% CPU1 = 8.5% 63.4 3.87 || TSO 35 36 35.6 MVS= 4.2% CPU2 = 8.2% 80.2 5.19 || IFA= 2.3% IFA3 = 5.9% || IFACP= 1.4% IFA4 = 6.7% | | || Average Logical Processor Utilization (CP) = 8.3% || (IFA) = 6.2% | | Physical CPU Utilization for this Partition (CP) = 8.3% || (IFA) = 6.2% || LPAR Management Overhead For This Partition (CP) = .3% || (IFA) = .1% || |+=============================================================================+



expanded to accomodate two digits. The ICF/IFL text was expanded to ICF/IFL/IFA to indicate that IFAs may now be included in the reported statistic.

For example:

Service Class Resource Reporting (RSCL)This report as modified to add the IFA and IFA on CP percentages for any service class period where either one of the two was consumed during the reporting interval. The column header represents the vertically "stacked" sequence of the statistics, CPU percentage followed by the IFA and IFA on CP percentages respectively.

IFAS If zAAPs are configured, the number of online and offline zAAPs configured to the current LPAR.

IFA relative processor speed

The speed of IFA processor relative to regular CP expressed as a ratio (n.nn:1)

IFA Crossover Whether or not IFA crossover is allowed

IFA Honor Priority Whether or not service class priority is honored by Java workloads running on regular CPs (if crossover is allowed)

IFA% The percentage of IFA resource consumed by the service class period over the reporting interval

IFC% The percentage of standard CP resource consumed by the service class period performing IFA work over the reporting interval

IBM 11/10/05 9:42 Mode: PAGE CMD==> ******************************************************************************* +======================= General System Information ==========================+ | From: 14:30 to 14:45 on 11/04/04 Elap = 15:00 M SYS | +-----------------------------------------------------------------------------+ | MVS SP7.0.6 Model=2084 Serial=11147E Mode= Partitioned | | IPS=N/A ICS=N/A OPT=GG RMF 7.1.5 | | Partition Name=SYSG Partition Num=1 | | Physical Processors=03 CP processors=03 ICF/IFL/IFA Processors=02 | | Processor Weight=230 Processor Complex Utilization=289.1 | | CPU Capping=NO Total LPAR Management Overhead=11.5 | | IFAs=02 IFA Crossover=YesIFA Honor Priority=Yes IFA Speed= 4.25:1 | | WLM Mode = GOAL Service Policy/definition = FEB0502 / prod | +=============================================================================+

Release Notes 19


You will see a screen similar to the following:

Workload Reporting (JOB, STC, TSO, SYS)This report was modified to include 3 new execution/wait states:

Using IFA The percentage of all observed execution states where the address space was found using an IFA. If IFA crossover is permitted, and IFA dispatch priority is honored, execution states where the address space was found to be executing IFA work on a standard CP, if any, are added to Using CPU. If IFA dispatch priority is not honored, any samples are added to Using IFA.

Using IFA on CP Percentage of samples where the address space was observed utilising CPU resource perfoming IFA work

Waiting for IFA The percentage of all observed execution states where the address space was found waiting to use an IFA

+=========================== WLM Service Classes==============================+| From: 20:00 to 20:14 on 05/22/05 Elap = 14:59 M SYS |+-----------------------------------------------------------------------------+| CPU%|| Service Perf. Goal Num Tran I/O Avg IFA%|| Class Pd Goal Dur Actual Index Imp. Tran Rate Rate Stor IFC%||-----------------------------------------------------------------------------|| BATCH 1 VEL+IO>10% 700 100.0 0.10 MED .1 28611 2.6|| 14.1|| 0.1|| 2 VEL+IO>10% 13.3 0.75 LOW 1 4/h .5 34285 1.9|| 0.0|| 8.1|| CICS 1 90%< 1.00s 50ms 0.50 HIGH 2 8/h || CICSTEST 1 95%< 1.00s 50ms 0.50 HIGH 90 6/m || IMSMPRS 1 VEL+IO>30% HIGH 75870 || STC 1 VEL+IO>30% 5000 5.2 5.76 HIGH 1 4/h .3 264321 || 2 VEL+IO>20% 22.7 0.88 MED 89.3 251591 6.2|| STCCMS 1 VEL+IO>30% 55K HIGH 188304 || 2 VEL+IO>20% 35.2 0.56 MED 24.3 630116 10.7|| STCMQ 1 VEL+IO>20% 7.1 2.81 MED 65652 || STCPROD 1 VEL+IO>20% 26.6 0.75 HIGH 1.9 99399 .1|| 14.1|| 3.3|| SYSSTC 1 SYSTEM 79.0 171142 4.6|| SYSTEM 1 SYSTEM 5.0 120562 5.0|| TSO 1 500ms 1000 166ms 0.33 HGHST 148 9/m 1.4 57016 .1|| 2 40%< 750ms 200 HGHST 51907 || 3 5.00s 5000 1.96s 0.39 HIGH 5 20/h .3 48617 || 4 VEL+IO>30% 20.0 1.50 MED 83272 ||*CICSRPT 1 90%< 1.00s 50ms 0.50 2 8/h |+=============================================================================+



You should see a screen like the following:

IBM 11/10/05 9:32 Mode: PAGE CMD==> ******************************************************************************* +=============================================================================+ | Started Task = $AFOPER JES Number = 06647 STC Steps = 1 / 1 | | From 14:30 to 22:00 on 11/04/04 Elap = 7:30 H SYS | +-----------------------------------------------------------------------------+ |Wait_Reason_____________Time_____%_|0___1___2___3___4___5___6___7___8___9___0| |Using CPU 10.45 S .0|. . . . . . . . . . .| |Using IFA 3.45 S .0|. . . . . . . . . . .| |Using IFA on CP 0.32 S .0|. . . . . . . . . . .| |ECB Wait (w/ STIMER) 7:27 H 99.5|------------============>>>>>>>>>>>>>>>>.| |Waiting for MVS Lock 1:32 M .3|. . . . . . . . . . .| |Waiting for CPU 17.51 S .0|. . . . . . . . . . .| |Waiting for IFA 9.22 S .0|. . . . . . . . . . .| |Disk CANPR1 0206 Act 2.50 S .0|. . . . . . . . . . .| |ECB Wait 2.50 S .0|. . . . . . . . . . .| |STC Elapsed Time 7:30 H | +=============================================================================+

Support Information 21

Support Information

If you have a problem with your IBM software, you want to resolve it quickly. This section describes the following options for obtaining support for IBM software products:

� �Searching knowledge bases� on page 21

� �Obtaining fixes� on page 22

� �Receiving weekly support updates� on page 22

� �Contacting IBM Software Support� on page 23

Searching knowledge basesYou can search the available knowledge bases to determine whether your problem was already encountered and is already documented.

Searching the information centerIBM provides extensive documentation that can be installed on your local computer or on an intranet server. You can use the search function of this information center to query conceptual information, instructions for completing tasks, and reference information.

Searching the InternetIf you cannot find an answer to your question in the information center, search the Internet for the latest, most complete information that might help you resolve your problem.

To search multiple Internet resources for your product, use the Web search topic in your information center. In the navigation frame, click Troubleshooting and support > Searching knowledge bases and select Web search. From this topic, you can search a variety of resources, including the following:

� IBM technotes

� IBM downloads

� IBM Redbooks®

� IBM developerWorks®

� Forums and newsgroups

� Google

A


Obtaining fixesA product fix might be available to resolve your problem. To determine what fixes are available for your IBM software product, follow these steps:

1. Go to the IBM Software Support Web site at (http://www.ibm.com/software/support).

2. Click Downloads and drivers in the Support topics section.

3. Select the Software category.

4. Select a product in the Sub-category list.

5. In the Find downloads and drivers by product section, select one software category from the Category list.

6. Select one product from the Sub-category list.

7. Type more search terms in the Search within results if you want to refine your search.

8. Click Search.

9. From the list of downloads returned by your search, click the name of a fix to read the description of the fix and to optionally download the fix.For more information about the types of fixes that are available, IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/handbook.html.

Receiving weekly support updatesTo receive weekly e-mail notifications about fixes and other software support news, follow these steps:

1. Go to the IBM Software Support Web site at http:/www.ibm.com/software/support.

2. Click My Support in the upper right corner of the page.

3. If you have already registered for My Support, sign in and skip to the next step. If you have not registered, click register now. Complete the registration form using your e-mail address as your IBM ID and click Submit.

4. Click Edit Profile.

5. In the Products list, select Software. A second list is displayed.

6. In the second list, select a product segment, for example, Application servers. A third list is displayed.

7. In the third list, select a product sub-segment, for example, Distributed Application & Web Servers. A list of applicable products is displayed.

8. Select the products for which you want to receive updates, for example, IBM HTTP Server and WebSphere® Application Server.

9. Click Add products.

10. After selecting all products that are of interest to you, click Subscribe to email on the Edit profile tab.

11. Select Please send these documents by weekly email.

http://www.ibm.com/software/support

http://techsupport.services.ibm.com/guides/handbook.html

http://techsupport.services.ibm.com/guides/handbook.html


12. Update your e-mail address as needed.

13. In the Documents list, select Software.

14. Select the types of documents that you want to receive information about.

15. Click Update. If you experience problems with the My support feature, you can obtain help in one of the following ways:

Online: Send an e-mail message to [email protected], describing your problem.

By phone: Call 1-800-IBM-4You (1-800-426-4968).

Contacting IBM Software SupportIBM Software Support provides assistance with product defects.

Before contacting IBM Software Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. The type of software maintenance contract that you need depends on the type of product you have:

� For IBM distributed software products (including, but not limited to, Tivoli, Lotus®, and Rational® products, as well as DB2 and WebSphere products that run on Windows or UNIX operating systems), enroll in Passport Advantage® in one of the following ways:

� Online: Go to the Passport Advantage Web page (http://www.lotus.com/services/passport.nsf/WebDocs/ Passport_Advantage_Home) and click How to Enroll

� By phone: For the phone number to call in your country, go to the IBM Software Support Web site at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region.

� For customers with Subscription and Support (S & S) contracts, go to the Software Service Request Web site at https://techsupport.services.ibm.com/ssr/login.

� For customers with IBMLink�, CATIA, Linux�, OS/390, iSeries�, pSeries®, zSeries®, and other support agreements, go to the Support Line Web site at http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006.

� For IBM eServer� software products (including, but not limited to, DB2 and WebSphere products that run in zSeries, pSeries, and iSeries environments), you can purchase a software maintenance agreement by working directly with an IBM sales representative or an IBM Business Partner. For more information about support for eServer software products, go to the IBM Technical Support Advantage Web site at http://www.ibm.com/servers/eserver/techsupport.html.

If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to the contacts page of the IBM Software Support Handbook on the Web at

http://techsupport.services.ibm.com/guides/contacts.html

http://www.lotus.com/services/passport.nsf/WebDocs/ Passport_Advantage_Home

http://www.lotus.com/services/passport.nsf/WebDocs/ Passport_Advantage_Home

http://www.ibm.com/servers/eserver/techsupport.html


http://www.ibm.com/servers/eserver/techsupport.html


http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region for phone numbers of people who provide support for your location.

To contact IBM Software Support, follow these steps:

1. �Determining the business impact� on page 242. �Describing problems and gathering information� on page 243. �Submitting problems� on page 25

Determining the business impactWhen you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting. Use the following criteria:

Describing problems and gathering informationWhen explaining a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions:

� What software versions were you running when the problem occurred?

� Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information.

� Can you re-create the problem? If so, what steps were performed to re-create the problem?

� Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, and so on.

� Are you currently using a workaround for the problem? If so, be prepared to explain the workaround when you report the problem.

� What software versions were you running when the problem occurred?

Severity 1 The problem has a critical business impact. You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution.

Severity 2 The problem has a significant business impact. The program is usable, but it is severely limited.

Severity 3 The problem has some business impact. The program is usable, but less significant features (not critical to operations) are unavailable.

Severity 4 The problem has minimal business impact. The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented.



Submitting problemsYou can submit your problem to IBM Software Support in one of two ways:

� Online: Click Submit and track problems on the IBM Software Support site at http://www.ibm.com/software/support/probsub.html. Type your information into the appropriate problem submission form.

� By phone: For the phone number to call in your country, go to the contacts page of the IBM Software Support Handbook (http://techsupport.services.ibm.com/guides/contacts.html) and click the name of your geographic region.

If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution.



Notices 27

Notices

OverviewThis information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in

B


new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the products described become available.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any

Notices 29

similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM�s application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights reserved.

If you are viewing this information in softcopy form, the photographs and color illustrations might not display.

Trademarks IBM, the IBM logo, Candle, Candle Management Server, Candle Management Workstation, CandleNet Portal, Common User Access, CUA, DB2, developerWorks, EPILOG, ETE, eServer, IBMLink, iSeries, Lotus, MVS, OMEGAMON, OMEGAMON II for MVS, OMEGAVIEW, OMEGAVIEW II, Passport Advantage, pSeries, Redbooks, OS/390, RACF, Rational, Tivoli, the Tivoli logo, Tivoli Enterprise Console, VTAM, WebSphere, z/OS, and zSeries are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.


Other company, product, and service names may be trademarks or service marks of others.

IBM@

Part Number: GI11-4038-00

Printed in USA

GI11-4038-00

GI11-4038-00

Version 3.1publib.boulder.ibm.com/tividd/td/ITOXfOS390/GI11-4038-00/en_US/P… · The 3.1. products...

Documents

Transcript of Version 3.1publib.boulder.ibm.com/tividd/td/ITOXfOS390/GI11-4038-00/en_US/P… · The 3.1. products...