Hardware Management Console Readme *Version 9 Release 1 Maintenance 942 (V9 R1 M942) README* Updated: 05 May 2021 (C) Copyright International Business Machines Corp., 2021 All rights reserved. Contents <#ibm-content> The information in this Readme contains the fix list and other package information about the Hardware Management Console. * Terminology <#term> * PTF MH01876 <#MH01876> * PTF MH01877 <#MH01877> * EOS of x86 Hardware Appliance <#eos> * New Function <#enhance> * List of fixes <#fixes> * Known issues <#known> * VRMF (Version, Release, Maintenance, Fix Level) format for the V9 <#vrmf> * Web Browser Requirements <#browser> * Installation <#install> Terminology *x86* - This term is used to reference the legacy HMC that runs on x86/Intel/AMD hardware for both the 7042 Machine Type appliances and the Virtual HMC that can run on the Intel hypervisors (KVM, VMWare, Xen). *ppc64 or ppc64le* - describes the Linux code that is compiled to run on Power-based servers or LPARS (Logical Partitions) *DNS* - Domain Name Server *GUI* - Graphical user interface *vHMC* - Virtual HMC. The HMC appliance that runs in supported VM Hypervisors PTF MH01876 HMC V9 R1.942.0 Service Pack - for 7042 Machine Types or vHMC for x86 hypervisors (5765-HMW) This package represents a service pack image that can be used to update your HMC from HMC V9 R1.910.0 to the HMC V9 R1.942.0 Service Pack. You can also reference this package by PTF MH01876 and APAR MB04268. * Service packs are cumulative and as such will include all the fixes for the PTFs released up to and including the last service pack(s) for this HMC version. Please read the individual Readme files for each PTF to see the list of fixes. * HMC V9 R1 is the _last planned_ release stream to support 7042-CR7 and CR8 Machine Types. * *Installation notes*: o For HMCs at V9R1 M931 or earlier, install prereq fix MH01853 and then update to V9R1M942. o For HMCs at V9R1 M940 or above update to V9R1M942. /Package information/ Package name Size Checksum (sha1sum) APAR# PTF# HMC_Update_V9R1M942_x86.iso 4186636288 394ba360602dd14831737a920d8a50906e70f234 MB04268 MH01876 Splash Panel information (or lshmc -V output) "version= Version: 9 Release: 1 Service Pack: 942 HMC Build level 2011270432 MH01876 - HMC V9R1 M942 ","base_version=V9R1 " PTF MH01877 HMC V9 R1.942.0 Service Pack - for 7063 Machine Types or vHMC for PowerVM (5765-HMB) This package represents a service pack image that can be used to update your HMC from HMC V9 R1.910.0 to the HMC V9 R1.942.0 Service Pack. You can also reference this package PTF MH01877 and APAR MB04269. * Service packs are cumulative and will include all the interim fixes for the PTFs released up to and including the last service pack(s) for this HMC version. Please read the individual Readme files for each PTF to see the list of fixes. * *Installation notes*: o For HMCs at V9R1 M931 or earlier, install prereq fix MH01854 and then update to V9R1M942. o For HMCs at V9R1 M940 update to V9R1M942. /Package information/ Package name Size Checksum (sha1sum) APAR# PTF# HMC_Update_V9R1M942_ppc.iso 4180641792 10d4dc631773b465f104b21f8b7d896fd054a9c9 MB04269 MH01877 Splash Panel information (or lshmc -V output) "version= Version: 9 Release: 1 Service Pack: 942 HMC Build level 2011270432 MH01860 - HMC V9R1 M941 MH01877 - HMC V9R1 M942 "," base_version=V9R1 " EOS of x86 Hardware Appliance HMC V9 R1 is the last release to support the 7042-CR7 and CR8 machine types. HMC V9R2 will support 7042-CR9, the 7063 machine types and Virtual HMC Appliances (x86/ppc64le) only. *Note*: iFixes and Service packs for V9 R1 will be supported on 7042-CR7 and CR8 machine types until EoS of V9 R1. Install notes Electronic Service Agent may fail to start after the mandatory restart of the PTF install. This can impact services such as call home of inventory. To verify if the service successfully started run the command: *netstat -ln | grep 5024 *One line showing port 5024 in LISTEN states indicates the service successfully started. No action is needed. Successful example: tcp6 0 0 :::5024 :::* LISTEN If no output is returned the HMC should be rebooted to restart the services (*hmcshutdown -r -t now*). New function * Allow reclaim of resources even when the vPMEM volumes are associated with the partition.\ List of fixes *General fixes* * Fixed a problem to prevent periodic service transmissions for FLRT and Disk Health from failing and sending email notifications. * Fixed an issue on Memory tab of IBM i partitions where the Options panel is not enabled. * Fixed RMC operations failure with "/UNAUTHENT requires 's' permission/" error during DLPAR operation. * Fixed an issue where a 5 minute timeout value specified on the chhwres command is ignored during a memory remove operation and a 120 minute timeout value is used instead. This issue only occurs when 5 minutes is specified as the timeout value. * Increased the default timeout value in UI and Rest to 120 minutes. * Fixed an issue to ensure that both encryption is set when authentication is set and vice versa for email notification setup. * Fixed an issue where profile activation fails when 2 VIOS with same Virtual Ethernet adapter configuration with same vlan ids and additional ids but one of them is not a trunk adapter. * Improved the error message when user is trying to remove storage from running partition. * Corrected a misleading error message while performing remote restart operation when the RR status is Source Remote Restarting. * Fixed an issue where the Power Enterprise Pool (PEP) GUI Set Master task was allowed to be performed by any user, instead of only users with the "Change Capacity on Demand" task role. * Fixed an issue where ppt_ratio value was returned as null on systems capable of ppt_ratio setting. * Fixed an issue where additional vlan remains in the last valid configuration of VIOS even though a virtual network that is an additional vlan on existing trunk adapter is deleted. This issue also impacts the last activated profile when automatically save configuration to profile is enabled. * Fixed an issue that caused Save Current Configuration to generate a saved profile named profile_0 where the number incremented each time rather than the specified profile name. This issue only impacts partitions that have Remote Restart enabled but have a configuration error that causes Local Storage Update Failed. * Fixed an issue where launching UI task might show errors for a server (General Settings, Processor, Memory, I/O, Virtual Networks, Virtual NICs) in some specific scenarios with running Linux Partitions on POWER8 systems. * Fixed an issue with profiles of where the Specify MAC Address Restrictions option is neither reflected nor able to be set while editing SR-IOV logical ports on systems capable of enabling migratable option for SRIOV Logical Ports * Enabled hover text to display the complete name for VIOS names longer than 13 characters in the VIOS and adapters tab of the Add Virtual Network wizard. * Fixed an intermittent issue where the partition storage diagram cannot be viewed due to some stale entry in the Storage Information * Fix to prevent the secondary HMC to take over as primary during daily 'primary arbitration' scheduled task if a repair operation is running. * Fixed gaps in the PCM data not showing up in the dashboard when run for a few days in a scaled environment and improved response time of the Aggregated metrics API * Fix to reduce slowness in pedbg data collection * Fixed a CEC periodically going to Incomplete state with NovaLink co-management * Fixed an issue with installios not using the user specified image name while installing VIOS from NFS server when multiple files existed in the directory. * Fix to prevent call home of SRC E2FF1801 * Fixed a UI issue where renaming a vSwitch did not take effect when there was only a change to the case (upper case to lower or vice-versa) of the characters * Fixed an issue with the REST call "/rest/api/uom/ManagedSystem?hwinventory=true" that does not return the results of the PowerSupplies and FANs XML on the first attempt. * Fix to prevent call home of SRCs E23D040A and E2FF4500. * Fixed a NullPointerException while creating a sysplan resulting in error * Fixed a performance issue that caused memory alerts to report SRC E35A0073 for call home. * Fixed an issue where BMC events would get re-reported by the HMC. * Fix to the actions menu options issue based on selection in VNIC Tab of Edit Partition Template. * Fixed lock timeout problem for cross HMC concurrent bi-directional partition migration operations. * Fixed an issue that caused a Power enterprise pool to show an incorrect number of unreturned processors or unreturned memory for the pool after a server in the pool that was unreachable from the master HMC came back up. This issue only occurs if the server had unreturned resources before it came back up, and those unreturned resources were able to be automatically reclaimed when the server came back up. * Fix for a failed partition migration operation without error message resulting in LPM in the other direction error of HSCL8012 The partition named was not found * Fixed an issue while trying to view the Manage Inbound Connectivity panel when a system was connected using ipv6 * Fixed and issue where migration operation failed with error message "/HSCLA319 The partition's virtual Fibre Channel client adapter 27 cannot be hosted by the existing Virtual I/O Servers (VIOSs) on the destination managed system. Set up the necessary VIOS host on the destination managed system, then try this operation again/." * Fix to prevent a LPM validation failure when there is a partition with remote restart state of remote restarting, but remote restart capability is disabled * Fix to display an error message for VIOS RMC state busy while viewing the license during Deploy System Template. * Fix for handling code update when one FSP times out during a firmware update operation while the other FSP completes * Fixed an issue with the Large Send attribute in network bridges using Deploy System Template. * Fixed an issue where user is not allowed to Deploy System Template on a CEC with "Poweroff on last LPAR Shutdown" setting enabled. * Fix an issue where view license text option was disabled when RMC state for VIOS for Busy. * Fixed an issue where the sftp configuration could not be retrieved. * Fixed an issue where the link aggregation configuration in network configuration tab of Deploy System Template was missing. * Fix to block the user from modifying the backing device type while the partition template is opened in view mode. * Fixed an issue where processor throttling may not be started, adjusted, or stopped on a server in a Power enterprise pool 2.0 when that server is managed by 2 HMCs and the state of the server on one of the HMCs is not in Standby or Operating state. * Fixed an issue when an error occurs while modifying dynamic memory allocation for a partition, but is not displayed to the user. The memory allocation appears to be update for the change even though the memory was not really updated in the partition. * Fixed an issue with reporting a truncated SRN for an operating system event when calling home. * Fixed an issue where the user is unable to view the memory panel for partitions on some BSR capable servers. Errors returned include: /"Error launching task// //An internal error occurrred. Please contact your service administrator. [Invocation of method valueChange in com.ibm.pmc.manage.properties.memory.MemoryView$AdvanceSectionListenerfailed.]”/ *Security **fixes* * Addressed the httpd vulnerabilities: CVE-2020-1927 and CVE-2019-10098 * Addressed the nss and nspr vulnerabilities: CVE-2019-17006, CVE-2020-6829, CVE-2020-12400, CVE-2020-12401, CVE-2020-12402 * Addressed the libssh2 vulnerability: CVE-2019-17498 Known issues and limitations * Customer will not be able to create Power Enterprise Pool if IP address not configured properly in Add HMC window in Create Pool Wizard. Workaround is (1) Configure the eth0 to have the same ip address as specified in the Create Pool Wizard. (2) Use REST API or CLI to create pool. * SRC E3550046 is observed, when n/w connection drops while handling nvram changes. * Recovery from a DLPAR failure doesn't restore the resources appropriately. * *lsprimhmc *includes an incorrect host name for master when the peer HMC is master and there is DNS entry for the private ip. * A failure occurs during a pool (CPU/Memory) update operation that prevents adding the resource to the server. * Partition Template does not have POWER9 processor compatibility mode in the list. * *chhmc -c syslog* does not validate *-h* parameter value * *chhmcfs* and *lshmcfs* do not handle the /var/hsc/log filesystem separately from the /var filesystem. This affects when cleaning up only one of those 2 filesystems. * *chlickey* does not handle newline at end of the lickeyfile.txt file * Java Null pointer exception observed when firewall is enabled in bond configuration * Error observed when USB is formatted from GUI * User shall see that help page is not getting loaded for storage pool with reduce option * Console internal error observed when clicked on Help button in View VLAN Network Data * Console Internal error observed when Help button is clicked in Create virtual Disk Panel * When perform the CLI command "*"lslparmigr -r virtualio -m -t --vniccfg 2 --filter ""lpar_ids="*", with the partition in the Open Firmware state the operation may fail with the following error message: "/HSCLB91D The partition cannot be migrated to the destination managed system because the destination managed system does not support the operating system of the migrating partition/." * During LPM operation, when there is an SRIOV mapping failure at the destination, the Validate button in the "LPM validate window" gets disabled after closing the error message box. * DLPAR operation to reducing memory fails with HMC internal error and the GUI session times-out. The workaround is to relaunch the UI. * LPM with VNICs without first doing validation fails when vNIC backing devices are mapped to a target adapter which is switched to dedicated mode right before the migration. * HMC APIs may fail with service unavailable (503) error when there is a heapdump in progress on that service VRMF (Version, Release, Maintenance, Fix Level) format for the V9 The differences in the VRMF with Version 8 & prior vs Version 9 & later is depicted in the following table: * * *V8 & prior** * *V9 & higher** * *Further explanation** * V = Version 8 9 Maps to Power Family R = Release 810,820… 1,2,3… In V8, release mapped to the firmware release. In V9, release increments when an upgrade is required. M = Mod 0,1,2… 910,920… In V8, mod mapped to a service pack. In V9, mod maps the first 2 digits to the service firmware release. In V9, the third digit maps to the HMC service pack. F = Fix Not used 1,2,3… V9 only. The fix level increments for each interim fix (a PTF released between service packs). lshmc -V output will list the PTF number associated with fix. lshmc -v "*RM" field will list the Fix level. * The initial release of the V9 HMC is VRM V9.R1.M910.0 o If a PTF with a security fix comes out the following month, the lshmc –V output would show "Version: 9 Release: 1 Service Pack: 910" as well as the iFix PTF number and description. lshmc -v output would list it as V9R1.910.1. o If Service Pack 1 comes out 3 months later, the VRMF will then be V9.R1.M911.0 * Interim fixes (iFixes) are only published for the most recent service pack level. Once a Service Pack is released, for example 9.1.941.0, you must update 9.1.91x to 9.1.941.0 to obtain future iFixes for V9R1. * When the release is incremented to 9.2 instead of 9.1, new recovery images or vHMC images will be published & a fresh install/upgrade can be done from previous releases. * Maintenance releases will be supported until they are superseded by the next subsequent maintenance level. Web browser requirements Learn about the requirements your web browser must meet to monitor and control the HMC. To access HMC through a remote browser in a Windows 7 environment, you must have a minimum/default of 1600x900 screen resolution. HMC web browser support requires HTML 2.0, JavaScript 1.0, Java™ Virtual Machine (JVM), Java Runtime Environment (JRE) Version 8 U151, and cookie support in browsers that will connect to the HMC. Contact your support personnel to assist you in determining if your browser is configured with a Java Virtual Machine. The web browser must use HTTP 1.1. If you are using a proxy server, HTTP 1.1 must be enabled for the proxy connections. Additionally, pop-ups must be enabled for all HMCs addressed in the browser if running with pop-ups disabled. The following browsers have been tested: Google Chrome This HMC version supports Google Chrome Version 73 (Official Build) (64-bit). Safari This HMC version supports Safari 11.1 Mozilla Firefox This HMC version supports Mozilla Firefox Version 60.5 Extended Support Release (ESR) and Mozilla Firefox Version 60.6 Extended Support Release (ESR). Ensure that the JavaScript options to raise or lower windows and to move or resize existing windows are enabled. To enable these options, click the Content tab in the browser’s Options dialog, click Advanced next to the Enable JavaScript option, and then select the Raise or lower windows option and the Move or resize existing windows options. Use these options to easily switch between HMC tasks. For more information about the latest Mozilla Firefox ESR levels, see Security Advisories for Firefox ESR . Safari This HMC version supports Safari Browser Version 12.0.3 Clearing the Browser Cache In Microsoft Internet Explorer 1. Open the Browser 2. Select *Tools* 3. Select *Internet Options* 4. Under Browser History, select *Delete* 5. Check "*Temporary Internet files and websites files*" and "*Cookies and website data*" 6. Click on *Delete* In Mozilla Firefox 1. In the top-right corner of the browser window click the *menu*button Choose *History*, and then *Clear Recent History.* In time range to clear, select "*Everything*" In the Details section, select "*Cookies*" and "*Cache*" Click on "*Clear now*" 2. In the top-right corner of the browser window click the menu button Choose *Options > Advanced > Network >* In "*Offline Web Content and User Data*" section click on "*Clear Now*" In Google Chrome 1. In the top-right corner of the browser window, click the *Chrome menu* Choose *History*. Click the button *Clear browsing data*. A dialog will appear. From the drop-down menu, select "t*he beginning of time*." Check the boxes "*Cookies, site, and plug-in data*" and "*Cache*" Click the button *Clear browsing data*. 2. Open the following URL with the Chrome browser: *chrome://appcache-internals/* If there is an entry related to the target hmc, click the corresponding “*Remove*” link Other web browser considerations Session cookies need to be enabled in order for ASMI to work when connected to HMC remotely. The ASM proxy code saves session information and uses it. Mozilla Firefox 1. Click *Tools > Options*. 2. Click the *Cookies *Tab. 3. Select *Allow sites to set cookies.* If you want to allow only specific sites, select Exceptions, and add the HMC to allow access. Installation * *Installation notes*: o For HMCs at V9R1 M931 or earlier, install prereq fix MH01853/MH01854 and then update to V9R1M942. o For HMCs at V9R1 M940 update to V9R1M942. o Electronic Service Agent may fail to start after the mandatory restart of the PTF install. This can impact services such as call home of inventory. To verify if the service successfully started run the command: *netstat -ln | grep 5024 *One line showing port 5024 in LISTEN states indicates the service successfully started. No action is needed. Successful example: tcp6 0 0 :::5024 :::* LISTEN If no output is returned the HMC should be rebooted to restart the services (*hmcshutdown -r -t now*). Installation instructions for HMC Version 9 upgrades and corrective service can be found at these locations: Upgrading or restoring HMC Version 9 Updating, upgrading, and migrating your HMC machine code Instructions and images for upgrading via a remote network install can be found here: HMC V9 network installation images and installation instructions Virtual HMC Installation for x86 hypervisors *Installation Images * Download of the Power Hardware Management Virtual Appliance (vHMC) install images are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss . You must be entitled to Product ID 5765-HMW or 5765-HMV in order to download 5765-HMW from the ESS site. Upgrade of 5765-HMV to 5765-HMW is supported. Fixes, mandatory fixes and service packs for the vHMC are common to the Power Hardware management console (HMC) and will be available at IBM Fix Central . The splash panel information (lshmc -V output) for the vHMC will be the same as for the HMC recovery DVD that is documented in the above description section. Installation guidance for installing the vHMC into your hypervisor is found in the IBM Knowledge Center . Installation procedures may vary depending on the operating system you use and the hypervisor you use. A feature of the vHMC is the activation engine which allows you to preconfigure the HMC Console by passing configuration information to the HMC at the first boot of the HMC, when using these images. Please look at the on-line Knowledge Center documentation on using the Activation Engine feature . Notes for the Virtual Appliance for x86 hypervisors * The supported hypervisors for x86 are o VMWARE ESXi 6.0 or higher o KVM on Red Hat RHEL7 or higher o Xen 4.2 or higher on SLES 12 * There are now two images for the VMWare ESXi Server, one is for ESXi 6.0 and the other for ESXi 6.5. This is due to differences in the encoding of the OVA images. SHA1 for ESXi 6.0 , SHA256 for ESXi 6.5 * The processor on the systems hosting vHMC for x86 must have either Intel VT-x or AMD-V Hardware Virtualization enabled. Installation methods for vHMC on x86 hypervisors http://www.ibm.com/support/knowledgecenter/POWER8/p8hai/p8hai_installvhmc.htm After the upgrade, install the mandatory fix using the instructions at Installation methods for HMC Version 8 fixes Virtual HMC for PowerVM LPARS *Installation Images * Download of the Power Hardware Management Virtual Appliance (vHMC) install images are available at the Entitled Systems Support site (ESS): http://www-304.ibm.com/servers/eserver/ess/OpenServlet.wss . You must be entitled to Product ID 5765-HMA or 5765-HMB in order to download 5765-HMB from the ESS site. Upgrade of 5765-HMA to 5765-HMB is supported. Fixes, mandatory fixes and service packs for the vHMC are common to the Power Hardware management console (HMC) and are available at IBM Fix Central. The splash panel information (lshmc -V output) for the vHMC will be the same as for the HMC recovery DVD that is documented in the above description section for the 7063 Machine type. Installation guidance for installing the vHMC into your hypervisor are found in the Online Knowledge Center. Installation procedures may vary depending on the operating system you use and the hypervisor you use. Notes for the Virtual Appliance for PowerVM : * On Power9 servers, the HMC Virtual Appliance for PowerVM must run in Power8 compatibility mode, for this release. * The HMC Virtual Appliance for PowerVM does not provide graphics adapter support for adapters assign to the partition. Use a supported web browser to point to the HMC for UI support. * DLPAR operations such as memory and processor moves for HMCs running in an LPAR are not supported. * Inactive partition migration and Simplified Remote Restart operations are supported. * The virtual appliance for PowerVM requires a Power8 or Power9 server that is enabled for little endian support. Minimum System Firmware 860 recommended for Power8 servers. * vHMC for PowerVM cannot manage the server it is hosted on. Installation of vHMC for LPARs: http://www.ibm.com/support/knowledgecenter/POWER8/p8hai/p8hai_vhmc_pvm.htm Back to top General Virtual HMC notes * Virtual HMC Appliance can be deployed in your existing POWER virtualized infrastructure. Virtual HMC Appliance supports install into PowerVM LPARs. * Call home of serviceable events with a failing MTMS of the HMC itself is disabled. Those serviceable events should be manually reported to IBM software support. * To see if you are running on a virtual HMC use the lshmc -v command. If it displays a UVMID field, then you are running in a virtual machine. Example: lshmc -v "vpd=*FC ???????? *VC 20.0 *N2 Thu Sep 14 15:02:44 UTC 2017 *FC ???????? *DS Hardware Management Console *TM Vc87-f0a *SE 7f61457 *MN IBM *PN N/A *SZ 8371892224 *OS Embedded Operating Systems *NA 127.0.0.1 *FC ???????? *DS Platform Firmware *RM V8R8.7.0.0 **UVMID c87f:0a7f:603a:1457* " * When deploying a virtual HMC, if the mac address is not specified, it will be generated by the hypervisor. Network configuration on the HMC relies on the value of MAC addresses. If you re-deploy a new virtual HMC and want to restore critical console data previously taken on a virtual HMC, ensure sure you are using the same MAC addresses. * When using Activation Engine to setup NTP configuration, you must specify the NTP version value. * We recommend upgrading to the new image that uses 500GB by following the steps below: o From the current HMC version (e.g. HMC V8.860.0), upgrade to HMC V9 R1 M910 o When the upgrade is complete the HMC is now at a new version but still has a 160GB disk. o Perform a Critical Console Data backup, excluding network information and store the backup to a remote location. o Deploy the new HMC V9 R1 M910 image which uses a 500GB disk. o After the HMC boots up with the 500GB disk, restore the Critical Console data. National Language Support (Supported languages) *Languages* *Locales* English en_US,en_AU,en_BE,en_BE@preeuro,en_CA,en_GB,en_GB@euro,en_HK,en_IE,en_IE@preeuro,en_IN,en_NZ,en_PH,en_PK,en_SG,en_ZA Catalan ca_ES, ca_ES@preeuro German de_DE, de_DE@preeuro, de_CH, de_AT, de_AT@preeuro, de_LU, de_LU@preeuro French fr_FR, fr_FR.UTF-8, fr_CH, fr_CA, fr_BE, fr_BE@preeuro, fr_LU, fr_LU@preeuro Italian it_IT, it_IT@preeuro, it_CH Spanish es_ES, es_ES@preeuro, es_AR, es_BO, es_CL, es_CO, es_CR, es_DO, es_EC,es_SV, es_GT, es_HN, es_MX, es_NI, es_PA, es_PY,es_PE, es_PR, es_US, es_UY,es_VE Brazilian Portuguese pt_BR Portugal Portuguese pt_PT, pt_PT@preeuro Polish pl_PL, pl_PL.UTF-8, pl_PL@euro,pl_PL@preeuro Japanese Ja_JP Simplified Chinese zh_CN, zh_SG Traditional Chinese zh_TW, zh_HK Korean ko_KR Hungarian hu_HU, hu_HU.UTF-8,hu_HU@euro,hu_HU@preeuro Dutch nl_NL, nl_NL@preeuro, nl_BE, nl_BE@preeuro Russian ru_RU Czech cs_CZ, cs_CZ.UTF-8,cs_CZ@euro,cs_CZ@preeuro Slovakian sk_SK, sk_SK.UTF-8,sk_SK@euro,sk_SK@preeuro Copyright and Trademark Information http://www.ibm.com/legal/copytrade.shtml Notices This information was developed for products and services offered in the US. 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 grant you any license to these patents. You can send license inquiries, in writing, to: /IBM Director of Licensing// //IBM Corporation// //North Castle Drive, MD-NC119// //Armonk, NY 10504-1785// //US/ For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: /Intellectual Property Licensing// //Legal and Intellectual Property Law// //IBM Japan Ltd.// //19-21, Nihonbashi-Hakozakicho, Chuo-ku// //Tokyo 103-8510, Japan/ 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 jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may 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 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 websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you provide 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 Director of Licensing// //IBM Corporation// //North Castle Drive, MD-NC119// //Armonk, NY 10504-1785// //US/ 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. The performance data and client examples cited are presented for illustrative purposes only. Actual performance results may vary depending on specific configurations and operating conditions. 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. 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 similarity to actual people or business enterprises 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. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. 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_. If you are viewing this information in softcopy, the photographs and color illustrations may not appear. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml . Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft is a trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Back to top